15 minute read

面向 AI 的规格驱动开发框架 OpenSpec 迎来 1.2.0 版本，新增配置文件系统、一站式提案工作流、AI 工具自动检测，以及 Pi、Kiro 两大新工具支持。

写在前面

OpenSpec 是一款面向 AI 的规格驱动开发框架，帮助你与 AI 在写代码之前先就「要做什么」达成一致。无论是 Cursor、Claude Code、Windsurf，还是 GitHub Copilot、Amazon Q，OpenSpec 支持 20+ 主流 AI 编程工具，让你的需求规格可追踪、可迭代。

本次 1.2.0 版本聚焦三件事：更灵活的工作流选择、更顺畅的初始化体验，以及 更多工具的接入。

一、配置文件系统：按需安装，按需启用

以前，OpenSpec 会为所有工作流生成命令和技能文件，项目里可能堆积不少你不常用甚至不用的内容。

现在，1.2.0 引入 配置文件系统（Profile）：

  • core — 4 个核心工作流（propose、explore、apply、archive），适合快速上手和日常使用
  • custom — 自由选择任意工作流子集，完全按需配置

通过新命令 openspec config profile 可以随时切换和管理当前使用的配置。想精简项目时，再也不用自己删来删去。

Demo 1：查看当前配置

$ openspec config list

输出示例：

Profile settings:
  profile: core (default)
  delivery: both (default)
  workflows: propose, explore, apply, archive (from core profile)

当全局配置与当前项目不一致时，还会看到 配置漂移警告，提醒你运行 openspec update 同步。

Demo 2：一键切换到 core preset

如果你之前自定义过工作流，想快速回归「精简模式」，可以用 preset 快捷键：

$ openspec config profile core
Config updated. Run `openspec update` in your projects to apply.

这会立即将工作流集合重置为 core 的 4 个：propose、explore、apply、archive，并保留你之前的 delivery 设置（skills/commands/both）。

Demo 3：交互式配置向导

运行 openspec config profile 不带参数，会进入交互式配置向导：

$ openspec config profile

第一步：选择要改什么

? What would you like to change?
  > Change delivery + workflows     # 同时改「安装方式」和「工作流」
    Change delivery only            # 只改安装方式
    Change workflows only           # 只改工作流
    Keep current settings           # 退出，不修改

第二步（若选 delivery）：选择安装方式

? Delivery mode (how workflows are installed):
  > Both (skills + commands) [current]   # 同时安装 skills 和 slash 命令
    Skills only                          # 只安装 skills（如 .claude/skills/）
    Commands only                        # 只安装 slash 命令（如 .cursor/ 等）

第三步（若选 workflows）：勾选工作流

? Select workflows (space to toggle, enter to confirm):
  [x] propose       # 一步创建完整提案（核心）
  [x] explore       # 探索与调研（核心）
  [ ] new           # 新建变更目录
  [ ] continue      # 逐步创建单个 artifact
  [x] apply         # 实施任务（核心）
  [ ] ff            # 一次性创建所有 planning artifacts
  [ ] sync          # 同步 delta specs 到 main specs
  [x] archive       # 归档已完成变更（核心）
  [ ] bulk-archive  # 批量归档
  [ ] verify        # 验证实现是否符合规格
  [ ] onboard       # 15 分钟引导式入门

空格切换勾选，回车确认。选中的工作流会在下次 openspec update 时写入项目；未选中的会被移除。

Demo 4：在项目内配置时自动应用

如果你在已初始化的 OpenSpec 项目目录下运行 openspec config profile，保存配置后会提示：

Config updated. Run `openspec update` in your projects to apply.

Apply to this project now? (y/n)

输入 y 会立即执行 openspec update，把新配置应用到当前项目，无需再手动跑一遍。

可用工作流一览

工作流 说明 core 预设
propose 一步创建完整提案 ✓
explore 探索与调研 ✓
apply 实施任务 ✓
archive 归档已完成变更 ✓
new 新建变更目录  
continue 逐步创建单个 artifact  
ff 一次性创建所有 planning artifacts  
sync 同步 delta specs  
bulk-archive 批量归档  
verify 验证实现是否符合规格  
onboard 引导式入门  

二、Propose 工作流：一步完成设计、规格与任务

过去，要完成「新需求 → 设计 → 规格 → 任务」通常需要先跑 new，再跑 ff，两步操作。

1.2.0 新增 Propose 工作流：一次请求即可生成完整的变更提案，包括：

  • 设计说明
  • 规格文档
  • 实施任务

无需在 new 和 ff 之间来回切换，更适合「先想清楚再动手」的节奏。

三、AI 工具自动检测：初始化更省心

在新项目中运行 openspec init 时，OpenSpec 会自动扫描项目中的工具目录，例如：

  • .claude/
  • .cursor/
  • 等等

已检测到的工具会被预先勾选，你不用再一一回忆自己装了哪些 AI 工具，初始化过程更顺畅。

四、两大新工具：Pi 与 Kiro

1.2.0 新增对两个 AI 编程工具的支持：

Pi（pi.dev）

Pi 编程助手现已作为正式支持的工具，可生成对应的 prompt 和 skill 配置。

Kiro（AWS Kiro IDE）

AWS Kiro IDE 也已纳入支持，同样支持 prompt 和 skill 生成。

如果你在使用 Pi 或 Kiro，现在可以直接用 OpenSpec 管理规格与工作流。

五、同步行为优化：取消选择即清理

openspec update 的同步逻辑有了重要调整：

当你取消选择某个工作流时，对应的工作流命令文件和技能目录会被删除。

项目结构会随你的配置自动保持干净，不会留下废弃文件。

六、配置漂移提醒

运行 openspec config list 时，如果全局配置与当前项目不一致，会给出 配置漂移警告。

帮助你及时发现「项目配置」和「全局配置」的差异，避免因配置不同步导致的意外行为。

七、Bug 修复一览

1.2.0 还包含多项修复，提升稳定性和跨平台体验：

问题 修复说明
onboarding 预检误报 修复了在刚初始化完成的项目上，预检错误提示「未初始化」的问题
archive 中途中断 修复了 archive 工作流在同步时中途停止的问题，现在会在同步完成后正确继续
Windows 兼容性 为 onboarding 中的 shell 命令补充了 PowerShell 替代方案，Windows 用户体验更完整

如何升级

1. 升级包

npm install -g @fission-ai/openspec@latest

2. 刷新项目中的 AI 指令

在每个已使用 OpenSpec 的项目中执行：

openspec update

小结

OpenSpec 1.2.0 的核心变化可以概括为：

  • 更灵活 — 通过 Profile 按需选择工作流，项目更精简
  • 更顺畅 — Propose 一步生成提案，init 自动检测工具
  • 更兼容 — 新增 Pi、Kiro 支持，并修复多项跨平台问题

如果你已经在用 OpenSpec，建议尽快升级；如果还没尝试，1.2.0 会是一个很好的起点。

OpenSpec 是 Fission AI 的开源项目，遵循 MIT 协议。

GitHub: github.com/Fission-AI/OpenSpec

Discord: discord.gg/YctCnvvshC