规范驱动开发(SDD)将规范置于代码之上，OpenSpec 提供了具体的落地工具。通过维护结构化规范文档，OpenSpec 让 AI 工具精准获取上下文，实现需求到代码的自动化流转，重塑开发流程。
智能速览
规范驱动开发核心是规范作为需求迭代的第一等公民
OpenSpec 通过维护结构化文档为 AI 编程提供精准上下文
工作流涵盖提案、验证、实现与归档四个关键阶段
工具生成 openspec/ 目录，统一管理变更提案与历史规范
支持主流 AI 编程工具，无需配置 API 密钥即可快速接入
随着规范文档积累，AI 生成代码的准确性与合理性持续提升
精华内容
规范驱动开发的本质在于在代码工程中维护一套结构化规范文档，AI 编程工具在交互时提取这些内容作为 Prompt，从而实现需求，完成从“氛围编码”到“规范驱动”的转变。
目录结构设计
OpenSpec 会在项目中生成 `openspec/` 目录，用于统筹规范驱动开发。其中 `AGENTS.md` 用于指示 Cursor、Claude Code 等 AI 助手接管工作流；`project.md` 定义项目级别的架构模式与规范；`changes/` 目录存放变更提案及相关文件；`specs/` 目录则存储已验证通过的规范文档，作为后续开发的指导标准。
接入与初始化
通过 npm 或 pnpm 全局安装 `@fission-ai/openspec` 后，在项目根目录运行 `openspec init` 即可完成初始化。该过程会自动创建 `openspec/` 目录结构，并在 `.cursor/commands` 下配置提案、实施和归档三个核心命令。初始化完成后，建议利用 AI 填充 `project.md`，建立项目的技术栈与规范标准。
开发工作流实践
实践流程始于创建提案，使用命令生成包含需求背景与改动点的方案文档。随后进入验证阶段，检查生成的 `spec.md`、`proposal.md` 和 `tasks.md` 是否准确。确认无误后，执行实施命令，AI 将读取文档并生成代码。若实现不满足需求，可调整任务清单并重新实施，最后通过归档命令将规范移入 `specs/` 目录。
适用场景与建议
规范驱动开发并非银弹，对于微小的代码改动（如单纯新增接口），直接修改可能更为高效。在团队协作中，建议将 `openspec/` 目录纳入版本控制，并统一团队的 AI 编程工具与 LLM 模型，以确保规范的一致性与生成的准确性。随着规范文档的不断沉淀，AI 对项目架构的理解将更加深入。
OpenSpec 为 AI 时代的软件工程提供了一套从“写代码”转向“写规范”的可行路径。通过结构化的工作流，它不仅提升了代码生成的准确性，更让需求管理变得清晰可控，是探索规范驱动开发的高效工具。
