OpenSpec
OpenSpec 是一款面向软件开发者的轻量级命令行工具,用于在编码实施前自动生成结构化规范文档,以减少开发意图与实际实现之间的偏差。其核心工作流涵盖提案、延续、应用与归档四个阶段,规范文档以纯 Markdown 格式存储,无需依赖特定开发框架或环境,可与 AI 辅助编程工具配合使用。
核心事实
时间轴 (近 90 天)
作者分析了788个使用 OpenSpec 模式的开源仓库,发现折回步骤是手动的,且没有人维护没人读的文字。
OpenSpec 的验证步骤(/opsx:verify)属于扩展工作流配置,通过 openspec config profile 启用。
OpenSpec 的所有内容都放在 openspec/ 文件夹下,分为 specs/(当前系统行为的事实来源)和 changes/(提议的修改,每个变更一个文件夹)两部分。
OpenSpec 的工作流包括六个步骤:探索(/opsx:explore)、提议(/opsx:propose <name>)、审查、应用(/opsx:apply)、验证(/opsx:verify)、归档(/opsx:archive)。
OpenSpec 不是一个需要迁移过去的新 IDE 或平台,而是仓库里的一个 Markdown 文件夹、一个小型 CLI,以及一套给代理的指令。
OpenSpec 的核心概念是增量规格(delta spec),一个变更不会重述整个规格,只描述新增、修改或删除的部分。
OpenSpec 归档后,增量合并进 specs/,变更文件夹移入 changes/archive/ 并加上日期前缀,规格描述系统现在的状态,归档的变更保留完整的来龙去脉。
在 OpenSpec 的增量规格里,场景被当作需求的验收标准:ADDED Requirements 下的每条 Requirement 后跟若干 Scenario,分别覆盖正常路径、边界和异常。
GitHub的SpecKit提供constitution、plan、tasks、implement等斜杠命令,FissionAI的OpenSpec遵循propose→explore→apply→archive工作流
OpenSpec 不直接生成代码,而是优化喂给 AI 的输入
还有 12 条时间轴事件
全部知识事实 (20)
AI编程工具的发展经历三个阶段:代码补全、对话式代码生成、自主式开发Agent
90%已验证AI模型生命周期管理对开发者日益重要,需要建立清晰的部署、监控与退役机制
65%已验证OpenSpec的Explore模式让AI自由探索代码库,帮助分析架构、定位瓶颈、理解现有设计
65%待验证OpenSpec的Apply命令会将源Spec和DeltaSpec自动合并成最新版本
90%待验证DeltaSpec通过edit新增、modify修改、remove删除三种操作来描述变化
90%待验证OpenSpec使用Devon文档格式来描述需求场景
90%待验证OpenSpec使用DAG(有向无环图)产物依赖图机制,依次产出Proposal、Specs、Design、Tasks四份需求文件
90%待验证一个功能从想法到上线需要经过七步流程:需求产物生成、Auto Plan评审、TDD编码、Review审查、QA验收、SHIP发布、Archive归档
85%待验证GStack的SHIP命令会自动触发OpenSpec的Archive操作,将本次迭代的Delta规范合入主规范,完成从需求到发布再到归档的闭环
85%待验证GStack的Auto Plan模块从四个维度评审OpenSpec产物:CEO视角看商业价值、工程视角看技术可行性、设计视角看用户体验、DX视角看开发者友好度
85%待验证DeltaSpec增量变更机制将规范输出从800行压缩到250行,比传统方式短70%
70%待验证OpenSpec的Propose命令一次生成4个文件:Proposal.md、Specs、Design.md和Task.md
60%待验证OpenSpec的核心工作流包含Propose、Continue、Apply、Archive四个命令
60%待验证OpenSpec不需要API Key,纯Markdown存储在代码仓库里
60%待验证作者分析了788个使用 OpenSpec 模式的开源仓库,发现折回步骤是手动的,且没有人维护没人读的文字。
50%待验证OpenSpec 的工作流包括六个步骤:探索(/opsx:explore)、提议(/opsx:propose <name>)、审查、应用(/opsx:apply)、验证(/opsx:verify)、归档(/opsx:archive)。
50%待验证OpenSpec 的验证步骤(/opsx:verify)属于扩展工作流配置,通过 openspec config profile 启用。
50%待验证OpenSpec 归档后,增量合并进 specs/,变更文件夹移入 changes/archive/ 并加上日期前缀,规格描述系统现在的状态,归档的变更保留完整的来龙去脉。
50%待验证在 OpenSpec 的增量规格里,场景被当作需求的验收标准:ADDED Requirements 下的每条 Requirement 后跟若干 Scenario,分别覆盖正常路径、边界和异常。
50%待验证OpenSpec 不是一个需要迁移过去的新 IDE 或平台,而是仓库里的一个 Markdown 文件夹、一个小型 CLI,以及一套给代理的指令。
50%