引言
如果你曾在用AI编码工具时被混乱的聊天记录、丢失的上下文和损坏的代码困扰，本指南将帮你用OpenSpec解决这些问题——一个轻量级规格驱动开发框架。我们将讲解OpenSpec的工作原理、与其他流行框架的对比，以及如何用它构建稳定可维护的AI项目。
什么是规格驱动开发？
核心概念：规格驱动开发（SDD）——确保在写任何代码之前定义清晰的需求、设计和验收标准。它解决了AI忘记上下文或修改时破坏已有代码的常见问题。
两大方法论：SDD（先定义需求再构建）和TDD（先写测试再构建）。OpenSpec是灵活的SDD框架，强制AI将需求拆解为三份关键文档：
- Proposal（提案）：为什么构建？
- Design（设计）：怎么构建？
- Spec（规格）：构建什么（含验收标准）。
OpenSpec四步工作流
第一步：探索需求
向AI描述你的想法，如"帮我构建一个AI聊天机器人"。AI会追问：用什么前端框架？集成哪个模型？项目结构？回答这些问题完善需求。
第二步：生成文档
需求明确后，AI生成Proposal、Design和Spec三份文档。
第三步：开发
AI按Spec文档中的任务逐个实现，实时跟踪进度。
第四步：归档
开发完成后所有文档归档，变更合并到中央规格表，确保任何人可理解项目历史。
框架对比
| 特性 | OpenSpec | Spec-Kit | Superpowers |
|---|---|---|---|
| 聚焦 | 轻量规格管理 | 完整SDD生命周期 | Agent行为约束 |
| 场景 | 中小项目 | 大型复杂项目 | 确保AI遵循规则 |
| 复杂度 | 易学 | 学习曲线较陡 | 中等 |
安装使用
npm install -g openspec
# 初始化新项目
openspec init
# 探索需求
openspec explore
# 生成文档
openspec generate
# 基于规格开发
openspec develop
# 归档变更
openspec archive为什么OpenSpec适合新手
- 低门槛：无需高级技术技能。
- 清晰工作流：四步流程确保不会迷失。
- 可维护项目：所有变更文档化，易于更新或交接。
- 灵活：可自定义工作流适配需求。
常见问题
SDD和写好提示词有什么区别？
好提示词产出好的单次回复。SDD产出好的项目。区别在于持久性：精心设计的提示词可能一次生成优秀代码，但两周后回来加功能时，你和AI都忘了上下文。SDD通过将上下文外部化为跨会话持久化的文档（Proposal、Design、Spec）来解决这个问题。当你回到项目，AI读取归档的规格，完全理解构建了什么、为什么构建、验收标准是什么。这是AI辅助编码（适合一次性任务）和AI驱动开发（适合持续项目）的区别。
每个项目都需要用OpenSpec吗？
不需要。OpenSpec在跨多会话、涉及多个功能或可能交接给他人的项目上发挥价值。一次性脚本或快速实验不值得这个开销——直接用AI编码工具就好。经验法则：项目需要超过一天工作量就用OpenSpec。单会话任务跳过。框架足够轻量，初始文档生成仅需5-10分钟，但不是零成本——不要为了流程而加流程。
OpenSpec能用于任何AI编码工具吗？
可以。OpenSpec与工具无关——它是个npm包，生成和管理规格文档。可与Claude Code、Codex、Cursor或任何能读取项目文件的AI编码助手配合使用。工作流相同：运行OpenSpec命令生成文档，然后让AI工具读取Proposal/Design/Spec文件并实现。部分工具有内置OpenSpec集成提供更流畅体验，但即使没有原生支持，基于文件的方式也能普遍适用。
项目中途改需求怎么办？
这正是归档和规格系统的设计目的。需求变更时，用新需求再次运行openspec explore。OpenSpec生成引用归档版本的更新文档，展示变更内容和原因。AI仅实现增量——不从零重建。这是相比临时AI编码的核心优势：需求变更被文档化、可追溯、精准实施，而非靠"从头来过"式提示词。归档确保你永远不会丢失最初决策的上下文。