Codex Skills 安装指南：项目目录、用户目录与 SKILL.md

Codex Skills 是可审查的本地工作流说明。项目级 Skills 位于 $CWD/.agents/skills，用户级 Skills 位于 $HOME/.agents/skills。每个有效的 Skill 目录必须包含 SKILL.md；来源、说明文件和所需权限都应在安装前核对。

使用安装器的示例

在支持该安装器的 Codex 环境中，可请求安装 Linear Skill：

$skill-installer linear

安装前后都应阅读对应的 SKILL.md，确认它的触发条件、工具调用和可读写路径符合当前任务。

手工放置 SKILL.md

1. 项目级 Skill：创建 $CWD/.agents/skills/my-skill/。
2. 用户级 Skill：创建 $HOME/.agents/skills/my-skill/。
3. 在其中创建 SKILL.md，写明名称、用途、触发条件、允许访问的路径和停止条件。
4. 在不含密钥的低风险任务中触发一次，确认它没有自动发布内容、修改生产配置或访问浏览器凭据。

可复现操作案例

创建 $CWD/.agents/skills/read-only-check/SKILL.md，只描述读取项目 Markdown 并列出术语差异的任务。用一份测试文档触发它，验收标准是只产生报告、不写源文件，也不把 API Key、cookie 或用户资料写入日志。

目录与安装方式以 官方 Codex Skills 文档为准；不明来源的 Skill 不应直接用于有凭据或生产发布的任务。