SuperAPI AI 工具集

use-pi-subagents

智能体与模型

查看项目

更新于 10-16 06:45

技能介绍

用途:这是 Pi 平台专用的 RPC 子代理启动器。当在 Pi 环境且原生 subagent_* 工具不可用时使用。委派拆分、任务归属、隔离策略、工作树与 Git 操作、验证、工作区清理和汇报等行为需加载并遵循 use-subagents 技能。

主要能力:通过脚本 scripts/subagents.mjs 启动并监督 Pi RPC 子进程。角色有 scout、research、worker 三种,Pi 配置位于 assets/agents/。父代理需提供确切的 --cwd(须先按 use-subagents 准备 worktrees)。Pi 子代理不执行任何 Git 操作(包括 bash),不做工作树/分支管理,也不做递归委派。子代理的 claim/exit/status 仅作为证据而非验收结论。clean 只清除脚本运行状态,不动 cwd、工作树或 Git。

使用方式:只能从本技能目录使用 node scripts/subagents.mjs …,绝不使用原始 pi --mode rpc。先执行预检:node scripts/subagents.mjs --help 和 node scripts/subagents.mjs info。启动命令:node scripts/subagents.mjs run --role <scout|research|worker> (--assignment FILE|--prompt TEXT) --cwd PATH --timeout MS [--async]。默认阻塞;--async 仅用于独立通道。监督用 status|send|stop。状态、代数与恢复见 references/rpc-lifecycle.md。审核后清理运行状态:node scripts/subagents.mjs clean --run ID,安全时再加 --apply。最后按 use-subagents 汇报,必要时附 runId。

限制:归属、权限、身份、存活状态或 cwd 来源未经证实则停止。对不明确的运行状态予以保留,报告 runId、最后状态、cwd 及下一步安全检查步骤;不得强杀未验证的 PID。