Codex Skill 怎么用?从选择技能到复用代码审查流程

从查看已有 Codex Skill 到建立项目级代码审查清单,给出 SKILL.md 示例、显式调用方法和按文件及测试核对输出的步骤。

Codex Skill 是把一项会重复执行的工作写成可复用说明,而不是寻找“万能提示词”。如果团队每次代码审查都要检查行为变化、测试缺口和回滚风险,可以先选已有的审查技能;没有合适的,再建立一个小型项目 Skill。Codex 会根据技能的说明匹配任务,也可以显式调用,最终结论仍要由人核对代码证据。

先查已有 Skill 是否覆盖任务

在 Codex CLI 或 IDE 中可通过 /skills查看技能,或输入 $选择一个已安装的 Skill;这是 OpenAI 的 Skill 使用文档列出的显式调用方法。先读该 Skill 的任务边界与输出要求:若它只是格式化提交说明,就不能当作代码审查。实际技能名取决于你安装了什么,不要照抄一个不存在的名字。

Codex Skill 怎么用?从选择技能到复用代码审查流程

例如,已有名为 review-checklist的技能时,可以提出这段示例请求:

$review-checklist
只审查当前未提交的改动,重点检查登录失败路径、空输入和测试缺口。
每条发现给出文件路径、触发条件、预期与实际行为;没有证据的猜测单列。
不要修改代码。

预期输出应能指向具体 diff、文件和复现条件。若 Skill 未出现,先确认安装位置与名称,再按下节创建项目级技能;不要把“模型回答了”误当成技能已被调用。

没有合适的技能:建立项目级审查流程

官方文档说明本地项目 Skill 可放在 .agents/skills/下,目录里至少有 SKILL.md,其 frontmatter 必须包含 name和 description。下面是教学示例,请结合团队规则修改后再使用:

.agents/skills/review-checklist/SKILL.md
---
name: review-checklist
description: 审查当前仓库的代码改动,定位行为风险与测试缺口;只读并给出文件证据。
---

1. 先确认审查范围是未提交改动、某个提交还是分支差异。
2. 阅读差异和相关调用路径,检查输入边界、失败状态与现有测试。
3. 只报告可定位到文件与触发条件的问题;不确定的点标为待验证。
4. 按严重程度输出发现、验证步骤和仍需人工确认的部分。
5. 不在审查任务中修改文件。

保存后重新打开技能列表,确认名称和说明被识别;若刚更新却未出现,可按 官方文档建议重启 Codex。随后用一个已有已知缺陷的小改动试运行,核对它是否指出实际路径和失败条件,再调整说明。不要把长篇代码规范全部复制进去;只保留这项审查任务重复需要的步骤。

调用后如何判断有用

  1. 把本次审查目标说清,例如“只审查未提交改动”,避免把整个仓库的旧问题混进结论。
  2. 逐条打开引用的文件和 diff,核对触发条件是否真实。
  3. 能运行的相关测试亲自运行;没有运行的测试不要写成通过。
  4. 把反复遗漏的检查项改进到 Skill,下次再用相近变更验证。

OpenAI 代码审查文档说明审查发现仍需与最新差异和测试核对;审查聊天本身不会自动替你批准或合并变更。本文示例 Skill 未在读者仓库中实测,是否能发现某个 bug 取决于实际代码、上下文与模型判断;Skill 的作用是稳定流程,不能保证零漏报。

Ai菜鸟网。发布者:AI小管家,转载请注明出处:https://www.alyyhw.com/29784.html

赞 (0)
AI小管家的头像AI小管家
Codex 多智能体协作怎么配置?从子智能体设置到一次代码库排查
上一篇 13小时前
Cursor 如何导入已有项目?打开本地目录并让 Agent 定位代码入口
下一篇 13小时前

相关推荐

联系我们

联系我们

1

在线咨询: QQ交谈

邮件:admin@example.com

工作时间:周一至周五,9:30-18:30,节假日休息

关注微信
关注微信
分享本页
返回顶部