用途:该技能提供一套代码审查方法,用于评估实现过程中新增或修改的代码(delta),在提交前发现质量、设计、正确性和可维护性问题,而不是对整个代码库做审计。
主要能力:
- 审查工作流:按顺序执行,避免一开始就纠结细枝末节。步骤包括:理解上下文(要解决什么问题、是否有票据或设计文档、实现计划)、高层扫描(涉及文件/目录、新公开 API 或端点、新依赖、迁移与数据变更、变更规模)、评估正确性(是否解决问题、边界与错误条件、假设是否显式、竞态条件)、评估设计(是否符合现有架构、是否引入不必要的新模式、是局部改动还是隐藏的架构决策)、评估测试(关键路径与边界、测试是否像规格说明、是否稳定隔离快速)、轻量安全(标出明显风险,细节留给 security-reviewer)、评估可运维性(日志、指标、追踪、错误信息、告警与 SLO 影响、失败模式)、评估可维护性(中级工程师能否理解、耦合与内聚、命名结构与注释、未来变更),最后提供反馈。
- 模式识别:列出坏味道与建议模式的对照,如长方法→Compose Method、基于类型的条件→Replace Conditional with Polymorphism、重复算法结构→Form Template Method、分散的空值检查→Introduce Null Object、类型字段驱动行为→Replace Type Code with State/Strategy。要求明确指出模式名称。
- SOLID 快速检查:给出 SRP、OCP、LSP、ISP、DIP 各自的危险信号。
- 测试评估:关注关键路径与边界覆盖、测试可读性、稳定性与速度;危险信号包括测试私有方法而非行为、对可用真实实现的对象使用 mock、测试不必要地慢、缺少边界覆盖。
- 安全轻量评估:用户输入是否跨越信任边界、授权与隐私、密钥处理;详细安全分析交给 security-reviewer。
- Conventional Comments:格式为 <label> [decorations]: <subject>,可附讨论。标签包括 praise、nitpick、suggestion、issue、todo、question、thought、chore。装饰包括 (blocking)、(non-blocking) 以及 (security)、(performance)、(tests)、(readability)、(maintainability)。要求区分阻塞与非阻塞、解释每点为何重要、每次审查至少一条 praise、以明确结论收尾。
- 基于原则的审查:按名引用原则形成共同词汇,如 Rich Hickey 的简单不可变数据与纯函数、John Carmack 的直接实现避免不必要抽象、Joe Armstrong 的隔离失败与严格错误处理、Barbara Liskov 的接口契约与可替换性、John Ousterhout 的深模块与简单接口、Donald Knuth 的可读性与可维护性优先于聪明。
- 变更规模指引:<200 行逐行详细审查;200-400 行详细审查(最佳规模);400-1000 行聚焦关键路径、安全边界与架构并建议拆分;>1000 行仅做架构审查并强烈建议拆分。
- 报告格式:包含 Summary、Findings(文件位置在前,再写 Conventional Comment)、Verdict(APPROVE / APPROVE WITH NITS / REQUEST CHANGES)、Rationale。结论标准:APPROVE 表示无阻塞问题;APPROVE WITH NITS 表示仅有非阻塞建议;REQUEST CHANGES 表示存在阻塞问题并给出具体修复建议,用户仍可选择继续(软门禁)。
使用方式:从实现阶段调用时,审查实现期间的所有变更,参考计划理解预期行为,关注变更的质量影响,清晰报告可操作建议;若发现阻塞问题,软门禁完成流程(用户可覆盖);此处标记的安全问题将由 security-reviewer 后续深入检查。
适用场景:审查实现阶段引入的代码增量,检查质量、设计、正确性与可维护性,并给出结构化反馈。
限制:资料未提供安装方式、平台支持、收费或价格信息,暂未提供。