日常学习资料

Appearance

Return to top
On this page

OpenSpec — AI 编程助手按规范开发，而不是瞎猜

是什么

OpenSpec 是一个规范驱动开发（Spec-Driven Development, SDD）框架，让 AI 编程助手在写代码之前先达成共识，再按规范实现。

  • GitHub： github.com/Fission-AI/OpenSpec
  • 官网： openspec.dev
  • 作者： Fission AI（创始人 @0xTab）
  • 定位： 轻量、可移植的规范驱动框架，非 IDE 绑定，支持 30+ AI 编程工具
  • License： MIT
  • Stars： 28k+（2026年2月）

不是什么

  • 不是 IDE 或编码代理，而是一个规范层（spec layer）
  • 不是规约工具，不做类型检查或验证
  • 不是项目管理工具，不替代 Jira / Linear
  • 没有"阶段门控"（phase gates），允许随时修改任意 artifact
  • 不绑定模型，不绑定工具链

解决啥

痛点方案
AI 编程助手经常误解需求，写出来不是你要的propose 阶段先产出规范文档，人和 AI 对齐再动手
新会话丢失上下文，每次都要重新解释规范文件存在代码库中（Git 管理），跨会话持久化
AI "顺手"做了你不让做的事tasks.md 任务清单约束 AI 不越界
多人协作，新人看不懂系统设计archived specs 记录每次变更的动机和技术方案
需求在聊天记录中，不可追溯每个变更是一个独立文件夹（proposal + specs + design + tasks）
代码评审只看实现，难以理解变更意图spec delta 提供需求级 diff，评审意图而非只评审代码

好在哪

能力说明
跨会话持久化specs 存为文件，新会话直接读取，无需重复解释
工具无关支持 Claude Code / Cursor / Copilot / Windsurf / Gemini CLI 等 30+ 工具
迭代而非瀑布可随时修改任意 artifact，无阶段门控
适配棕地项目/opsx:onboard 扫描已有代码自动生成 specs
轻量只需 Node.js 20.19+，npm 安装，openspec init 即用
Git 友好全部是 Markdown 文件，天然适合版本管理
开源 MIT无商业锁定
  • 对比 Spec Kit（GitHub）：更轻量、无阶段门控、不用 Python
  • 对比 Kiro（AWS）：不绑定 IDE 和模型
  • 对比 "裸用 AI"：增加了预测性和可追溯性

怎么跑

安装

bash
# 需要 Node.js 20.19+
npm install -g @fission-ai/openspec@latest

在项目中初始化

bash
cd your-project
openspec init

会自动创建 openspec/ 目录，并在项目中注册斜杠命令。

⚡OPSX 新版工作流（推荐）

核心三个命令：

bash
# Step 1：提出变更
# 告诉 AI 你想做什么，它会生成 proposal + specs + design + tasks
/opsx:propose 添加暗色主题

# Step 2：按规范实现
# AI 按照 tasks.md 逐项实现，不做多余的事
/opsx:apply

# Step 3：归档记录
# 完成的工作归档到 openspec/changes/archive/
/opsx:archive

🧠 Classic 工作流（斜杠命令）

如果开启经典模式，有更多命令可用：

命令作用
/opsx:continue恢复未完成的工作
/opsx:ff快速实现（跳过确认）
/opsx:verify验证任务是否全部完成
/opsx:sync代码改了但 specs 没更新时同步
/opsx:bulk-archive批量归档多个完成项
/opsx:onboard扫描现有代码生成初始 specs

更新

bash
# 更新全局 CLI
npm install -g @fission-ai/openspec@latest

# 刷新项目中的 AI 指令
openspec update

AI 工具集成

OpenSpec 通过斜杠命令集成到以下工具（部分示例）：

  • Claude Code — 原生支持
  • Cursor — .cursor/rules 注册
  • GitHub Copilot — Copilot Chat 集成
  • Windsurf / Codex / Gemini CLI — 同样支持

任何能读文件和处理斜杠命令的 AI 工具都可以使用。

怎么用

  • 个人项目：防止每次新会话重头解释，保持 AI 上下文的连续性
  • 多人协作：新成员通过 openspec/specs/ 快速了解系统设计决策
  • 棕地项目：用 /opsx:onboard 扫描已有代码库，自动生成初始规范
  • 需求变更追踪：每次变更都有完整的 proposal → design → tasks 记录，可回溯
  • 代码评审：评审时同时看 spec delta（需求级 diff）和 code diff，全方位理解变更

延伸资源

by 文殊