| name | code-review |
| description | 用于当前项目的 Codex 代码审查与评分。适用于“代码审查、PR/MR review、质量评估、风险检查”等场景,要求按 v2.0 规范输出 P0/P1/P2、量化评分、星级和审查结论,并且终端结果与落盘报告都必须使用中文,结果写入根目录 code-review 文件夹。 |
Codex 代码审查技能 v2
执行审查时遵循以下规则:
审查流程
- 先读取
references/review-standard-v2.md 作为评分与分级标准。
- 再读取
references/project-review-focus.md,锁定当前仓库高风险区域。
- 通过
git branch --show-current 获取当前分支名,并将分支名中的 / 替换为 -,生成报告文件名,例如 feat/harness-engineering -> feat-harness-engineering.md。
- 将最终审查结果写入仓库根目录
code-review/ 文件夹,文件路径固定为 code-review/{sanitized-branch-name}.md。
- 结合代码、Diff、检索结果与可执行命令结果形成证据链。
- Findings 输出顺序固定:
- 每个问题必须说明:
- 严重等级与优先级映射固定为:
P0 = 🔴严重
P1 = 🟡中等
P2 = 🟢轻微
- 根据扣分规则计算总分并映射星级。
- 用标准模板给出最终总结与审查结论,并确保“终端输出内容”和“写入 md 文件内容”一致,且两者都必须使用中文。
检查建议
在遵守当前仓库规则与用户限制的前提下,优先使用以下信息源:
npm run type-check
npm run lint
- 必要时使用
npm run build-only
rg 做针对性检索
输出约束
- Findings 必须在前,评分与结论在后。
- 必须给出准确路径和行号。
- 必须给出
P0 / P1 / P2 三类问题计数。
- 必须在报告中写明当前分支名、报告文件路径和最终评分。
- 必须将最终审查结果落盘到
code-review/{sanitized-branch-name}.md。
- 若
code-review/ 不存在,应先创建后再写入报告。
- 终端输出与落盘报告必须全程使用中文,标题、字段名、分组标题、总结与结论不得混用英文模板。
- 若未发现问题,也要写明剩余风险和验证缺口。
- 若命令未执行,必须写明原因,不能假装已验证。
建议输出结构
# 代码审查 - {branch-name}
- 分支:`{branch-name}`
- 报告:`code-review/{sanitized-branch-name}.md`
- 评分:`85/100`
- 星级:`⭐⭐⭐⭐`
- 结论:`建议合并`
## P0(🔴严重)
1. [path:line] 问题说明
## P1(🟡中等)
1. [path:line] 问题说明
## P2(🟢轻微)
1. [path:line] 问题说明
## 汇总
- P0:0
- P1:2
- P2:3