作者:互联网 时间: 2026-08-21 07:44:55
个人开发者应将重复操作固化为一键触发的自动化流程;需确认Codex≥2.4.0、执行codex init初始化并启用skills,再用结果反推法创建PR Summary Generator Skill,最后通过.gitignore外的.codex.yml绑定真实开发动作。
个人开发者需要把零散的重复操作固化为可一键触发的自动化流程,而不是每次打开Codex都从头解释项目结构、编码规范和验证方式。
打开终端,运行 codex --version,确保输出版本号 ≥ 2.4.0;低于此版本需先升级,否则无法加载本地Skill目录。
执行 codex init 初始化工作区,该命令会在当前用户主目录下创建 ~/.codex/ 文件夹,并自动生成 skills/ 子目录——【这是所有Skill必须存放的位置,不可更改路径】。
检查 ~/.codex/config.yaml 中是否包含 skills_enabled: true,若无则手动添加并保存,否则后续定义的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并等待你提供三个输入字段。
第一步:在项目根目录创建 .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”。