01MVP

Spec Kit / OpenSpec 值得用吗?怎么快速上手?

给小项目与进阶团队的最短决策:什么时候用 Spec Kit、什么时候用 OpenSpec,以及 OpenSpec 的核心使用步骤。

先说结论:

  • 个人小项目/新手:优先轻量流程(想法 → 计划 → 执行),不必一开始就上很重的规范。
  • 多人协作/需求复杂:更建议用 OpenSpec,因为文档分层清晰、任务可追踪。
  • Spec Kit:适合强流程、强审计团队;如果你追求速度,体感会偏重。

先对齐两个概念:

  • 计划 plan → 执行”是 Codex / Claude Code 内置的开发模式,比如 Claude Code 可以 Shift + Tab 切换到 plan 模式,完成计划之后再开始执行任务。
  • OpenSpec 的核心价值,是把“计划”拆细成 proposal / specs / design / tasks 四份文档,让协作和追踪更稳定。

四个文档各自做什么(最简理解):

  1. proposal:回答“为什么做这件事、这次改动边界在哪”(老板角度)。
  2. specs:回答“用户到底要什么、验收标准是什么”(产品经理角度)。
  3. design:回答“技术上怎么落地、方案取舍是什么”(技术架构师角度)。
  4. tasks:回答“具体先做哪几步、每步的完成标准是什么”(程序员角度)。

从 OpenSpec README 提炼的“最重要怎么用”(先 init):

  1. 安装(需 Node.js 20.19.0+):npm install -g @fission-ai/openspec@latest
  2. 进入项目后先初始化:openspec init
  3. 在 Claude Code / Codex 里创建变更:/opsx:new <你要做的功能>
  4. 生成完整规划:/opsx:ff(proposal / specs / design / tasks)
  5. 执行任务:/opsx:apply
  6. 完成后归档:/opsx:archive
  7. 升级后同步指令:openspec update
最省心实践:小需求直接 new → ff → apply;改动完成后再 archive。这样既有文档约束,又不会过重。