如果你反复让 Codex 做同一类任务,比如代码审查、生成运维文档、分析实验结果、改 Halo 主题页面,就可以考虑把流程沉淀成 Skill。
Skill 适合解决什么
Skill 适合稳定、可复用、需要步骤约束的任务,例如:
- 固定格式的代码审查
- 发布前检查
- 文档生成模板
- 设计验证流程
- 数据分析流程
- 常见部署排查
它不适合一次性的临时需求。一次性需求直接写在提示词里更轻。
一个 Skill 通常包含什么
通常会包含:
- 什么时候使用
- 执行步骤
- 禁止事项
- 需要读取的参考文件
- 可复用脚本
- 输出格式
- 验证方式
好的 Skill 不只是“提示词更长”,而是把容易漏的环节固定下来。
判断是否该做 Skill
问三个问题:
1. 这个任务会重复出现吗? 2. 每次都有固定流程吗? 3. 漏掉某一步会造成明显返工或风险吗?
三个答案都是“是”,就值得做。
示例:代码审查 Skill
它可以规定:
- 先列问题,不先总结
- 按严重程度排序
- 必须给文件位置
- 重点看 bug、回归、边界和测试
- 没发现问题要明确说明
这样每次 review 的质量会更稳定。
示例:设计验证 Skill
它可以规定:
- 改页面前先找现有设计语言
- 不凭空发明新风格
- 桌面和移动都截图
- 检查文字是否溢出
- 改线上模板前必须备份
这正适合主题页面改造这类任务。
常见坑
不要把 Skill 写成百科全书。越长越难执行,重点应该是关键流程和禁忌。
不要把项目私密信息写进公开 Skill。私钥、服务器密码、内部 token 都不应该进入 Skill。
不要把一次性业务目标写进 Skill。Skill 是复用能力,不是当前任务记录。
官方来源
- https://developers.openai.com/codex/concepts/customization
- https://developers.openai.com/codex/learn/best-practices