← ClaudeAtlas

forge-reviewlisted

Use when performing 3+1 stage code review (3 mandatory + 1 optional supplement) covering spec alignment, structural code quality, and anti-pattern inspection.
gldu/dev-forge · ★ 1 · AI & Automation · score 62
Install: claude install-skill gldu/dev-forge
# forge-review — 3+1 轮审查 ## Goal 作为 Reviewer,只产报告 + 修复任务,不直接改代码。 ## Workflow 使用 `references/REVIEW.md` 模板分三轮审查(后端/lib 项目跳过第三轮)。 ### 第一轮 · Spec 合规审查 逐条对照 REQUIREMENT.md 的 AC: - [ ] 每条 AC 是否被实现 - [ ] 每条 AC 是否被测试覆盖(链接到 TEST.md) - [ ] 是否引入了 `out of scope` 里明令排除的内容 - [ ] 是否新增了 REQUIREMENT.md 里没有的功能(范围蔓延) - [ ] 是否触动了 DESIGN.md 之外的架构 ### 第二轮 · 代码质量审查(书本驱动 6 维衰退风险) #### 2.0 TEST.md 5 轮金字塔完整性 打开 TEST.md,检查"本次测试范围声明"段: - 5 轮状态都明确(无未填) - 跳过的轮次都有理由 - 第 1 轮每条 AC 有覆盖 - 第 2~5 轮按需达标 任意一项不达 → 标 🔴 Critical,先回 5-test 补完。 #### 2.1 代码质量诊断 · 6 维衰退风险 | 编号 | 衰退风险 | 诊断问题 | 主要源头 | |---|---|---|---| | R1 | Cognitive Overload | 理解这段代码要多少心智? | Code Complete / Refactoring / DDD | | R2 | Change Propagation | 改一���会坏多少不相干的地方? | Clean Architecture / Pragmatic | | R3 | Knowledge Duplication | 同一个决定被表达在多处? | Pragmatic / Refactoring / DDD | | R4 | Accidental Complexity | 代码是否比问题本身更复杂? | Brooks / Philosophy of SD | | R5 | Dependency Disorder | 依赖流是否一致方向? | Clean Architecture / SE@Google | | R6 | Domain Model Distortion | 代码是否忠实反映业务领域? | DDD / Refactoring | 路径 A(装了 brooks-lint):`/brooks-review`,输出必须含 4 要素(Symptom / Source / Consequence / Remedy)+ 书本引用,原样贴入 REVIEW.md。 路径 B(未装):AI 自己逐个维度诊断,输出同样 4 要素格式。每条都要标 R1~R6 编号、具体 `<file>:<line>`、至少一本书作为 Source。 #### 2.2 架构依赖检查(大型 change 触发) 触发条件:新增/重命名顶级模块 / 危险 import / 引入新中间件 / 跨 >= 5 模块重构。 1. **图谱查询**(工具支持时):检测循环依赖 ``` MATCH (a:Class)-[:CodeRelation {type: 'IMPORTS'}]->(b:Class)-[:CodeRelation {type: 'IMPORTS'}]->(a) RETURN a.name, a.filePath, b.name