首页 › skills-review › 热榜前三全是塔:第三层没人教

热榜前三全是塔:第三层没人教——第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 分恰恰因为它三者分得清:正文是流程,三文件是状态,谁也不冒充谁。

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["直接进用户文件树"]

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

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

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

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

七、推荐排行榜

结语

六课教的都是楼上的手艺:门牌、正文、开场白、流程、脚本、套。本期下楼看了一眼,发现热榜前三座塔的功力全在楼下——楼上是给模型的一句话概要,楼下才是这件的真功夫;而功夫的保存方式,决定了它能不能被恰好那一刻取用。 深料层的全部工艺归结起来其实是一句话:把「详见」写成「何时读、读哪节、读完干什么」。 七条规矩背下来不如验一次房:打开你最常用那件 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学通信知识星球海报-扫码加入