文档教程知识库人工智能【免费下载链接】ai-guide程序员鱼皮的 AI 资源大全 Vibe Coding 零基础教程分享 OpenClaw 保姆级教程、大模型玩法DeepSeek / GPT / Gemini / Claude / GLM、最新 AI 资讯、Prompt 提示词大全、AI 知识百科Agent Skills / RAG / MCP / A2A、AI 编程教程Harness Engineering、AI 工具用法Cursor / Claude Code / TRAE / Codex / Copilot、AI 开发框架教程Spring AI / LangChain、AI 产品变现指南帮你快速掌握 AI 技术走在时代前沿。本项目为开源文档 aiguide已升级为鱼皮 AI 导航网站项目地址https://gitcode.com/GitHub_Trending/aig/ai-guide点击查看免费下载让文档和代码始终保持同步在 AI 编程时代如何让 AI 遵循专业、可控的流程开发项目而不是想到哪写到哪本教程以 Vibe Coding 零基础教程中《OpenSpec轻量规范开发框架》为核心结合仓库内 Spec-kit 教程、AI 辅助工具集 与 Vibe Coding 概念大全 中对规范驱动开发SDD的讲解系统介绍 OpenSpec 的安装初始化、目录结构、五步标准化开发流程以及与 Spec-kit 的适用场景差异。学完后你将掌握在现有项目上借助 AI 进行提案—审查—实现—归档规范迭代的完整技能。一、什么是 OpenSpecOpenSpec 是一个轻量的规范驱动开发SDDSpec-Driven Development框架相比 Spec-kit 更简单易用特别适合在现有项目上迭代功能。要理解 OpenSpec 的价值先要理解规范驱动开发的核心理念。如 Vibe Coding 概念大全 所述传统开发流程是想到什么写什么边写边改最后再补文档容易导致需求不清晰、代码和文档对不上而 SDD 的思路正好相反——先把需求写成规范文档并把规范文档当作代码的唯一真相来源AI 必须严格遵守这些条文来生成代码确保产出完全符合预期。OpenSpec 在此基础上做了轻量化设计它的核心哲学是把规范文档作为代码库的一部分。每次改功能先写变更提案⇒ 确认后再实现 ⇒ 实现完再把变更归档到规范文档中让文档和代码始终保持同步。这套循环提案 → 实现 → 归档正是 OpenSpec 区别于其他 SDD 工具的精髓不是一次性把整个项目规范做完而是把每一次功能变更都沉淀成可追溯的规范记录。二、快速上手 OpenSpec下面通过给现有项目添加用户搜索功能这个实际例子带你完整走一遍 OpenSpec 的开发流程。1. 安装 OpenSpec首先确保你的电脑安装了符合要求的 Node.js 版本示例环境要求Node.js 20.19.0然后全局安装 OpenSpec CLInpm install -g fission-ai/openspeclatest进入你的项目目录运行初始化命令openspec init初始化过程中会让你选择要集成的 AI 工具如 Claude Code、Cursor 等本文以选择 Cursor 为例。初始化完成后OpenSpec 会自动在你的项目中生成一个openspec/目录里面包含openspec/specs/存放主规范文档记录项目的完整现状openspec/changes/存放变更提案记录每次修改的计划⭐️openspec/AGENTS.md让 AI 编程助手使用 OpenSpec 进行规范驱动开发的操作指南包含如何创建变更提案、编写需求规范、验证和归档变更的完整工作流程openspec/project.md当前项目的上下文说明用于记录项目信息此外OpenSpec 还会根据你选择的 AI 编程工具生成对应的命令文件例如 Cursor 的斜杠命令配置这样你就能在 AI 编程工具中直接以斜杠命令方式驱动整个流程。2. 标准化开发流程五步走初始化完成后即可开始规范化的开发流程主要分为 5 个步骤步骤 1Draft 起草变更提案直接在 AI 编程工具中告诉 AI让它创建变更提案。例如添加用户搜索功能创建一个 OpenSpec 的 change添加功能根据名称和邮箱搜索用户也可以用 AI 编程工具如 Claude Code、Cursor的斜杠命令/openspec:proposal 添加功能根据名称和邮箱搜索用户AI 会为这个功能创建一个独立目录openspec/changes/add-user-search/并在目录下创建一系列文档proposal.md描述要改什么、为什么改tasks.md实施步骤的任务分解specs/…/spec.md需求变更的具体内容每个变更都有独立目录是 OpenSpec变更即文档设计的体现——一次变更的全部上下文都收敛在一个文件夹里便于审查与追溯。步骤 2Verify Review 验证和审查运行以下命令检查 AI 创建的变更提案是否正确openspec list # 查看所有变更 openspec validate add-user-search # 验证格式是否正确 openspec show add-user-search # 查看详细内容list用于总览当前所有未归档的变更validate会校验变更目录内的文档结构是否符合 OpenSpec 的规范格式是保证机器可读的关键检查show用于逐项查看某个变更的完整内容方便人工审阅。步骤 3和团队一起审查提案如果提案需要完善可以继续与 AI 对话例如你能帮我添加更多搜索条件和限制么AI 会据此更新规范文档和任务列表直到团队对需求达成一致。这一步体现了 SDD 的对齐价值所有人包括 AI都基于同一份规范文档工作从源头减少误解。步骤 4Implement 实现变更规范确认后让 AI 开始实现规范已经很完美了开始生成代码吧也可以用斜杠命令/openspec:apply add-user-searchAI 会按照tasks.md中的任务列表逐一实现并标记完成状态。由于所有改动都建立在已确认的规范之上AI 的输出会非常整齐每次改动的目标、范围一目了然。步骤 5Archive 归档变更所有任务完成后让 AI 归档这次变更请归档这次变更也可以用斜杠命令/openspec:archive add-user-search或者在终端直接运行openspec archive add-user-search --yes这个命令会完成三件事将变更文件夹移动到openspec/changes/archive/归档区将需求变更自动合并到openspec/specs/主规范中保持文档和代码的同步归档意味着本次变更正式转正需求从提案状态升级为主规范的一部分成为项目现状的权威描述。这样一来通过openspec/changes/的历史记录你可以随时追溯每次变更的来龙去脉。实践建议在整个开发过程中建议定期运行openspec validate验证命令确保规范的完整性避免提案堆积或格式漂移。三、OpenSpec 和 Spec-kit 的区别OpenSpec 常与 Spec-kit 一起被归为规范驱动开发工具参见 AI 辅助工具集但两者定位有明显差异维度Spec-kitOpenSpec流程完整的 7 步流程制定准则 → 写需求 → 澄清疑问 → 定方案 → 拆任务 → 检查 → 写代码更简化的 5 步起草提案 → 审查 → 实现 → 归档 → 验证适用场景适合从 0 开始做大型新项目适合在现有项目上迭代功能上手成本流程完整但较重上手更快轻量易用核心机制全流程规范驱动以变更提案 归档保持文档与代码同步如 Spec-kit 教程 中所说Spec-kit 完整流程虽能保证项目质量但对小项目而言几分钟能写完的代码要走半小时流程而 OpenSpec 正是针对这种痛点做的轻量化设计——把规范流程收敛为变更提案这一核心单元每次只规范一次改动天然适配日常的功能迭代节奏。选型建议如果你是在现有项目上持续迭代功能OpenSpec 是更好的选择如果你是从 0 开始做大型新项目Spec-kit 的完整流程能帮你打好基础。两者并不冲突可以在同一套规范理念下按项目阶段灵活选用。四、总结OpenSpec 的适用场景与价值回顾全文OpenSpec 的核心价值可以概括为三点轻量相比 Spec-kit 的 7 步完整流程OpenSpec 用提案 → 审查 → 实现 → 归档四个动作承载规范驱动开发上手更快同步通过归档机制把每次变更自动合并进openspec/specs/主规范从机制上保证文档与代码不脱节可追溯所有变更的历史记录保留在openspec/changes/含归档区团队随时可以回溯每个功能的决策过程。如果你觉得 Spec-kit 太重可以试试 OpenSpec。它的流程更简单但同样能保证文档和代码的同步让团队协作更顺畅。建议你在自己的项目中实际跑一遍创建提案 → 验证 → 实现 → 归档的完整流程亲身体验规范驱动开发给功能迭代带来的秩序感。延伸阅读想进一步了解规范驱动开发的整体方法论可阅读本仓库的 SDD 规范驱动开发对比学习完整流程可阅读 Spec-kit规范驱动开发框架更多辅助工具推荐见 AI 辅助工具集 与 优质 AI 编程扩展推荐。赞分享文档教程知识库人工智能【免费下载链接】ai-guide程序员鱼皮的 AI 资源大全 Vibe Coding 零基础教程分享 OpenClaw 保姆级教程、大模型玩法DeepSeek / GPT / Gemini / Claude / GLM、最新 AI 资讯、Prompt 提示词大全、AI 知识百科Agent Skills / RAG / MCP / A2A、AI 编程教程Harness Engineering、AI 工具用法Cursor / Claude Code / TRAE / Codex / Copilot、AI 开发框架教程Spring AI / LangChain、AI 产品变现指南帮你快速掌握 AI 技术走在时代前沿。本项目为开源文档 aiguide已升级为鱼皮 AI 导航网站项目地址https://gitcode.com/GitHub_Trending/aig/ai-guide点击查看免费下载相关推荐OpenSpec 规范驱动开发实战在 Midway 仓库中编写、实施与归档变更提案的完整指南OpenSpec 规范驱动开发实战在 Midway 仓库中编写、实施与归档变更提案的完整指南 MidwayNode.js 云端一体框架在其仓库根目录维护了后端微服务云原生OpenSpec 轻量规范驱动开发框架实战让文档与代码始终保持同步OpenSpec 轻量规范驱动开发框架实战让文档与代码始终保持同步 面向现有项目迭代场景的规范驱动开发SDD轻量方案本文基于《Vibe Coding 零文档教程知识库人工智能OpenSpec 变更归档工作流实战基于 openspec-archive-change 技能将已完成变更安全归档OpenSpec 变更归档工作流实战基于 openspec archive change 技能将已完成变更安全归档 导读 openspec archive c数据库灾备创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考