<!-- title: 热榜前三全是塔：第三层没人教 -->

# 热榜前三全是塔：第三层没人教——第8轮设计模式提炼：给深料层立七条规矩

## 概述

写件教学这条线拍到今天：第一件怎么落笔（九条套路）、路由怎么排（前台件）、脚本怎么配（六套路）、套怎么搭（长套五模式）、开场白怎么写（六式）、楼盖多高（正文 500 行预算）——全部讲过。但每次讲到第三层 `references/`，都只有一句话打发：「超出部分搬进去，留一行指针」。**下楼的路指了六次，楼下长什么样，一次都没教过。** 本期补这一课。核心发现一句话：**快照里星数最高的前三座技能仓没有一座是单页件，全靠第三层的「多间房」撑体量——而第三层的写法工艺（分房间、挂门牌、切节、标日期、分体裁）至今没有成文规矩，本期从存档六个标本里提炼七条。**

## 一、行情：热榜前三，全是塔

| 仓库 | 快照星数 | 快照日 | 形态 | 转引出处 |
|---|:---:|:---:|---|---|
| obra/superpowers | 292,501 | 09-29 | 12+ 子件塔式整套 | 今日 r8-0204 卷 |
| mattpocock/skills | 272,327 | 09-30 | 「Straight from my .agents directory」家底仓 | 昨日 r8-1608 卷 |
| affaan-m/ECC | 268,977 | 09-29 | 宿主增强整套 | 今日 r8-0204 卷 |

三行读法。**其一，塔是常态不是变态**：29 万星量级的前三名全是目录形态——superpowers 的 12+ 子件名字本身就是流程动词表（brainstorming、writing-plans、test-driven-development、systematic-debugging、verification-before-completion，09-27 九条套路卷原文），mattpocock 的门牌干脆自报家门「直接从我 .agents 目录里搬来的」。**其二，塔的每一层都有房**：本栏拆 superpowers 那卷的标题已经把话说尽——《先背目录再干活》：目录即界面，先认房再干活。**其三，也是本期题眼**：教程线教会了大家把正文压进 500 行（套路二），却没教搬下楼的东西怎么安置——热榜件的功力恰恰在楼下。

## 二、评测对比表：六个标本的深料层形态账

先补一张底账——四件样本的五维存档分（2026 年 5 月存档时点评定，出处 09-27 九条套路卷，本期不翻案）：

| 样本件 | 功能 25% | 设计 25% | 实战 20% | 上手 15% | 社区 15% | 综合 |
|:---|:---:|:---:|:---:|:---:|:---:|:---:|
| impeccable | ★★★★★ | ★★★★★ | ★★★★☆ | ★★★★☆ | ★★★★★ | **4.75** |
| planning-with-files | ★★★★★ | ★★★★☆ | ★★★★★ | ★★★★★ | ★★★★★ | **4.70** |
| superpowers | ★★★★★ | ★★★★★ | ★★★★☆ | ★★★☆☆ | ★★★★★ | **4.60** |
| Trail of Bits skills | ★★★★★ | ★★★★☆ | ★★★★☆ | ★★☆☆☆ | ★★★★☆ | **4.15** |

本期主表——六个标本的深料层形态账（综合分沿用存档并注明出处卷；「深料形态」列为本期定性判词※）：

| 样本 | 深料形态 | 综合分（存档） | 出处卷 | 一句话判词 |
|---|---|:---:|---|---|
| impeccable | 菜单挂 7 份分册 | **4.75** | 09-27 九条套路卷 | 教科书：正文只放命令索引，科室按需开门 |
| Trail of Bits skills | 窄件重装深料 | **4.15** | 09-27 九条套路卷 | 楼上才是主体，正文只是门房——上手两星的代价也在这 |
| superpowers | 目录即课程表 | **4.60** | 09-27 卷（另有 09-29 专文《先背目录再干活》） | 每间房是一节课，先点名后上课 |
| chart-craft-plus | 按类拆 5 个 templates 分册 | **4.50** | 今日 r7 图表卷 | 35 种注册表外置，类型判断留楼上 |
| article-to-excalidraw | 坐标分区表 + 更新日志 | **3.30** | 今日 r7 图表卷 | 快照律孤本：敢在深料里给自己写勘误 |
| planning-with-files | 零 references | **4.70** | 09-27 九条套路卷 | 反例锚：三文件是「写的」不是「读的」，它根本不住深料层 |

## 三、标本细看：楼下有四种住法

