SuperAPI AI 工具集

parallel-agent

智能体与模型

查看项目

更新于 10-15 20:12

技能介绍

用途:parallel-agent 是 Pi 的轻量本地策略层,用来决定是否以及如何拆分工作。它本身不定义 API、角色或执行细节,这些以已安装的 pi-subagents 技能为唯一依据。

主要能力与判断标准:仅当每条并行通道有不同问题域、且不依赖其他通道结果、也不共享可变状态时才并行。典型场景包括互不相关的缺陷、独立子系统侦察、不同评审角度、本地上下文加外部研究。耦合调查、有依赖的顺序任务、重叠源码接缝或会修改同一状态的任务不应并行,应先弄清共同根因。

使用方式:派发前需完整阅读已安装的 pi-subagents 技能,按其路由查阅提示词/角色、执行控制、多通道编排或约束与配方;运行 subagent({ action: "list" }) 并只使用可执行、未禁用且会话允许的智能体。使用 workflowScript,独立通道用 runs.all,依赖阶段用 runs.run;独立通道用 fresh,仅在需要继承父级决策且满足文档所述会话前提时用 fork。跨仓库工作需写明仓库、显式 cwd、权限边界与预期输出路径。多个可变更通道前需记录通道板,包含仓库/cwd、权限、声明文件或契约、隔离路径、验证门与交接;一个仓库/cwd 或工作树只能有一个写入者,并发修改需显式工作树隔离。

角色与形态:按已安装文档选择最窄角色,如本地侦察、外部研究、咨询式决策评审、只读评审或已批准实现。三种标准形态为只读扇出、研究扇出、分阶段实现(并行只读规划→父级批准的 acceptedScope→单一写入者→并行只读验证)。

限制与交接:父 Agent 负责编排、综合、批准与最终验收;规划或评审输出只是证据而非批准,子智能体只接收父级批准的 acceptedScope,不得自行推断额外修复。普通子智能体不再启动子智能体,产品、架构、范围、权限、合并、发布等决策须上报父级。每个子任务需给出简洁交接,含 status、findings、changedFiles、validation、remainingRisks;大报告用已安装的产物/输出机制传递。部分失败仍算结果:保留成功的独立通道,报告失败通道,仅在安全处继续,不得静默丢弃失败或无限重试。该技能为 Chasen 的 Pi 环境本地维护,应保持聚焦本地策略。