轻持则活
—— SDD 与 OpenSpec 的禅学解读

一、缘起：一场发生过两次的争论

SDD 的全部争论——要不要写 spec、spec 该多重、语言能否穷尽实现——在禅宗一千二百年的历史里完整地发生过一遍。这不是修辞巧合，是同构：两边争的都是同一件事，文字与真实的关系，以及人应当如何持有文字。经院派把文字越写越厚，狂禅派把文字全部烧掉，而禅门真正的传统站在中间：文字是渡河的筏、指月的指——郑重地用，用完就放。

下文五节，每一节取一个禅学概念，对应 OpenSpec 的一个具体机制。对应是机械的、可检验的，不是氛围比附。

二、筏喻：spec 的本体论地位——筏，不是彼岸

SDD 最常见的堕落形态是执指为月：把 spec 当成系统本身，文档越写越厚，维护文档反客为主——spec-kit 每个 feature 七个文件，评测者说 review 变成了”审计 AI 生成的文本而非设计软件”，这就是顶着筏子赶路。而 OpenSpec 把”舍筏”做成了内建仪式：change 文件夹从出生起就注定被归档，proposal、design、tasks 渡你过这一条河，archive 之后统统冻结，不再背负。一个工具在设计层面承认”我的产物是用完即弃的方便法门”，这在文档工具里是罕见的自觉。

三、无常：delta 的形而上学——流是实相，快照是假名

全量 spec 派有一个隐藏的形而上学承诺：系统存在一张可被完整描述的终点蓝图——一个”常”。佛教对此的回答干脆：诸行无常，变化才是唯一的基本单位。”describe the diff, not the destination” 是无常观的工程表达；再深一层是缘起无我——specs/ 里的”真相”没有自性，它不是被谁一次性写就的本质，而是几十次归档变更缘起和合的当前断面。系统之”我”，只是变更之流的相续。

四、顿渐之争：两偈分宗——spec-kit 与 OpenSpec 的分岔

五、中道：狂禅与经院之间——百丈清规

对抗评审一下——真正彻底的禅其实是反方：”不立文字，直指人心。模型已经够强，一个 plan.md 直接开写，要什么 spec 框架？”这是标准的禅门锋芒，而且它没错。但禅宗史早给出了下文：取消一切形式的”狂禅”最终都堕落了——”酒肉穿肠过”的后半句没人念。于是百丈怀海立清规，”一日不作，一日不食”：禅门自己最终也立了制度。不是背叛顿悟，而是发现：护持日常修行的，恰恰是最小限度的形式。戒不是束缚，是护栏。

六、言语道断：缝隙处的诚实，与一枚圆相

对 SDD 最深的一刀是那句：”如果 spec 真能唯一决定实现，spec 就成了更高级的编程语言”——即语言不可能穷尽实现。禅宗对此从不辩解，直接承认：言语道断，心行处灭。所以只说到指月为止，剩下的留白给参。OpenSpec 的 spec 格式恰好是这个态度：只写外部可观察行为，requirement 粒度，明令禁止写类名、库、实现步骤。它不试图说尽，只负责指认；spec 与代码之间那道不可消除的缝隙，留给 design 与实现去”参”。这不是能力缺陷，是对”言不尽意”的诚实设计。

七、对照表：禅学概念 ↔ OpenSpec 机制（可检验的映射）