Spec Kit / OpenSpec 值得用吗?怎么快速上手?
给小项目与进阶团队的最短决策:什么时候用 Spec Kit、什么时候用 OpenSpec,以及 OpenSpec 的核心使用步骤。
先说结论:
- 个人小项目/新手:优先轻量流程(想法 → 计划 → 执行),不必一开始就上很重的规范。
- 多人协作/需求复杂:更建议用 OpenSpec,因为文档分层清晰、任务可追踪。
- Spec Kit:适合强流程、强审计团队;如果你追求速度,体感会偏重。
先对齐两个概念:
- “计划 plan → 执行”是 Codex / Claude Code 内置的开发模式,比如 Claude Code 可以 Shift + Tab 切换到 plan 模式,完成计划之后再开始执行任务。
- OpenSpec 的核心价值,是把“计划”拆细成
proposal / specs / design / tasks四份文档,让协作和追踪更稳定。
四个文档各自做什么(最简理解):
proposal:回答“为什么做这件事、这次改动边界在哪”(老板角度)。specs:回答“用户到底要什么、验收标准是什么”(产品经理角度)。design:回答“技术上怎么落地、方案取舍是什么”(技术架构师角度)。tasks:回答“具体先做哪几步、每步的完成标准是什么”(程序员角度)。
从 OpenSpec README 提炼的“最重要怎么用”(先 init):
- 安装(需 Node.js
20.19.0+):npm install -g @fission-ai/openspec@latest - 进入项目后先初始化:
openspec init - 在 Claude Code / Codex 里创建变更:
/opsx:new <你要做的功能> - 生成完整规划:
/opsx:ff(proposal / specs / design / tasks) - 执行任务:
/opsx:apply - 完成后归档:
/opsx:archive - 升级后同步指令:
openspec update
最省心实践:小需求直接
new → ff → apply;改动完成后再 archive。这样既有文档约束,又不会过重。