对于个人开发者来说,将高频重复操作沉淀为一键触发的自动化流程,能够显著提升开发效率。首先,需要确认 Codex 版本 ≥ 2.4.0,然后执行 codex init 完成初始化并启用 skills 功能。接着,利用“结果反推法”创建 PR Summary Generator Skill。最后,通过位于 .gitignore 之外的 .codex.yml 将 Skill 与真实开发流程绑定起来。

个人开发者应把分散且重复的操作固化成可一键执行的自动化工作流,而不是每次打开 Codex 都重新说明项目结构、代码规范以及验证方式,这样才能更高效地完成日常开发与协作。
确认Codex环境与Skill基础支持
打开终端,运行 codex --version,确认输出的版本号 ≥ 2.4.0;如果低于该版本,需要先完成升级,否则将无法正常加载本地 Skill 目录。
执行 codex init 初始化工作区。该命令会在当前用户主目录下创建 ~/.codex/ 文件夹,并自动生成 skills/ 子目录——【这是所有 Skill 必须存放的位置,路径不可修改】。
检查 ~/.codex/config.yaml 中是否包含 skills_enabled: true,如果没有,则需要手动添加并保存;否则,后续定义的 Skill 将不会被系统加载。
用“结果反推法”快速生成第一个Skill
方法一:基于你刚刚完成的一份高质量 PR 描述文档
全选并复制该文档内容,然后在 Codex 中输入:“依据这份 PR 描述,反向推导出一个可复用的‘PR Summary Generator’技能。其要求涵盖:输入字段(diff片段、commit message、关联issue)、执行步骤(识别修改文件类型、提取关键变更点、匹配业务影响层级)、输出格式(分为‘功能变更’‘风险提示’‘验证建议’三栏,禁用Markdown列表)。”
方法二:直接复用已经验证过的模板
进入 ~/.codex/skills/,新建文件 pr_summary.skill,粘贴以下内容(注意保留缩进和空行):
name: PR Summary Generator
trigger: "generate pr summary"
input: ["diff", "commit_message", "issue_link"]
output_format: |
功能变更:
- [简明动词开头,不超过12字]
风险提示:
- [明确指出文件/逻辑/兼容性风险]
验证建议:
- [给出可执行的本地验证命令或路径]
保存后,在任意对话中输入“generate pr summary”,Codex 会自动调用该 Skill,并等待你依次提供这三个输入字段。
让Skill真正跑起来:绑定真实开发动作
第一步:在项目根目录创建 .codex.yml,写入:
skills:
- name: pr_summary
enabled: true
context: "frontend/src/components/, backend/api/v1/"
第二步:进入你的 Git 仓库,执行 git diff HEAD~1 --no-color,并复制输出结果。
第三步:在 Codex 中输入:generate pr summary → 粘贴刚才的 diff → 回车 → 输入 commit message → 回车 → 输入 issue 链接(如无则输入“none”)。
第四步:Codex 会严格按照你预先定义的格式输出三栏内容,【此时不会进行自由发挥,它只会执行你写好的固定结构】。
第五步:复制输出结果,直接粘贴到 GitHub PR 描述框中,然后点击“Comment”。
