Workflow

Workflow Runner

执行 .workflows/<name>/workflow.md 中定义的 workflow，按 stage 逐步推进，直到全部完成。用法：/workflow <name>。

协调者角色 — CRITICAL

CRITICAL: Workflow 运行期间，你是协调者，不是执行者。

当 stage 的 subagent 非空时：

• MUST 通过 Agent 工具委托
• MUST NOT 对项目源码使用 Edit/Write（stages.json 除外）
• 如果发现自己在写业务代码，立即停止，改为调用 Agent

当 subagent 为空时：自行处理（对话、协调、轻量操作）。

生命周期

1. 初始化

读取 workflow.md，解析为 stages 数组，写入 stages.json。

写入路径: ~/.talos/<workspace>/<workflowName>/$CLAUDE_CODE_SESSION_ID/stages.json

• <workspace> = 当前项目目录名（basename "$PWD"）
• 目录名直接使用 $CLAUDE_CODE_SESSION_ID（即当前会话 ID），无需额外生成
• 写入前确保目录存在

stages.json 顶层结构：

{
  "workflowName": "default",
  "title": "简短、有意义的工作流标题",
  "stages": [
    {
      "stage": -1,
      "name": "prepare 名称",
      "desc": "...",
      "status": "pending",
      "summary": null,
      "subagent": null
    },
    {
      "stage": 0,
      "name": "stage 名称",
      "desc": "...",
      "status": "pending",
      "summary": null,
      "subagent": ["agent-name"]  // 正文中 "委托 **X** agent" → ["X"]，没有则 null
    }
  ]
}

可选 prepare 章节：若 workflow.md 包含 ## prepare — <name> 开头的章节，解析为特殊条目写入 stages 数组第一项：{ "stage": -1, "name": "<name>", "desc": "<正文>", "status": "pending", "subagent": null }。prepare 的 subagent 始终为空——由协调者自行处理，不做委托。不含该章节的 workflow 不生成此条目，生命周期无变化。

title 生成规则：理解用户意图，用一句话概括本次工作流要做什么。

status 枚举值：pending（等待）、running（执行中）、skipped（跳过）、completed（完成）。

1.5 准备（仅当 prepare 条目存在时）

1. 设置 prepare 的 status 为 running，写入 stages.json。
2. 按 prepare 的 desc 描述，协调者自行执行环境准备（如：读取上下文、更新 stages.json 顶层字段、创建分支/worktree、切换目录等）。协调者在此阶段只能执行环境准备操作，不得编写业务代码。
3. 自检：验证 desc 中声明的准备产物是否就绪。
4. 通过后标记 status 为 completed，写入 summary；未通过则报告用户等待。

2. 执行循环

仅当 stages 数组中存在 stage -1 时，执行循环应在其 status 为 completed 或 skipped 后才启动。不含 prepare 的 workflow 直接从首个编号 stage 开始。

对每个 stage 按顺序执行：

1. 前置检查 — 确认上一个 stage 的 status 为 completed 或 skipped。stage 1 跳过此检查。如果上一个 stage 不满足，不继续推进，报告当前状态让用户决定。
2. 设置状态 — 进入 stage 前先将该 stage 的 status 更新为 "running"，写入 stages.json。
3. 评估跳过 — 根据 workflow.md 中该 stage 的跳过条件（"XX时跳过"）和当前上下文判断是否跳过。如果条件明确满足，标记 status: "skipped"，summary 写明跳过原因。如果不确定，问用户。
4. 宣告 — 告诉用户即将执行哪个 stage 以及执行方式（委托给哪个 agent / 自行处理）。
5. 执行 — 按宣告的方式执行该 stage。通过 Agent 工具委托时，prompt 中始终要求 subagent 先加载 memorizer skill。
6. 自检 — 重新读取当前 stage 的 desc，逐条检查完成标准是否满足。不要假设执行完就等于完成——验证产出物是否存在、是否符合 desc 的要求。
7. 更新状态 — 自检通过后，标记 status: "completed"，写入 summary。如果未通过，报告缺失内容，询问用户如何处理。

3. 完成

所有 stage 通过后：

• 向用户报告 workflow 整体完成
• 列出所有阶段产出的 artifacts 汇总

Memo

通过 Agent 工具委托 subagent 时，prompt 中始终包含：

"使用 memorizer skill 来获取记忆的读取、写入能力，在任务完成时，声明是否需要写入记忆。"

规则

• workflow.md 是唯一事实来源
• 遇到错误先报告用户再继续