如需查看完整的文档索引,请参阅 llms.txt。在文档页面的 URL 末尾加上 .md 即可查看该页面的 Markdown 版本。
主导航
主题
Codex

Codex 使用场景

将工作流保存为技能

为经常重复的工作创建一项技能,方便 Codex 随时调用。

难度 Easy
时间跨度 5m

您可以把已成功完成任务的 Codex 聊天记录、审查规则、测试命令、发布清单、设计约定、写作示例或特定代码仓库的脚本整理成技能,供 Codex 在后续任务中使用。

最适合

  • 已有明确步骤、希望让 Codex 重复使用的工作流。
  • 希望复用技能,省去每次聊天都要粘贴一长段提示词这一步的团队。

目录

    ← 所有使用场景

    将工作流保存为技能

    为经常重复的工作创建一项技能,方便 Codex 随时调用。

    您可以把已成功完成任务的 Codex 聊天记录、审查规则、测试命令、发布清单、设计约定、写作示例或特定代码仓库的脚本整理成技能,供 Codex 在后续任务中使用。

    Easy
    5m

    您可以把已成功完成任务的 Codex 聊天记录、审查规则、测试命令、发布清单、设计约定、写作示例或特定代码仓库的脚本整理成技能,供 Codex 在后续任务中使用。

    Easy
    5m

    相关链接

    最适合

    • 已有明确步骤、希望让 Codex 重复使用的工作流。
    • 希望复用技能,省去每次聊天都要粘贴一长段提示词这一步的团队。

    技能与插件

    • 收集工作流的相关信息,搭建技能的基本结构,编写简明的核心指令,并验证技能是否按预期工作。
    技能 使用理由
    Skill Creator 收集工作流的相关信息,搭建技能的基本结构,编写简明的核心指令,并验证技能是否按预期工作。

    起始提示词

    请使用 $skill-creator 创建一项 Codex 技能,用于 [fixes failing Buildkite checks on a GitHub PR / turns PR notes into inline review comments / writes our release notes from merged PRs] 创建技能时,请使用以下材料: - 成功示例:[say "use this chat," link a merged PR, or paste a good Codex answer] - 参考资料:[paste a Slack thread, PR review link, runbook URL, docs URL, or ticket] - 代码仓库:[repo path, if this skill depends on one repo] - 可复用的脚本或命令:[test command]、[preview command]、[log-fetch script]、[release command] - 预期输出示例:[paste the Slack update, changelog entry, review comment, ticket, or final answer you want future tasks to match]
    请使用 $skill-creator 创建一项 Codex 技能,用于 [fixes failing Buildkite checks on a GitHub PR / turns PR notes into inline review comments / writes our release notes from merged PRs] 创建技能时,请使用以下材料: - 成功示例:[say "use this chat," link a merged PR, or paste a good Codex answer] - 参考资料:[paste a Slack thread, PR review link, runbook URL, docs URL, or ticket] - 代码仓库:[repo path, if this skill depends on one repo] - 可复用的脚本或命令:[test command]、[preview command]、[log-fetch script]、[release command] - 预期输出示例:[paste the Slack update, changelog entry, review comment, ticket, or final answer you want future tasks to match]

    创建 Codex 可以随时调用的技能

    对于反复要做的工作,您可以用技能为 Codex 提供可复用的指令、资源和脚本。技能可以保留最初让 Codex 帮上忙的任务、文档、命令或示例,供以后复用。

    先选一个实际用过的例子,比如一段 Codex 从某个 PR 中拣选提交的聊天记录、一份 Notion 发布检查清单、一组有用的 PR 评论,或一个说明上线流程的 Slack 讨论串。

    使用方法

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

      在您想保留的 Codex 聊天中继续操作,粘贴 Slack 讨论串或文档链接,并补充您希望 Codex 记住的规则、命令或示例。

    2. 发送起始提示词。

      在提示词中写明您想创建的技能名称,然后把需要保留的任务、文档、PR、命令或输出交给 $skill-creator。

    3. 让 Codex 创建并验证技能。

      创建的技能应定义 $skill-name,说明何时应触发该技能,并将可复用的指令保存在适当的位置。

      ~/.codex/skills 中的技能可在任何代码仓库中使用。您也可以将当前代码仓库中的技能提交到仓库,让团队成员一起使用。

    4. 使用技能,再通过聊天更新它。

      下次处理 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 确定首个可玩的游戏循环要包含哪些内容,选择素材,调整游戏手感,截取画面,并在浏览器中打磨游戏细节。

    相关使用场景