摘要
很多人使用 Codex 的方式，还停留在一句话：
“帮我改一下代码。”
但真正高效的 Codex 用法，不是让它一上来就动手，而是让它先理解目标、制定计划、确认风险，再进入执行闭环。
这也是 create-plan 和 gh-fix-ci 这两个 Skill 值得安装的原因。
一个负责“先想清楚”，一个负责“把 CI 修好”。
前者提升决策质量，后者打通工程反馈。两者组合起来，Codex 就不再只是一个会写代码的助手，而更像一个可以被训练的工程执行伙伴。
不要只训练 AI 会写代码，要训练 AI 会按正确流程推进工作。
一、先理解：Codex Skill 到底是什么？
Codex Skill 可以理解为一组可复用的任务能力包。
它通常包含：
- 固定的任务说明
- 执行流程
- 操作约束
- 可调用脚本
- 参考资料
- 验证方法
普通提示词的问题是：每次都要重新说一遍，而且模型容易遗漏关键约束。
Skill 的价值是：把高频工作流沉淀下来，让 Codex 下次遇到类似任务时，能按更稳定的方式执行。
比如修 CI 这件事，如果只是对 Codex 说：
帮我修一下 CI。它很可能直接猜问题，然后开始改代码。
但真正可靠的流程应该是：
检查 PR → 拉取 GitHub Actions 日志 → 提取失败原因 → 判断根因 → 提出修复计划 → 等待确认 → 修改代码 → 本地验证 → 总结结果。这就是 Skill 的价值。
它不是让 AI 更会聊天，而是让 AI 更会保管工作方法。
Skill 不是一句提示词，而是一套被保存下来的工作方法。
二、为什么推荐这两个 Skill？
1. create-plan：让 Codex 先计划，不要急着改
create-plan 的核心价值是：让 Codex 在动手前，先形成一个清晰、可执行、可审查的计划。
它适合这些场景：
- 要开发一个新功能，但不希望 AI 直接乱改。
- 要重构一块代码，但希望先看到影响范围。
- 要排查 bug，但希望 Codex 先读懂项目结构。
- 要改官网、改文案、改 UI，但希望它先给迭代路线。
- 要让 Codex 多轮执行，但第一步必须先规划。
它最重要的不是“计划”两个字，而是让 Codex 进入一种更稳的工作模式：
理解上下文 → 拆解任务 → 识别风险 → 定义验证方式 → 再进入执行。很多人用 Codex 翻车，不是因为模型不会写代码，而是因为一开始目标没有被拆清楚。
目标不清楚，AI 就会猜。
AI 一猜，就容易多改、误改、顺手重构，最后项目越来越乱。
create-plan 的作用，就是在执行前加一道“思考闸门”。
create-plan 像一道思考闸门，让 Codex 先拆清目标、风险和验证方式。
2. gh-fix-ci：专门修 GitHub Actions 失败
gh-fix-ci 是一个非常实用的工程 Skill。
它的目标很明确：当 GitHub PR 的 CI 失败时，让 Codex 使用 GitHub CLI 检查失败的 checks 和 logs，定位问题，提出修复计划，并在确认后修改代码。
它适合这些场景：
- PR 已经提交，但 GitHub Actions 红了。
- 不想自己一层层点开 CI 日志。
- 不确定是测试失败、lint 失败、类型错误，还是构建失败。
- 希望 Codex 先解释失败原因，再修复。
- 希望修完后自动跑相关测试。
它的价值在于，把一个真实工程里的重复流程产品化了：
看 CI → 找日志 → 定位失败 → 给计划 → 修代码 → 验证。这比一句“帮我修 CI”稳定得多。
gh-fix-ci 把红色 CI 变成可定位、可修复、可验证的反馈闭环。
三、安装前准备
安装之前，建议先确认三个基础条件。
1. Codex 可以正常使用 Skill
你需要能在 Codex 中调用：
$skill-installer安装完成后，可以用：
/skills查看当前已经安装的 Skill。
也可以输入：
$看 Codex 是否能列出可调用的 Skill。
2. gh-fix-ci 需要 GitHub CLI
gh-fix-ci 依赖 GitHub CLI，也就是 gh 命令。
先检查本机是否已经安装：
gh --version再检查是否已经登录：
gh auth status如果没有登录，执行：
gh auth login建议确保 GitHub CLI 有 repo 和 workflow 相关权限，否则 Codex 可能无法读取 CI 日志。
3. create-plan 属于 experimental skill
create-plan 不一定能像 curated skill 一样直接通过名字安装。
更稳的方式，是明确告诉 Codex：
从 openai/skills 仓库的 .experimental 目录安装 create-plan。这个过程通常需要网络访问权限。
四、安装 gh-fix-ci
在 Codex 里输入：
$skill-installer gh-fix-ci安装完成后，执行：
/skills如果列表里出现 gh-fix-ci，说明安装成功。
也可以输入：
$gh-fix-ci看 Codex 是否能识别这个 Skill。
五、安装 create-plan
推荐使用这条命令：
$skill-installer install the create-plan skill from the .experimental folder如果安装失败，可以用更明确的路径：
$skill-installer install https://github.com/openai/skills/tree/main/skills/.experimental/create-plan安装后验证：
/skills或者输入：
$create-plan如果 Codex 能识别，说明安装成功。
六、推荐工作流：先 plan，再 fix
这两个 Skill 最好不要孤立使用，而是组合使用。
推荐流程是：
$create-plan Read this repository and create a concise implementation plan for fixing the failing CI. Do not modify files yet.等 Codex 输出计划后，先看三件事：
- 它有没有理解失败目标？
- 它有没有明确要检查哪些文件？
- 它有没有写清楚如何验证？
确认计划靠谱后，再执行：
$gh-fix-ci Inspect the failing GitHub Actions checks on the current branch PR, use the approved plan, implement the fix, run relevant tests, and summarize the final diff.这套流程的重点不是“多一步”，而是把 AI 的执行过程从黑箱变成可控流程。
先用 create-plan 定边界，再用 gh-fix-ci 修反馈，最后回到验证。
七、常用提示词模板
模板 1：只做计划，不改文件
$create-plan Read the repository, understand the current task, and create a concise implementation plan. Do not modify any files. Include files likely to change, risks, and validation steps.适合功能开发、重构、bug 排查前使用。
模板 2：修当前 PR 的 CI
$gh-fix-ci Inspect the failing GitHub Actions checks on the current branch PR. Summarize the failure, identify the likely root cause, propose a fix plan first, and wait for my approval before modifying files.适合已经开了 PR，并且 GitHub Actions 失败的场景。
模板 3：修指定 PR
$gh-fix-ci Debug the failing CI on PR #123. Fetch the relevant GitHub Actions logs, summarize the actionable error snippets, propose a fix plan, then wait for approval before implementation.适合多分支、多 PR 的项目。
模板 4：修完后强制验证
After applying the fix, run the most relevant local tests or checks. If local verification is not possible, explain why and list the exact checks that should pass in GitHub Actions.这句可以追加在任何 CI 修复任务后面。
八、最重要的四条原则
原则 1：不要让 AI 一上来就改
很多 Codex 翻车，不是因为它不会改，而是它过早进入执行。
更稳的方式是：
先计划，不改文件。计划确认后，再让它进入执行。
这会显著降低误改、过度重构和“顺手优化”的概率。
原则 2：CI 修复必须看日志，不要靠猜
CI 失败通常有真实证据。
你至少要知道：
- 哪个 job 失败？
- 哪个 step 失败？
- 是 lint、test、build、typecheck，还是 deploy？
- 失败日志里的第一处有效错误是什么？
- 本地是否能复现？
gh-fix-ci 的价值就在于，它不是只根据用户描述修，而是拉取 GitHub Actions 日志后再判断。
这比“凭感觉修 CI”可靠得多。
原则 3：approval gate 是安全阀
gh-fix-ci 很重要的设计是：
先给计划，经过确认后再改。这点非常关键。
在真实项目里，CI 失败可能只是表象。贸然修改，可能会引入更大问题。
所以要把“先计划、后确认、再修改”当成默认流程，而不是可有可无的步骤。
原则 4：修完一定要验证
AI 改完代码，不等于任务完成。
真正的闭环是：
定位问题 → 修改代码 → 跑测试 → 查看结果 → 总结变更 → 明确剩余风险。如果本地不能跑测试，也要让 Codex 说清楚原因，并告诉你需要在 GitHub Actions 里观察哪些 check。
把审批门、日志证据和验证结果放进同一个工程闭环。
九、常见问题
1. 安装后看不到 Skill 怎么办？
先执行：
/skills如果没看到，重启 Codex。
有些 Skill 安装后需要重新加载，Codex 才能识别。
2. create-plan 安装失败怎么办？
优先尝试：
$skill-installer install the create-plan skill from the .experimental folder如果失败，再用明确路径：
$skill-installer install https://github.com/openai/skills/tree/main/skills/.experimental/create-plan还不行，就检查 Codex 是否有网络访问权限。
3. gh-fix-ci 不能读取 PR 怎么办？
先检查 GitHub CLI：
gh auth status确认你已经登录，并且当前目录是 GitHub repo。
再确认当前分支是否已经关联 PR：
gh pr status如果 gh 本身都读不到 PR，Codex 也无法通过 gh-fix-ci 正常工作。
4. 它能修所有 CI 吗？
不一定。
gh-fix-ci 主要面向 GitHub Actions。
如果你的项目用的是 Buildkite、CircleCI、GitLab CI 或其他外部 CI，它可能只能看到链接，无法像 GitHub Actions 一样完整拉取日志。
这时可以让 Codex 总结它能看到的信息，但不要期待它完成完整自动化。
十、我的推荐默认流程
我建议把这两个 Skill 固定成 Codex 的默认工程流程。
开发新功能
$create-plan Plan this feature first. Do not modify files.确认后再执行开发。
修 bug
$create-plan Investigate the bug and propose a minimal fix plan. Do not modify files yet.确认后再修改代码。
修 CI
$gh-fix-ci Inspect the failing PR checks, summarize the root cause, propose a fix plan first, and wait for approval.确认后再执行修复。
大改动前
$create-plan Create a safe migration plan. Include changed files, risks, rollback strategy, and validation steps. Do not modify files.十一、真正的启发：不要只训练 AI 写代码，要训练 AI 按流程工作
create-plan 和 gh-fix-ci 表面上是两个 Codex Skill。
但它们背后代表的是一种新的 AI 工作方法。
过去我们使用 AI，是把它当成“聪明的临时工”：
我说一句，它做一步。但更高级的用法，是把 AI 训练成“有流程的执行系统”：
目标 → 上下文 → 计划 → 执行 → 验证 → 复盘。Skill 的价值，不只是省提示词，而是把高质量工作方式沉淀下来。
真正值得积累的，不是某一次 AI 给出的答案，而是让 AI 下次也能稳定做对的工作流程。
所以，这两个 Skill 对 Codex 用户的启发很简单：
不要只训练 AI 会写代码，要训练 AI 会按正确流程推进工作。
这才是 Codex 从“代码助手”走向“工程执行伙伴”的关键一步。
参考资料
-
OpenAI Codex 官方文档：Agent Skills
https://developers.openai.com/codex/skills -
OpenAI skills GitHub 仓库
https://github.com/openai/skills -
OpenAI skills README：Installing a skill
https://github.com/openai/skills/blob/main/README.md -
OpenAI skill-installer 说明
https://github.com/openai/skills/blob/main/skills/.system/skill-installer/SKILL.md -
OpenAI Codex Discussion #8877：create-plan 位于 .experimental 目录
https://github.com/openai/codex/discussions/8877 -
gh-fix-ci Skill 说明
https://github.com/openai/skills/tree/main/skills/.curated/gh-fix-ci