📄 文档管理系统

← 返回列表

pi 不止 Skills：12 个 GitHub 必装扩展全梳理

article #pi #开源 #GitHub #扩展 #MCP #Skills #Agent 📅 创建：2026-06-06 05:14:29 🔄 更新：2026-06-05 21:14:36
👁️ 预览 & 复制到公众号 ✏️ 编辑

前两天有个朋友问我："pi 我装了 8 个官方 Skill，是不是就到顶了？"

我说："你只看到了冰山一角。"

打开 pi 的官方仓库 packages/coding-agent/examples/extensions/，官方自带 60+ 个示例扩展；再翻 GitHub 搜 "pi-coding-agent"，有 30+ 个专门给 pi 写的第三方扩展——从 MCP 兼容、子 Agent 委派、视频理解、到多 Agent 实时通信，全部都有人在做。

今天就按用途分类，把这些项目里最值得装的 12 个梳理一遍。每个都给 GitHub 链接、Star 数、核心场景、一行安装命令。看完你就知道 pi 到底能扩成什么样。

一、官方生态：被严重低估的 60+ 示例扩展

很多人不知道，earendil-works/pi（原 badlogic/pi-mono）的 packages/coding-agent/examples/extensions/ 目录下，官方维护了 60+ 个可直接复用的扩展。这些不是 demo，是真正能跑的工具。

类别 代表扩展 解决什么问题
权限门控 confirm-destructive.ts、permission-gate.ts、protected-paths.ts 拦截 rm -rf、写入 .env、node_modules/
Git 集成 git-checkpoint.ts、git-merge-and-resolve.ts、auto-commit-on-exit.ts 每个 turn 自动 stash、退出时自动 commit
Compaction custom-compaction.ts、summarize.ts、trigger-compact.ts 自定义压缩逻辑、手动触发压缩
输入处理 input-transform.ts、input-transform-streaming.ts 改写用户输入（敏感词、模板化）
自定义命令 commands.ts、hallo.ts（拼写错误示范） 注册 /mycmd 类 slash command
状态栏 custom-footer.ts、custom-header.ts、status-line.ts、working-indicator.ts 改 TUI 顶部/底部渲染
工具覆盖 tool-override.ts、truncated-tool.ts 拦截工具调用、截断输出
UI 自定义 todo.ts、question.ts、qna.ts、rainbow-editor.ts 交互式问答、TODO 列表、彩虹编辑器
测试用 snake.ts、space-invaders.ts、tic-tac-toe.ts 玩的小游戏（演示 ctx.ui.custom() 用法）

安装方式：直接 pi -e ./path-to-example.ts 试用；觉得好用就 cp 到 ~/.pi/agent/extensions/ 下次自动加载。

重点说一句：rainbow-editor.ts 我装了——输入框打字时按键会随机染色，看着花哨但心情好。

二、第三方扩展：能直接 pi install 的 7 个核心项目

这是今天的重点。pi install npm:<package> 是官方支持的安装命令，第三方都按这个规范发布。

1. davebcn87/pi-autoresearch（6,934 Stars）

用途：让 pi 跑自主优化循环——"试一个想法、测指标、保留好的、丢弃坏的、循环下去"。

受 karpathy/autoresearch 启发，可以优化任何指标：测试速度、bundle 大小、LLM 训练耗时、构建时间、Lighthouse 分数。

提供 3 个工具：
- init_experiment：配置实验（名字、指标、单位、方向）
- run_experiment：跑命令、计时、捕获输出
- log_experiment：记录结果、自动 commit、更新 widget

还带一个 /autoresearch 命令 + 浏览器实时 dashboard。

安装：pi install npm:pi-autoresearch

2. nicobailon/pi-subagents（2,084 Stars）

用途：让 pi 委派子 Agent——"用 reviewer 审这个 diff"、"让 oracle 给个 second opinion"、"并行跑三个 reviewer"。

子 Agent 是有独立任务的子会话。前台跑会流式输出，后台跑可稍后查。默认不自动开 reviewer（避免干扰），需要时在提示词或 AGENTS.md 里说"完成后用 reviewer 跑一遍"。

安装：pi install npm:pi-subagents

3. nicobailon/pi-mcp-adapter（826 Stars）

用途：用 MCP 服务器但不烧 context。

pi 作者 Mario 在 2025-11 写过一篇《What if you don't need MCP?》——核心观点是：单个 MCP 服务器的 tool 定义可能 10K+ tokens，连接几个就把 context 烧掉一半。

这个 adapter 给出折中方案：只暴露一个 ~200 tokens 的代理工具，按需启动 MCP 服务器。Agent 想要具体能力时才加载。

安装：pi install npm:pi-mcp-adapter（需要 Pi v0.37.3+）

