用途 Architecture Hardening Loop 用于在用户指定的代码范围(目录、模块、包或文件集合,或能唯一解析成该范围的定位信息)内,自动跑一轮架构加固循环:扫描候选项、分类准入、最小修复、独立复核,然后在同一范围重新扫描,直到没有证据支持的待修项。它强调“可停止”,不追求把扫描报告清零,也不为让报告“有内容”而制造重构。
不适用情形:只读诊断或只要报告;一次性 review 或 review-fix-re-review 这类不含同范围复扫的流程;完整 plan/spec 定稿。
主要能力
- 范围解析与冻结:读取用户附件、引用内容与只读 Git 信号(commit hash/列表/range、完整 commit 标题、最近 N 个 commit、明确纳入的 working tree 改动),解析成具体文件集合;唯一且非空才继续,歧义时只问一个最小消歧问题并停止。
- Hardening Contract:扫描前写下不可漂移的范围/排除项、范围来源、失败不变量、决策约束、写边界与轮次预算(默认最多 3 个实施轮次)。
- 扫描:调用 improve-codebase-architecture 的 Explore 与 HTML 报告,report-only 后停止,不进入候选选择、grilling 或领域文档;codebase-design 作为扫描器的传递硬依赖。
- 候选准入:Architecture Fix 须同时通过五项准入(当前伤害、真实复杂度或变化、删除测试、决策允许、复杂度净下降);Local Fix 须通过第 1、4、5 项且不改变现有 Interface;其余归 Backlog 或 Reject。
- Candidate Ledger:以“失败不变量或传播成本 + 领域 owner + 拟议 Seam/最小修正”为 fingerprint 去重,记录 First seen、Disposition、证据/反证、Reconsider when 与最后核验轮次。
- 独立复核:修改前调用 agentic-review-handoff 的 consult;修改后走 review-fix-re-review,按用户偏好选择 Reviewer,超时自动换后备。
- 同范围复扫与终态:复扫只接受新 fingerprint 或满足重考虑条件的候选;无 Fix 时经终态 consult 或复用 verdict 后,输出 NO_ACTIONABLE_FINDINGS 并停止。
使用方式 安装命令:npx skills add adonis0123/adonis-skills --skill architecture-hardening-loop。硬依赖需已安装、可读且执行能力可用:improve-codebase-architecture(提示安装:npx skills add mattpocock/skills --skill improve-codebase-architecture)、codebase-design、agentic-review-handoff(npx skills add adonis0123/adonis-skills --skill agentic-review-handoff)。goal-gate 是条件依赖:仅当用户明确要求创建/管理 Goal,或已有可核对的 active Goal / parent contract 时使用;仅点名本 Loop 不授权创建产品 Goal。
主流程:明确范围 → 扫描候选项(仅扫描+报告)→ Candidate Ledger 去重 → 分类为 Architecture Fix / Local Fix / Backlog / Reject → 零 Fix 则 Reviewer consult 复核终态并 NO_ACTIONABLE_FINDINGS;有 Fix 则事前 consult → 条件 Goal 集成 → 最小修改与测试 → Reviewer review-fix-re-review → 原范围重新扫描 → 有 Fix 进入下一轮,否则终态。
Reviewer 选择:用户点名产品或账号则使用它,可加 --reviewer-command / --peer-command;否则只传 --host=<当前宿主产品>,由脚本读用户保存的偏好(默认 claude,codex,grok,不跳过宿主),超时自动换下一个产品重跑同一轮。
适用场景
- 在指定模块或目录里自主加固,修掉现在值得修的架构问题;
- 把架构问题按证据修干净,scan-fix-review 直到没有可修项;
- review 完再扫,确认修复后同一范围不再产生有证据的候选。
限制
- 本技能是薄编排,不复制依赖实现,也不代装依赖;硬依赖未安装/不可读、worker 或 Reviewer 不可用、delegation 不可用时返回 MISSING_DEPENDENCIES 并停止。
- Host 须能启动扫描器要求的独立只读 exploration worker;agentic-review-handoff 须能对偏好里至少一个产品创建或恢复真实 consult/review。
- 会写被 Git 忽略的 .review-handoff/,首次还可能幂等更新 $GIT_COMMON_DIR/info/exclude;用户禁止 .git/ 写且 exclude 未配置时,扫描前返回 HUMAN_GATE。
- 默认最多 3 个外层轮次;破坏性/不可逆/生产数据/认证/计费/外部发布、候选要求扩大原始范围、同一已验证 Fix 连续两次实施或验证失败、3 轮后仍有门槛内 Fix、依赖/凭证/环境使完成条件无法验证、delivery/hash/deadlock/预算异常时暂停并交给用户。
- 普通 PASS_WITH_CONCERNS 按 completion=pass 处理,不问用户;只有用户显式选择 completion=review 才进入 awaiting_user_decision。
- 不得编造验证结果:命令未执行记为 UNVERIFIED。
完成报告包含 Scope、Hardening Contract、Iterations、Result(NO_ACTIONABLE_FINDINGS | HUMAN_GATE | MISSING_DEPENDENCIES | UNVERIFIED)、Architecture Fixed、Local Fixed、Backlog、Rejected、Candidate Ledger、Stop reason、Reviewer evidence、Evidence id、Verification、Lessons 与 Goal 状态。