Arch Check —— 架构与实现审查

Arch Check —— 架构与实现审查

把架构审查做成与代码审查相同的操作流程，而不是一份让人逐条挑刺的清单。核心纪律：只报有把握、有实质影响的问题；架构审查最常见的失败是"建议加更多抽象"——这本身就是要被滤掉的 AI slop。

调用解析

从用户输入里解析两件事（缺省值见下）：

• 范围 (scope)：目录 / 文件 / PR 号 / 「当前分支变更」。
• 动作：缺省出报告；--plan 出可勾选的重构任务清单；--fix 直接应用低风险重构。

强度恒定：始终按最高强度审——全部 lens（A–E）、fan-out 并行子 agent、依赖图/环检测、对每条 finding 做对抗式复核。不存在"轻审"模式。

两种作用域模式

diff 范围 = 当前分支相对基线的所有变更（不是只看未提交的）。取变更集：

BASE=$(git merge-base HEAD origin/main 2>/dev/null || git merge-base HEAD main 2>/dev/null || git merge-base HEAD master)
git diff --stat $BASE...HEAD          # 已提交的分支变更
git diff --stat                       # 叠加未提交的工作区改动
git diff $BASE...HEAD                 # 完整 diff

基线优先级：origin/main → main → master →（都没有则问用户或退回 HEAD~N）。在 base/main 分支本身上、无分叉时，退回审未提交改动；仍为空则提示无变更可审。

缺省判定：给了路径 → audit；没给路径、在 git 仓库 → diff（当前分支全部变更）；不在仓库且没给路径 → 询问要审的范围。

审查 lens（对应 references/，按需加载——不要一次性全读）

审查时只读当前 lens 对应的 reference 文件，不要把全部 reference 一次性读进上下文。