用途:对代码变更做结构化审查。它以 review_rules.md 和 coding-rules.md 为规则来源,按“规则×文件”矩阵逐条检查改动,并输出评审文件;没有规则文件时退化为安全、正确性、风格的最小默认规则。
主要能力:自动识别输入语言并用同语言输出(日文输入用 references/review-guide.ja.md,英文输入用 references/review-guide.md,显式指定优先);解析 diff 提取变更文件与行;按规则类别匹配文件类型(如 TS 规则对应 .ts/.tsx、测试规则对应 .test./.spec.、API 规则对应控制器/路由);可选与 .specs 设计文档比对一致性;对 Critical/Improvement 发现标注 fix_before(implementation、trial、required_check、follow_up),Minor 不标注;据 fix_before 机械判定 Gate:存在 implementation 即 FAIL,否则 PASS。重审时只读未解决发现、修复改动及相关代码,不重复已记录发现,个别严重新发现可标 implementation,其余为 follow_up。
使用方式:通过命令行选项调用。--task {task-id} 审查指定任务变更并自动检测 diff;--base-commit {sha} 配合 --task 给出基准提交(推荐);--diff {file} 直接审查 diff 文件;--spec {path} 指定 .specs 目录做设计一致性检查;--rules {path} 指定规则文件(省略则自动搜索 docs/development/、docs/);--output {path} 指定输出路径,默认 .specs/{feature}/review-{task-id}.md。示例:/spec-review --task T-007 --base-commit abc1234 --spec .specs/did-deactivation/;无选项时先看 git diff --cached,为空再看 git diff。
限制与错误处理:无可用 diff 时报错停止“No changes to review.”;--task 无法确定基准提交时要求提供 --base-commit;找不到规则文件时警告并使用最小默认规则;--spec 但缺 design.md 时跳过设计一致性检查;输出目录不存在则创建。资料未提供安装方式、平台与收费信息。