**impeccable——科室制分册。** 5 月存档记录它的结构是「一个件文件挂 20 个命令和 7 份深度参考指南」，七间房按领域命名：排版、色彩、空间、动效、交互、响应式、UX 文案。用户跑 `/typeset` 时只开排版一间，跑 `/polish` 才翻动效。它拿了设计满分的原因就一条：**每次开门，开的都是恰好那一间。**

**Trail of Bits——门房制重装。** 窄到只有静态分析一件事，却拆成 CodeQL、Semgrep、合约入口分析、变体分析等独立小件，每件深料极重。它的 4.15 分是一堂免费的课：**楼上越重，上手越贵**（上手维度只拿两星）——深料层的深度要和触发的频率成正比，低频件盖高楼等于让每个访客爬十一层楼梯。

**chart-craft-plus——注册表外置。** 今日 r7 卷的原文账：主文件只留「5 大类 / 35 种」的判断路由，模板按 A 技术、B 流程、C 业务、D 数据、E 信息五类拆成 5 个 `templates-*.md`。这是「切片律」的现成范本——楼上管判断，楼下管照抄，**判断和抄写分层，正是类型重叠处不需要读 35 种模板的原因**。

**article-to-excalidraw——快照律孤本。** 它的深料里躺着一张 Y 坐标分区表（0-500 封面、500-1300 架构区……），更稀有的是 v2.1.0 更新日志那句改口：「修正技术描述：Excalidraw 不支持真正的多页面」——前一版吹过的能力，后一版亲手在文档里勘误。今日 r7 卷的评价原文：「Skill 文档敢给自己写勘误，比多加十种图型更稀缺。」

**planning-with-files——反例锚。** 4.70 分的零脚本、零 references 件。它的 task_plan.md、progress.md、findings.md 三文件不住深料层——那是**运行时状态**，是「写的」，不是「读的」。把它错当成深料层写法的读者，会犯本期第七条规矩要治的病。

## 四、深料层七规矩

先立坐标。三层加载的经济学前六课讲过：**描述常驻、正文按需、深料再按需**；正文预算（500 行）讲过；执行顺序（先跑便宜的再读贵的）讲过。本期只讲一件事：**楼下的房子怎么盖**。七条规矩，每条标明它延伸或反转了哪条旧规律。

**规矩一：自足律——每间房自带门窗。** 深料文件可能被**单独**载入：模型读 `references/colors.md` 时，正文那句上下文帮不了它。所以每间房不许写「如上文所述」「同第一章」——跨房引用一断，懒加载就断。自检法：把任何一间房单独贴给一个没读过全文的人，看不懂就是不合格。这条是七条的地基。

**规矩二：挂牌律——门口写清何时进。** 套路二教的指针是「详见 references/xx.md」——这是路牌的最低配。升级写法是**条件句**：「当遇到 X 情况，读 references/xx.md」。条件写进正文指针，也写进深料文件自己的开头——两处挂牌，模型在哪头都能判断该不该进这门。官方 pdf 件的分工表（读版面用 pdfplumber、合并拆分用 pypdf、从零生成用 reportlab，以仓库当前版本为准）本质就是六块并排的门牌。

**规矩三：切片律——指针带节号，不带整卷。** 文件内部必须立小标题，指针落到节：「读 references/format-spec.md 的『四节规格』一节」。一节几百字比整卷几千字便宜一个量级，且 greppable——模型可以按标题定位，不必全文入场。chart-craft-plus 的五分册是文件级切片，官方 docx 件把字段规范写成可单独引用的小节是节级切片，两层都用才满分。

**规矩四：体裁律——深料写规约，正文写顺序。** 工作流（第一步、第二步、失败了怎么办）只住在正文；深料里放事实与规约（字段规格、格式标准、领域知识）。深料里出现流程令是体裁错乱——它会绕过正文的验收条款和负面清单直接指挥手脚。若某间房必须带指令，只许指挥它自己领域内的动作。这条反转了九条套路的套路三（「写流程不写知识」）：那是楼上/楼下的分工，本条是楼下内部的纪律。

**规矩五：单源律——同一张表只写一处。** 两间房都需要同一张对照表时，抽出来做第三间房，让两边都指过去——不许抄一份放进各自文件。证据是今日 r7 卷刚对完的账：chart-craft 与 chart-craft-plus 是同门，措辞重合度极高、判定同源，分家后各改各的，trigger 已经互相抢活——**复制品必然漂移，漂移的复制品就是将来的撞车现场**。

