什么是 Spec-First
Spec-First 是面向 Claude Code 与 Codex 的 Node.js CLI + workflow asset package。它不是单纯的方法论文章，也不是只靠 prompt 模板维持的开发习惯，而是一套可以安装到项目里的 workflow runtime。
核心定位
Spec-First 负责确定性部分：
- 检查环境与 managed runtime assets：
spec-first doctor - 初始化或清理宿主运行时：
spec-first init --claude|--codex、spec-first clean --claude|--codex - 交付 host-specific workflow assets：Claude Code 使用
/spec:*，Codex 使用$spec-* - 校验 task-pack hash 与结构：
spec-first tasks hash、spec-first tasks validate - 通过 setup 与 graph bootstrap 形成 readiness facts
- 通过 App audit、skill audit 和 task-pack 校验提升专项 review 输入质量
LLM 仍负责语义判断：需求取舍、方案设计、实现细节、评审结论和质量判断不会被 CLI 硬编码。
它解决什么问题
临时 prompt 可以启动一次对话，但很难稳定支撑长期工程：
- 上下文依赖个人记忆，换会话后容易断裂
- 需求、计划、实现、评审之间缺少可检查的边界
- agent 能力分散，入口和责任不清晰
- 经验沉淀难以回流到下一轮任务
Spec-First 把这些能力变成项目级 runtime：入口可安装、资产可更新、readiness 可检查、task-pack 可验证、经验可沉淀。
产品组成层
| 层级 | 作用 |
|---|---|
| CLI 层 | 安装、初始化、清理、doctor、task-pack hash/validate |
| Runtime 资产层 | workflow skills、commands、agents、templates 和 host-specific copies |
| Workflow 治理层 | brainstorm、plan、work、debug、code-review、doc-review、app-consistency-audit、skill-audit、compound 等宿主入口 |
这是 Spec-First 自身的产品组成。要理解 Spec-First 在 AI 工程方法论中的位置（Prompt / Context / Harness Engineering），见 三层工程模型。
不会做的事
- 不替代 Claude Code 或 Codex（宿主级体验由它们提供）
- 不替代 RAG / MCP servers（Context Engineering 工具）
- 不接管现有工具链（不强制使用某个测试框架、构建工具或 CI）
- 不依赖外部 SaaS（runtime 全部 repo-local）
- 不让 LLM 跑
npm install、git push等改变环境的脚本（CLI 拥有这些） - 不让脚本替代设计决策（scope / 方案 / 评审由 LLM 与人类完成）