Codex 用例
将工作流保存为技能
创建一个 Codex 可以随时备用的技能,用于处理重复性工作。
将一个有效的 Codex 线程、审查规则、测试命令、发布检查清单、设计规范、写作示例或特定于仓库的脚本转化为 Codex 可在未来线程中使用的技能。
适用场景
- 经过整理并希望 Codex 再次使用的工作流。
- 希望使用可复用技能,而不是将冗长的提示词粘贴到每个线程中的团队。
目录
将工作流保存为技能
创建一个 Codex 可以随时备用的技能,用于处理重复性工作。
将一个有效的 Codex 线程、审查规则、测试命令、发布检查清单、设计规范、写作示例或特定于仓库的脚本转化为 Codex 可在未来线程中使用的技能。
适用场景
- 经过整理并希望 Codex 再次使用的工作流。
- 希望使用可复用技能,而不是将冗长的提示词粘贴到每个线程中的团队。
技能与插件
- 收集有关工作流的信息,构建技能框架,保持主要指令简短,并验证结果。
| 技能 | 为什么使用它 |
|---|---|
| 技能创建器 | 收集有关工作流的信息,构建技能框架,保持主要指令简短,并验证结果。 |
起始提示词
创建一个 Codex 可以随时备用的技能
使用技能为 Codex 提供可复用的指令、资源和脚本,用于处理你重复的工作。一个 技能 可以保存使 Codex 首次发挥作用时的线程、文档、命令或示例。
从一个有效的示例开始:一个精挑细选了 PR 的 Codex 线程、来自 Notion 的发布检查清单、一组有用的 PR 评论,或是一个解释发布流程的 Slack 线程。
如何使用
-
添加你希望 Codex 使用的上下文。
留在你想要保存的 Codex 线程中,粘贴 Slack 线程或文档链接,并添加 Codex 应记住的规则、命令或示例。
-
运行启动提示词。
该提示词会指明你想要的技能,然后提供
$skill-creator要保存的线程、文档、PR、命令或输出。 -
让 Codex 创建并验证该技能。
结果应当定义
$skill-name, 描述其触发条件,并将可复用的指令保留在正确的位置。在
~/.codex/skills中的技能在任何仓库中均可用。当前仓库中的技能可以被提交,以便团队成员也能使用。 -
使用该技能,然后在线程中对其进行更新。
在下一个 PR、警报、审查、发布说明或设计任务上调用新的
$skill-name。如果它使用了错误的测试命令、遗漏了审查规则、跳过了操作手册步骤,或者写出了你不会发送的草稿,请要求 Codex 将该修正内容添加到技能中。
提供源材料
提供 $skill-creator 解释该技能应如何运作的材料。
| 你已有的内容 | 要添加的内容 |
|---|---|
| 你想保留的某个 Codex 线程的工作流 | 留在该线程中并说 use this thread。Codex 可以将该线程中的对话、命令、编辑和反馈作为起点。 |
| 文档或操作手册 | 粘贴发布清单,链接事件响应手册,附加 API PDF,或指向你仓库中的 Markdown 指南。 |
| 团队对话 | 粘贴有人解释警报的 Slack 线程,链接带有前端规则的 PR 审查,或附加解释客户问题的支持对话。 |
| 该技能应复用的脚本或命令 | 添加你希望未来 Codex 线程运行的测试命令、预览命令、发布脚本、日志获取脚本或本地辅助命令。 |
| A good result | 添加你希望未来 Codex 线程匹配的已合并 PR、最终更新日志条目、已通过的发布公告、已解决的工单、前后对比截图或最终的 Codex 回答。 |
如果来源在 Slack、Linear、GitHub、Notion 或 Sentry 中,请在 Codex 中使用以下方式连接该工具: 插件,在起始提示词中提及它,或将相关部分粘贴到线程中。
Codex 创建的内容
大多数技能最初是 SKILL.md file. $skill-creator 可以在工作流需要时添加更长的参考内容、脚本或资产。
-
my-skill/
- SKILL.md 必填:说明和元数据
- references/ 可选:较长的文档
- scripts/ 可选:可重复的命令
- assets/ 可选:模板和起始文件
-
你可以创建的技能
当未来的线程需要阅读相同的操作手册、运行相同的 CLI、遵循相同的审查标准、撰写相同的团队更新或对相同的浏览器流程进行 QA 时,请使用相同的模式。例如:
$buildkite-fix-ci下载失败作业的日志,诊断错误,并提出最小的代码修复建议。$fix-merge-conflicts检出 GitHub PR,将其针对基础分支进行更新,解决冲突,并返回确切的推送命令。$frontend-skill使 Codex 贴合你的 UI 偏好、现有组件、截图 QA 循环、素材选择以及浏览器打磨阶段。$pr-review-comments将评审意见转化为简明扼要的行内评论,语气得体,并附带 GitHub 链接。$web-game-prototyper界定首个可玩循环,选择素材,调整手感,截取屏幕截图,并在浏览器中进行打磨。