为什么选择 OpenSpec
AI 编码助手非常强大，但当需求只存在于聊天历史中时，它们也是不可预测的。OpenSpec 添加了一个轻量级的规范层，让你在编写任何代码之前就构建内容达成一致。
问题
AI 编码存在几个关键挑战：
- 模糊的需求 - AI 不清楚你到底想要什么
- 缺乏跟踪 - 随着对话进行，需求可能改变但没有记录
- 无法审查 - AI 生成的代码难以审查和验证
- 上下文混乱 - 长对话导致上下文污染
解决方案
OpenSpec 通过以下几个特性解决这些问题：
| 特性 | 说明 |
|---|---|
| Agree before you build | 在编写代码之前，人类和 AI 就规范达成一致 |
| Stay organized | 每个变更都有自己的文件夹，包含提案、规范、设计和任务 |
| Work fluidly | 随时更新任何工件，没有僵化的阶段门 |
| Use your tools | 通过 slash 命令支持 20+ AI 助手 |
vs 竞品
vs Spec Kit (GitHub)
| 特性 | Spec Kit | OpenSpec |
|---|---|---|
| 完整性 | 全面但繁重 | 轻量级 |
| 灵活性 | 僵化的阶段门 | 自由迭代 |
| 设置 | Python 设置 | npm 初始化 |
| 工作流 | 线性流程 | 灵活流动 |
vs Kiro (AWS)
| 特性 | Kiro | OpenSpec |
|---|---|---|
| IDE | 仅限其自己的 IDE | 任何支持 slash 命令的 IDE |
| 模型 | 仅限 Claude 模型 | 任何模型 |
| 工具 | 限时工具 | 你已有的工具 |
vs 没有规范
| 挑战 | 没有规范 | OpenSpec |
|---|---|---|
| 结果可预测性 | 模糊的提示和不可预测的结果 | 清晰的规范和可预测的结果 |
| 代码审查 | 难以审查 | 可审查的工件 |
| 追溯性 | 聊天历史 | 结构化的变更历史 |
核心优势
- 可预测性 - 通过规范确保结果可预测
- 可审查性 - 每个变更都是可审查的
- 可追溯性 - 清晰的变更历史记录
- 灵活性 - 可以在任何时间更新任何工件
- 兼容性 - 与你现有的 AI 助手兼容
吸引谁
- 追求质量的开发者 - 希望代码符合规范
- 团队协作 - 需要一致的开发流程
- 代码审查者 - 需要可审查的变更
- 项目维护者 - 需要清晰的变更历史
开始使用
开始使用 OpenSpec 只需要几个步骤：
npm install -g @fission-ai/openspec@latest
cd your-project
openspec init
/opsx:propose your-idea