用途:team-planex 是面向基于 issue 开发的“计划-执行”流水线统一团队技能,作为纯路由器运行,始终由 coordinator 协调。触发方式为“team planex”,调用形式为 Skill(skill="team-planex", args="任务描述")。
主要能力:
- 角色路由:无 --role 时读取 roles/coordinator/role.md 并执行入口路由;带 --role <name> 时读取 roles/<name>/role.md 并执行 Phase 2-4。
- 角色注册:coordinator(roles/coordinator/role.md,无前缀)、planner(roles/planner/role.md,前缀 PLAN-,启用 inner loop)、executor(roles/executor/role.md,前缀 EXEC-,启用 inner loop)。
- 协调流程:coordinator 负责 analyze -> dispatch -> spawn workers -> STOP,之后派发 planner 与 executor 两类 team-worker 代理。
- 预加载(可选,不可用则跳过):若存在 .workflow/codebase/ARCHITECTURE.md 则读取模块边界;maestro load --type spec --category arch 与 maestro load --type spec --category coding 加载架构与编码约束;maestro search "plan execute implementation" --json 取前 5 条作为先验上下文。
使用方式:
- 共享常量:会话前缀 PEX,会话路径 .workflow/.team/PEX-<slug>-<date>/;CLI 工具 maestro delegate --mode analysis(只读)与 maestro delegate --mode write(修改);消息总线 mcp__maestro__team_msg(session_id=<session-id>, ...)。
- 用户命令:check / status 查看执行状态图;resume / continue 推进到下一步;add <issue-ids 或 --text '...' 或 --plan path> 向 planner 队列追加任务。
- 会话目录结构包含 .msg/(messages.jsonl、meta.json)、task-analysis.json、artifacts/solutions/ 与 wisdom/(learnings.md、decisions.md、conventions.md、issues.md)。
适用场景:基于 issue 的团队式计划与执行开发,由 coordinator 编排、planner 规划、executor 实现。
限制与错误处理:team-worker 代理不可用时提示需要 .claude/agents/team-worker.md;出现未知命令、角色未找到或角色 spec 文件缺失时给出相应错误与可用列表;planner 规划失败重试一次后跳过,executor 实现失败上报后继续下一 EXEC-* 任务;流水线停滞由 coordinator 监控并升级给用户;worker 无响应则报告等待任务并建议 resume。官方文档与收费信息暂未提供。