SuperAPI AI 工具集

team-planex

部署与运维

查看项目

更新于 10-15 17:32

技能介绍

Team PlanEx 是一个统一团队技能,用于基于 issue 的计划-执行开发管线。它基于 team-worker 智能体架构:coordinator 负责编排,worker 是加载 roles/<role>/role.md 中角色专属指令的 team-worker 智能体。

用途:把任务描述交给技能后,coordinator 进行分析并派发,随后生成 planner 与 executor 等工作角色,分别处理计划与执行。

主要能力:纯路由器设计,coordinator 始终是协调者;角色注册表包含 coordinator、planner(前缀 PLAN-)、executor(前缀 EXEC-),planner 与 executor 具有内部循环。通过 roles/<role>/role.md 加载角色指令。

使用方式:调用 Skill(skill="team-planex", args="task description");带 --role <name> 时读取 roles/<name>/role.md 并执行 Phase 2-4,不带该参数则走 coordinator 入口路由。会话前缀为 PEX,会话路径为 .workflow/.team/PEX-<slug>-<date>/。CLI 工具为 ccw cli --mode analysis(只读)与 ccw cli --mode write(修改)。消息总线通过 mcp__ccw-tools__team_msg(session_id=<session-id>, ...)。coordinator 使用 Agent 模板生成 worker,参数含 subagent_type: "team-worker"、team_name: "planex" 等。

可用命令:check / status 查看执行状态图;resume / continue 推进下一步;add <issue-ids 或 --text '...' 或 --plan path> 向 planner 队列追加任务。

会话目录:.workflow/.team/PEX-<slug>-<YYYY-MM-DD>/ 下含 .msg/(messages.jsonl、meta.json)、task-analysis.json、artifacts/solutions/、wisdom/(learnings.md、decisions.md、conventions.md、issues.md)。

限制:team-worker 智能体不可用时会报错,需要 .claude/agents/team-worker.md。planner 计划失败重试一次后跳过;executor 实现失败上报 coordinator 并继续下一个 EXEC-* 任务;管线停滞由 coordinator 监控并升级给用户;worker 无响应时报告等待任务并建议用户 resume。未知命令会报错并列出可用命令;角色未找到或角色规格文件缺失时给出预期路径。资料未提供收费、价格与平台信息。