用途
gsd-code-review 用于审查某个阶段(phase)内变更的源文件,检查其中是否存在缺陷(bugs)、安全问题以及代码质量问题。它通过启动 gsd-code-reviewer 智能体来分析代码,并在阶段目录中生成 REVIEW.md 产物,其中包含按严重程度分类的审查发现,同时输出内联的发现摘要。
主要能力
- 按阶段审查:以阶段编号为必填参数,审查该阶段内的变更。
- 深度级别控制:支持 quick、standard、deep 三种审查深度。
- quick:仅进行模式匹配(约 2 分钟)。
- standard:逐文件分析,并执行语言特定检查(约 5-15 分钟,默认)。
- deep:跨文件分析,包括导入图和调用链(约 15-30 分钟)。
- 文件范围控制:可通过 --files 显式指定逗号分隔的文件列表,此时跳过 SUMMARY/git 范围界定(在范围界定中优先级最高)。
- 自动修复:通过 --fix 在审查完成后(或 REVIEW.md 已存在时)自动应用发现的修复,会启动 gsd-code-fixer 智能体。
- --all:将 Info 级别的发现也纳入修复范围(默认仅 Critical + Warning)。
- --auto:启用修复 + 重新审查的迭代循环,最多 3 次迭代。
- 可选审查通道标志:任何由 gsd_run review-lane flags 返回的标志(例如 --codex、--agy)会请求该通道独立审查同一已解析范围,与内部 gsd-code-reviewer 智能体并行。其发现仅作为佐证证据——由 gsd-code-reviewer 单独对照实际源代码验证每项声明并写入 REVIEW.md;REVIEW.md 模式只有一个。默认(无审查通道标志)仅使用内部智能体审查。
使用方式
命令参数:
- 阶段编号(必填)——要审查哪个阶段的变更(例如 "2" 或 "02")。
- --depth=quick|standard|deep(可选)——审查深度级别,覆盖 workflow.code_review_depth 配置。
- --files file1,file2,...(可选)——显式逗号分隔的文件列表,跳过 SUMMARY/git 范围界定(范围界定优先级最高)。
- --fix(可选)——审查完成后(或 REVIEW.md 已存在时)自动应用发现的修复。启动 gsd-code-fixer 智能体。接受子标志:
- --all——将 Info 发现纳入修复范围(默认:仅 Critical + Warning)。
- --auto——启用修复 + 重新审查迭代循环,上限 3 次迭代。
- 可选审查通道标志(#4209)——任何由 gsd_run review-lane flags 返回的标志(规范审查通道名册;例如 --codex、--agy)请求该通道独立审查同一已解析范围,与内部 gsd-code-reviewer 智能体并行。其发现仅作为佐证证据——由 gsd-code-reviewer 单独对照实际源代码验证每项声明并写入 REVIEW.md;REVIEW.md 模式只有一个。默认(无审查通道标志)仅使用内部智能体审查,与 #4209 之前逐字节一致。
输出:阶段目录中的 {padded_phase}-REVIEW.md + 内联发现摘要。
上下文文件(CLAUDE.md、SUMMARY.md、阶段状态)在工作流内部通过 gsd-tools query init.phase-op 解析,并通过 <required_reading> 块委托给智能体。
执行端到端流程。工作流(而非本命令)强制执行以下门控:
- 阶段验证(在配置门控之前)
- 配置门控检查(workflow.code_review)
- 文件范围界定(--files 覆盖 > SUMMARY.md > git diff 回退)
- 空范围检查(无文件则跳过)
- 智能体启动(gsd-code-reviewer)
- 结果呈现(内联摘要 + 后续步骤)
适用场景
适用于在开发流程中按阶段对变更代码进行系统化审查,尤其适合需要区分严重程度、控制审查深度、并可选自动修复的场景。
限制
关于收费、价格、平台支持等具体信息,资料中暂未提供。