SuperAPI AI 工具集

pi-delegate

编程与开发

查看项目

更新于 10-15 16:48

技能介绍

用途:pi-delegate 把编码代理当作独立实现者使用。你充当编排者,负责写任务简报、判断与最终落地;pi 在自己的会话中修改代码;随后由你验证并提交。整个循环只需一条 shell 命令与文件访问,任何同类编排者都可驱动。

主要能力:先写简报——pi 只能看到你发送的文本和工作区内容,没有聊天历史或共享上下文,因此简报需包含目标、当前状态、要改与不要改的内容、项目真实的检查门禁和报告约定,并告知 pi 不要提交;一次简报只放一个任务。pi 会自动加载工作区及其父目录的 AGENTS.md/CLAUDE.md 上下文文件。然后用随附 relay(node "<skill-dir>/scripts/relay.mjs" --brief brief.txt --cd /path/to/repo)把简报通过 stdin 传给 pi --mode json,捕获 JSON 事件流并写出 result.json;可选 --model、--provider、--read-only、--approve、--resume-last、--session、--timeout 等参数。之后等待完成,再自行重跑项目的门禁、对照简报阅读 diff(从 touchedFiles 开始),必要时发送增量简报重新返工,检查通过后才由编排者提交。

使用前提:需安装 pi(npm install -g @earendil-works/pi-coding-agent)并完成认证,确认 pi --version 成功,且在目标 git 仓库中工作或通过 --cd 指向该仓库。

限制:pi 没有沙箱也没有权限模式,默认无头运行可读写、编辑并执行 shell 命令且不会询问;--read-only 仅把可调用工具限制为 read、grep、find、ls,已安装的扩展代码仍以宿主权限运行;默认传 --no-approve,使项目 .pi 设置、扩展和技能不被信任,--approve 是对可信仓库的显式选择加入。任务过小、未安装或未认证 pi、或需要沙箱化实现者时不应使用。委派须由人工主动开启;遇到范围变化应停下询问而非扩大授权。