<!-- title: 单件写到头，下一步是套 -->

# 单件写到头，下一步是套——第8轮设计模式提炼：从第一件到第一套

## 概述

## 一、行情证据：星数的半衰期，站在整套这边

| 仓库 | 形态 | 快照星数 | 快照日 | 本栏处置 |
|---|---|---|---|---|
| obra/superpowers | 方法论整套 | 292,501 | 09-29 | 已专文两卷 |
| affaan-m/ECC | 宿主增强整套 | 268,977 | 09-29 | 已专文 |
| cbrock84/headcount | 编队整套（15+ 部门、125+ 件） | 1,739 | 10-01 | 已专文两卷 |
| Contrastive-LM/CLM | 单件（无描述） | 2,277 | 09-29 | 已点名「哑巴门牌」 |
| dzhng/jevgrep | 单件 CLI | 1,905 | 10-01 | 本栏判定「毕业倒计时」 |
| yibie/awesome-jev | 收录目录 | 1,998 | 09-30 | 已专文 |
| heyjunpenn/awesome-jev | 收录目录（同名） | 867 | 09-28 | 未拆 |
| v-modal/awesome-jev-tools | 收录目录（近同名） | 727 | 09-28 | 未拆 |

两组对照值得放大。其一，**单件的星是脉冲，整套的星是年金**：本栏 10-01 卷刚给 jevgrep 记了「毕业倒计时」——单件工具走红快、被官方化或被替代也快；而 superpowers 和 ECC 在 29 万星量级上稳坐热榜，靠的不是某一次冲榜，而是「一套件覆盖一条工作流」的复用面。其二，**收录目录已经卷到三胞胎撞名**：48 小时内三份 awesome-jev 同场竞逐，说明「把目录做成件」这条路已从蓝海挤成红海——套件的每个物种都有自己的拥挤度，这在第三节评分表里直接体现。

## 二、评测对比表：五种整套骨架

| 骨架 | 样本 | 功能 | 设计 | 实战 | 上手 | 社区 | 加权 | 一句话 |
|---|---|:---:|:---:|:---:|:---:|:---:|:---:|---|
| 方法论式 | superpowers | ★★★★★ | ★★★★★ | ★★★★★ | ★★★☆ | ★★★★★ | **4.70** | 套件即开发流程，目录先于内容 |
| 增强式 | ECC | ★★★★★ | ★★★★☆ | ★★★★☆ | ★★☆ | ★★★★★ | **4.30** | 不加能力，改写宿主的运行品质 |
| 编队式 | headcount | ★★★★☆ | ★★★☆ | ★★★☆ | ★★☆ | ★★★★☆ | **3.50**（存档分转引） | 125 件靠部门制当上下文路由 |
| 流水线式 | pcap 三件 / 传家宝三件 | ★★★★☆ | ★★★★☆ | ★★★★☆ | ★★★★☆ | ★★★☆ | **3.90** | 一条链拆三段，每段窄门牌 |
| 收录式 | awesome-jev 三胞胎 | ★★★☆ | ★★☆ | ★★★ | ★★★★★ | ★★★☆ | **3.10** | 门牌成本最低，撞名代价最高 |

三条口径说明：方法论式与增强式的高分对应其在热榜的常青位次，属定性对应、非因果断言；编队式分数转引 09-29 深拆卷纸面分，本期不翻案；收录式是三胞胎合并计分——单看 yibie 一份（1,998 星）可以到 3.6，但撞名内卷要计入赛道风险，故压到 3.1。

## 三、五条长套模式（全部有判例）

**模式一：拆工序——链路长到一件装不下，就按交接物切段。** 判例是本机装机位与存档双证：pcap 赛道一条线拆成 generator / analyzer / modifier 三件，每件管一段（09-26 卷《都叫部署件》同款思路的取证版）；内容产线同理，09-28 卷《一窝传家宝》已把 arxiv 件、ebook 件、excalidraw 件对读成「进口、加工、分发」三个车间。切段的标准不在步骤多少，在**交接物**：上一段的产出是文件还是记要，能否独立验收。有独立交接物才值得切段，否则切出来的是三个半成品件。

**模式二：拆变体——同一工序换参数，用后缀不开新坑。** 本机实测：course-video-maker 家族挂着 -zh、-en、-link 多个变体，ericsson-ppt-writer 三个版本并存（09-28 六条心法卷已记）。变体式的纪律只有一条：**变体之间只许门牌和参数区不同，工序段必须逐字一致**——否则改一处工序要同步 N 份正文，套越大腐化越快。判据照旧：两件事永远一起被需要就合一，经常只要其中一件就拆；变体是被「需要但换个口味」的那一半。

