<!-- title: 写代码之前：效率赛道规格层首拆 -->

# 写代码之前：效率赛道规格层首拆——hello-sdd 上榜，四条矿道该收账了

## 概述

## 一、收官盘货：四条矿道犁完之后，地图上还剩哪个象限

先自证这轮轮次方向的覆盖密度，四条线各引一期存档对账：

**审查线**最拥挤——《出厂四件套》拆过 code-review 的档位化设计（low/medium/high 三档、fewer 高置信发现），《撞名九组》引过它和 simplify 之间那句让位句（"Quality only — it does not hunt for bugs; use /code-review for that."），《推完代码之后》又补了 gh-address-comments 式的接线件。审查的供给过剩已经不用再证。

**测试线**有一篇专文审计过真空：《测试件缺席》用装机端、市场端、出厂端三组口供证明「为业务代码编写用例」这件事全生态无人设件，官方把 test 一词消费在 verify 的「手动测一测」上。结论当时是「效率赛道最后真空」——本期要对这句话做个修正，见第四节。

**重构线**刚刚犁过：simplify 的描述在四件套里唯独发生了变更，新增 altitude 维度；市场侧三条路线（顺手修、先访谈再动刀、规则编译）已在《altitude 进场》横评里排座次。

**调试线**被犁了两遍：源码层有 superpowers 家族 systematic-debugging 的四阶段根因分析（存档口径），字节层有 reverify 的「模型提议、工具裁决」和 x64dbg-mcp-server 把 Windows 传奇调试器暴露成 MCP 工具（1860 星存档口径），网络层还有抓包三件套。

四条线的共同点值得写在黑板上：**它们全部工作在代码已经存在之后**。审查审已写之码，测试测已写之码，重构整已写之码，调试纠已写之码。轮次方向给自己划定的四个科目，其实是同一件事的四个事后环节。那么事前呢——代码还不存在的时候，效率工具在哪？

## 二、评测对比表

权重沿用本栏目固定口径：功能 25%、设计 25%、实战 20%、上手 15%、社区 15%。**口径声明**：brainstorming 与 notion-spec-to-implementation 两行的五格评分取自各自存档的格级评分，加权总分按本期口径重算；hello-sdd 全部五格为描述级估分（带 ※）；参照行取存档原始口径仅作定位。

| 样本 | 规格层分工 | 功能 25% | 设计 25% | 实战 20% | 上手 15% | 社区 15% | 加权 |
|---|---|---|---|---|---|---|---|
| brainstorming（obra/superpowers） | 决策格：访谈逼出设计决策 | ★★★★★ | ★★★★★ | ★★★★ | ★★★★★ | ★★★★★ | **4.80** |
| notion-spec-to-implementation（notion-skills） | 契约格：规格↔代码双向总线 | ★★★★ | ★★★☆ | ★★★★★ | ★★★★☆ | ★★★★ | **4.15** |
| mouredev/hello-sdd ※ | 契约格：SDD 通识课 | ★★★☆※ | ★★★★※ | ★★★※ | ★★★★☆※ | ★★★☆※ | **3.68** |
| 参照：planning-with-files（存档黑箱口径） | 记忆格：跨会话计划产物 | ★★★★ | ★★★★☆ | ★★★★ | ★★★★★ | 出厂按分发记 | 4.15※ |
| 参照：simplify（出厂件，09-03 存档口径） | 事后：顺手重构 | — | — | — | — | — | 4.55 |
| 参照：verify（出厂件，09-03 存档口径） | 事后：推前验行为 | — | — | — | — | — | 4.35 |

评分说明：hello-sdd 的实战格给三星是保守值——课程能否转化为读者的规格产出质量，无任何实测证据；社区格给三星半的理由见下节：星数是学生数，不是装机数。

## 三、hello-sdd 逐词拆：一句西语描述里的五个设计决定

> Curso de SDD (Spec-Driven Development) desde cero

**第一词 Curso（课程）。** 形态宣言。它不承诺「装了之后 Agent 会做什么」，只承诺「学完之后你会做什么」。对照本栏体重学谱系（W0 纯名件到 W6 家族流水线），课程仓库是谱系之外的第八种形态：它的交付物是读者的能力，不是 Agent 的行为。这也是为什么它进不了装机端统计——本机 390 件注册表里没有它，也不该有。

**第二、三词 SDD 与括号全称。** 缩写加全称双写，是描述工程的经典手路——sepia 当年被评「设计质量第一」就靠「同义词全给」：不管用户搜 spec-driven、SDD 还是规格驱动，描述里都得有命中的词。课程作者未必读过本栏的描述工程论，但检索规律不认作者，只认写没写全。

**第四段 desde cero（从零开始）。** 人群宣言兼上手承诺。工具件的「上手」成本是配置，课程件的「上手」成本是前置知识——desde cero 等于把前置知识清零写进了标题。

**数字 463 的读法。** 首次入包即 463 星，什么概念？同名单里规则编译路线的重构件 refactoring-ui-skill 六期快照爬坡为 459→471→502→514→524→528（08-31 至 09-06 口径），六天涨了 69 星；hello-sdd 一天走了它六天路程的三分之二。※解释是品牌溢价：mouredev 是以课程仓库见长的西语区教育者※（其身份与影响力未经独立信源核验，仅由仓库命名与语言推断）。但教育件的星数单位是「学生」，工具件的星数单位是「装机」，两者在社区维度不可直接换算——这正是评分表里它社区分打折的原因。

