De-slop 的真面目：一个 skill 背后是 27 个——Matt Pocock 开源了他的 .agents 目录

先报一笔视频里没有的账：这期「用一个 skill 整理 AI 搞乱的代码库」的作者 Matt Pocock——就是上周那座 226 行软件工厂 Sandcastle 的作者——今年二月把自己的 .agents 目录整个开源了，仓库名就叫 skills，副标题写得很直白：「Skills for Real Engineers. Straight from my .agents directory.」。八个月，284,215 star，两万三千个 fork，MIT。这大概是 2026 年增长最快的仓库之一，而它卖的东西只有一样：把软件工程的老纪律写成 agent 可执行的工作流。

视频里那「一个 skill」，对上仓库里的 improve-codebase-architecture。它干的事：扫描代码库，找出「深化机会」（deepening opportunities），生成一份可视化 HTML 报告，然后陪你逐个过。「深化」这个词来自 John Ousterhout 的《软件设计哲学》——浅模块是接口很大、装的东西很少；深模块是接口很小、装的东西很多。重构的方向就是把浅的磨深。README 里那句推荐语值得抄下来：「建议每隔几天跑一次。它是一次勘察，不是一次救援」——它负责找出候选，不负责替你把泥潭解开。

但真正的设计密度在 skill 文件本身，71 行里有三处值得拆开看。第一处是目标函数：写明重构的目的是 testability 和 AI-navigability——AI 可导航性，让 agent 能读懂的结构，被当成了和可测试性平级的一等公民。代码库的读者列表里从此多了一个非人类。第二处是词汇纪律：skill 强制 agent 调用另一个 codebase-design skill 拿到共享词汇表（module、interface、depth、seam、adapter、leverage、locality），并且明文禁止漂移——「不要漂到 component、service、API、boundary 这些词上」。术语一致性被写成了硬约束，因为 agent 建议的措辞一旦漂移，你的判断就得重新对齐。第三处是记忆联动：重构中命名的每个新概念要随手进 GLOSSARY.md，文件可以惰性创建；你拒绝某个候选时，skill 会问一句「要不要把这个理由记成 ADR，免得未来的架构审查再把同一个方案推荐给你」——拒绝的理由也是资产，但要筛：有分量的理由才值得记，一时兴起的「现在不值得」和自明的理由不配进档。

「一个 skill」这个说法，准确说是「一个入口」。improve-codebase-architecture 的 frontmatter 里就引用了 codebase-design（架构词汇）和 domain-modeling（领域建模）两个 skill，grilling——一套反复追问直到设计树的每个分支都有着落的面试原语——是五个 skill 共用的底层件。仓库把这套网络的关系写成了架构规则：skill 分两层，user-invoked 的只许你手动触发，负责编排流程；model-invoked 的允许 agent 在任务匹配时自动取用，承载可复用的纪律。编排类可以调用纪律类，纪律类之间互不调用，编排类之间也互不调用。依赖方向定死，这是一个小型软件架构，只不过架构里的模块是工作流。还有一个细节：improve-codebase-architecture 的 frontmatter 写着 disable-model-invocation: true——重架构这种大动作，只许人扣扳机，agent 无权自作主张。

这套东西的整体叙事在仓库 README 里写得很狠：「agent 能极大加速写代码，同时也在以前所未有的速度加速软件熵增」——Ball of Mud 一节引 Kent Beck 的话「每天都投资于系统的设计」。解法不是少用 AI，是把设计纪律外置：tdd skill 固化红绿重构，diagnosing-bugs skill 固化「先造出能红的反馈环再假设再修」的调试环，code-review skill 用两个并行 sub-agent 分别查「符合仓库规范吗」和「忠实实现需求吗」，明确说明分开跑是为了互不污染——评审的独立性是个架构问题。连 PR 模板里都有一条 merge-danger call：这是一次性门还是两次门，爆炸半径多大。爆炸半径这个词从部署审批一路漂进了 PR 描述。

海关核账：视频概要与仓库内容逐条对得上，「先理解整个代码库，再制定重构策略，逐步整理回来」对应扫描-报告-grill 的三段结构，无膨胀。素材里没提的背景：这套 skill 的服务形态在 aihero.dev 上挂着「See all 27 skills」，仓库与网站同源；另一个叫 slopwatch 的同名概念仓库只有一行 README，是作者的未完成实验，别混淆。归属清晰：个人开源，教育站导流，免费与付费的分界在课程不在 skill。

收个尾。上一条 Sandcastle 的结论是「软件工厂是 if/for 写的」，这一条可以接上它的下半句：软件工厂的工艺规程是 skill 写的。方法论从书和博客里搬出来，切成 agent 能执行的步骤，配上词汇表、记忆文件和调用权的分层——二十年前这些东西叫团队规范，写进 wiki 就没人看了；现在它们长成了可执行文件，八个月二十八万人下载。Ousterhout 的书还是那本书，变的是读书的不再只有人。