一、项目简介
OpenSpec 是 Fission AI 开源的一款「规格驱动开发（Spec-Driven Development, SDD）」框架，核心理念是：在写任何一行代码之前，先让你和 AI 就「要做什么」达成一致。它为 AI 编程助手补上了一层轻量的规格层（spec layer），把原本只存在于聊天记录里的模糊需求，沉淀成结构化、可评审、可复用的 Markdown 规格文档。截至目前项目已在 GitHub 收获 62,500+ Stars，是当前最受欢迎的规格框架之一。
二、安装要求与快速上手
环境要求：Node.js 20.19.0 或更高版本（同时兼容 pnpm、yarn、bun、nix）。
全局安装：
npm install -g @fission-ai/openspec@latest初始化项目：进入你的项目目录并初始化，OpenSpec 会自动为你的 AI 助手写入配置。
cd your-project
openspec init开始与 AI 对话：直接在支持的编程助手中使用斜杠命令。
# 还没想清楚要做什么？先探索，让 AI 读代码、权衡方案、成型计划
/opsx:explore
# 已经明确需求？直接提出变更提案
/opsx:propose add-dark-mode
# 提案通过后，逐条实施任务
/opsx:apply
# 完成后归档，规格自动更新
/opsx:archive升级只需 npm install -g @fission-ai/openspec@latest，再在各项目内运行 openspec update 刷新 AI 指令即可。
三、核心功能
- 规格先行、代码后行：每个变更都会生成独立文件夹，包含
proposal.md（为什么做/改什么）、specs/（需求与场景）、design.md（技术方案）、tasks.md（实施清单），人和 AI 先对齐再动手。 - 纯 Markdown、零学习成本：规格就是带具体场景（WHEN/THEN）的普通 Markdown，无需学习任何专用语法，AI 负责撰写、你负责评审。
- 流式而非瀑布：任何产物随时可改，没有僵硬的阶段闸门（phase gates），支持从探索到实现的自由迭代。
- 广泛的工具兼容：通过斜杠命令支持 25+（并持续增长）主流 AI 编程助手，包括 Claude Code、Codex、Cursor 等，不锁定任何 IDE 或模型。
- 团队级 Stores（Beta）：把规划放进独立仓库，通过
git push共享，实现跨仓库特性、共享需求、代码未动先立规划——为多团队协作提供单一事实来源。
四、典型使用场景
- 为老项目做增量特性开发（Brownfield）：OpenSpec 明确定位「不只是绿地项目」。在成熟代码库里加新功能时，用
/opsx:explore让 AI 先读懂现有代码结构，再权衡最干净的实现路径，避免 AI 凭空乱改。 - 个人开发者约束 AI「别跑偏」：单人开发时，规格层能让你和 AI 在单仓库上保持诚实——先评审计划再写代码，杜绝「模糊 prompt → 不可预测结果」的困境。
- 企业团队跨仓库协作：一个特性横跨 API 服务、Web 前端和共享库时，用 Stores 把「一个变更、一份计划」共享给三个仓库；平台团队维护规格，产品团队只读引用，让每个编程 Agent 都能读到同一份需求，告别到处漂移的 Wiki。
五、推荐理由
体验下来，OpenSpec 最打动我的是它对「轻量」的坚持。同类的 GitHub Spec Kit 更全面但偏重——僵硬的阶段闸门、大量 Markdown、还要配 Python 环境；AWS 的 Kiro 很强却把你锁死在它的 IDE 和 Claude 模型上。OpenSpec 则用一条 npm install 就接入你已经在用的工具链，规格全是能随手改的纯 Markdown，真正做到了「有预测性但不繁文缛节」。
官方建议搭配高推理能力的模型（如 Codex、Opus 系列）效果最佳，并注意保持干净的上下文窗口——实施前清理上下文，能显著提升产出质量。对于厌倦了「AI 一顿乱写、结果全靠运气」的开发者，OpenSpec 是一个成本极低、收益明显的习惯升级。MIT 许可，可放心用于商业项目。
六、下载地址
- GitHub 仓库：https://github.com/Fission-AI/OpenSpec
- 官方网站：https://openspec.dev/
- npm 包：@fission-ai/openspec
项目信息：Stars 62,500+ | Forks 4,325 | 主语言 TypeScript | 许可证 MIT | 首次发布 2025-08
