Skip to content

OpenSpec升级1.0版本

v1.0.0 有哪些新功能

OpenSpec 1.0 标志着从实验阶段向稳定阶段的过渡。工作流程已围绕一个基于操作的系统重建,AI 能理解您项目的状态——现有的工件、可以创建的内容以及每个操作解锁的功能。

⚠️ 从 1.0 之前版本迁移

重大变更:

  • 旧命令已移除 — /openspec:proposal/openspec:apply/openspec:archive 不再存在
  • 配置文件已移除 — 特定工具的文件(CLAUDE.md.cursorrulesAGENTS.mdproject.md)不再生成

升级方法: 运行 openspec init。您现有的工作是安全的——活跃的更改、归档的更改以及主要规格都会被保留。只有过时的配置文件会被清理(需确认)。


新功能

  • 基于动作的工作流 — 用灵活的动作 取代了固定的提案 → 申请 → 存档流程。可随时编辑任何制品。制品图会自动跟踪状态。
CommandWhat it does
/opsx:exploreThink through ideas before committing to a change
/opsx:new开始新的改变
/opsx:continueCreate one artifact at a time (step-through)
/opsx:ffCreate all planning artifacts at once (fast-forward)
/opsx:apply实现 tasks.md 任务
/opsx:verify验证实现与规范匹配
/opsx:syncSync delta specs to main specs
/opsx:archive最终确定并归档变更
/opsx:bulk-archive一次归档多个变更
/opsx:onboardGuided 15-minute walkthrough of complete workflow
  • - 动态指令 — AI 指令现在由三层组成:上下文(你的技术栈)、规则(工件特定约束)和模板(输出结构)。AI 不再接收静态提示,而是查询 CLI 获取实时状态。

  • 语义规格同步 — Delta 规格使用类似 ## ADDED Requirements## MODIFIED Requirements 的标记。Archive 在需求级别解析这些标记,而不是依赖脆弱的标题匹配。

  • 代理技能 — 单个 .claude/skills/ 目录取代了 8 个以上分散的配置文件。YAML 前置的 Markdown 文件可在 Claude Code、Cursor 和 Windsurf 中使用。

  • 入职技能/opsx:onboard 引导新用户完成他们的第一次完整变更,并提供与代码库相关的任务建议。共有 11 个阶段,约 15 分钟。

  • 交互式设置openspec init 显示动画欢迎界面,并提供可搜索的多选工具列表。已配置的工具会被预先选择,方便快速刷新。

  • 支持 21 种 AI 工具 — Claude Code、Cursor、Windsurf、Continue、Gemini CLI、GitHub Copilot、Amazon Q、Cline、RooCode、Kilo Code、Auggie、CodeBuddy、Qoder、Qwen、CoStrict、Crush、Factory、OpenCode、Antigravity、iFlow 和 Codex。

  • 自定义模式 — 可在 openspec/schemas/ 中定义自定义工件工作流,无需修改包代码。

Fixed

  • Claude Code YAML parsing failure when command names contained colons
  • Task file parsing to handle trailing whitespace on checkbox lines
  • JSON instruction output now separates context/rules from template (AI was copying constraint blocks into artifact files)

迁移 project.md 到 config.yaml

上下文出现在所有工件中;规则仅出现在匹配工件中

命令映射

遗产OPSX等效产品
/openspec:proposal/opsx:new/opsx:ff
/openspec:apply/opsx:apply
/openspec:archive/opsx:archive

新功能

颗粒文物制作:

/opsx:continue

基于依赖,一次创建一个工件。当你想复习每一步时,可以使用这个。

探索模式:

/opsx:explore

https://github.com/Fission-AI/OpenSpec/blob/main/docs/migration-guide.md

最近更新