AI写代码一时爽，两周后改不动？Matt Pocock 开源的这套技能让 AI 学会”架构思维”

你用 AI 写代码，有没有这种感觉——写的时候贼快，过两周回头看，完全不敢改？代码能跑，但越来越难懂、越来越难动。

这不是 AI 的问题，是代码架构太浅。一个模块接口又大又复杂，里面却没多少东西——这种东西叫”浅模块”，是 AI 编程时代的头号债务。

Matt Pocock（就是那个 18 万星 TypeScript 课程的大佬）开源了一套工程技能集，其中有一个叫 codebase-design 的 Skill，专门解决这件事。

这个 Skill 在干什么

它不是帮你写代码，而是教你（和你的 AI）用一套统一的语言来设计和评估代码模块。这套语言里有几个核心概念：

• Module：任何有接口和实现的东西——函数、类、包、跨层切片都算。不用”组件””服务”这些模糊词。
• Depth：接口背后有多少行为。小接口+大实现=深模块=好代码；大接口+薄实现=浅模块=要重构。
• Seam：不用改代码就能改变行为的位置——就是接口待的地方。
• Locality：改动集中在一处而不是扩散到一堆调用方。

这套语言最妙的地方在于——它让你和 AI 用同一套词汇表思考架构。你让 Claude Code 去”把某个模块加深”，它真的懂你什么意思。

怎么用

在 Claude Code、Codex 或其他支持 Skills 的 AI 编程工具里安装：

npx skills@latest add mattpocock/skills

安装时选中 /codebase-design 这个 Skill。装好后，每次你想设计或重构一个模块，直接说”用 /codebase-design 来看看这个模块”——AI 会按照这套设计词汇来帮你分析：接口是不是太大了、实现是不是太薄了、要不要拆分。

它还配套有一个 improve-codebase-architecture Skill，能扫描你的代码库找出”浅模块”，生成一份带图表的可视化报告，告诉你哪些地方值得重构。

为什么这很重要

AI 写代码越来越强，但架构设计能力还没有同步进化。很多 AI 生成代码的问题是：逻辑正确，但模块之间耦合紧、接口臃肿、改一处牵一片。

codebase-design 提供的是一套设计纪律——不是告诉 AI 怎么写代码，而是告诉 AI 怎么评估代码。用这套词汇沟通，AI 更容易生成”可维护”而不是”可运行”的代码。

GitHub ⭐ 18.6 万，持续更新，社区活跃。真心建议每个用 AI 写代码的工程师都装上这套技能集，哪怕只用到其中两三个命令。

GitHub：https://github.com/mattpocock/skills

GitHub: https://github.com/mattpocock/skills