Spec-First

Work 详细指南 ​

Claude Code 使用 /spec:work，Codex 使用 $spec-work。契约见 spec-work。

Work 是主工作流里的实施阶段。它的关键前提是：先有计划，再执行实现。

输入与输出 ​

  • 输入：计划文档
  • 输出：代码、测试与必要文档更新

Work 不应该从“空白想法”直接起步，它应该消费已经形成的 Plan artifact。

使用方式 ​

Claude Code：

bash
/spec:work docs/plans/2026-04-20-001-feat-example-plan.md

Codex：

bash
$spec-work docs/plans/2026-04-20-001-feat-example-plan.md

执行逻辑图 ​

text
用户运行 /spec:work 或 $spec-work
  |
  v
读取 plan 或 task pack，并确认 target_repo / 文件范围 / stop_if
  |
  v
检查工作区状态、测试入口、已有实现和相邻模式
  |
  v
逐个 Implementation Unit 执行最小必要改动
  |
  v
同步测试、文档、CHANGELOG 或生成资产
  |
  v
运行验证命令并处理失败
  |
  v
输出可审查 diff、测试结果和剩余风险
  |
  v
进入 spec-code-review 或 spec-doc-review

Work 真正要做的事 ​

  • 读取计划并识别 change surface
  • 依照 Implementation Units 执行
  • 运行需要的验证
  • 保持与计划边界一致

这一步的核心不是“尽快改代码”，而是“在计划边界内，把实现做实并验证掉”。

典型执行心智 ​

text
读计划
→ 明确边界
→ 实施最小必要改动
→ 运行验证
→ 准备进入 Review

当前官网不再沿用的旧说法 ​

  • Work 固定是旧五阶段里的第三步
  • Work 主要是手工分支操作教程
  • Work 可以脱离计划直接开始

现在更稳妥的口径是：

  • Work 是主工作流中的实施阶段
  • 它必须以计划为输入
  • 它与 Review、Compound 连成一条受治理链路

下一步 ​