夜雨聆风学习资料网

ARTICLE · 1048996

Pi入门第三期 | 给 Pi 装插件、Skill 和 MCP:三种扩展方式一次讲懂

Pi入门第三期 | 给 Pi 装插件、Skill 和 MCP:三种扩展方式一次讲懂
先分清三个概念

很多人第一次看到 Pi 的扩展生态,会把插件、Skill 和 MCP 混在一起。

类型
你可以把它理解成
主要作用
Extension
一段程序
注册工具、命令、事件和界面
Skill
一份带规则的操作手册
保存一套可复用的工作流程
MCP
外部服务的连接器
调用浏览器、文档、数据库或 API
Package
能力的安装包
把多个资源打包分发

简单记住:插件做事情,Skill 告诉 Pi 怎么做,MCP 连接外部世界。

安装和管理 Pi Package

安装 npm 包:

pi install npm:包名 

从 Git 仓库安装:

pi install git:github.com/用户名/仓库名 

查看、更新和删除:

pi list pi update pi remove npm:包名 

只想试用、不想永久安装:

pi -e npm:包名 

!第三方包拥有 Pi 进程权限。安装前先看源码、依赖,以及它会读取哪些文件。

推荐安装清单:把 Pi 补成接近 Codex 的工作台

Codex 的完整体验不是由一个插件提供的,而是由项目规则、Skill、MCP、子代理、权限控制和代码审查等能力共同组成。Pi 也可以补齐这些能力,只是需要自己选择组件。

下面这份清单按实用程度排列:

推荐包
补充的能力
主要用途
建议
pi-subagents
子代理和并行任务
把检索、规划、实现、审查和验证交给不同代理
优先安装
pi-background-tasks
后台命令
在后台运行测试、构建、开发服务器和长脚本
优先安装
pi-mcp-adapter
MCP 支持
连接 GitHub、浏览器、数据库和文档服务
优先安装
pi-web-access
允许Pi访问网络
查询最新资料、错误信息和项目文档
优先安装

@juicesharp/rpiv-ask-user-question

向用户询问问题
当遇到需要用户提供的信息时,自动弹出对话框询问用户
推荐安装
pi-permission-system
权限规则
为命令、写文件、MCP 和 Skill 设置允许、询问或拒绝
推荐安装
pi-memctx
项目记忆
保存架构、约定、决策和操作手册,减少重复分析
按需安装

@juicesharp/rpiv-todo

任务清单
显示多步骤任务的当前进度
按需安装
@pandi-coding-agent/worktree
Git Worktree
在独立目录和分支里并行处理任务
进阶安装
@georgedong32/pi-review
多代理代码审查
并行检查缺陷、安全和可维护性
进阶安装
如果你刚开始使用,先安装这五个:
pi install npm:pi-subagents 
pi install npm:pi-background-tasks
pi install npm:pi-mcp-adapter 
pi install npm:pi-web-access 

pi install npm:@juicesharp/rpiv-todo

安装完成后重启 Pi,运行:

/reload 

这套组合已经补齐了子代理、后台任务、外部工具、联网和todo,日常写代码时最容易感受到变化。

需要长期在项目里使用,再根据需求增加,也可以前往 https://pi.dev/packages 查看更多的插件,同名称推荐安装量靠前的。

给 Pi 安装一个 Skill

一个最小 Skill 通常长这样:

my-skill/ └── SKILL.md 

SKILL.md 可以这样写:

--- name: project-release description: 检查项目、运行测试并生成发布清单。 ---  # Project Release 1. 检查工作区状态。 2. 运行项目测试。 3. 汇总变更和风险。 

全局 Skill 放在:

~/.pi/agent/skills/ 

项目 Skill 放在:

.pi/skills/ 

加载后可以这样调用:

/skill:project-release 

Pi 还可以读取 Codex 的 Skill 目录:

{   "skills": ["~/.codex/skills"] } 
如果需要安装Skill,可以直接把Skill的文件路径给Pi,让它自己安装,或者前往 https://skillhub.cn/ 查找需要的Skill下载并安装,安装前请审查确保安全!

给 Pi 接入 MCP

Pi 的核心默认不包含 MCP,需要先安装适配器:

pi install npm:pi-mcp-adapter 

安装后重启 Pi,再运行:

/mcp setup 

项目级配置可以放在 .mcp.json。例如接入微软官方的 Playwright MCP,让 Pi 可以操作浏览器、检查页面和执行网页测试:

{  "mcpServers": {    "playwright": {      "command""npx",      "args": [        "-y",        "@playwright/mcp@latest"      ]    }  }}

MCP 越多,模型需要选择的工具越多,也越容易选错;先安装真正会用到的两个或三个。

常用操作:

/mcp 
/mcp tools 
/mcp reconnect 
/reload 

MCP 服务可能执行命令、访问文件或发送网络请求。先从一个可信、权限范围小的服务开始,再逐步增加能力。

到目前为止,Pi已基本完成配置,下一期,我们将正式开始使用Pi。

关注后续内容,继续把 Pi 变成自己的 AI 工具箱。

相关学习资料