Work 详细指南 ​

当前入口是 spec-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
  |
  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 是主工作流中的实施阶段，不是固定“第三步”。已有清晰 plan、task pack 或明确实现目标时才进入。
  • Work 不是手工分支操作教程；分支、worktree 和验证命令只是执行中的工程手段。
  • Work 不应脱离计划边界直接扩大范围；scope 变了就回到 brainstorm / plan / task pack。
  • Work 完成后通常进入 Review；问题稳定解决且值得复用时再进入 Compound。

下一步 ​