Improve Codebase Architecture 使用教程，让 AI 帮你找出架构问题

Tue, 09 Jun 2026 00:00:00 +0000

它能帮你发现什么

你跟 AI 说「帮我优化这段代码」，它通常做的是局部优化——提取函数、加类型、改命名。这些有用，但不触及架构。

Improve Codebase Architecture 做的事不一样。它会让 AI 先理解你的领域模型，然后从模型出发找架构问题。比如「用户模块不应该知道订单的内部结构」，这种跨模块的耦合问题，局部优化是看不到的。

这个 Skill 是 Matt Pocock 的 18 个技能之一。安装整个套件：

npx skills@latest add mattpocock/skills

安装后先运行 /setup-matt-pocock-skills，设置你的 Issue 跟踪器、标签和文档路径。这一步很重要——AI 需要知道你的项目用 GitHub Issues 还是 Linear，文档放在哪里。

先确保项目里有 CONTEXT.md（项目术语和上下文）。没有的话可以先手动写一个，告诉 AI 你的项目里「用户」「订单」「支付」这些概念分别对应什么。

然后运行 /improve-codebase-architecture。AI 会扫描代码库，结合领域语言和 ADR 给出改进建议。每条建议都会说明：问题是什么、为什么是问题、建议怎么改。

直接问 AI 「我的架构有什么问题」，它可能会给你一些泛泛的建议。这个 Skill 的优势在于它结合了项目文档（CONTEXT.md）和 ADR，给出的建议是跟你的具体业务领域挂钩的，不是那种放到任何项目都说得通的废话。

这个 Skill 需要你已经有了一定规模的项目。新项目的架构问题通常靠直觉就能看出来，不需要 AI 帮你分析。

另外它只是给出建议，不会自动帮你改代码。每个建议你都需要自己判断是否采纳。建议配合 /grill-me 使用——让 AI 先盘问你的重构方案，再动手。

配合 /to-issues 把架构改进建议拆成可独立领取的 GitHub Issue，一个一个跟进。

Thu, 04 Jun 2026 00:00:00 +0000

让 AI 扫描你的代码库，基于领域语言和 ADR（架构决策记录）发现深层的架构改进机会。不是表面地帮你提取一个函数或者改个变量名，而是识别出模块耦合、职责混乱、抽象层次不当这些需要系统性重构的问题。

你让 AI 「帮我优化代码」，它通常会做局部优化——提取函数、加类型、改命名。这个 Skill 会让 AI 先理解你的领域模型，再基于模型找架构层面的改进点。需要配合 Matt Pocock 套件的 CONTEXT.md 使用，AI 才知道你项目里的术语是什么意思。

代码库已经有一定规模（不是新项目），开始出现「技术债务」迹象的团队。如果你经常觉得代码能跑但越来越难改，这个 Skill 能帮你系统性地发现哪里该重构。

AI 不只帮你写代码，还帮你找出代码的架构问题在哪。