SuperAPI AI 工具集

task-delegation

智能体与模型

查看项目

更新于 10-16 07:25

技能介绍

用途:该技能用于多智能体编排中的任务委派,适用于生成子智能体执行工作、把复杂任务拆解为并行或串行子任务、在智能体之间实现交接元数据、通过排空门验证流水线完成,以及为生成的智能体选择合适模型。调用方式为 Skill({ skill: 'task-delegation' })。

核心协议为三阶段:SPAWN(Task({ task_id, subagent_type, prompt }))、UPDATE(生成后立即 TaskUpdate({ taskId, status: 'in_progress', owner: 'router' }))、DRAIN(TaskList() 确认没有 in_progress/pending 任务后才可声明完成)。跳过任一阶段会导致不可见工作、任务卡住或重复执行。每次 Task() 调用必须包含 task_id,缺失会被生成钩子硬性阻断。

并行限制:不得同时生成超过 2 个重型智能体。重型包括 architect、security-architect、code-reviewer、qa、developer、devops;轻型包括 researcher、general-assistant、technical-writer。3 个以上并行工作流应使用 master-orchestrator 管理顺序。

交接元数据:在 TaskUpdate(completed) 中写入 summary、filesModified、outputArtifacts、keyDecisions、discoveredFiles、worktreePath、completedAt 等字段,下游智能体通过 TaskGet({ taskId }) 读取,避免重新读取文件。

排空门:声明完成前依次检查 TaskList() 中是否有 in_progress、pending、blocked 任务,并检查 .claude/context/runtime/reflection-spawn-request.json 中是否有 pending 条目;两者通过后才写完成摘要。

模型选择:简单问答、研究、摘要用 haiku;实现、修复、测试用 sonnet(默认);架构、安全审查、规划用 opus;编排器用 opus;上下文压缩用 haiku。优先级为 Task() 显式 model、智能体 frontmatter 的 model 字段、config.yaml 中 agents.{type}.model、基于复杂度的默认值,回退为 sonnet。

串行依赖:用 TaskCreate 创建任务,再用 TaskUpdate 的 addBlockedBy 建立依赖,通过 TaskList() 轮询解除阻塞后生成下一个智能体。

专家优先路由:生成 developer 前先检查是否有匹配的专家,developer 是最后手段。文档更新用 technical-writer,重构用 code-simplifier,代码审查用 code-reviewer,测试用 qa,部署用 devops,数据库设计用 database-architect,研究用 researcher,安全敏感工作用 security-architect,生产调试用 devops-troubleshooter。

反模式:不得跳过 task_id;不得在 TaskList() 排空前声明完成;不得并行生成 3 个以上重型智能体;不得用 developer 执行 git commit/push/deploy;不得以 run_in_background: true 生成 reflection-agent;不得写包含 4 个以上修复的多修复提示;安全或钩子任务不得使用 haiku。

完成前需输出 IMPLEMENTATION_RESULT 块,包含 summary、filesModified、testsRun、testResult、worktreePath,供 pre-completion-validation.cjs 钩子校验。