Codex 技巧：何时使用 Skill，何时使用 AGENTS.md，何时使用普通 prompt

在处理 Codex 技巧时，理解何时使用 Skill、何时使用 AGENTS.md 以及何时使用普通 prompt 是非常重要的。这些工具的合理使用可以极大地提高工作效率和项目管理的清晰度。

AGENTS.md：项目长期规则

AGENTS.md 主要用于存放项目的长期规则和事实信息。这些信息对于项目来说是稳定且具有持续性的，并且只对当前项目有意义。例如，使用特定的包管理工具（如 pnpm 而不是 npm）、UI 组件的存放位置（如 src/components）、在完成前运行代码检查等。这些规则不会频繁变动，且只适用于特定的项目。

Skill：可复用任务流程

Skill 用于定义可复用的任务流程。这些流程不局限于某个项目，而是可以作为标准做法在不同的项目中应用。比如，代码审查（code-review）、前端视觉检查（frontend-visual-check）、发布说明（release-notes）、安全检查（security-check）、PDF 提取（pdf-extract）等。这些技能可以被多次调用，以提高工作效率和标准化操作流程。

普通 prompt：当前需求

普通 prompt 适用于存放一次性或临时的任务需求。这些需求通常是针对特定任务的，不适用于其他场景或项目。例如，修改登录页的错误提示，这种需求是一次性的，不应该被纳入 Skill 或 AGENTS.md 中。

判断使用场景

在使用这些工具之前，可以问自己三个问题来判断使用哪个工具：

这条规则下周还会用吗？如果会，考虑使用 AGENTS.md。
这个流程换项目也能用吗？如果可以，考虑使用 Skill。
这是本次任务独有的吗？如果是，使用普通 prompt。

组合例子

假设有一个项目，需要 Codex 完成以下任务：

AGENTS.md：告诉 Codex 项目怎么跑。
Skill：告诉 Codex 怎么做 UI 视觉检查。
prompt：告诉 Codex 这次要改哪个页面。

通过这种方式，可以保持上下文的清晰，避免将所有信息堆砌在一个 prompt 中，从而提高项目的可维护性和效率。