Codex Skills：封装重复工作的操作方法

中文实战指南 · 核验于 2026-11-14

如果你总在重复说明一套操作，比如如何检查发布说明、怎样整理某类文档，可以把方法写成 Skill，留待下次使用。

下面从最小的 SKILL.md 开始，介绍名称、描述和步骤的写法。项目长期约定适合放在 AGENTS.md，Skill 则用来描述一件具体工作怎么做。

最小结构

在适用的 .agents/skills/ 下建立独立目录，其中包含 SKILL.md。Codex 可沿当前目录向上的适用路径发现项目 Skills；不要假定同名目录会自动合并成一个 Skill。

.agents/skills/release-note-review/
└── SKILL.md

文件示例：

---
name: release-note-review
description: Review a release note against a provided change list.
---

1. Read the change list and the draft release note.
2. Check each claimed behavior against the supplied evidence.
3. Report missing changes and unsupported claims with file references.
4. Return review findings without publishing the release note.

name 和 description 是必要元数据。描述要说清何时使用，正文再写具体步骤、输入和结果。

从说明到工具

先让纯文本 Skill 能完成工作。只有确实需要时再增加 scripts/、references/ 或 assets/，并从正文按需引用。渐进加载意味着发现 Skill 不等于所有引用文件都已读入。

在 Codex 中可用 $release-note-review 显式调用这个示例 Skill。验证时准备一个完整输入和一个缺少变更清单的输入，检查它是否分别给出审查结果或精确指出缺什么。

Skill 中的文字不能替代发布授权，也不会给工具增加权限。需要外部系统操作时，继续看 MCP 和 审批与沙箱。