SuperAPI AI 工具集

use-subagents

智能体与模型

查看项目

更新于 10-16 00:22

技能介绍

用途:这是一份与具体智能体框架无关的委派策略,规定“如何委派”,而具体工作流负责决定任务目标。只要宿主提供安全的子智能体机制,就应使用它;工作“小或简单”不构成留在父智能体执行的理由。父智能体仅在框架/拆解/综合、共享工作文档与 ADR 状态、集成与验收、用户沟通、工作区与运行时清理、原子无判断步骤或用户明确禁止时保留工作,跳过委派需记录原因。

主要能力:启动前拆分,每条泳道一个可独立验证的产出,分类为 reader、writer、independent validator,记录范围、依赖、预期输出与汇合点;仅并行独立泳道,耦合工作合并为一条等待泳道;扇出受父智能体集成/验证/清理能力限制;优先使用 assets/agents/ 中的 scout、research、worker 角色。

使用方式:每条泳道选一个可问责的启动器,优先全流程统一。启动器须提供精确 cwd/上下文、权限与写入边界、可观测的启动与完成、输出捕获、超时/边界、异步取消、明确的清理归属。候选顺序为内置/原生子智能体工具、宿主扩展或插件、该框架的目录/运行时适配技能、具备上述能力的非交互式智能体 CLI;否则父智能体可执行,仅在必须委派或独立时阻塞。任务契约基于 assets/assignment-template.md 与一个角色档案,包含角色与目标、模式、上下文、范围、最小权限、VCS 限制、验证要求、停止条件与交接内容;只发送任务相关上下文,禁止发送密钥、令牌、.env 或私密记录。

隔离与监督:reader 只读,writer 需串行或隔离工作区且所有权不重叠;子智能体不得创建/管理 worktree、分支或改动 VCS,集成与清理由父智能体负责。新判断用新子智能体,同一任务跟进可复用;确认启动并监控至完成/失败/取消/超时/未知,禁止即发即忘,重复相同失败应改变方法。

验证与清理:检查交接与完整泳道差异,父智能体重跑相关检查,验证通过后按仓库常规方式集成。每条泳道及流程结束或中断恢复后,停止/取消存活子进程,仅移除安全资源,保留并报告不安全或未知资源,不得遗留悬空 worktree、分支、进程或套接字。报告角色/泳道、结果、父验证、未解决工作、创建与移除的工作区、保留资源及原因。限制:具体启动器命令、平台与收费信息暂未提供。