跳到主要内容

Spec-First Runbook

前置条件​

  • 任务已经不是简单 bugfix，而是需要明确方案和阶段。
  • 你能写清输入、输出、边界和验收。
  • 团队接受先写 spec 再执行。

执行表​

阶段要做什么产出
定目标写目标、非目标、验收。最小 spec。
拆阶段按阶段定义产物和验证。阶段计划。
进执行选择执行入口并推进第一阶段。第一阶段结果。
阶段复盘验证结果并决定是否继续。下一阶段决策。

步骤​

  1. 先写最小 spec：目标、范围、不要做什么、验收。
  2. 再拆阶段，每阶段只定义一个清晰产物。
  3. 选择执行入口，例如 OpenAI Codex 快速开始 或 Cursor 快速开始。
  4. 每推进一阶段就跑一次验证，并决定是否继续。
  5. 阶段结束后把结果写回 spec、PR 或任务系统，不让 spec 和执行脱节。

默认停点​

  • 目标和非目标还没分清，先停，不进执行。
  • 某阶段没有清晰产物和验证，先停，补阶段定义。
  • 执行过程中发现边界变化，先停，回 spec 更新合同。

验证​

  • spec 是否足够驱动下一步执行。
  • 每阶段是否有清晰产物和验证方式。
  • review 人是否能直接看懂为什么这样拆。
  • 阶段推进是否真的降低了返工风险。

交付检查​

  • 这份 spec 是否已经能服务 owner、执行者和 reviewer。
  • 阶段之间是否真的做到“先定界再推进”。
  • 中途暂停时，是否仍然能顺畅交接。
  • 如果任务已经降级成小步维护，是否准备切回 Bugfix / Refactor / Test Runbook。

下一步​

来源​