个人开发者应将重复操作固化为一键触发的自动化流程；需确认Codex≥2.4.0、执行codex init初始化并启用skills，再用结果反推法创建PR Summary Generator Skill，最后通过.gitignore外的.codex.yml绑定真实开发动作。

个人开发者需要把零散的重复操作固化为可一键触发的自动化流程，而不是每次打开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’ Skill。要求包含：输入字段（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”。