**第五个决定是没写的部分。** 描述里没有一个字提 Claude、Agent、Skill——对比同名单 scroll-craft 的「Works with Codex, Claude Cod…」跨厂兼容清单、sepia 的「77+ via the Skills CLI」，hello-sdd 的宿主中立是彻底的：它教的是方法论，方法论不挑执行器。这个「不写」反而坐实了它的赛道归属：SDD 落地时用什么 Agent 都行，Skill 生态只是它最大的应用市场。

## 四、事前层不是一件事：记忆格、决策格、契约格

把 hello-sdd 放进事前层之前，得先承认本栏此前的一个含混：planning-with-files 被拆解时说的「把计划本身当产物管理」，和 brainstorming 的「出口是设计文档」，和 SDD 的「先写规格」，三件事被笼统叫过「计划」。摊开看是三个格子：

**记忆格：planning-with-files。** 解决的是跨会话、跨窗口的长活里「Agent 的上午和下午接不上」——产物是计划文件本身，服务执行连续性。它是出厂件，黑箱口径 4.15。

**决策格：brainstorming。** superpowers 流水线的守门员，存档记录的三个细节值得复述：一次只问一个问题（禁止连环问卷）；先探测用户已有方案与 must-not-do 清单（避免自作主张选型）；出口不是代码而是一份落盘在 docs/plans/ 的设计文档，并且明确指示交给下一环 writing-plans。它把「想清楚」做成了一个可验收的阶段。

**契约格：SDD。** 前两格的产物仍是散文——设计文档写给人看，规格写给验收看。SDD 的方法论内核（此处按通用定义陈述，非 hello-sdd 仓库原文※）是把需求写成**可判定的规格**：每条要求都能对着实现判真伪，规格即验收标准，甚至规格即用例。notion-spec-to-implementation 在六月存档里展示过这个格子的企业形态：从规范页反向生成脚手架、接口契约与测试用例，实现进度再回写规范页——规格成了需求与代码之间的双向总线。

契约格为什么是三格里最缺的？出厂端口供：官方清单没有一件 spec 件；verify 描述的五个触发场景（verify a PR / confirm a fix works / test a change manually / check a feature works / validate local changes before pushing）全部消费在「验行为」上，没有一个触发在「对规格」上。市场端口供：六期快照里 spec 向条目为零，直到 hello-sdd 上榜——而且上来的是教材，不是工具。**测试件缺席那一期的结论需要修正一行：效率赛道最后的真空不是测试，是测试的上游。** 有规格才有用例的判据，没规格的测试只能靠人脑补预期值。

## 五、全景图：规格层给四条矿道换了工作对象

```mermaid
flowchart LR
    A["模糊需求"] --> SPEC
    subgraph SPEC["① 规格层 · 事前 · 本期新标"]
        B1["决策格<br/>brainstorming<br/>单题访谈→设计文档"]
        B2["契约格<br/>SDD / hello-sdd 任教※<br/>notion-spec 做总线"]
        B3["记忆格<br/>planning-with-files<br/>跨会话计划产物"]
    end
    SPEC --> C["② 写码"]
    C --> R["③ 审查线<br/>code-review · grill 家族"]
    R --> T["④ 测试线<br/>真空带·官方只教手测"]
    T --> F["⑤ 重构线<br/>simplify + altitude"]
    F --> D["⑥ 调试线<br/>reverify · x64dbg 二进制层"]
    D --> H["⑦ 推后接线<br/>gh-fix-ci · sentry · linear"]
```

规格层一旦成型，下游四条矿道的工作对象会跟着变（以下为推演※）：审查从「对码审」变「对着规格审」，偏离规格的优雅代码也是错；测试从「手测观察」变「规格直接展开成用例」；重构的 altitude 维度获得了客观锚——「该在的楼层」由规格的结构决定，不再全凭审美；调试的根因分析多了一个归因终点——实现没错而行为错时，查规格。四条矿道的收益率，上游一句话就能改写。

## 六、安装与使用

```bash
# hello-sdd：课程仓库，clone 阅读而非安装挂载
git clone https://github.com/mouredev/hello-sdd

# brainstorming：随 superpowers 技能家族分发（家族安装方式以其仓库 README 为准，本栏未在线核验具体命令）
git clone https://github.com/obra/superpowers

# notion-spec-to-implementation：随 notion-skills 套件分发，见本站 6-27 存档
# planning-with-files：出厂件，无需安装
```

hello-sdd 是课程不是技能，clone 后按课程路径学习；若课程内含技能产物，以仓库实际目录为准※。

## 七、推荐排行榜

- **规格层综合最强**：brainstorming 4.80——三格里唯一被逐行验证过的，访谈纪律与阶段出口设计是可抄度最高的范本
- **企业落地最强**：notion-spec-to-implementation 4.15——规格双向总线直接压缩「需求→开发」翻译成本，六月存档的变现评级至今未过时
- **最值得追的新面孔**：hello-sdd 3.68※——形态分不高，但它是契约格进入大众教育的第一课；若后续出现工具形态的 spec 件，第一批用户将从这门课的学生里来
- **赛道判断**：四条事后矿道已无洼地，事前三格中记忆格有出厂件、决策格有 superpowers，唯契约格工具件缺位——下一个 refactoring-ui-skill 式的黑马，大概率从这里冒出来

## 参考来源

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