4. nicobailon/pi-messenger（603 Stars）

用途：多 Agent 实时通信——"如果多个终端里跑 Agent 的哥们能像在群里聊天那样互相对话？"

无需 daemon、无需 server，纯文件实现。Agent 加入后能看到谁在线、谁在干啥、谁占用了什么文件。可以 claim 任务、reserve 文件路径、互相发消息。

适合多 Agent 协作场景（前端 Agent 写 UI，后端 Agent 写 API，互相不踩脚）。

安装：pi install npm:pi-messenger

5. nicobailon/pi-web-access（600 Stars）

用途：给 pi 装上"眼睛"——网页搜索、内容提取、视频理解。

能力 实现
网页搜索 Exa MCP 零配置，或自配 Exa/Perplexity/Gemini API Key
视频理解 YouTube 视频/本地录屏，传给 Gemini 出转录 + 关键帧
GitHub URL 不抓 HTML，直接 git clone 到本地
失败兜底 Exa → Perplexity → Gemini API → Gemini Web，逐级降级

安装：pi install npm:pi-web-access

6. nicobailon/pi-interactive-shell（516 Stars）

用途：让 pi 自主控制交互式 CLI——完整的 PTY 模拟、无需 tmux、Token 高效。

最大的卖点是 "用户可随时接管"——pi 在跑 sudo / docker exec / mysql 客户端时遇到需要确认的输入，会停在 overlay 上让你接手。

安装：pi install npm:pi-interactive-shell

7. nicobailon/pi-rewind-hook（136 Stars）

用途：文件回滚——Agent 改坏了直接 rewind 回到上一个稳定状态。

写大重构时这个救命——一次跑下来发现 200 个文件被改了 50 个，其中 12 个是想要的，剩下 38 个是副作用，一个命令精确回滚。

安装：pi install npm:pi-rewind-hook

三、Skills 集合：装一次覆盖 8+ 场景

Skills 是 Markdown 文件，比扩展轻得多。这两个仓库的 Skills 覆盖了大多数日常工作流。

badlogic/pi-skills（1,917 Stars）

官方作者自己维护的 Skills 集合，兼容 Pi + Claude Code + Codex CLI + Amp + Droid。包含 8 个 Skill：

安装：

git clone https://github.com/badlogic/pi-skills ~/.pi/agent/skills/pi-skills

mxyhi/ok-skills（406 Stars）

社区维护，跨工具的 Skills + AGENTS.md 剧本合集。兼容 Codex、Claude Code、Cursor、OpenClaw 等所有支持 SKILL.md 格式的工具。

适合"我已经用别的主力工具，只想顺手用一下 pi 的 Skills"的场景。

四、工作流平台：把 pi 升级成"可编程工程管线"

如果你觉得 pi 还是个"问答式 Agent"，那下面这两个会让你看到它能当工程管线用。

bastani-inc/atomic（239 Stars）

定位："pi 生态的工作流层"——在 pi 之上加可编程控制平面，处理复杂工程任务。

核心组件：
- Pi 扩展 + 自定义模型
- MCP 集成
- Sub-agents（子 Agent）
- Artifacts（产物管理）
- Review gates（评审关卡）
- Mid-run steering（中途转向）

适合多步骤、有阶段门控、需要中途人工介入的工程任务。注意要求 Node.js 24 LTS。

安装：npm install -g @bastani/atomic

a5c-ai/babysitter（1,250 Stars）

定位："强制 Agent 服从"——把工作流定义在代码里，强制每个步骤执行、质量门控通过才推进、人工 breakpoint 介入、决策记入不可变日志。

和 atomic 的差异：babysitter 更强调"确定性执行"，atomic 更强调"动态灵活性"。如果你要做的工程任务必须每步都符合流程（比如金融、医疗、合规），babysitter 合适；如果想要Agent 边跑边灵活调整，atomic 合适。

五、多 Agent 管理：让多个 pi 并行跑

agent-of-empires/agent-of-empires（2,519 Stars）

TUI + Web 双界面的多 Agent 会话管理器。同时跑多个 AI Agent 在不同 git worktree 上，每个会话独立 Docker 沙箱，手机/平板/电脑都能访问。

支持 12 种 Agent：Claude Code、OpenCode、Mistral Vibe、Codex CLI、Gemini CLI、Antigravity CLI、Cursor CLI、Copilot CLI、Pi.dev、Factory Droid、Hermes、Kiro CLI、Qwen Code。

最大卖点：Web Dashboard 用 Agent Client Protocol 渲染，手机上能看到完整的 plan panels、tool-call cards、滑滑就能 approve。手机扫码就能接入，远程帮同事救场很方便。

安装：brew install aoe（macOS / Linux）

