architecture-rescue 是一个面向代码库架构诊断的技能,用于在复杂或混乱的代码库中寻找“深化机会”。它的目标不是直接给出接口设计,而是先定位值得改造的位置,并整理成编号候选清单,作为后续设计评审(grill-me 会话)的议程。
主要能力包括:识别浅模块(shallow modules)、缺失的接缝(missing seams)和泄漏的抽象(leaky abstractions)。技能附带一套架构术语表,例如模块、接口、深度、接缝、适配器、杠杆和局部性,并要求在写作中保持规范词汇。它提供两种核心判断方法:删除测试(deletion test)用于判断模块是否是纯转发;双适配器规则(two-adapter rule)用于判断隐藏的接缝是否应提升为显式接口。
使用方式上,技能建议先勘察源码树,统计各模块文件数量并记录顶层分解;通读 3 至 5 个模块,优先选择用户指认为“混乱”的模块,否则选择最大且被引用最多的模块。随后对每个候选应用删除测试,并搜索双适配器配对(例如 class.*implements、并行文件名如 Memory. / Postgres.、跨文件重复的方法形状)。候选输出需包含文件引用(含行号)、问题陈述、通俗解决方案、局部性收益和杠杆收益。候选清单完成后交给 grill-me 进行设计树走查;若评审引入新术语,则调用 maintain-context 将新词落入 CONTEXT.md 或项目词汇表;只有在评审之后,才使用 Design It Twice 模式提出显式接口。
适用场景包括:代码库架构梳理、识别过度抽象或抽象不足的模块、为重构准备候选清单、以及需要以具体证据(文件与行号)讨论架构问题的团队评审。限制方面:该技能明确不直接提出接口,也不跳过评审直接进入接口设计;其输出应保持精简,一页精准候选优于冗长报告;资料未提供具体安装命令、平台支持、收费方式或效果数据。