OpenSpec升级1.0版本
v1.0.0 有哪些新功能
OpenSpec 1.0 标志着从实验阶段向稳定阶段的过渡。工作流程已围绕一个基于操作的系统重建,AI 能理解您项目的状态——现有的工件、可以创建的内容以及每个操作解锁的功能。
⚠️ 从 1.0 之前版本迁移
重大变更:
- 旧命令已移除 —
/openspec:proposal、/openspec:apply、/openspec:archive不再存在 - 配置文件已移除 — 特定工具的文件(
CLAUDE.md、.cursorrules、AGENTS.md、project.md)不再生成
升级方法: 运行 openspec init。您现有的工作是安全的——活跃的更改、归档的更改以及主要规格都会被保留。只有过时的配置文件会被清理(需确认)。
新功能
- 基于动作的工作流 — 用灵活的动作 取代了固定的提案 → 申请 → 存档流程。可随时编辑任何制品。制品图会自动跟踪状态。
| Command | What it does |
|---|---|
/opsx:explore | Think through ideas before committing to a change |
/opsx:new | 开始新的改变 |
/opsx:continue | Create one artifact at a time (step-through) |
/opsx:ff | Create all planning artifacts at once (fast-forward) |
/opsx:apply | 实现 tasks.md 任务 |
/opsx:verify | 验证实现与规范匹配 |
/opsx:sync | Sync delta specs to main specs |
/opsx:archive | 最终确定并归档变更 |
/opsx:bulk-archive | 一次归档多个变更 |
/opsx:onboard | Guided 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:explorehttps://github.com/Fission-AI/OpenSpec/blob/main/docs/migration-guide.md