该技能用于在代码库中寻找架构摩擦,并提出“深化”重构机会:把浅模块变为深模块,目标是提升可测试性与 AI 可导航性。
用途:当用户希望改进代码库架构时使用。它先阅读项目领域词汇表与所涉区域的 ADR,再通过探索子代理走访代码库,记录理解一个概念需在多个小模块间跳转、接口几乎与实现一样复杂、为测试抽取纯函数但真实缺陷藏在调用方式中、模块跨接缝泄漏、以及未被测试或难以测试等摩擦点。
主要能力:以统一术语描述模块、接口、实现、深度、接缝、适配器、杠杆与局部性;运用删除测试判断模块是否只是传递层;以编号列表呈现候选深化机会,每项包含涉及文件、问题、解决方案,以及从局部性、杠杆和测试改进角度说明的收益;候选若与 ADR 冲突,仅当摩擦足够真实时标出并建议重新审视。
使用方式:探索阶段先读领域词汇表与 ADR,再用 Agent 工具以 subagent_type=Explore 走访代码库;随后列出候选并询问用户想探索哪一个;用户选定后进入“拷问循环”,讨论约束、依赖、深化模块的形态、接缝背后内容以及哪些测试仍有效。过程中可把新概念或澄清后的术语写入项目领域词汇表;若用户以关键理由拒绝候选,可询问是否记录为 ADR。接口设计参考 INTERFACE-DESIGN.md,术语全表见 LANGUAGE.md,词汇表格式见 GLOSSARY-FORMAT.md,ADR 格式见 ADR-FORMAT.md。
限制:资料未提供具体安装命令、支持平台、收费方式、价格、效果保证或完整示例;不提出接口即要求用户先选择候选;不应逐条列出 ADR 禁止的所有理论重构;临时理由或自明理由不宜记录为 ADR。缺失事实暂未提供。