**模式三：提公用——第三层不该每件自带一份。** 单件时代的「参考文件下沉」到套件时代要再升一层：`references/`、脚本、模板挪到套件根的公用仓，各件按相对路径取用。判例就在 09-28 传家宝卷那张产线图里——「解析出图」标注的是**四件公用技能**，一份能力四家复用。这条模式最容易被忽略，代价也最隐蔽：四件各自拷贝一份同名参考文件，三个月后四份内容漂移，件与件对不上账。公用仓是套件的「单一事实源」，没有它，套只是多了几步的文件夹。

**模式四：立目录——件数过十，门牌之上要有一层「科室牌」。** headcount 的赌注就是这条：15+ 部门、125+ 件，用组织结构当上下文路由，任务先定位部门再选件（存档两卷已详拆，本期只取结论）。对普通写件人的可抄版本不必那么重：**一套的 README 就是科室牌**——先列工序段和变体清单，再写「什么需求进哪条线」的三行判据。09-29 卷交货的前台路由件管的是运行时点名，README 管的是人读的地图，两层不互替。CLM 那块 2,277 星的哑巴门牌是这条的反面注脚：连单件都不敢不写门牌，一套没地图等于把 125 个哑巴门牌捆在一起卖。

**模式五：配验收——套件要有自己的考卷。** 单件出错是一件的事，套件出错是产线停工。本机在架货里已经有这个物种的实例：pptx 件配着 pptx-test 卷一同挂架（存在为本机实测，内文本期未加载、不作引申）。套件验收的最小形态是**逐段交接物抽检**：进口件产出的文件，加工件能否无人工干预接住；变体之间跑同一输入，产出差异是否只在参数区。09-29 卷给演示件按「实战未实测两星起评」打分的规矩，本身就是这条模式的编辑部落版——没有考卷的套，分数只能自报。

## 四、一张图：一套件的解剖

```mermaid
flowchart TD
    U["用户一句需求"] --> R["套件门面<br/>README科室牌"]
    R --> D{"先判进哪条线"}
    D -->|进口线| A["进口件"]
    D -->|加工线| P["加工件"]
    D -->|分发线| F["分发件"]
    A --> S["公用仓<br/>参考与脚本"]
    P --> S
    F --> S
    P --> T["验收卷<br/>交接物抽检"]
    T --> O["交付物"]
    F --> O
```

九个节点读三遍：竖着读是工序线，横着读是变体位，底下垫的是公用仓——三样齐了，才叫一套。

## 五、写套四步：把你的第一件，长成第一套

以下是本文自拟的教学骨架（沿用 09-29 卷「演示件、未上架、不带效果担保」的申明惯例），不是任何官方文件的引用：

```text
my-suite/
├── README.md            # 科室牌：线+变体清单+三行判据
├── shared/
│   ├── format.md        # 公用模板（单一事实源）
│   └── validate.sh      # 公用脚本
├── ingest/              # 进口线
│   └── SKILL.md
├── process/             # 加工线
│   └── SKILL.md
├── publish/             # 分发线
│   └── SKILL.md
└── accept/              # 验收卷
    └── SKILL.md
```

四步各一句纪律：**第一步拆工序**，按交接物切，切不出独立交接物就不切；**第二步提公用**，两件以上用到的东西一律上移 shared/，件内只留引用；**第三步立目录**，README 先写「什么需求进哪条线」的判据，再写件清单；**第四步配验收**，至少一条「上一段产出能否被下一段无人工接住」的抽检步骤写进 accept 件。做完四步，回炉 09-28 首件卷的三次问话法，把每件门牌再各验一遍。

## 安装与对照命令

```bash
# 看常青整套怎么搭（方法论式样本）
git clone https://github.com/obra/superpowers
# 编队式样本：部门制目录
git clone https://github.com/cbrock84/headcount
# 宿主增强式样本
git clone https://github.com/affaan-m/ECC
# 收录式三胞胎对照（撞名现场，慎入）
git clone https://github.com/yibie/awesome-jev
# 装前先搜，别往红海里挤
npx skills find <关键词>
```

## 推荐排行榜

**按抄的对象排**：单人想从一件长到三件，抄流水线式（pcap 三件最易复现）；团队件数过十，抄编队式的科室牌 + 09-29 前台件的运行时点名，两层一起上；想改宿主体验而非加功能，才碰增强式——它对运行时理解的要求最高，新手勿人肉复刻。

**按踩坑概率排（高到低）**：收录式（三胞胎撞名证明红海）、增强式（牵一发动宿主）、编队式（初始化与维护成本重）、流水线式、变体式（最稳，后缀纪律守住即可）。

**三条反模式**：一、套未立目录先堆件——三个月后自己都不知道有哪些件；二、公用内容拷贝不引用——漂移比缺失更可怕；三、没有验收卷就宣布产线贯通——交接物断没断，只有跑一遍才知道。

单件教学教的是克制，套件教学教的是秩序：门牌管单点触发，目录管全局可寻，公用仓管一致性，验收卷管交付下限。星数半衰期的账已经算清——脉冲会退，年金常在，写的顺序别反。

## 参考来源

> [!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)
