SuperAPI AI 工具集

brooks-review

测试与质量

查看项目

更新于 10-29 11:34

技能介绍

Brooks-Lint — PR Review 是一个面向代码审查场景的技能,主要用于审查现有代码或代码差异(diff),评估可维护性、设计腐化(design decay)和架构风险。

用途 该技能聚焦于代码长期健康度而非单纯功能正确性,通过识别设计腐化症状并追溯其根源,帮助审查者发现可能影响维护成本和架构稳定性的问题。每条发现以“症状 → 根源 → 后果 → 补救”的结构呈现,便于转化为可执行的改进项。

主要能力

  • 按预设步骤扫描腐化风险:依据共享的腐化风险定义与来源归因,按指南中步骤 1–6 的顺序逐项扫描。
  • 自动范围检测:当用户未指定文件或粘贴代码时,应用共享配置中的自动范围检测来确定审查范围。
  • 快速测试检查:运行指南步骤 7 的 Quick Test Check,对仅文档或非生产变更可跳过。
  • 铁律约束:对每条发现应用共享配置中的 Iron Law,确保审查标准一致。
  • 统一报告:使用共享报告模板输出,并在报告中标注模式为 PR Review。

使用方式 使用前需阅读共享资料:../_shared/common.md(铁律、项目配置、报告模板、健康评分规则)、../_shared/source-coverage.md(书籍级覆盖、例外与权衡)、../_shared/decay-risks.md(症状定义与来源归因),以及本目录下的 pr-review-guide.md(分析流程)。随后按流程确定审查范围、依序扫描风险、执行快速测试检查(如适用)、对发现应用铁律,最后按模板输出报告。

适用场景 适合对现有代码库或拉取请求差异进行可维护性与架构风险审查,尤其关注设计腐化迹象和长期维护成本的团队。

限制 该技能依赖上述共享文件与指南文件的存在和内容;资料未提供具体症状清单、铁律细则、健康评分算法及报告模板细节,这些需查阅对应共享文件。资料也未说明支持的语言、平台或集成方式,暂未提供。