**规矩六：快照律——深料里的事实带日期。** 版本号、星数、价格、外部链接，凡是会漂移的事实，一律带「截至」标注；勘误直接写进文件，不改写历史段落。article-to-excalidraw 的更新日志是孤本示范，本栏自己的口径声明（每处星数标快照日）是同一律的编辑版。**不带日期的事实，漂移之后不是错的，是没法发现错的**——这比错更贵。

**规矩七：三家分家律——读的、抄的、写的，分三处住。** 深料层其实住着三种东西：**references 是读的**（载入上下文变成判断力）、**assets 是抄的**（模板、骨架、素材，复制落盘，不进上下文）、**状态是写的**（task_plan.md、编目这类运行时产出——昨天 r8-1608 卷的原话「编目是产出不是输入」）。三种住法混用是新手深料层的头号事故：把模板写进 references，模型每次规规矩矩读一遍全文再手抄一遍，token 双倍付；把状态文件当知识写，下次运行就是脏读。planning-with-files 拿 4.70 分恰恰因为它三者分得清：正文是流程，三文件是状态，谁也不冒充谁。

```mermaid
flowchart TD
    U["用户一句话"] --> D{"匹配层扫门牌<br/>name 加 description"}
    D -->|未命中| N["按普通对话处理"]
    D -->|命中| B["载入正文<br/>一页纸以内"]
    B --> P{"正文里的四类指针"}
    P -->|读| R["references<br/>读进上下文"]
    P -->|抄| A["assets<br/>复制不读取"]
    P -->|跑| S["scripts<br/>只要 stdout"]
    P -->|写| W["状态文件<br/>运行时产出"]
    P -->|都不需要| G["直接执行流程"]
    R --> G
    A --> G
    S --> G
    W --> G
    G --> V["对照完成定义自查"]
    V --> O["输出结果"]
```

读图要点：P 是全图唯一的分岔站，四条出路对应四种住法——**指针写的不是文件名，是动词**。写「详见」的指针等于没写动词，模型只能整卷吞。

## 五、动手：给第一件盖第三层

课程线交到第四课。第一件 minutes-fixer（09-27 交付）是纯正文单页件——本期给它加盖第三层，七条规矩一次用完。

**第一步，规矩六先行：规格文件带日期、带挂牌、带版本。** 新建 `references/format-spec.md`：

```markdown
# format-spec — 纪要四节规格

> 何时读本文：仅在第 3 步搭结构、第 4 步自查时读「四节规格」；
> 处理多方说法冲突的纪要时，加读「冲突处理」一节。
> 事实口径：本规格自 2026-10-01 定稿；栏目增删必须同步改
> assets/minutes-template.md，两处不许各改各的（规矩五）。

## 四节规格
1. 会议信息：主题、时间、地点/线路、与会人（缺席者单列）
2. 议题纪要：一议题一段，段首一句结论，后跟依据
3. 决议清单：每行「决议 + 表决情况（全票/多数/无异议）」
4. 待办表：三列表头固定为 事项｜负责人｜截止时间

## 冲突处理
同一事项出现两种说法：两个版本并列保留，标注发言人，
禁止代与会人取舍，裁决权在用户。

## 版本
v1.1（2026-10-01）：冲突处理从正文搬入本文——
它只在少见的争议现场才需要，住楼下省楼上的预算。
```

**第二步，规矩七：骨架进 assets，不进 references。** 新建 `assets/minutes-template.md`——它是**抄的**，模型永远不需要把它读进上下文：

```markdown
# 会议纪要 · 〈会议主题〉
- 时间：｜地点/线路：｜主持：｜记录：
- 与会：｜缺席：

## 议题纪要
### 〈议题一〉
结论：……
依据：……

## 决议清单
| 决议 | 表决情况 |
|---|---|

## 待办表
| 事项 | 负责人 | 截止时间 |
|---|---|---|
```

**第三步，规矩二、三、四落在正文：** 工作流加两步，指针全部写成「动词 + 条件 + 节号」：

```markdown
## 工作流程（新增第 4、5 步）
4. 输出前，对照 references/format-spec.md 的「四节规格」一节逐节自查
5. 用户要求落盘时，复制 assets/minutes-template.md 为底稿替换占位内容，
   禁止改动其栏目顺序

## 不要做（新增一条）
- 不要整卷读入 format-spec.md——争议现场才加读「冲突处理」一节

## 完成定义（新增一条）
- 落盘文件的栏目顺序与 assets/minutes-template.md 完全一致
```

