速查卡 A · OpenSpec + Spec-Kit 命令对照表

完整原理与实战详见：OpenSpec+SpecKit 完整整理版

30 秒上手

# OpenSpec（Node.js ≥ 20.19.0）
npm install -g openspec
cd your-project && openspec init

# Spec-Kit
uv tool install specify-cli
specify init --here --ai claude-code

OpenSpec 命令表

命令 用途 分组
openspec init 项目初始化（选 IDE） 环境
openspec propose <name> 一键生成 proposal + design + spec + task 创建
openspec explore 只对话不落盘（决策型 / 开放型 / 约束型） 创建
openspec new <name> 只建目录 创建（精细化）
openspec continue [msg] 逐步生成下一份制品（proposal→design→spec→task） 创建（精细化）
openspec apply <name> 根据 spec 生成代码 实现
openspec verify <name> 三维验证（正确性 / 完整性 / 一致性） 验证
openspec archive <name> 归档到主 spec 生命周期
openspec think <name> 同步中间态但不归档（长期开发用） 生命周期
openspec onboot 官方 10–30 分钟引导教程 引导
openspec profile preview 预览完整命令文件 模式切换
openspec profile update 切换 core / custom 模式 模式切换

Spec-Kit 命令表（默认全命令模式）

命令 用途 MVP 必需
specify init --here --ai <tool> 项目初始化 ✅
/constitution 生成 / 编辑项目宪法 ✅
/specify 写需求规格 ✅
/clarify 引导式提问、盲点发现 可跳过
/plan 生成技术方案 ✅
/tasks 拆分子任务 ✅
/analyze 一致性分析 可跳过
/implement 执行代码 ✅
specify extension search 搜索插件市场 —
specify preset search 搜索主题包 —
specify preset add lean 切换到 Lean 精简模式（skill 压缩 80%+） —

概念对照

概念 OpenSpec Spec-Kit
项目宪法 openspec.yaml .specify/memory/constitution.md
需求提案 propose /specify
技术方案 内嵌 propose 生成的 design.md /plan（独立一步）
任务拆分 内嵌 propose 生成的 task.md /tasks（独立一步）
代码执行 apply /implement
一致性校验 verify + 用户自定义规则 /analyze（内置 workflow）
盲点发现 ❌（需自己 explore） /clarify
归档 archive（内置） ❌（需装 archive 扩展）
中间态 think Git 分支天然管理
默认模式 Core（3 命令） 全命令（9 命令）
精简模式切换 profile update preset add lean
插件生态 无独立市场 Extension（加法）+ Preset（替换）

三条精细化路径（OpenSpec Custom Profile）

路径 A（Core 模式，默认）：
    propose  →  一键生成全部 4 份文件

路径 B（精细化，逐步审查）：
    new                      # 只建目录
    continue "..."           # 第 1 次: 生成 proposal（可注入自定义描述）
    continue                 # 第 2 次: 生成 design
    continue                 # 第 3 次: 生成 spec
    continue                 # 第 4 次: 生成 task

路径 C（快速前进，早期版本）：
    new
    ff "<需求描述>"          # 一次性触发内部 propose 流程

该选哪条：新手 → A；工程化 → B；已弃用 → C。

Spec-Kit 完整工作流

①  /constitution     ← 项目宪法（对标 openspec.yaml）
       ↓
②  /specify          ← 写需求规格
       ↓
③  /clarify（可跳过） ← 引导式提问、盲点发现
       ↓
④  /plan             ← 生成技术方案
       ↓
⑤  /tasks            ← 按 Phase 拆分子任务
       ↓
⑥  /analyze（可跳过） ← 一致性分析
       ↓
⑦  /implement        ← 执行代码

关键差异 vs OpenSpec：Spec-Kit 每一步默认停下等人工审核（Gate）——推崇“每一步产出必须人类确认”。

选型决策树

你的情况？
├── 完全没写过项目 / 需求都提不清
│   └── 用 Spec-Kit（有 clarify 引导式提问）
│
├── 有一定技术判断力，想快速跑通 MVP
│   └── 用 OpenSpec Core 模式（4 命令搞定）
│
├── 有一定技术判断力，工程要长期迭代
│   └── 用 OpenSpec Custom Profile（7 命令精细化）
│
├── 团队协作 / 多人开发 / 强规范要求
│   └── 用 Spec-Kit（Constitution 硬约束）
│
└── 已经很懂技术，只想让 AI 少乱写
    └── 用 Superpowers（约束 Agent 行为）或干脆手写 prompt

← 返回 AI 编程