OnlySpecs：AI 时代的全新开发范式——Spec-Driven Development

chjian

OnlySpecs：AI 时代的全新开发范式——Spec-Driven Development

2026 年，AI 编程工具（如 Cursor、Claude）已经让“写代码”变得前所未有地容易。但随之而来的是一个新痛点：AI 生成的代码往往“自由发挥”过头，导致返工、技术债堆积、项目失控。

这时，一种极端却高效的思路火了——OnlySpecs（或称“Only Specs Driven Development”）。它的核心口号是：

“代码就是厕纸，用完就扔；Specs（规格文档）才是永恒的核心资产。”

简单说：人类只负责写/改清晰、详细的规格文档（Specs），AI 负责根据 Specs 生成全部实现代码。迭代时不需要改代码，只改 Specs → AI 重新生成新代码，老代码直接删掉。

这不是科幻，而是当前 AI 社区正在热议的实战方法论。下面一步步教你理解和上手 OnlySpecs。

1. OnlySpecs 到底是什么？

传统开发流程：
- 先写代码 → 代码是核心资产
- 文档/Specs 是附属品，容易过时

OnlySpecs 完全反转：
- Specs 是唯一事实源（Single Source of Truth）：包含需求、用户故事、验收标准、架构约束、API 定义、数据模型、边界条件、技术选型等一切关键信息。
- 代码是“一次性消耗品”：AI 根据 Specs 生成，错了就重生成，不需要人类手动修补。
- 迭代逻辑：需求变了？改 Specs → AI 一键重生代码库 → 老代码直接丢。

极端比喻：就像装修房子——你只管画蓝图（Specs）和改蓝图，施工队（AI）每次都按最新蓝图重新盖房子，而不是在旧房子上补丁。

为什么这么激进？因为 AI 写代码太快（几秒到几分钟出一整个功能），但人类改代码慢、易出错。把精力集中在“写对需求”上，才是最高效。

2. OnlySpecs 的典型工作流程（保姆级教程）

步骤 1：创建/生成初始 Specs
- 新项目：用自然语言描述需求 → 喂给 Claude / Cursor / GPT 等大模型，让它帮你结构化成详细 Specs 文件（spec.md）。
  示例 prompt：
  “你是一个资深产品经理 + 架构师。请基于以下需求，输出一份完整的 OnlySpecs 格式文档，包括：
  - 项目概述
  - 用户故事（As a ... I want ... So that ...）
  - 验收标准（Given ... When ... Then ...）
  - 系统架构（分层、关键组件）
  - API 定义（OpenAPI 风格）
  - 数据模型
  - 非功能需求（性能、安全等）
  - 技术约束

  需求：一个基于 OpenClaw 的 AI Agent 插件市场，支持搜索、安装、LoRA 微调音乐模型（如 ACE-Step），用户可以上传自定义模型并分享。

- 已有项目（最酷的部分）：导入 GitHub 仓库 → AI 自动逆向分析代码 → 生成超详细 Specs。
  - 工具如 OnlySpecs或类似 Spec Kit 可以一键导入项目，AI 分析出需求、架构、API 等。
  - 结果：一个几千行的 spec.md，把整个项目“翻译”成，人类可读的规格。

步骤 2：完善 & 澄清 Specs
- AI 自动追问：不确定点让模型问你（“这个 API 需要支持分页吗？分页大小默认多少？”）
- 你只回答问题 → Specs 越来越完整。

步骤 3：AI 生成/重写代码
- 把 Specs + 技术栈要求喂给 AI（Cursor / Claude Code / OpenClaw 集成等）。
- 一键生成整个项目结构、代码文件。
- 如果有 bug 或需求变更：改 Specs → 重新生成（或增量生成）。

步骤 4：验证 & 迭代
- 运行测试 → Specs 里定义的验收标准自动校验。
- 需求变 → 只改 Specs → AI 重生代码。
- 老代码？直接删（或 git rm），不留技术债。

3. OnlySpecs 的优势与适用场景

**优势**：
- 迭代速度 ×10：需求变更只需改文档，AI 自动适配。
- 减少技术债：代码永远是最新的“翻译版”，没有历史包袱。
- 非码农友好：产品经理/设计师/创业者能直接改 Specs，指挥 AI 实现。
- 跨语言重构神器：导入 Python 项目 → 生成 Rust/Go/Zig 版 Specs → AI 输出新语言实现。
- 项目交接容易：新同学看 Specs 就能懂全部逻辑，不用读一堆代码。

**适用场景**：
- 快速原型/MVP（创业项目）
- AI Agent/插件开发（像 OpenClaw.生态）
- 遗留系统重构（导入老代码 → 生成现代 Specs → 重写新框架）
- 个人/小团队项目（不想维护复杂代码库）

**不适合**：超大型企业系统（需要严格代码审查、合规审计）、性能极致优化场景（AI 生成代码可能不是最优）。

4. 当前主流工具与玩法（2026 年 3 月）

- GitHub Spec Kit：官方开源，最规范的 SDD 框架，支持多阶段（constitution → specify → plan → tasks → implement）。
- OpenSpec：轻量 CLI，适合增量开发，生成 proposal + tasks。
- OnlySpecs（新兴爆款）：最激进，支持导入任意 GitHub 项目 → 自动逆向 Specs → 全项目重写（社区最火的“厕纸论”代表）。
- Tessl / Kiro / Spec Kitty：探索“Specs 作为源代码”的极致玩法。

社区共识：入门先用 OpenSpec或 Spec Kit（低门槛），想玩极端重写再上 OnlySpecs。

5. 结语：OnlySpecs 是“AI 时代的新生产力工具”

OnlySpecs 不是取代程序员，而是把程序员从“写实现”解放到“写意图 + 指挥 AI”。

未来可能出现“Specs 市场”：大家分享/交易高质量 Specs，AI 一键生成不同语言/框架的实现版本。你的项目或许可以用 OnlySpecs 定义 Agent 行为规范，让 AI 自动生成插件代码，迭代时只改一份 spec.md。

一句话：代码会过时，Specs 会永恒。
在 AI 写代码的时代，真正有价值的，是你对问题的清晰定义。

你准备试试 OnlySpecs 吗？