跳到主要内容
返回使用场景

Codex 使用场景

将工作流保存为技能

创建一个 Codex 可随时调用的技能，用于你会重复进行的工作。

简单5 分钟工程工作流
在 Codex app 中尝试官方来源

概览

把一个有效的 Codex 线程、审查规则、测试命令、发布检查清单、设计规范、写作示例或特定仓库脚本，转化为一个 Codex 可在未来线程中使用的技能。

适合场景

  • 你希望 Codex 再次使用的已规范化工作流。
  • 希望使用可复用技能，而不是在每个线程里都粘贴一大段提示词的团队。

根据我的上下文创建一个 Skill

使用 $skill-creator 创建一个 Codex 技能，用于[修复 GitHub PR 中失败的 Buildkite 检查 / 将 PR 备注转成行内审查评论 / 根据已合并的 PR 编写我们的发布说明]

创建技能时请使用以下来源：
- 有效示例：[比如说“use this thread”，链接一个已合并的 PR，或粘贴一个优秀的 Codex 回答]
- 来源：[粘贴一个 Slack 线程、PR 审查链接、runbook URL、文档 URL 或工单]
- 仓库：[仓库路径，如果此技能依赖某个仓库]
- 要复用的脚本或命令：[测试命令]、[预览命令]、[日志抓取脚本]、[发布命令]
- 理想输出：[粘贴你希望未来线程匹配的 Slack 更新、changelog 条目、审查评论、工单或最终答案]

创建一个 Codex 可随时调用的技能

使用技能，为 Codex 提供可复用的说明、资源和脚本，以处理你会重复进行的工作。一个 技能 可以保留第一次让 Codex 发挥作用的线程、文档、命令或示例。

从一个有效示例开始：比如一个成功 cherry-pick PR 的 Codex 线程、一份来自 Notion 的发布检查清单、一组有用的 PR 评论，或一个解释上线流程的 Slack 线程。

如何使用

  1. 添加你希望 Codex 使用的上下文。

停留在你想保留的 Codex 线程中，粘贴 Slack 线程或文档链接，并添加 Codex 应该记住的规则、命令或示例。

  1. 运行起始提示词。

该提示词会说明你想要的技能名称，然后将要保留的线程、文档、PR、命令或输出交给 $skill-creator。

  1. 让 Codex 创建并验证该技能。

结果应定义 $skill-name，说明它应在何时触发，并将可复用说明放在合适的位置。

~/.codex/skills 中的技能可在任意仓库中使用。当前仓库中的技能则可以提交，这样你的队友也能使用。

  1. 使用该技能，然后根据线程持续更新它。

在下一个 PR、告警、审查、发布说明或设计任务中调用新的 $skill-name。如果它使用了错误的测试命令、遗漏了审查规则、跳过了 runbook 步骤，或者写出了你不会发送的草稿，就让 Codex 把这些修正加入该技能。

提供源材料

把能说明该技能应如何工作的材料提供给 $skill-creator。

| What you have | What to add | | ------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 你想保留的、来自 Codex 线程的工作流 | 保持在该线程中并说 use this thread。Codex 可以将该线程中的对话、命令、编辑和反馈作为起点。 | | 文档或 runbook | 粘贴发布检查清单、链接事故响应 runbook、附上 API PDF，或让 Codex 查看你仓库中的 markdown 指南。 | | 团队对话 | 粘贴某人解释告警的 Slack 线程，链接包含前端规则的 PR 审查，或附上解释客户问题的支持对话。 | | 技能应复用的脚本或命令 | 添加你希望未来 Codex 线程运行的测试命令、预览命令、发布脚本、日志抓取脚本或本地辅助命令。 | | 一个理想结果 | 添加你希望未来线程对齐的已合并 PR、最终 changelog 条目、已采用的上线说明、已解决的工单、前后对比截图或最终 Codex 回答。 |

如果来源在 Slack、Linear、GitHub、Notion 或 Sentry 中，请在 Codex 中连接该工具的 插件，在起始提示词中提及它，或将相关部分粘贴到线程中。

Codex 会创建什么

大多数技能一开始都是一个 SKILL.md 文件。当工作流有需要时，$skill-creator 还可以添加更长的参考资料、脚本或资源文件。

你可以创建的技能

当未来线程需要读取同一个 runbook、运行同一个 CLI、遵循同一套审查标准、编写同一种团队更新，或对同一浏览器流程执行 QA 时，都可以使用同样的模式。例如：

  • `$buildkite-fix-ci` 下载失败任务日志，诊断错误，并提出最小范围的代码修复方案。
  • `$fix-merge-conflicts` 检出一个 GitHub PR，将其基于目标分支更新，解决冲突，并返回准确的 push 命令。
  • `$frontend-skill` 让 Codex 紧贴你的 UI 风格、现有组件、截图 QA 流程、资源选择和浏览器细节打磨步骤。
  • `$pr-review-comments` 将审查备注转成简洁的行内评论，并保持合适的语气和 GitHub 链接。
  • `$web-game-prototyper` 确定首个可玩循环的范围，选择资源，调整游戏手感，捕获截图，并在浏览器中进行打磨。