→ 灵活而非僵化
→ 迭代而非瀑布
→ 简单而非复杂
→ 为存量项目而生，不仅仅是新项目
→ 从个人项目到企业级都适用

[!TIP] 全新工作流现已推出！ 我们用全新的 artifact 引导式工作流重构了 OpenSpec。

运行 /opsx:onboard 开始体验。→ 了解更多

团队使用

在团队中使用 OpenSpec？发送邮件 获取 Slack 频道访问权限。

实际演示

You: /opsx:new add-dark-mode
AI:  Created openspec/changes/add-dark-mode/
     Ready to create: proposal

You: /opsx:ff   # "快进" - 生成所有规划文档
AI:  ✓ proposal.md — 为什么要做，要改什么
     ✓ specs/       — requirements 和 scenarios
     ✓ design.md    — 技术方案
     ✓ tasks.md     — 实现清单
     Ready for implementation!

You: /opsx:apply
AI:  Implementing tasks...
     ✓ 1.1 Add theme context provider
     ✓ 1.2 Create toggle component
     ✓ 2.1 Add CSS variables
     ✓ 2.2 Wire up localStorage
     All tasks complete!

You: /opsx:archive
AI:  Archived to openspec/changes/archive/2025-01-23-add-dark-mode/
     Specs updated. Ready for the next feature.

快速开始

需要 Node.js 20.19.0 或更高版本。

全局安装 OpenSpec：

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

然后进入你的项目目录并初始化：

cd your-project
openspec init

现在告诉你的 AI：/opsx:new <你想构建的功能>

[!NOTE] 不确定你的工具是否支持？查看完整列表 – 我们支持 20+ 种工具且持续增加。

也支持 pnpm、yarn、bun 和 nix。查看安装选项。

文档

→ 快速入门：第一步 → 工作流：组合和模式 → 命令：斜杠命令和 skills → CLI：终端参考 → 支持的工具：工具集成和安装路径 → 概念：整体架构 → 多语言：多语言支持 → 自定义：按需定制

为什么选择 OpenSpec？

AI 编程助手功能强大，但当需求只存在于聊天历史中时，结果往往不可预测。OpenSpec 添加了一个轻量级的 spec 层，让你在编写代码之前就能与 AI 达成共识。

• 先达成共识再构建 — 人类和 AI 在编写代码前先对 spec 达成一致
• 保持有序 — 每个 change 都有自己的文件夹，包含 proposal、specs、design 和 tasks
• 灵活工作 — 随时更新任何 artifact，没有僵化的阶段门槛
• 使用你的工具 — 通过斜杠命令支持 20+ 种 AI 助手

对比其他方案

vs. Spec Kit (GitHub) — 全面但重量级。僵化的阶段门槛，大量 Markdown，需要 Python 环境。OpenSpec 更轻量，让你自由迭代。

vs. Kiro (AWS) — 功能强大但被锁定在他们的 IDE 中，且仅限 Claude 模型。OpenSpec 与你已有的工具配合使用。

vs. 什么都不用 — 没有 spec 的 AI 编程意味着模糊的提示和不可预测的结果。OpenSpec 带来可预测性，而无需繁琐的流程。

更新 OpenSpec

升级包

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

刷新 agent 指令

在每个项目中运行此命令以重新生成 AI 指导并确保最新的斜杠命令生效：

openspec update

使用说明

模型选择：OpenSpec 在高推理能力模型上效果最佳。我们推荐 Opus 4.5 和 GPT 5.2 用于规划和实现。

上下文管理：OpenSpec 受益于干净的上下文窗口。在开始实现前清理上下文，并在整个会话中保持良好的上下文管理。

贡献

小修复 — Bug 修复、拼写纠正和小改进可以直接提交 PR。

较大改动 — 对于新功能、重大重构或架构变更，请先提交 OpenSpec change proposal，以便我们在实现前就意图和目标达成一致。

编写 proposal 时，请牢记 OpenSpec 的理念：我们服务于使用不同编程 agent、模型和用例的广泛用户群。改动应该对所有人都适用。

欢迎 AI 生成的代码 — 只要经过测试和验证。包含 AI 生成代码的 PR 应注明使用的编程 agent 和模型（例如，"使用 Claude Code 和 claude-opus-4-5-20251101 生成"）。

开发

• 安装依赖：pnpm install
• 构建：pnpm run build
• 测试：pnpm test
• 本地开发 CLI：pnpm run dev 或 pnpm run dev:cli
• 约定式提交（单行）：type(scope): subject

其他

OpenSpec 收集匿名使用统计。

我们仅收集命令名称和版本以了解使用模式。不收集参数、路径、内容或个人身份信息。在 CI 环境中自动禁用。

退出方式： export OPENSPEC_TELEMETRY=0 或 export DO_NOT_TRACK=1

查看 MAINTAINERS.md 了解核心维护者和帮助指导项目的顾问列表。

License

MIT