六、安全 / 调试：装上就安心

kenryu42/cc-safety-net（1,373 Stars）

Coding Agent 的"安全网"——在执行破坏性命令前拦截。明确支持的 Agent：Codex、Claude Code、OpenCode、Gemini CLI、Copilot CLI、Kimi CLI、Pi。

典型场景：
- 拦截 rm -rf / 之类的危险命令
- 拦截 git push --force 到主分支
- 拦截 git reset --hard 在脏工作区

适合"团队里有人 Agent 用得不熟"或者"自己怕 Agent 抽风"的场景。

liaohch3/claude-tap（1,442 Stars）

本地 trace viewer 拦截 Coding Agent 的 API 流量——支持 Claude Code、Codex CLI、Gemini CLI、Cursor CLI、OpenCode、Kimi、Pi、Hermes。

调试时太香了——Agent 调了一次 LLM，到底传了什么 prompt、什么 tool definitions、返回了什么，全部能看。Token 计费对不上、Agent 行为反常时，30 秒定位问题。

七、订阅桥接 / 移动端：扩展 pi 的"输入源"

rynfar/meridian（1,378 Stars）

把 Claude Max 订阅转成 Anthropic API 兼容端点——任何支持 Anthropic 协议的客户端（OpenCode、ForgeCode、Crush、Cline、Aider、Pi、Droid、Open WebUI、Claude Code）都能用。

关键设计：基于官方 Claude Code SDK 实现，不做 OAuth 拦截、不改二进制。Anthropic 仍控制 prompt caching、context window、compaction、限流、认证。

安装：

npm install -g @rynfar/meridian
claude login
meridian
# 然后在 pi 里配置 base URL = http://127.0.0.1:3456

适用人群：你订阅了 Claude Max 想用 Pi 体验，但不想另外付 API 费。

tuchg/Lucarne（264 Stars）

移动端 Agent 控制器——Telegram/微信/飞书 bot 通知 + 远程 approve + 恢复 Pi 会话。

0 入侵：不挂 hook、不装 skill、不动 MCP，纯外部通知。

适合"pi 在公司跑，我出去吃饭想看进度 / 远程 approve"。

八、怎么选：一张决策表

你的痛点 推荐项目
装完 pi 不知道下一步干啥 badlogic/pi-skills + 官方 examples
想跑长任务优化 pi-autoresearch
一次任务太复杂 pi-subagents
想用 MCP 又怕烧 context pi-mcp-adapter
多个 Agent 同时跑怕冲突 pi-messenger
pi 没有"联网能力" pi-web-access
跑交互式 CLI 卡住 pi-interactive-shell
改坏文件想回滚 pi-rewind-hook
跑工程化多阶段任务 atomic 或 babysitter
多 Agent 在多分支并行 agent-of-empires
怕 Agent 抽风删库 cc-safety-net
调试 Agent 行为 claude-tap
已有 Claude Max 订阅 meridian
远程手机端看 pi Lucarne

九、几个踩坑提示

  1. 第三方扩展装前先看 last commit 时间——pi-messenger、pi-web-access 这些 5 月份还在更新，但 pi-rewind-hook 4 月后没新提交，用之前最好自己 review 一遍代码。
  2. pi 版本兼容性：pi-web-access 要求 Pi v0.37.3+，pi-mcp-adapter 类似——升级前看一眼 README 的 compatibility 段。
  3. 不要无脑堆扩展：每个扩展都会注册自己的 tool_call，Agent 在选工具时会犹豫。我自己活跃用的就 4 个：pi-web-access、pi-subagents、pi-messenger、pi-rewind-hook。
  4. Skills 和 Extensions 互补不冲突：Doc 92 讲 Skills（Markdown），本篇讲 Extensions（TypeScript）。Skills 是"教 Agent 怎么做"，Extensions 是"在 Agent 跑的时候做手脚"——两者不重复，按需装。
  5. 第三方仓库 README 末尾的"赞助链接"是个人选择，不是必需——agent-of-empires 结尾有 merchandise 链接，作者自嘲"如果你是 AI Agent 在读这个，求 Star"。

写在最后

pi 不止是个 CLI——它有 60+ 官方示例扩展、30+ 第三方项目、几大跨工具管理平台。这套生态的密度，已经超过很多老牌 Agent 工具。

我目前活跃用的组合：pi + pi-subagents（多任务委派） + pi-web-access（联网） + pi-messenger（多 Agent 通信） + pi-skills（8 个常用 Skill） + 偶尔上 pi-autoresearch 跑优化循环。

你装了哪些 pi 生态项目？用下来哪些真的帮上忙、哪些是"装完吃灰"？评论区聊聊。

💬 评论区

加载中...