写件教学这条线拍到今天:第一件怎么落笔(九条套路)、路由怎么排(前台件)、脚本怎么配(六套路)、套怎么搭(长套五模式)、开场白怎么写(六式)、楼盖多高(正文 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 分恰恰因为它三者分得清:正文是流程,三文件是状态,谁也不冒充谁。
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:
# 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——它是抄的,模型永远不需要把它读进上下文:
# 会议纪要 · 〈会议主题〉
- 时间:|地点/线路:|主持:|记录:
- 与会:|缺席:
## 议题纪要
### 〈议题一〉
结论:……
依据:……
## 决议清单
| 决议 | 表决情况 |
|---|---|
## 待办表
| 事项 | 负责人 | 截止时间 |
|---|---|---|
第三步,规矩二、三、四落在正文: 工作流加两步,指针全部写成「动词 + 条件 + 节号」:
## 工作流程(新增第 4、5 步)
4. 输出前,对照 references/format-spec.md 的「四节规格」一节逐节自查
5. 用户要求落盘时,复制 assets/minutes-template.md 为底稿替换占位内容,
禁止改动其栏目顺序
## 不要做(新增一条)
- 不要整卷读入 format-spec.md——争议现场才加读「冲突处理」一节
## 完成定义(新增一条)
- 落盘文件的栏目顺序与 assets/minutes-template.md 完全一致
第四步,安装与自测:
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 步只对照「四节规格」一节
# 点火②「这两段纪要说法对不上」→ 加读「冲突处理」一节,两版本并列
# 灭火③「帮我翻译这段会议录音」→ 不点亮
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["直接进用户文件树"]
给装机盘里任何一件做深料层年检,七问:
七问全过,这件的楼下才算装修完。
六课教的都是楼上的手艺:门牌、正文、开场白、流程、脚本、套。本期下楼看了一眼,发现热榜前三座塔的功力全在楼下——楼上是给模型的一句话概要,楼下才是这件的真功夫;而功夫的保存方式,决定了它能不能被恰好那一刻取用。 深料层的全部工艺归结起来其实是一句话:把「详见」写成「何时读、读哪节、读完干什么」。 七条规矩背下来不如验一次房:打开你最常用那件 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 等场景全覆盖。
