workflowlisted

# Team Workflow ## Session Entry 主 Claude 收到用户请求后，按以下三路判断如何启动： 1. **直接执行**（无需组队）：明确指向单一文件 / 单一角色的小型修改（改文案、调整 agent 描述、修明显笔误）、纯查询解释、单步重构。 2. **派给 `product-lead` 单角色 subagent**：需求明确但要走完整 PRD/拆分/审查/测试链路、且核心实现只动一个执行层角色时。派单语法：`Agent({subagent_type: "product-lead", description: "...", prompt: "..."})`。 3. **建 Agent Team**（多角色并行）：命中 `CLAUDE.md` "Team Mode" 节启用条件——任务涉及 ≥2 执行层角色 / 跨完整交付链路 / 用户提示含「team / 团队 / 并行 / 同时 / 多角色」等词。由用户 `/agf:team-start <feature>` 触发，或主 Claude 主动按 Team Mode 协议建立。 判断不清时按"更高路径"处理（subagent 优于直接执行；team 优于 subagent）——多一轮调度成本远低于跳过编排导致的返工。 **Headless / CI 入口**：在 CI 或脚本里以 `claude -p --agent <name> "<prompt>"` 触发某个 agent 时，CLI 会同时尊重该 agent frontmatter 的 `tools:` / `disallowedTools:`（自 2.1.119）与 `permissionMode:`，工具白名单与模式不因 headless 失效。例如 `claude -p --agent code-reviewer "review HEAD"` 直接得到该角色的工具集与 `auto` 模式。 ## Workflow 1. **Simple tasks**: 按上节"Session Entry"判定为可直接执行的请求，主 Claude 处理 2. **Complex tasks**（扁平 2 层结构）: ``` USER → [product-lead] ──技术咨询──→ [tech-lead]（顾问，按需介入） │ ├──→ [uiux-designer] ──设计标注──→ [frontend-dev] ├──→ [frontend-dev] ←─API契约──→ [backend-dev] ├──→ [backend-dev] ├──→ [ai-agent-dev] └──→ [ml-engineer] [所有执行层: 自跑 Unit + SIT 并写 progress/<role>.md] ↓ 完成报告（含 SIT 证据） [product-lead] → [code-reviewer]（代码审查 + SIT Audit）→ [qa-engineer]（E2E / UAT） ↓