Codex Skills 实战

1. Skills 在 Codex 里解决什么问题

没有 Skills 时，很多高频任务都要重复解释：

• 怎么做代码审查
• 怎么补测试
• 怎么做页面美化
• 怎么输出交付总结

有了 Skills，这些方法就能从“一次性提示词”变成“可复用工作流”。

2. 常见技能目录

• 项目级：.agents/skills/
• 用户级：$HOME/.agents/skills/
• 系统级：/etc/codex/skills/

3. 一个最小 Skill 示例

# PR Review Skill

## Purpose
Review pull requests for correctness, regressions, and missing tests.

## When to use
- 用户要求做代码审查
- 需要补测试建议
- 需要指出行为回归风险

## Workflow
1. 先阅读改动范围
2. 优先找 bug、回归和缺失测试
3. 最后再给总体建议

4. 最值得先沉淀的 4 类 Skill

1. review
2. debugging
3. frontend-polish
4. release-check

因为这四类任务在课程交付和真实团队里都特别常见。

5. Skills 和 AGENTS.md 的分工

• AGENTS.md 负责长期规则
• Skills 负责具体流程

一个很好记的说法是：

AGENTS.md = 长期约束

Skills = 可复用动作

官方参考

• OpenAI Developers: Skills
• Subagents、AGENTS.md、Skills 与 MCP