第四步，安装与自测：

```bash
mkdir -p ~/.claude/skills/minutes-fixer/references \
         ~/.claude/skills/minutes-fixer/assets
# 上述三段分别存为：
#   ~/.claude/skills/minutes-fixer/SKILL.md（覆盖旧版）
#   ~/.claude/skills/minutes-fixer/references/format-spec.md
#   ~/.claude/skills/minutes-fixer/assets/minutes-template.md

# 出厂自测三句
# 点火①「把这段转写整理成纪要」→ 点亮，第 4 步只对照「四节规格」一节
# 点火②「这两段纪要说法对不上」→ 加读「冲突处理」一节，两版本并列
# 灭火③「帮我翻译这段会议录音」→ 不点亮
```

```mermaid
flowchart TD
    M["SKILL.md<br/>正文六步"] -->|第4步 对照一节| F["references/<br/>format-spec.md"]
    M -->|第5步 复制落盘| T["assets/<br/>minutes-template.md"]
    F -->|只读节不读卷| X["进上下文"]
    T -->|不进上下文| Y["直接进用户文件树"]
```

## 六、装修前先验房：七规矩自检清单

给装机盘里任何一件做深料层年检，七问：

1. 每间房单独拎出来读，缺上下文吗（自足）
2. 正文指针写的是条件，还是偷懒的「详见」（挂牌）
3. 指针有没有落到节号（切片）
4. 深料里有没有流程令在抢正文的活（体裁）
5. 有没有两张长一样的表住在两间房（单源）
6. 深料里的数字、链接、版本带不带「截至」（快照）
7. 该抄的是不是被写成了该读的，该写的是不是被当成了知识（三家分家）

七问全过，这件的楼下才算装修完。

## 七、推荐排行榜

- **深料层教科书榜**：impeccable（科室制，4.75）＞ Trail of Bits（门房制重装，4.15，低频件慎学它的楼高）＞ 官方 pdf 件（分工表式挂牌，骨架见 09-28 专文）＞ chart-craft-plus（注册表外置，4.50）。
- **性价比最高的三条**：挂牌律（十分钟改完全部指针，误触发当场下降）＞ 三家分家律（治 token 双倍付）＞ 快照律（治「没法发现错」）。
- **最容易被高估的一条**：切片律——文件少了先别切节，**一页纸以内的房间不需要门牌号**（09-28 卷原话「三层楼拆分——件长大到一页装不下时再做，别一开始就过度工程」）。
- **新手行动清单**：第一件还没写的，先回 09-27 交 minutes-fixer 的作业；写过的，今晚按七规矩给它加盖第三层；**正文不到 200 行的，本期对你暂时无效**——单页件没有楼下，别为了显得工程化硬盖空房。

## 结语

六课教的都是楼上的手艺：门牌、正文、开场白、流程、脚本、套。本期下楼看了一眼，发现热榜前三座塔的功力全在楼下——**楼上是给模型的一句话概要，楼下才是这件的真功夫；而功夫的保存方式，决定了它能不能被恰好那一刻取用。** 深料层的全部工艺归结起来其实是一句话：**把「详见」写成「何时读、读哪节、读完干什么」。** 七条规矩背下来不如验一次房：打开你最常用那件 references 目录，跑一遍七问——第一间挂错门牌的房间，就是这件一直「装了没怎么用」的原因。

## 参考来源

> [!tip] 51学通信知识星球
> **星主：爱卫生**（微信：gprshome201101）——公众号「51学通信」创办者，19 年通信行业运维与讲师经验，著有《GPRS网络信令实例详解》《EPC原理与实践》《5G核心网原理与实践》三本纸质书（各大电商平台有售）。
> **星球定位**：深耕 5G 核心网、IMS、NFV/AI、云原生等 ICT 领域，主打运维岗位与信令分析。
> **当前规模**：5200 篇主题 / 990 个回答，198 元/年。
> **加入福利**：加入星球后请加爱卫生微信，拉您进知识星球年度陪伴与答疑群——不限量回复您的各种问题，另有群内分享。
> **AI 加持**：51学通信知识星球已作为 skill 接入 WorkBuddy，使用 deepseek-4-flash 在海量星球帖子中精准找贴、找视频、找 FAQ 和案例，做总结、找文档和 PPT 等场景全覆盖。

![51学通信知识星球海报-扫码加入](https://wiki.500nian.com/images/zhixingqiu_qrcode.png)
