# @giladbarnea/pi-simple-team 中文文档

规范地址：https://npmcn.com/package/%40giladbarnea/pi-simple-team/

版本：2\.0\.28
npm 元数据更新时间：2026-11-16T04:59:46.706Z
中文译文更新时间：2026-11-16T08:56:13.518Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40giladbarnea/pi-simple-team
原文对照：https://npmcn.com/package/%40giladbarnea/pi-simple-team/?lang=original
项目主页：https://github.com/giladbarnea/pi-simple-team
源码仓库：https://github.com/giladbarnea/pi-simple-team

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：5.1 MB，68 个文件
- TypeScript 类型：未声明
- 运行依赖：1 个
- peer 依赖：typebox \*，@earendil-works/pi-ai \*，@earendil-works/pi-tui \*，@earendil-works/pi-coding-agent \>=1\.4\.0
- 首次发布：2026-07-22T04:49:08.266Z
- 最新版本发布：2026-11-16T04:59:46.413Z
- 近 30 天下载量：4483（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：76（近 12 个月 76 个）

## 中文简介

一个平地活活的皮特工团队.

## 安装

```sh
npm install @giladbarnea/pi-simple-team
```

也可以使用：`pnpm add @giladbarnea/pi-simple-team`、`yarn add @giladbarnea/pi-simple-team`、`bun add @giladbarnea/pi-simple-team`

## README

