更轻量化的规范驱动编程
上手使用
安装及项目初始化
安装 openspec cli 工具：
npm install -g @fission-ai/openspec@latest在项目目录下初始化配置并按照指示选择使用的开发 Agent 工具（执行前可先提交保存好项目记忆 md 文件如 CLAUDE.md，此命令会覆盖项目记忆文件）：
openspec init项目配置安装后，openspec 会提示后续使用介绍：
Info
Populate your project context: “Please read openspec/project.md and help me fill it out with details about my project, tech stack, and conventions”
Create your first change proposal: “I want to add [YOUR FEATURE HERE]. Please create an OpenSpec change proposal for this feature”
Learn the OpenSpec workflow: “Please explain the OpenSpec workflow from openspec/AGENTS.md and how I should work with you on this project”
上面内容介绍了三种操作：
- 初始化项目信息：阅读
openspec/project.md并在其中填写项目具体相关信息，包括项目信息、技术栈、项目规范 - 提出变更提案：为 xxx 需求创建 OpenSpec 变更提案(change proposal)
- 了解如何使用 OpenSpec 工作流：阅读
openspec/AGENTS.md并介绍 OpenSpec 工作流，以及我应该如何与你在项目中协作
OpenCode 使用
OpenSpec 提供了几个命令：
/openspec-proposal: 提出新功能变更，进行方案设计/openspec-apply: 同意方案设计，开始实现代码/openspec-archive: 功能开发完成，归档
目录结构：
openspec/
├── specs/
│ └── auth/
│ └── spec.md # Current auth spec (if exists)
└── changes/
└── add-2fa/ # AI creates this entire structure
├── proposal.md # Why and what changes
├── tasks.md # Implementation checklist
├── design.md # Technical decisions (optional)
└── specs/
└── auth/
└── spec.md # Delta showing additions
命令行
openspec list # View active change folders
openspec view # Interactive dashboard of specs and changes
openspec show <change> # Display change details (proposal, tasks, spec updates)
openspec validate <change> # Check spec formatting and structure
openspec archive <change> [--yes|-y] # Move a completed change into archive/ (non-interactive with --yes)