AI编码助手已经成为日常开发的标配工具，但多数开发者都会遇到同一个棘手问题，所有需求、交互逻辑、变更细节全部存储在对话上下文内，一旦会话清空、窗口关闭，前期沟通的需求标准、技术方案就会彻底丢失。单纯依靠聊天记录传递需求，很容易出现AI理解偏差，同一功能反复修改、代码实现与预期不符，小型项目尚可手动调整，企业级长期迭代项目会持续积累大量技术债务。市面上现有的规范工具要么流程厚重、强制固定阶段划分，要么绑定专属IDE与模型，无法适配开发者现有的工具链，个人开发者与中小型团队始终缺少一套轻量、无绑定、可自由迭代的规范管理方案。

OpenSpec的出现填补了AI编码流程里规范落地的空白，它以轻量化文档文件夹为载体，在编写代码前统一对齐人与AI的开发标准，摒弃传统瀑布式开发的刚性阶段约束，支持随时修改需求、设计、任务清单，兼顾存量项目改造与全新项目搭建。该工具兼容市面上二十余种主流AI编码助手，不强制切换开发环境，兼顾个人独立开发与企业多人协作场景，用极低的学习成本解决AI编码需求模糊、流程混乱、文档缺失的核心痛点，让AI生成代码具备可追溯、可校验、可归档的完整工程属性。

简介

OpenSpec由Fission AI团队打造，项目托管于GitHub仓库，仓库地址为
https://github.com/fission-ai/openspec，整体采用MIT协议分发，无商用限制，个人开发者与企业均可免费使用。项目核心定位是轻量化规范框架，核心逻辑是在AI生成代码前建立标准化需求档案，将口头、对话中的模糊需求转化为结构化可存储文档，解决纯对话式AI编码无留存、难复盘、易返工的缺陷。仓库持续更新维护，截至2026年5月仍有高频代码提交，配套完善文档、多语言适配能力、社区扩展方案，同时提供完整CLI工具链，支持npm、pnpm、yarn、bun、nix多种包管理工具，适配Windows、macOS、Linux全平台开发环境。

项目核心功能与特色围绕AI协同开发设计，第一是独立变更文件夹管理，每一次功能迭代都会生成专属目录，内置需求提案、功能规格、技术设计、任务清单四类核心文档，所有变更记录永久留存；第二是一套完整斜杠指令工作流，通过简单命令完成需求提出、代码落地、校验归档全流程，无需复杂配置；第三是无绑定兼容特性，不限制使用的AI模型，推荐Codex 5.5、Opus 4.7等高推理能力模型，同时兼容25款以上主流编码助手；第四是灵活迭代机制，没有强制阶段门槛，开发者可随时修改任意文档内容，不用走完完整流程才能调整需求；第五是低侵入接入，存量老项目无需大规模改造即可接入，无需重构现有工程目录结构。

OpenSpec适配多类开发场景，个人独立开发时，可用于记录每一项功能的设计思路，避免多次切换会话后遗忘开发细节；小型团队协作场景中，统一规范文档标准，新人可通过历史变更档案快速了解项目历史需求，减少沟通成本；企业长期迭代项目可借助归档功能沉淀完整需求资产，后续迭代、代码重构时可回溯原始设计标准；多语言跨栈开发场景下，依托多语言适配能力统一前后端、脚本、工具类项目的规范流程；同时支持CI流水线集成，匿名数据采集功能可辅助团队分析开发流程瓶颈，也可一键关闭数据收集保障隐私安全。对比同类工具，GitHub Spec Kit流程繁琐、阶段约束僵硬，AWS Kiro绑定自有IDE与专属模型，而OpenSpec轻量化、无锁定、自由迭代的特性更适配多数开发者日常工作流。

使用

OpenSpec运行环境要求Node.js 20.19.0及以上版本，整体操作分为全局安装、项目初始化、配置可选扩展配置、完整功能开发流程四步，全程使用终端命令执行，搭配AI对话斜杠指令完成开发闭环。

第一步完成全局工具安装，打开终端执行npm全局安装命令，也可替换为pnpm、yarn等本地使用的包管理器，命令如下：

安装完成后可输入openspec -v校验安装是否成功，输出版本号即代表环境就绪。

第二步进入目标项目目录执行初始化命令，工具会自动生成基础配置文件与目录结构，适配当前项目工程类型：

初始化完成后，项目根目录会生成基础配置，默认使用基础工作流，若需要完整扩展指令集，可切换配置文件配置文件，执行配置切换命令：

执行openspec update会刷新项目内AI指引信息，同步最新斜杠指令规则，保证AI识别完整工作流。

第三步启动功能开发完整流程，全部操作通过AI对话内斜杠指令触发，首个指令为propose，用于提交开发需求，示例指令如下：

执行后工具自动创建
openspec/changes/add-dark-mode文件夹，自动生成四份核心文档，分别为记录开发目的与变更范围的proposal.md、存储功能需求与场景的specs目录、说明技术实现方案的design.md、拆解落地步骤的tasks.md，此时仅完成需求规划，未生成任何代码，可人工核对文档调整需求细节。

第四步执行代码落地指令，AI读取目录内全部规范文档，按照tasks.md内清单分步完成编码实现，指令如下：

终端会逐条输出任务完成状态，全部任务执行完毕后，可人工校验代码是否匹配设计文档，若存在偏差可修改specs或design文档后重新执行apply指令更新代码。

第五步功能验收完成后执行归档指令，将本次变更全部文档迁移至归档目录，统一管理历史迭代记录：

归档文件会按日期分类存储在openspec/changes/archive路径下，方便后续复盘查阅。

除基础流程外，工具配套多扩展指令，可按需使用，例如verify用于代码校验、bulk-archive批量归档多条变更、onboard完成项目初始化引导，完整指令集可查阅官方CLI文档。若需要关闭匿名使用数据采集，可在终端设置环境变量，Windows PowerShell与类Unix系统命令略有区分，通用配置命令如下：

工具支持nix环境部署，提供flake配置文件适配nix开发环境，仓库内附带完整flake.nix配置，可直接复用构建脚本，本地二次开发调试可使用pnpm管理依赖，执行pnpm install安装依赖后运行pnpm run dev启动本地CLI调试。

总结

OpenSpec围绕AI编码的痛点打造轻量化规范闭环，核心能力聚焦在结构化变更文档管理、无绑定多工具兼容、自由迭代无刚性流程、完整命令行工作流四个维度，通过在编码前统一对齐需求标准，解决纯对话式AI开发需求模糊、成果无留存、迭代不可追溯的问题。工具兼顾轻量与完整，既不会像重型规范工具增加大量流程负担，也不会像无规范AI编码缺少标准化约束，同时提供可自定义配置、社区扩展schema、多包管理器适配等附加能力，从个人小型脚本到企业大型工程均可适配，文档、测试、归档全链路内置，无需额外搭建第三方流程工具。

从应用价值层面来看，OpenSpec重新定义AI辅助开发的协作模式，把一次性对话转化为可长期沉淀的项目资产，降低团队沟通成本与后期重构返工成本。对于独立开发者，它可以替代零散笔记，系统化留存每一项功能的设计思路；对于企业团队，统一规范标准降低新人上手门槛，历史归档文档可作为项目技术资产长期留存；从行业视角，它提供一套中立无锁定的规范开发标准，不绑定特定厂商IDE与大模型，推动AI编码从临时原型制作向标准化工程开发演进，其轻量化、灵活迭代的设计思路，也为同类规范工具提供了差异化实现思路，具备长期复用与二次扩展的空间。