热点模块反复修改
结合近期历史调查反复引发修改的区域。
Improve Codebase Architecture by Matt Pocock
使用 Matt Pocock 的 Improve Codebase Architecture，调查仓库中难以修改或测试的部分。先查看以实际摩擦为依据的模块改进候选与可视化报告，再选定一项深入讨论设计，明确取舍后决定是否实施重构。
安装与快速上手
选择你使用的 Agent，查看对应的安装或使用方式。在 Floatboat 中，可复制请求让 Agent 读取原始说明；其他选项会显示该 Skill 的安装命令或发布者提供的原生步骤。
选择 Agent
在 Floatboat 中开始
复制请求，粘贴到 Floatboat 对话
请阅读 https://github.com/mattpocock/skills/blob/main/skills/engineering/improve-codebase-architecture/SKILL.md 中的 Improve Codebase Architecture 原始说明，介绍它的用途、所需工具和安装方式，再协助我使用。由 Agent 读取原始说明，再确认当前环境的使用方式。
下载 Floatboat ↗试试这样提问
调查订单导入子系统的架构摩擦，尊重已有 ADR，先展示候选，等我选择后再考虑重构。
关于 Improve Codebase Architecture
Improve Codebase Architecture 是 Matt Pocock 集合中供用户主动调用的架构调查入口。它围绕指定区域或近期频繁修改的热点，查找浅模块、边界泄漏和测试困难，并生成列明文件、前后结构与推荐强度的 HTML 报告。用户选定候选后才进入进一步讨论，流程不会一开始就重新设计所有接口。后续访谈结合 grilling、codebase-design 与 domain-modeling，并参考项目术语表和已有架构决策。它的作用是识别和讨论值得改进的地方，提出建议本身不证明新架构更优，也不等于获得全仓库重写授权。
架构评审的使用场景
探索与持续开发摩擦直接相关的架构问题。可以调查反复修改的模块、分析真实行为为何难以测试，或检查职责分散的代码，再选择一项有明确依据的候选，讨论可审阅的接口与实现改进。
真实行为难以测试
检查接口是否无法暴露有意义行为，导致测试深入内部实现。
理解概念需要跨越多文件
检查分散模块是否造成实际导航与维护成本。
如何评审架构改进
安装相关配套 Skills，并提供子系统或具体痛点。让 Agent 调查相关代码和已有决策，审阅可视化候选报告，再选择一项进入设计访谈；讨论明确后，才规划实施范围与验证方式。
- 01
确定调查范围
说明区域或痛点并提供领域资料；未指定时可结合近期变更确定范围。
- 02
审阅候选报告
核对涉及文件、摩擦、改进方向和结构比较，区分强建议与推测候选。
- 03
深入一项设计
选一项进入决策访谈，重构前明确接口、需保留行为和验证方式。
探索更多 Agent Skills
查看其他 Skill 指南，并在使用前核对原始来源。
Improve Codebase Architecture 常见问题
它会重构所有发现的问题吗？
不会。它先展示候选并询问要深入哪一项，实施是另一个有独立范围和检查的任务。
什么是模块深化机会？
指把实际复杂性放到更简单且有用的接口之后。价值应通过调用方、局部性或可测试性说明，而不是只增加抽象。
需要哪些配套 Skills？
当前原文引用 codebase-design、grilling 和 domain-modeling，应安装集合，使宿主 Agent 能找到这些引用。
报告包含什么？
包含相关文件、架构摩擦、可能改动、收益、可视化比较与推荐强度。原文将独立 HTML 文件保存到系统临时目录。
如何处理已有 ADR？
调查先读取相关决策。与之冲突的建议应指出冲突，并说明哪些实际摩擦值得重新讨论。
流程需要子代理吗？
原始探索流程使用子代理，接口备选也可能使用并行代理。缺少这些能力的宿主不能原样复现全部步骤。