Spec-First

快速开始 ​

本页展示从安装到首次进入 spec-first workflow runtime 的最短路径。当前主路径不再是旧的 stage0-context，而是 CLI 初始化后在宿主中运行 setup 与 graph bootstrap。

1. 安装并检查 CLI ​

bash
npm install -g spec-first
spec-first doctor

2. 按宿主初始化项目 ​

bash
# Claude Code 项目
spec-first init --claude -u <name> --lang zh

# Codex 项目
spec-first init --codex -u <name> --lang zh

同一个仓库同时使用 Claude Code 与 Codex 时，可以分别运行两条 init。

3. 重启宿主并完成 readiness ​

步骤Claude CodeCodex
宿主 setup/spec:mcp-setup$spec-mcp-setup
Graph bootstrap/spec:graph-bootstrap$spec-graph-bootstrap
Project standards/spec:standards$spec-standards
更新 runtime/spec:update$spec-update

setup workflow 负责安装并验证 MCP servers、graph-provider MCP servers、helper CLIs 和项目 setup facts。graph bootstrap workflow 在 setup ready 后编译 canonical graph 与 impact readiness artifacts。standards workflow 可选，用于在 brownfield 或团队协作项目中建立项目规范与 glue capability baseline。

4. 进入工作流 ​

意图Claude CodeCodex
生成和筛选想法/spec:ideate$spec-ideate
编译项目规范与 glue baseline/spec:standards$spec-standards
澄清需求/spec:brainstorm$spec-brainstorm
写计划/spec:plan$spec-plan
编译 task packstandalone write-tasks skillstandalone write-tasks skill
执行实现/spec:work$spec-work
调试问题/spec:debug$spec-debug
代码评审/spec:code-review$spec-code-review
文档/计划评审/spec:doc-review$spec-doc-review
移动 App 静态一致性审查/spec:app-consistency-audit$spec-app-consistency-audit
Skill 质量与治理审计/spec:skill-audit$spec-skill-audit
知识沉淀/spec:compound$spec-compound

5. 验证 task pack ​

当 plan 被拆成 task pack 后，可以用 package CLI 做确定性校验：

bash
spec-first tasks hash docs/plans/<plan>.md
spec-first tasks validate .spec-first/tasks/<task-pack>.json --repo .

CLI 校验结构和 hash；具体实现取舍、测试判断和 review 结论仍由宿主 workflow 与 LLM 完成。

推荐第一条路径 ​

  1. spec-first doctor
  2. spec-first init --claude -u <name> --lang zh 或 spec-first init --codex -u <name> --lang zh
  3. 重启宿主
  4. 运行当前宿主的 setup workflow
  5. setup ready 后运行 graph bootstrap
  6. 复杂 brownfield 项目可先运行 standards，再用 brainstorm/plan/work/review 进入具体任务；移动 App 或 skill 维护场景再插入 app-consistency-audit 或 skill-audit

下一步 ​