![A dark wireframe room in a starry void](https://raw.githubusercontent.com/giladbarnea/pi-simple-team/main/screenshots/pi-simple-team-banner.png)

# 简单团队

> **队伍扩展没有特征.**

[![Pi extension](https://shieldcn.dev/badge/pi-extension.svg?variant=outline)](https://github.com/earendil-works/pi) [![npm version](https://shieldcn.dev/npm/%40giladbarnea%2Fpi-simple-team.svg?variant=outline)](https://www.npmjs.com/package/@giladbarnea/pi-simple-team) [![test status](https://shieldcn.dev/github/ci/giladbarnea/pi-simple-team.svg?workflow=test.yml&branch=main&variant=outline)](https://github.com/giladbarnea/pi-simple-team/actions/workflows/test.yml) [![license](https://shieldcn.dev/github/license/giladbarnea/pi-simple-team.svg?variant=outline)](https://github.com/giladbarnea/pi-simple-team/blob/main/LICENSE) [![TypeScript](https://shieldcn.dev/badge/typescript.svg?logo=typescript&variant=outline)](https://www.typescriptlang.org/) [![tested with Bun](https://shieldcn.dev/badge/tested_with-Bun.svg?logo=bun&variant=outline)](https://bun.sh/)

**没有角色。 没有野生动物图。 没有邮箱。 没有路线规则.**

`pi-simple-team` 培养出一小队Pi特工 他们可以互相交谈 就像他们负责的成年人一样, **然后别挡道.**

* * *

## 为什么

我在一间小房间里做了我最好的工作, 和一群非常有能力的人.

> _\[叫声\]_ 有没有人知道如何建立认证机构?

不提交"援助请求".

> _\[拍肩\]_ 哥们儿,你能不能帮我个忙?

不安排会议.

**这是整个设计。 不是一群人,也不是一个公司. _一个房间._**

## 安装

需要Pi 1. 4.0或更新.

```sh
pi install npm:@giladbarnea/pi-simple-team
```

来自 [`soft-skills`](https://www.npmjs.com/package/soft-skills) 通过皮的正常技能发现而包含和提供.

## 使用 `pi-simple-team`

告诉你的主要探员:

> 生一队.

就是这样。 团队采取任务的形式:

你们:

> 创建执行者审查小组以完成 `PLAN.md`。 。 。 .

主要代理人:

> 创建了 `implementer` 财务报告和审定财务报表 `reviewer` 循环 :
> 
> -   `implementer` 将一直固定到 `reviewer` 满意.
> -   我会告诉你,当他们完成.

[![A team appears, receives direction, and starts working](https://raw.githubusercontent.com/giladbarnea/pi-simple-team/main/screenshots/abstract-tool-output-preview-640.png)](https://raw.githubusercontent.com/giladbarnea/pi-simple-team/main/screenshots/abstract-tool-output-preview.png)

_直接来,跟随一个小队 从正常的皮谈话._

  
**pi-simple-team 截图**  

[![Status outputs for several parallel teams](https://raw.githubusercontent.com/giladbarnea/pi-simple-team/main/screenshots/team-status-multiple.png)](https://raw.githubusercontent.com/giladbarnea/pi-simple-team/main/screenshots/team-status-multiple.png)

[![Event log outputs for two parallel teams](https://raw.githubusercontent.com/giladbarnea/pi-simple-team/main/screenshots/team-log-multiple.png)](https://raw.githubusercontent.com/giladbarnea/pi-simple-team/main/screenshots/team-log-multiple.png)

### 看一个现场的团队 `/team`。 。 。 .

`/team` 这是给你的,不是另一个代理工具。 它能让你看到这间屋子的活景 而不会把主要特工变成状态中继器.

命令打开一个滚动的最近状态、信件和单独的事件日志.

上下选择信件或日志部件 。 输入缩放到全部覆盖。 Esc会回去的.

[![The live team dashboard showing statuses, messages, and recent events](https://raw.githubusercontent.com/giladbarnea/pi-simple-team/main/screenshots/team-view.png)](https://raw.githubusercontent.com/giladbarnea/pi-simple-team/main/screenshots/team-view.png)

_现场,只读 `/team` 仪表板._

## 机械师

### 必要时醒来。 自由工作,否则.

**托肯斯,智慧和时间 从来没有浪费在忙碌的收集信息.**

相反, `pi-simple-team` 向收件人推动消息.

它既高效又有效:

-   没有信箱可以忘记.
-   \\\\ 上下文窗口保持倾斜.
-   解锁任意工作流程.

### QQ 信件到达 _快点_。 。 。 .

-   次二等受者闲时.
-   当工作结束的时候,当忙碌的时候.

### {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}每个人都能看到状况.

随时免费 像设定Slack状态.

队友发表一行:

> 执行者   完成,89个测试,等待审查.

> 审查者       阅读实施情况,几分钟后完成审查.

你的主要经纪人打来电话 `team_status` 并完全理解 发生了什么事。 主不要求队友进行更新或拼凑上下文.

### ++ 背景窗口自我意识

**该小组管理自己的背景:**

队友们知道他们留下了多少自由背景.

主干员知道自己的,其他人也是 你也看到了:团队工具结果显示,除了每个团队成员之外,最后报告的上下文使用,例如: `Team Send → builder ▆72% context`。 。 。 .

当是时候说再见时,他们会自主地交出工作.

你可以停止照看上下文窗口.

### 如果有正当理由,则中断.

> _情况:下午很晚。 团队完成了"热补"的制作并开始收尾. 还有一个问题._

-   17: 32: 00: 00: 00: 00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00: `security-guard` 点出未覆盖的私有 SSH 密钥 `.gitignore`。 。 。 .
-   17:32:01 (英语) `release-owner` 设置状态 : _小兰 `git add .`准备承诺和推动._
-   17:32:02 (英语) `security-guard` 立即中断 `release-owner`钥匙从不离开机器。 开发者再继续工作一天 QQ

### 零成本现场观察

你的主要用途 `team_log` 当它需要理解 高颗粒度的事件链.

提供主要时间标注,可过滤,仅附件记录团队的信息,工具呼叫和生命周期事件. 尝试可以在复试完成前结束. 单独的运行行报告最终结算结束或取消. 结束并不意味着成功. 在提供者出错后结束的运行会添加一个带有提供者消息的错误行,并将队友状态设置为 `error` 带这个信息,直到稍后的运行完成。 Main也收到一条信息. 一名背景队友在没有被阻止的情况下退出,在注册后,也发出带有其退出代码的主信息. 退出自己的队友(出局代码为0)不会. 一个Herdr pane队友收到同样的信息。 如果程序失效,主要被告知它退出了。 如果它关闭了面板后闲置了,或者接收了SIGHUP或SIGTERM,主会得到一个给信号取名的中性消息,因为两者都可以是故意的. 在队友工作时一扇窗关上,Pi通常会一并结束,因此主被告知退出. 重启会关闭队友之前的面板. 一个主关闭的窗帘本身 发送什么.

### 贺尔德支持

`pi-simple-team` 可以在专用的 Pi 中打开队友直接会话 [贺德](https://herdr.dev/) 窗关。 叫你的主要经纪人来做.

-   现场观看房间.
    
-   与队友直接交谈.
    
    我建议从“船长”开始。 感觉很好,他们脸上的惊喜是无价之宝.
    

### 队友是耐久的皮课.

队友只是带队附身的Pi会话.

这意味着 **队友(因此,团队)在停工后幸存.**

让队友工作,完全离开皮, 明天回来的全新会话, 并要求主 得到你的队友 在它的皮会话ID。 所学之事皆能不动.

你甚至可以这样 `/resume` 队友直接进行,如果你想 舒适的一对一,或运行 `pi --session <teammate-session-id>`。 。 。 .

每个队友都记录哪个主课和小组开始的,一个 `pi-simple-team-teammate` 模式和TUI从未见过的自定义条目。 内容 `sessionId` 是它被写入的会话,所以稍后 `pi --fork` 队友携带一份你可以看到的复制品是继承的.

`team_spawn` 财务报告和审定财务报表 `team_add_teammates` 也可以使用停止的,永不中断的对话. 设定 `session` ,或现有的绝对 JSONL 路径。 Omit 模式/ 考虑保留 Pi 保存的设置或默认值 . `startIdle` 保持它的睡眠,直到你发出它.

这个第一个版本拒绝已知的团队拥有或先前的团队会话,其他项目,以及等待提醒,命名被阻断状态及其所属位置. 源程序必须先被停止:皮没有会话写作锁,一个普通的过程或幸存的面板可能对Simple Team看不见. 未解决的导入保留而不自动重新启动 .

## – 球队一路倒下(可选)

告诉主您想 **有队友管理自己的团队.**

这是一个强大的技术 创建 **单独的上下文层.**

该队友将产卵、驾驶和观察自己的队伍,而不向兄弟姐妹或父母支付代币.

与上级代表团一样,权衡权被削弱:你被移到离战壕更远的一层.

这是选入:队友默认不能创建队伍.

如果你的主力是队长,这个技术就更好了\[^1\].

* * *

## 地图工程师

**因为** 没什么特别的, `pi-simple-team` 能够 **构造您需要的任何代理图表.**

告诉主 :

> 1.  断开 `PLAN.md` 输入任务图。 包含有成功标准的循环,并平行运行独立的任务.
> 2.  创建一个执行任务图的团队.

或者给主队一个具体的目标:

> **团队目标 :**
> 
> 1.  映射所有客户QQ购买资金流的数据库.
> 2.  把新知识喂入记忆层.
> 3.  让数据分析代理通过新购买的evals.
> 
> **说明:**
> 
> -   #1是一个 **饱和循环.** 只有在找不到新东西时才停止.
> -   #3是一个 **山地攀爬环.** 停止只有 evals 是绿色的.
> -   队友一号与三号创建自己的队伍来循环,直到任务完成.

此提示创建此图 :

![The team graph: 1-map (Scout and Devil’s advocate) feeding subagent dispatch, feeding 3-eval (Engineer and Performance watcher)](https://raw.githubusercontent.com/giladbarnea/pi-simple-team/main/screenshots/team-graph.png)

## 工具

保留最小值 :

| 作用 | 对于 | 工具 |
| --- | --- | --- |
| **主要代理人** | 团队生命周期 | `team_spawn`, (中文(简体) ), `team_list`, (中文(简体) ), `team_resume`, (中文(简体) ), `team_add_teammates`, (中文(简体) ), `team_update_teammates`, (中文(简体) ), `team_shutdown` |
|  | 与团队 | `team_send_message` |
|  | 团队 | `team_status`, (中文(简体) ), `team_log` |
|  | 每个人 | `get_context_window_usage` |
|  | 自动 | `schedule_reminder`, (中文(简体) ), `list_reminders`, (中文(简体) ), `cancel_reminders` |
| **管理队友** | 自己和自己的团队 | 与主要代理工具相同的工具 |
|  | 与母队 | `team_send_message`, (中文(简体) ), `team_status`, (中文(简体) ), `send_main_message` |
| **队友** | 与团队 | `team_send_message` |
|  | 带主 | `send_main_message` |
|  | 自动 | `get_context_window_usage` |
| **每个人** | 为了大家 | `team_status` |

`team_spawn`, (中文(简体) ), `team_resume`,以及 `team_add_teammates` 一旦每个受影响的队友准备好,就自动开始工作。 与 `startIdle: true`,他们的通报在背景中等待而不开始工作.

启动交付 `commonPrompt` 内部 `<team-system-message>` 和每个队友的 `systemPrompt` 内部 `<your-specific-system-message>`。这些是自定义团队信息中的标签,而不是系统作用覆盖。 简报中还载有队友的身份和协调指导.

当主机退出,重新装入或坠入时,其队伍会停止. 当主会话重新开始时,"简单团队"(Simple Team)将正在运行,闲置的队友和在他们自己的对话中重新接通,没有向他们发送任何信息或发出模型请求. Main得到一条信息,列出它们和它们正在起作用,这样它就可以告诉它们继续。 团队停止 `team_shutdown`,或通过切换主会话离开,停止。 相撞后,一名Herdr pane队友可能仍然在其pane中运行,因此被列出而不是被重新附着.

继续附加自定义的介绍,包括团队身份,当前时间,以及上次录制的模型活动. 可选 `resumptionPrompt` 指示在简报之后不改变节省的定义。 与 `startIdle: true`,简报将在下一轮进行.

现有的队友可以在同一输入字段中通过名称或Pi会话ID来选择. 信件、日志和上下文使用共享 a `targets` 列表中选择一个选项。 为其所有队友选择一个团队,或者在整个团队中选择个人队友. 模糊姓名 返回您可以使用的ID .

`team_update_teammates` 在自己的对话中改变现场队友的模型,思维水平或扩展. 闲散的队友如果有的话,立即在队框内重新启动;忙碌的队友继续工作,并在跑步结束后更新,或随即更新 `interrupt: true`. 管理队友从未被持有:虽然它或自己的任何队友工作,但呼叫失败并告诉主机要求它软停,一旦闲置,同一呼叫成功. 重启的队友会得到一条带有新设置的信息,并且团队会停止重启,从而可以恢复. 当保存的更新适用时,主会收到信息; `team_shutdown` 列出任何它掉下来. `team_resume` 在 `teammateUpdates` 对于队友 它恢复。 指示和 `forkContext` 保留为创建.

`team_list` 将活动团队显示为短行, 最先创建, 每页默认 20 个( )`limit` 最多100个 `cursor`) (中文(简体) ). 过 `includeDormantTeams: true` 包括休眠小组,或 `team` 一个团队的完整记录。 页面遵循创建顺序,因此在页面之间更改状态或活动的团队既不重复也不跳过.

提醒记录在会话中,所以它们存活下来 `/reload` 并重新开始该会话。 一个在Pi没点起火 说已经晚了.

`list_reminders` 显示此会话的待发提醒, 并显示他们的身份证、 弹片和时间 . `cancel_reminders` 以 ID 或 swit 注销提醒, 或每个待发提醒 `all: true`;没有取消任何内容的电话.

喷出,恢复,并添加 返回完整的名册。 结果将现场运行时间与积极工作区分开来,包括呼吁前已经进行的工作.

设定 `showOnHerdrPane: true` 给队友打开窗帘 明确 `showOnHerdrPanes` 值在产物上覆盖所有单个设置.

`extensionPaths` 列表中包含一个队友现有的绝对扩展路径。 RPC和Herdr的发射在团队运行时间和扩展时加载它们 `pi` 在项目中发射发现并恢复保存。 父母自己的命令行 `-e` 扩展和 `--no-extensions` 没有继承。 一个 `extensionPaths` 在与发现的同一扩展副本不同的路径上输入,当该扩展登记工具或旗帜时会停止队友启动。 同一道,或同道相通,一载一载. 这些模块运行的权限与Pi相同.

消息工具返回 `published: true` 当扩展名接受消息发送时。 如果后来交付失败,发送者会自动收到错误.

* * *

## 路线图

**用户参与轨道 :**

-   [x] 给队友的赫德面板.
-   [x] `/team`:现场直播,只读团队仪表板.
-   [ ] 队友钻倒并抄本.
-   [ ] 加入并指挥来自斜线命令的队伍.
-   [ ] 直接从斜线命令中将队友添加到现有队伍中.
-   [ ] 直接从斜线指令中喷出队伍.

**职能:**

-   [x] 恢复所有或选定的队友 从休眠的团队.
-   [x] 团队诞生后加入队友.
-   [x] 让被选中的队友创建和管理自己的队伍.
-   [ ] 将队友从一队中除名.
-   [ ] 主要触发器 `/compact` 在选定的队友.
-   [ ] 队友们自发地面对低级环境.

* * *

\[^1\]: [队长](https://github.com/giladbarnea/soft-skills/blob/main/plugins/soft-skills/skills/ai-to-delegated/coordination/leading-leaders.md) 输入 `ai-to-delegated` 技术.

## 常见问题

### @giladbarnea/pi-simple-team 是什么？

一个平地活活的皮特工团队\.

### 如何安装 @giladbarnea/pi-simple-team？

在项目目录运行 npm install @giladbarnea/pi-simple-team，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：typebox（\*）、@earendil-works/pi-ai（\*）、@earendil-works/pi-tui（\*）、@earendil-works/pi-coding-agent（\>=1\.4\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @giladbarnea/pi-simple-team 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/giladbarnea\_\_pi-simple-team 是否存在。

### @giladbarnea/pi-simple-team 可以商用吗？

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

### @giladbarnea/pi-simple-team 的下载量有多少？

根据 npm 官方下载统计，@giladbarnea/pi-simple-team 在 2026/10/17 – 2026/11/15 这 30 天内被下载 4,483 次，日均约 149 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @giladbarnea/pi-simple-team 还在维护吗？

最新版本 2\.0\.28 发布于 2026/11/16（今天）；至今共发布 76 个版本，其中过去 12 个月发布了 76 个；首次发布于 2026/07/22。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

