架构深化
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kunlungrowth/improve-codebase-architecture。
技能介绍
要解决什么问题
模块越拆越碎、改一处要跨很多小文件,或者接口几乎就是实现、单测只能测纯函数而真实 bug 藏在调用链里——这类架构摩擦会让维护者和 agent 都难导航。本技能不直接改代码,而是像架构巡检:先定位热点与浅模块,再给出可落地的深化方向(把浅模块收成深模块),并产出可读报告供你选型。
工作方式
- 探索(YAGNI 定范围):优先看最近频繁改动的区域,或你点名的模块/痛点;结合
CONTEXT.md与区域 ADR 走读代码,记录理解成本、浅模块信号(可用删除测试辅助判断)、接缝泄漏与难测点。 - HTML 报告:在系统临时目录生成自包含报告(不进仓库),用 Mermaid 与卡片列出每个候选的文件/模块、问题、通俗方案、收益(局部性、杠杆、测试面),并标注推荐强度(Strong / Worth exploring / Speculative),结尾给出首要推荐。
- 拷问循环:你对选定候选跑
/grilling决策树(约束、依赖、深化后模块形状、接缝里藏什么、哪些测试仍有效);必要时更新CONTEXT.md、提议 ADR,或联动 codebase-design 的 design-it-twice。
产出工件类型为 ArchitectureReview(含 candidates、top_recommendation、grilling_log 等),选定项可交给 codebase-design 深化或 implement / tdd 落地。
适用边界
- 适合:想随手保持代码库健康,或某块代码难改、难测、老出 bug 时做架构审视。
- 不适合:本 skill 暂不直接写接口或实现;落地请用 implement / tdd。与 codebase-design 共享「深模块」等词汇,报告若与现有 ADR 冲突,仅在摩擦足够真实、值得重议时才会标出。
使用场景
- billing 等模块反复出 bug,想先看清是浅模块还是接缝泄漏,再决定深化范围
- 某子系统改一行要动十几个小文件,需要一份带推荐强度的 HTML 候选报告供团队选型
- 接手陌生代码库前,想按提交热点扫一遍摩擦点,但不希望报告文件写进仓库
- 已锁定一个难测模块,选定深化候选后要用 /grilling 把约束和测试边界谈清楚再交给 implement
适合人员
- 负责单体或模块化后端、经常要在 legacy 接缝上改需求的维护工程师
- Tech lead 想在 sprint 空档用提交热点做轻量架构巡检,而不是直接开大型重写
- 和 agent 协作改代码的开发者,希望模块边界更清晰、CONTEXT 与 ADR 和深化词汇一致
- 测试薄弱区的 owner,需要把「接口宽实现薄」的候选拆成可交给 tdd/implement 的决策记录