首页 › skills-review › 写代码之前:效率赛道规格层首拆

写代码之前:效率赛道规格层首拆——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 上榜——而且上来的是教材,不是工具。测试件缺席那一期的结论需要修正一行:效率赛道最后的真空不是测试,是测试的上游。 有规格才有用例的判据,没规格的测试只能靠人脑补预期值。

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

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 维度获得了客观锚——「该在的楼层」由规格的结构决定,不再全凭审美;调试的根因分析多了一个归因终点——实现没错而行为错时,查规格。四条矿道的收益率,上游一句话就能改写。

六、安装与使用

# 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 后按课程路径学习;若课程内含技能产物,以仓库实际目录为准※。

七、推荐排行榜

参考来源

[!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学通信知识星球海报-扫码加入