Codex 使用场景
将工作流保存为技能
为经常重复的工作创建一项技能,方便 Codex 随时调用。
您可以把已成功完成任务的 Codex 聊天记录、审查规则、测试命令、发布清单、设计约定、写作示例或特定代码仓库的脚本整理成技能,供 Codex 在后续任务中使用。
最适合
- 已有明确步骤、希望让 Codex 重复使用的工作流。
- 希望复用技能,省去每次聊天都要粘贴一长段提示词这一步的团队。
目录
将工作流保存为技能
为经常重复的工作创建一项技能,方便 Codex 随时调用。
您可以把已成功完成任务的 Codex 聊天记录、审查规则、测试命令、发布清单、设计约定、写作示例或特定代码仓库的脚本整理成技能,供 Codex 在后续任务中使用。
您可以把已成功完成任务的 Codex 聊天记录、审查规则、测试命令、发布清单、设计约定、写作示例或特定代码仓库的脚本整理成技能,供 Codex 在后续任务中使用。
相关链接
最适合
- 已有明确步骤、希望让 Codex 重复使用的工作流。
- 希望复用技能,省去每次聊天都要粘贴一长段提示词这一步的团队。
技能与插件
- 收集工作流的相关信息,搭建技能的基本结构,编写简明的核心指令,并验证技能是否按预期工作。
| 技能 | 使用理由 |
|---|---|
| Skill Creator | 收集工作流的相关信息,搭建技能的基本结构,编写简明的核心指令,并验证技能是否按预期工作。 |
起始提示词
创建 Codex 可以随时调用的技能
对于反复要做的工作,您可以用技能为 Codex 提供可复用的指令、资源和脚本。技能可以保留最初让 Codex 帮上忙的任务、文档、命令或示例,供以后复用。
先选一个实际用过的例子,比如一段 Codex 从某个 PR 中拣选提交的聊天记录、一份 Notion 发布检查清单、一组有用的 PR 评论,或一个说明上线流程的 Slack 讨论串。
使用方法
-
添加您希望 Codex 使用的上下文。
在您想保留的 Codex 聊天中继续操作,粘贴 Slack 讨论串或文档链接,并补充您希望 Codex 记住的规则、命令或示例。
-
发送起始提示词。
在提示词中写明您想创建的技能名称,然后把需要保留的任务、文档、PR、命令或输出交给
$skill-creator。 -
让 Codex 创建并验证技能。
创建的技能应定义
$skill-name,说明何时应触发该技能,并将可复用的指令保存在适当的位置。~/.codex/skills中的技能可在任何代码仓库中使用。您也可以将当前代码仓库中的技能提交到仓库,让团队成员一起使用。 -
使用技能,再通过聊天更新它。
下次处理 PR、告警、审查、发行说明或设计任务时,调用新建的
$skill-name。如果它用错了测试命令、遗漏了审查规则、跳过了操作手册中的某个步骤,或写出的草稿让您不愿发出去,请告诉 Codex 应如何改正,并让它据此更新技能。
提供参考材料
将能说明技能应如何工作的材料交给 $skill-creator。
| 您已有的材料 | 如何添加 |
|---|---|
| 您想从 Codex 聊天中保留的工作流程 | 在原聊天中输入 use this chat。Codex 可以从聊天中的上下文、命令、修改和反馈入手创建技能。 |
| 文档或操作手册 | 粘贴发布检查清单,提供事件响应手册的链接,附上 PDF 格式的 API 文档,或告诉 Codex 代码仓库中的 Markdown 指南在哪里。 |
| 团队讨论 | 粘贴同事解释某条告警的 Slack 讨论串,提供包含前端规则的 PR 审查链接,或附上说明客户问题的支持对话记录。 |
| 技能应复用的脚本或命令 | 添加您希望 Codex 在后续任务中运行的测试命令、预览命令、发布脚本、日志获取脚本或本地辅助命令。 |
| 符合预期的结果 | 提供已合并的 PR、定稿的变更日志条目、已获认可的上线说明、已解决的工单、修改前后的对比截图,或您满意的 Codex 最终答复,供后续任务参照。 |
如果材料来自 Slack、Linear、GitHub、Notion 或 Sentry,您可以在 Codex 中通过插件连接相应工具,在起始提示词中提及该工具,或将相关内容粘贴到聊天中。
Codex 会创建哪些文件
大多数技能最初只有一个 SKILL.md 文件。工作流程有需要时,$skill-creator 可以添加较长的参考文档、脚本或素材。
-
my-skill/
- SKILL.md Required: instructions and metadata
- references/ Optional: longer docs
- scripts/ Optional: repeatable commands
- assets/ Optional: templates and starter files
-
您可以创建的技能
如果后续任务需要查阅同一本操作手册、运行同一个 CLI、遵循相同的审查标准、撰写同一类团队进展通报,或测试同一个浏览器操作流程,都可以用这种方法创建技能。例如:
$buildkite-fix-ci下载失败作业的日志,诊断错误,并提出改动最小的代码修复方案。$fix-merge-conflicts检出 GitHub PR 的分支,依据基分支的最新更改更新该分支,解决冲突,并给出可直接运行的推送命令。$frontend-skill让 Codex 按照您的界面风格偏好选用素材,沿用现有组件,反复通过截图检查界面,并在浏览器中打磨细节。$pr-review-comments将审查笔记整理成简洁、语气得当的行内评论,并附上相应的 GitHub 链接。$web-game-prototyper确定首个可玩的游戏循环要包含哪些内容,选择素材,调整游戏手感,截取画面,并在浏览器中打磨游戏细节。
相关使用场景
持续推进目标
如果任务需要 Codex 在多轮对话中持续工作,直到满足可验证的结束条件,请使用 `/goal`。
创建 Codex 能用的 CLI
请 Codex 创建一个可组合使用的 CLI。Codex 可以在任意文件夹中运行它,将它与代码仓库中的脚本配合使用,用它下载文件,并通过配套技能记住它的用法。
开发网页游戏
让 Codex 根据游戏设计概要制定清晰的开发计划,再按计划做出可玩的网页游戏。使用 imagegen 生成美术素材,让 Codex 在真实浏览器中试玩,逐步改进游戏操控和界面。