@pi-in-go/pigpen-subagents

中文文档
0.2.0发布于 2026/11/02MIT零依赖构建来源已验证

Go端口pi-subagents:代理和链定义,它们的发现,子代理工具的列表和get操作,单代理和链运行通过子pig进程(部分:没有并行,异步,工作流,工作树或舰队功能)

中文使用文档

pi-subagents (Go端口,部分)

PiG的Go扩展:将工作委托给markdown文件中定义的专家代理。它是一个港口 pi-subagents 由尼克 Bailon(见 CREDITS.md),用 扩展移植技能,不需要Node。

使用

中定义代理 .pi/agents/<name>.md (项目)或 ~/.pi/agent/agents/<name>.md (你),原件的格式:

---
name: helper
description: Helps with things
model: provider/model
tools: read, grep
---

You help.

该模型看到两个工具。 subagents_enable 使 subagent 工具可用(在此之前不提供,如 原始);然后:

  • subagent {action: "list"} 列出代理(agentScope(用户、项目或两者), {action: "get", agent: "helper"} 显示一个;
  • subagent {agent: "helper", task: "..."} 在子节点中运行一个代理 pig --print 处理并返回其答案;
  • /run-chain <chain> <task> 运行一个 .chain.md 链(.pi/chains/ 或者 ~/.pi/agent/chains/):每一步的答案都流入 下一个是 {previous},要求如下: {task}.

13个代理商随包裹一起发货(原装) scout, worker, reviewer,……)。 PIG_SUBAGENT_PIG_BINARY 猪的名字 为孩子开始;否则猪跑这个扩展,那么a pig 那么,除了这个程序 PATH. 一个孩子得到了 stdin上的任务,像原始的后台子节点一样发现扩展(模型提供程序和它的登录名来自一个),并且 可能自己只委托给深度2 (PI_SUBAGENT_MAX_DEPTH(如原文);一次最多运行4个子进程,一个被取消的调用(Escape)会停止它的子进程。代理人 systemPromptMode: replace 不能在小猪二进制子程序中运行(二进制程序有自己的系统提示符)。

代理选择其子代理的扩展名与原始代理一样。 extensions: a, b 只装载那些(空的) extensions: 负载 没有,甚至没有模型提供程序),以及 subagentOnlyExtensions: c 负载 c 在孩子身上,在其他人身上。条目是什么? pig --extension 取:路径(./ 和 ../ (相对于代理文件), builtin:<name>,或 npm:/git: 源。对于两者都不具备的代理, subagents.defaultExtensions 和 subagents.defaultSubagentOnlyExtensions 在 settings.json 是默认的:PiG自己的文件(.pig/settings.json 在人群中, ~/.pig/agent/settings.json)及 原始的(.pi/settings.json 在项目的根, ~/.pi/agent/settings.json)都是read, project over user和PiG的 在每一层的Pi上

{ "subagents": { "defaultSubagentOnlyExtensions": ["/path/to/child-only-extension"] } }

一个孩子的模式和思维水平首先最强,来自呼唤 model, subagents.agentOverrides.<name>.model 和 .thinking (false 清除代理自己的),然后清除代理的前台 subagents.defaultModel 和 defaultThinking,从相同的文件中读取,每个从第一个设置它的文件中读取。没有他们,孩子继续跑 主机的默认型号。其他 agentOverrides 字段, defaultProvider 和 modelScope 未读:

{ "subagents": { "defaultModel": "provider/small-model", "agentOverrides": { "oracle": { "model": "provider/large-model", "thinking": "high" } } } }
pig install ./components/subagents

移植了什么

前端内容解析、代理和链定义(项目中的发现、用户目录和内置集); 项目优先于用户优先于内置、包、别名、名称解析)、markdown链文件(解析和写入) subagent 工具的 list 和 get, subagents_enable 加载器,并通过子进程运行一个代理或链 另外:原始版本通过它自己的执行器和脚本工作流运行子版本)。

不被接纳,被拒绝; 并行、异步和后台运行、脚本工作流程(workflow, workflowScript, workflowScriptPath)和遗产 tasks/chain 输入,理事会模式,工作树隔离,舰队和状态视图,转向和 主管频道,看门狗,任务,档案, agentOverrides 除了 model 和 thinking, .chain.json 连锁,管理行为其他 比 list 和 get. 工具荣誉 agent, task, agentScope, cwd, model 和 async: false (端口总是在前台运行)和for list 和 get, action, agent 和 agentScope. 任何其他 参数或动作,以及工具 bg_wait 和 subagent_supervisor (声明让模型看到原作的工具),被拒绝 只有一条消息,什么都不运行:

@pi-in-go/pigpen-subagents (Go端口)不支持异步(后台)运行(async: true)。安装原来的扩展,npm:[email protected],它在PiG中运行不变。

原始的斜杠命令,而不是端口自己的 /run-chain (/run, /subagents, /subagents-stop, /prompt-workflow)不是 注册,也没有它的技能和提示模板。看到 港口/ PORT.md.

版本与发布记录

@pi-in-go/pigpen-subagents 共发布 4 个版本,首次发布于 2026/10/06;过去 12 个月发布了 4 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.2.0latest2026/11/021 天前
0.1.22026/10/304 天前
0.1.02026/10/0628 天前
0.0.0-stage2026/10/0628 天前

关于 @pi-in-go/pigpen-subagents 的常见问题

@pi-in-go/pigpen-subagents 是什么?

Go端口pi-subagents:代理和链定义,它们的发现,子代理工具的列表和get操作,单代理和链运行通过子pig进程(部分:没有并行,异步,工作流,工作树或舰队功能)

如何安装 @pi-in-go/pigpen-subagents?

在项目目录运行 npm install @pi-in-go/pigpen-subagents,或使用 pnpm add / yarn add / bun add。

@pi-in-go/pigpen-subagents 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/pi-in-go__pigpen-subagents 是否存在。

@pi-in-go/pigpen-subagents 可以商用吗?

@pi-in-go/pigpen-subagents 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@pi-in-go/pigpen-subagents 还在维护吗?

最新版本 0.2.0 发布于 2026/11/02(1 天前);至今共发布 4 个版本,其中过去 12 个月发布了 4 个;首次发布于 2026/10/06。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。