Codex critical-review 技能安装与用法:按严重程度评审代码
EnglishCodex 安装步骤
- 打开 GitHub 固定提交的 `.agents/skills/critical-review/SKILL.md`,核对内容与使用条件。
- 在自己的项目中创建 `.agents/skills/critical-review/`,把核对后的文件保存为 `.agents/skills/critical-review/SKILL.md`。
- 在该项目根目录启动 Codex,输入 `$critical-review` 并选择同名技能。
中文摘要
对照验收条件检查变更,从正确性、设计、可读性和测试等方面报告有证据的问题。按严重程度给出位置、影响和修改建议。
SKILL.md 中文导读
可复现示例
调用 critical-review,对下面虚构的订单汇总代码做变更评审。
case data `order_totals_test` | acceptance=sum all items
file `order_totals.py` | changed expression `sum(items[1:])`
input `items=[3]` | observed `total=0` | expected `total=3`工作步骤
- 先阅读验收条件,确认变更的预期行为。
- 逐项检查正确性、设计、可读性、输入约束、性能和测试,并根据证据写出问题。
- 按严重程度分组,给出修复建议和边界用例检查。
验收方法
将 `order_totals.py` 的首项漏算列为 `Blocker`。写明 `items=[3]` 时观察到 `total=0`,验收要求 `total=3`。建议修复求和范围,并保留该边界用例。
GitHub 原文 · 更新日期
适用环境
Codex 项目工作区。示例提供变更片段、验收条件和观察结果,便于按严重程度评审。
常见问题
如何把评审结果写成可处理的问题?
先按严重程度分组,然后指出变更位置、影响和可验证的修复建议。本例的问题影响订单汇总正确性。