用途:该技能面向代码库架构改进,重点是发现并呈现“深化机会”——把浅模块重构为深模块,即用较小的接口承载较多行为,目标是提高可测试性和便于 AI 理解与导航。它强调先阅读项目领域词汇表与相关 ADR,再探索代码,避免重复讨论已有架构决策。
主要能力:技能提供一套固定的术语体系(Module、Interface、Implementation、Depth、Seam、Adapter、Leverage、Locality),要求在所有建议中一致使用,避免漂移为 component、service、API、boundary 等词。它包含若干原则:删除测试(想象删掉该模块,若复杂度消失说明它只是直通层;若复杂度在 N 个调用方重现,说明它确有价值)、接口即测试面、一个适配器是假设接缝、两个适配器才是真实接缝。领域模型为好的接缝提供名称,ADR 记录不应被反复推翻的决策。
使用方式:流程分三步。第一步探索:先读领域词汇表与相关 ADR,再用 subagent_type=Explore 的 Agent 工具遍历代码库,有机地记录摩擦点,例如理解一个概念需要在多个小模块间跳转、接口与实现同样复杂、为可测试性抽出的纯函数而真实缺陷藏在调用方式中(缺乏 locality)、紧耦合模块跨接缝泄漏、未测试或难以通过现有接口测试的部分;对疑似浅模块应用删除测试。第二步呈现候选:以编号列表给出每个候选涉及的文件/模块、问题、方案(用平实英文描述变化)、收益(用 locality 与 leverage 以及测试改善来说明),使用 CONTEXT.md 的领域词汇与 LANGUAGE.md 的架构词汇;若候选与现有 ADR 冲突,只在摩擦真实到值得重开 ADR 时标注出来。此阶段不提出具体接口,而是询问用户想探索哪一个。第三步拷问循环:用户选定候选后进入讨论,梳理约束、依赖、深化模块的形态、接缝之后的内容、哪些测试保留;决策形成时同步副作用,如把新概念加入 CONTEXT.md、就地更新模糊术语,或在用户以关键理由拒绝候选时提议记录 ADR(仅当未来探索者确实需要该理由以避免重复建议时)。如需探索替代接口,参考 INTERFACE-DESIGN.md。
适用场景:已有代码库的架构梳理与重构规划、识别浅模块与跨接缝泄漏、提升可测试性与 AI 可导航性、在领域语言与 ADR 约束下讨论架构改动。
限制:该技能依赖项目存在 CONTEXT.md 与 docs/adr/ 等上下文文件,缺失时按需惰性创建;它不直接产出代码改动,而是提出候选并引导讨论;具体命令、安装方式与价格等信息暂未提供。