用途:对当前工作区 Git 变更做系统性代码审查,可选对照相关计划文件,识别工程问题并输出报告。
主要能力:
- 发现变更:使用 git status、git diff、git diff --cached、git diff HEAD 查看已暂存与未暂存改动。
- 关联计划:在 .plans/ 目录查找相关计划,或从分支名、用户确认中确定;无计划则按通用最佳实践审查。
- 逐文件审查:按新增、修改、删除、重命名分类,逐个读取当前状态与 diff,评估是否符合计划、范围是否蔓延、REMOVAL SPEC 是否执行。
- 问题识别:分为不良工程(逻辑错误、错误处理缺失、校验缺失、硬编码、耦合、类型问题、边界缺失)、过度工程(多余抽象、过早优化、框架滥用、功能蔓延、YAGNI 违背)、次优方案(重复代码、重复造轮子、工具选择不当、低效算法、命名差、未复用现有代码、模式不一致)。
- 覆盖度验证:从 GitHub issue、PR 描述、任务单或计划中提取全部需求,逐项核对,覆盖率低于 100% 必须要求修改。
- 跨文件分析:架构影响、破坏性变更、新依赖、模式一致性、完整性检查。
- 生成报告:输出到 .reviews/code-review-[timestamp].md,含摘要、计划符合度、按严重级别分类的问题、文件级审查、统计与建议,并给出 APPROVE、REQUEST CHANGES 或 REJECT 结论。
使用方式:在需要审查当前 Git 变更时调用该技能,按阶段执行命令与检查,最终向用户提供简明总结。
限制:仅做审查,不编辑文件;需有 Git 变更可查;计划文件与 issue 来源若不存在,则按通用实践审查并说明。具体安装或调用命令资料未提供。