必须启用Skills功能并创建项目级审查Skill:在.config.toml中设置[skills] enabled = true且指定directory;在项目根目录建.agents/skills/code-review-safe/并写SKILL.md,含YAML元数据和5步审查流程;重启后用/skills或codex skill list验证生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你想让Codex每次审查代码时都自动检查改动范围、测试覆盖率、安全风险和文档更新情况,而不是每次都手动复制粘贴同一段提示词——必须把这套流程固化成Skill,否则Codex只会按当前对话临时响应,无法形成稳定审查能力。
确认Skills功能已启用
打开Codex客户端 → 点击左下角设置图标 → 打开config.toml文件 → 检查[skills]区块中enabled = true是否已启用。若为false或该区块缺失,需手动添加并保存;【未开启此开关,后续所有技能均不会被加载】。
接着确认directory字段是否指定路径,例如:directory = "D:/codex-skills"。不填则默认使用~/.codex/skills/(Windows为C:\Users\用户名\.codex\skills\)。
创建项目级审查Skill目录结构
在你的项目根目录下新建目录:.agents/skills/code-review-safe/
这个路径是Codex识别项目级Skill的标准位置,不能写成skills/或codex-skills/,否则Codex启动时不扫描。
进入code-review-safe/目录,新建SKILL.md文件。
编写SKILL.md核心内容
在SKILL.md顶部用YAML front matter声明元数据:
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像,然后保存
---
name: code-review-safe
description: 在PR提交前,自动检查git diff范围、AGENTS.md规范符合度、测试命令执行结果、敏感API调用及文档同步状态。
---
description字段必须具体到触发时机和判断依据,不能写“安全审查工具”这种模糊表述。Codex靠它做Skill匹配,写得越准,误触发越少。
正文部分按实际审查流程写步骤,例如:
1. 先读取当前项目根目录下的AGENTS.md,提取禁止修改的文件列表与必跑命令。
2. 运行git status --porcelain和git diff --no-color HEAD~1 -- :!*.md,仅分析本次提交涉及的源码变更。
3. 检查是否新增了os.exec、eval、crypto.createCipher等高危函数调用。
4. 验证是否所有改动模块都有对应单元测试文件更新,且测试命令能通过。
5. 检查是否同步更新了docs/目录下关联的接口说明或配置文档。
验证Skill是否生效
方法一:重启Codex客户端,输入 /skills 查看插件列表,确认code-review-safe出现在其中。
方法二:在终端执行 codex skill list,输出应包含code-review-safe及其description摘要。
方法三:直接发起一次审查请求,例如:“请对本次git diff做code-review-safe检查”,Codex将自动加载该Skill执行流程,而非依赖你本次输入的提示词。

















