如果你反复让 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