OpenSpec — 规范驱动开发框架

一句话概括

面向 AI 编程助手的「规范驱动开发（SDD）」框架，通过 propose → apply → archive 标准化流程，让 agent 先写 spec 再实现，不再盲写代码。

解决的问题

• AI agent 拿到需求直接就开始改代码，缺乏设计阶段
• 开发过程中没有文档沉淀，项目越改越乱
• 频繁切换上下文，忘记了"为什么要做这件事"
• 重构和新增功能缺乏规范化的审查流程

核心机制与工作流

完整工作流

graph LR
    A[用户提出需求] --> B[/opsx:propose]
    B --> C[生成 proposal.md]
    C --> D[specs/ 需求与场景]
    D --> E[design.md 技术方案]
    E --> F[tasks.md 实施清单]
    F --> G[/opsx:apply]
    G --> H[分任务实现]
    H --> I[/opsx:archive]
    I --> J[归档到 archive/]
    J --> K[准备接受下一个需求]

分步骤说明

1. /opsx:propose — 用户描述想法，OpenSpec 生成完整的变更提案，包含：
   • proposal.md — 变更动机和范围
   • specs/ — 详细需求与验收场景
   • design.md — 技术实现方案
   • tasks.md — 逐项实施清单
2. /opsx:apply — 按任务清单逐项实现，agent 自主完成
3. /opsx:archive — 完成后归档变更记录，供日后回溯

扩展工作流

安装方式

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

前置依赖

• Node.js 20.19.0 或更高

初始化

cd your-project
openspec init

然后告诉 AI：/opsx:propose <你想做什么>

配置文件

openspec config profile   # 选择工作流配置
openspec update           # 应用更新

适用人群

• 使用 AI agent 做项目开发的开发者
• 团队需要规范化的变更管理流程
• 希望项目中长期保持设计和文档整洁的团队

应用场景

优缺点

设计理念

fluent not rigid | iterative not waterfall | easy not complex

OpenSpec 强调规范驱动而不是瀑布式开发，spec 是"够用就行"而不是"一步到位"。

类似项目对比

注意事项 / 坑

• 全局安装需要 Node.js 20.19+
• 初始配置需要 openspec init 一次
• 扩展工作流需手动启用：openspec config profile
• 确保 AI agent 支持 /opsx: 命令前缀

相关 Skills

• GitNexus — 代码理解 + 变更影响分析
• Superpowers — 更完整的 AI 编程方法论
• Self-Improving Agent — 配合归档信息做持续改进

来源

• GitHub：https://github.com/Fission-AI/OpenSpec
• npm：https://www.npmjs.com/package/@fission-ai/openspec
• Discord：https://discord.gg/YctCnvvshC