workflow

用途

Workflow 用于创建和执行位于 agent-team 之上的控制器侧交付工作流。它让工作流模板保持可复用，让运行状态与模板分离，并使用本仓库中基于 Go 的 agent-team 工作流辅助工具完成模板生成、校验和运行状态持久化。

主要能力

• 创建项目本地的工作流模板，默认路径为 .agents/workflow/<workflow-name>.yaml。
• 运行或恢复工作流，运行状态文件默认路径为 .agents/workflow/runs/<workflow-name>/<run-id>.yaml。
• 提供三种预设：branching（控制器分发，含显式 dev_first / test_first）、dev-first（先实现后验证的线性循环）、test-first（先测试后实现）。
• 通过 agent-team workflow create 生成模板，通过 agent-team workflow validate 立即校验。
• 通过 agent-team workflow state init|show|start|wait|block|complete|confirm 初始化、查看和更新运行状态。
• 在运行时将工作流角色别名解析为具体 worker，并使用 agent-team worker create、agent-team worker open、agent-team worker assign、agent-team worker merge 等命令进行编排。

使用方式

创建流程：先确认存在经批准的头脑风暴/设计产物；若没有，则停止并先调用 brainstorming。然后选择与设计匹配的最小预设，生成模板并立即校验，最后总结生成的角色、入口节点、分支和输出路径。示例：

agent-team workflow create feature-delivery \
  --preset branching \
  --output .agents/workflow/feature-delivery.yaml

agent-team workflow validate .agents/workflow/feature-delivery.yaml

运行流程：先校验工作流模板；若非恢复已有运行，则用 agent-team workflow state init 初始化运行状态；在运行时解析每个角色别名到具体 worker；创建或复用 worker；执行当前节点后用 agent-team workflow state ... 持久化状态；在 worker 等待状态、worker 主动回复、结果不明确或控制器确认时暂停；恢复时读取运行状态文件并从 current_node 继续。示例引导：

agent-team workflow validate .agents/workflow/feature-delivery.yaml
agent-team workflow state init .agents/workflow/feature-delivery.yaml

执行循环：读取模板与当前运行状态；用 agent-team workflow state start 启动当前节点；执行节点动作（controller_task、assign_role_task、wait_for_completion、decision、handoff、verify_or_test、merge）；持久化 wait、block、complete 或 confirm 结果；当运行状态变为 completed 或 blocked 时停止。

默认等待协议：在 assign_role_task 之后，将运行持久化为 waiting 并停止主动状态轮询；正常的下一个信号是 worker 主动发送的 agent-team reply-main "<message>"；不要将 agent-team worker status 作为 wait_for_completion 的默认驱动，仅在分配失败诊断、超时或无回复调查、或用户明确要求状态快照时使用。

Worker 准备：在第一个角色支撑节点执行前，确认每个引用的角色在本地存在或可安装；若角色缺失且必须创建，遵循 role-creator 契约而非手动编写角色文件；确认是复用现有 worker 还是为每个角色别名创建新 worker；在分配前打开 worker 会话，以便回复能流回控制器。

确认与分支：将 requires_confirmation: true 视为硬暂停；当 worker 反馈不明确时不要自动选择分支；优先使用工作流定义的分支标签，如 test_first、dev_first、passed、failed；仅在控制器明确要求重试时重新运行已完成节点；使用 agent-team workflow state confirm 确定性地解决确认节点。

适用场景

适用于需要以主控制器身份编排 agent-team 交付流程的场景，例如创建可复用的项目交付工作流模板、运行或恢复工作流、检查工作流进度，以及在多角色之间进行任务分配、等待、确认、分支和合并。

限制

• 只能作为主控制器使用，不得在 worker 会话内使用此技能。
• 不得修改 agent-team 源代码、配置模式或内部协议。
• 编写新工作流文件前必须已有经批准的头脑风暴/设计产物。
• 模板文件与运行状态文件必须始终分开。
• 只能使用已有的 agent-team 命令作为执行后端。
• 每次节点转换后以及每次暂停或确认门之前都必须持久化状态。
• 其他未在资料中明确说明的功能、收费、价格、平台或效果暂未提供。