# 计划团队统一的团队技能：规划和执行基于问题的开发流程。基于 **团队工作人员代理架构** 构建 - 所有工作人员角色共享一个代理定义，并从 Markdown 规范加载特定于角色的第 2-4 阶段。 > **注意**：该技能有自己的协调器实现（`roles/coordinator/role.md`），独立于`team-lifecycle`。它遵循相同的 v5 架构模式（团队工作代理、角色规范、生成和停止），但具有专为计划和执行工作流程量身定制的简化的 2 角色管道（计划者 + 执行者）。 ## 架构 ┌──────────────────────────────────────────────┐ │ Skill(skill="team-planex", args="需求描述") │ └──────────────────┬──────────────────────────┘ │ 总是 → 协调员 ↓ ┌────────────┐ │ 协调器 │ 阶段 1-5 + 调度/监控命令 └────┬──────┬────┘ │ │ ↓ ↓ ┌──────────┐ ┌──────────┐ │ 策划者 │ 执行者 │ 团队合作者 │ PLAN-* │ │ EXEC-* │ 带角色规范注入 └──────────┘ └──────────┘ ## 角色路由器此技能**仅限协调员**。工作人员不会调用此技能 - 他们直接作为“团队工作人员”代理产生。 ### 输入解析解析“$ARGUMENTS”。不需要“--role”——总是路由到协调器。可选标志：`--exec`（执行方法），`-y`/`--yes`（自动模式）。 ### 角色注册表角色 |规格|任务前缀 |类型 |内循环 ---|---|---|---|--- 协调员| [roles/coordinator/role.md]() | （无）|协调器| - 策划师| [role-specs/planner.md]() |计划-* |管道|真实执行人| [role-specs/executor.md]() |执行-* |管道|真实 ### 调度始终路由至协调器。协调器读取“roles/coordinator/role.md”并执行其阶段。 ### 编排模式用户提供任务描述。 **调用** ：`技能（skill =“team-planex”，args =“<任务描述>”）` **生命周期**：用户提供任务描述 -> 协调器阶段 1-3：解析输入 -> TeamCreate -> 创建任务链（调度） -> 协调器第 4 阶段：spawn planner 工作人员（后台）-> 停止 -> Worker（团队工作代理）执行 -> SendMessage 回调 -> 协调器前进 -> 循环直到管道完成 -> 第 5 阶段报告 + 完成操作 **用户命令**（唤醒暂停的协调器）：命令 |行动 ---|--- `检查` / `状态` |输出执行状态图，无进展 `继续` / `继续` |检查工人状态，推进下一步 `添加 ` |将新任务追加到计划器队列 ** ** ## 命令执行协议当协调器需要执行命令（调度、监控）时： 1. **读取命令文件** : `roles/coordinator/commands/.md` 2. **遵循命令文件中定义的工作流程**（阶段2-4结构） 3. **命令是内联执行指南** \- 不是单独的代理或子流程 4. **同步执行** \- 完成命令工作流程后再继续 ** ** ## 输入类型支持3种输入方式：输入类型 | 格式 | 效果 ---|---|--- 问题 ID | 直接确定ID | `ISS-20260215-001 ISS-20260215-002` 文本需求 | `--文本'...'` | `--text '实现用户认证模块'` 计划文件 | `--计划路径` | `--计划计划/2026-02-15-auth.md` ## 执行方法选择支持2种执行：执行人| 联系人 | 适用场景 ---|---|--- `法典` | `ccw cli --tool codex --mode write` | 复杂任务、后台执行 `双子座` | `ccw cli --tool gemini --mode write` | 分析类任务、后台执行 ### 选择决策表状况 |执行方法 ---|--- `--exec=codex` 指定 |法典 `--exec=gemini` 指定 |双子座存在“-y”或“--yes”标志 |自动（默认 Gemini）无标志（交互式）| AskUserQuestion -> 用户选择自动 + 任务计数 <= 3 |双子座自动 + 任务计数 > 3 |法典 ** ** ## 协调器生成模板 ### v5 Worker Spawn（所有角色）当协调器生成工作人员时，使用带有角色规范路径的“team-worker”代理：代理({ agent_type: "团队合作者", 描述：“生成<角色>工人”， team_name: <团队名称>, 名称：“<角色>”， run_in_background：真，提示：`## 角色分配角色：<角色> 角色规格：.claude/skills/team-planex/role-specs/<角色>.md 会话：<会话文件夹> session_id: <会话 ID> team_name: <团队名称> 要求：<任务描述> 内部循环：<真|假> 执行方法：读取 role_spec 文件以加载阶段 2-4 域指令。执行内置阶段 1（任务发现）-> 角色规范阶段 2-4 -> 内置阶段 5（报告）。 }) **内循环角色**（计划者、执行者）：设置 `inner_loop: true`。团队工作代理在内部处理循环。 ** ** ## 管道定义 ### 管道图基于问题的节拍管道（逐问题节拍） ═════════════════════════ ══════════════════════════ PLAN-001 ──> [规划者]问题1解决方案 → EXEC-001 问题 2 解决方案 → EXEC-002 ... 问题 N 解决方案 → EXEC-00N 所有计划信号 EXEC-001 ──> [执行者]实施issue-1 EXEC-002 ──> [执行者]实施issue-2 ... EXEC-00N ──> [执行者] 执行issue-N ═════════════════════════ ══════════════════════════ ### 踏频控制 **节拍模型**：事件驱动的生成和停止。每个节拍 = 协调器唤醒 -> 处理回调 -> 生成下一个 -> 停止。节拍循环（协调器生成并停止） ========================================================================= 活动协调员 ---------------------------------------------------------------------------------- 用户调用 ----------> ┌─ 第 1-3 阶段 ──────────┐ │ 解析输入 │ │ 团队创建 │ │ 创建PLAN-001 │ ├─ 第四阶段────────────┤ │ 生成规划器────────┼──> [规划器] 第1-5阶段 └─ 停止（空闲）──────────┘ │ │ 回调 <─ planner issues_ready ────────────────────────┘ ┌─ 监视器.handleCallback ─┐ │ 检查新的 EXEC-* 任务 │ │ 生成执行者──────────┼──> [执行者]阶段1-5 └─ 停止（空闲）────────────┘ │ │ 回调 <─ 执行器 impl_complete ────────┘ ┌─ 监视器.handleCallback ─┐ │ 标记完成 │ │ 检查下一个准备好的任务 │ └─ 产卵/停止 ────────────┘ ========================================================================= **检查点**：触发条件 | 位置 | 行为 ---|---|--- 规划师全部完成 | all_planned 信号 |执行器完成剩余 EXEC-* 后结束管道投资 | 无需准备+无需运行 |协调员升级为用户执行器阻塞 |已阻止 > 2 个任务 |协调员升级为用户 ### 任务元数据注册表任务 ID |角色 |相|依赖关系 |描述 ---|---|---|---|--- 计划-001 |策划师|规划| （无）| 初始规划：需求拆解、问题创造、方案设计执行-001 |执行人|执行| （由规划器在运行时创建）| 第一期的代码实现执行-N |执行人|执行| （由规划器在运行时创建）| 第N个问题的代码实现 > 注: EXEC-* 任务由规划者在运行时逐个创建（逐问题节拍），而不是预先定义的完整任务链。 ** ** ## 完成动作当管道完成时（所有任务完成，协调器第 5 阶段）：如果（自动是）{ // 自动模式：存档和清理而不提示 completionAction = "存档并清理"; } 否则{ 询问用户问题({ 问题：[{ 问题：“团队管道已完成。您想做什么？”, 标题：“完成”，多重选择：假，选项：[ { label: "存档和清理（推荐）", description: "存档会话，清理任务和团队资源" }, { label: "Keep Active", description: "保持会话活跃以进行后续工作或检查" }, { label: "导出结果", description: "将可交付成果导出到指定位置，然后清理" } ] }] }) } 选择|行动 ---|--- 归档和清理|更新会话状态=“已完成”-> TeamDelete -> 输出最终摘要保持活跃 |更新会话状态=“已暂停”->输出恢复指令导出结果 |向用户询问目标路径 -> 复制可交付成果 -> 存档和清理 ** ** ## 会话目录 .workflow/.team/PEX-{slug}-{日期}/ ├── .msg/meta.json # 会话状态 ├── 文物/ │ └── Solutions/ # 每个问题的规划器解决方案输出 │ ├── {issueId-1}.json │ └── {issueId-N}.json ├── 智慧/ # 跨任务知识 │ ├── 学习.md │ ├── 决策.md │ ├── 约定.md │ └── issues.md ├── .msg/messages.jsonl # 团队消息总线 └── .msg/meta.json # 会话元数据 ** ** ## 消息总线最后SendMessage 前，先调用 `mcp__ccw-tools__team_msg` 记录： * 参数：操作=“log”，session_id=``，from=``，type=``，data={ref:“``”} * `to` 和 `summary` 自动默认——不明确指定 * **CLI 后备** : `ccw team log --session-id --from --type --json` **按角色划分的消息类型**：角色 |类型 ---|--- 策划师| `issue_ready`、`all_planned`、`error` 执行人| `impl_complete`、`impl_failed`、`错误` ** ** ## 错误处理场景 |分辨率 ---|--- 找不到角色规范文件 |预期路径错误（角色规范/.md）未找到命令文件 |回退到协调器 role.md 中的内联执行团队工作人员代理不可用 |错误：需要 .claude/agents/team-worker.md 规划师问题规划失败|重试一次，然后跳到下一期执行器 impl 失败 |向协调员报告，继续执行下一个 EXEC-* 任务管道失速|协调员监控，升级给用户完成操作超时 |默认保持活动状态

平面团队

包含技能