用途:对用户指定的一块代码区域做有界调研,发现架构摩擦点,提出模块加深(deepening)重构方案,目标是让代码库更易测试。它使用共享的代码库设计词汇(模块、接口、深度、接缝、适配器、杠杆、局部性),不重复定义这些术语。该技能只负责一次请求范围内的调研、候选对比和重构 RFC;完整仓库审计、实现与递归加深由独立的 codebase-improver 工作流负责,本技能不接管。
主要能力与流程:1)探索代码库,从近期变更热点入手(未暂存、已暂存改动与近期提交),近期变更只是线索而非架构重要性的证明,只有证据(调用方、依赖、失败测试、重复导航)跨出初始边界时才扩大范围并记录证据与新范围。探索时关注:理解一个概念是否要在多个小文件间跳转;模块是否浅到接口复杂度接近实现;为可测试性抽出的纯函数是否掩盖了调用处的真实缺陷;紧耦合模块在接缝处的集成风险;哪些部分未测试或难测试。摩擦点即信号。2)以编号列表呈现加深机会,每项包含涉及的模块/概念、耦合原因、依赖类别、测试影响,此时不提出接口,并询问用户想探索哪一个。3)用户选择候选。4)先写面向用户的问题空间说明:新接口需满足的约束、需依赖的依赖项、说明性代码草图(非提案)。5)运行 3 个以上设计练习,默认串行内联;有明确委派权限时可并行。每个设计使用相同技术简报但不同约束:最小化接口(1-3 个入口)、最大化灵活性、优化最常见调用方、以及适用时基于端口与适配器。每个输出接口签名、用法示例、隐藏的复杂度、依赖策略与权衡,随后比较并给出有主见的推荐或混合方案。6)用户选择接口或接受推荐。7)在 docs/ 下创建 Markdown 重构 RFC,使用 REFERENCE.md 模板,创建后直接分享路径,不要求先审阅。
限制:无委派权限时只能串行内联执行,不得声称内联过程相互独立或并行;当隔离性对结果必要时应报告不可用。可视化报告默认可选且临时,除非用户明确要求,否则不写入或提交;重构 RFC 是唯一默认持久输出。资料未提供具体安装命令、收费与平台支持信息。