最近折腾 Codex Skills 和 AGENTS.md,我觉得三者边界可以这么分:
AGENTS.md:项目长期规则- Skill:可复用任务流程
- 普通 prompt:本次具体需求
官方文档:
- Codex Skills: Agent Skills – Codex | OpenAI Developers
- OpenAI skills repo: GitHub - openai/skills: Skills Catalog for Codex · GitHub
1. AGENTS.md 放项目事实
比如:
[推广] HyperAPI 的新老用户来领福利了
消费级显卡(16G A 卡)是不是不适合运行 vllm 和 sglang,好像使用 transformer 推理都比这两个框架快,并且占用显存低
- Use pnpm, not npm.
- UI components live in src/components.
- Run pnpm lint before finishing.
- Do not edit generated files.
这些规则长期稳定,而且只对当前项目有意义。
2. Skill 放可复用流程
比如:
code-review
frontend-visual-check
release-notes
security-check
pdf-extract
它们不是某个项目独有的,而是一类任务的标准做法。
3. 普通 prompt 放当前需求
比如:
把登录页的错误提示改成 toast,并保持现有 API 不变。
这种一次性目标不应该写进 Skill,也不应该写进 AGENTS.md。
我的判断问题
写之前问自己三句话:
- 这条规则下周还会用吗?会,考虑 AGENTS.md。
- 这个流程换项目也能用吗?能,考虑 Skill。
- 这是本次任务独有的吗?是,放 prompt。
一个组合例子
AGENTS.md:告诉 Codex 项目怎么跑。
Skill:告诉 Codex 怎么做 UI 视觉检查。
prompt:告诉 Codex 这次要改哪个页面。
这样上下文会干净很多,不会所有东西都堆在一条 prompt 里。
1 个帖子 - 1 位参与者