Pi Agent技能与插件:如何10分钟给AI智能体装上新能力
Pi Agent技能与插件:如何10分钟给AI智能体装上新能力
Pi Agent 是一款跨平台的 AI 编程智能体桌面应用,它内置的 Skills(技能) 与 Plugins(插件) 体系,让你无需写代码就能给 AI 智能体"装上新能力":用一句话搜索并安装技能包,用开关控制智能体何时调用它们,还能从 npm、Git 仓库或本地路径安装插件,扩展出提示词、主题和自定义扩展。本文带你 10 分钟走完"搜索 → 安装 → 启用 → 更新"的完整流程。
技能与插件:两种扩展方式怎么选?
在 Pi Agent 中,扩展智能体能力主要有两条路径:
| 对比项 | Skills(技能) | Plugins(插件) |
|---|---|---|
| 本质 | 一份 SKILL.md 文档,教智能体做某类任务 |
一个资源包,可携带扩展、技能、提示词、主题 |
| 典型来源 | skills.sh 技能市场、项目内 .agents/skills 目录 |
npm 包、Git 仓库、本地路径 |
| 生效方式 | 开启后自动注入到模型提示中 | 安装后按资源类型各自生效 |
| 适合场景 | 补充方法论、工作流、领域知识 | 批量注入多类资源或 UI 扩展 |
- 技能在运行时由资源加载器统一发现,全局技能、项目技能、
settings.json中配置的技能路径都会被纳入,源码位于 skills-service.ts。 - 一个插件包可以同时携带 4 类资源(extensions / skills / prompts / themes),面板会分别统计数量,逻辑见 route.ts。
💡 简单记:只想教会智能体一种本领,装 Skill;想一次性带入一整套资源,装 Plugin。
第一步:打开技能管理面板
- 在 Pi Agent 主窗口左下角的工具栏中,点击 Skills(齿轮图标旁)。
- 面板左侧按"全局 / 项目 / 路径"三个作用域分组展示已安装的技能,右侧显示当前选中技能的详情。
- 面板代码位于 SkillsConfig.tsx,其中
global、project、path三种作用域决定了技能的可见范围:- 全局(global):装到
~/.agents/skills,所有项目共用; - 项目(project):装到项目的
.agents/skills,只对本项目生效,适合团队协作共享。
- 全局(global):装到
第二步:搜索并一键安装技能
面板顶部的搜索框会实时查询 skills.sh 技能市场(见 route.ts),按安装量排序返回候选技能,每个结果都带"安装量"标签,帮你快速判断成熟度。
选中结果后点击安装,背后执行的是 route.ts 中的安装命令:
npx skills add <技能包> -y --agent pi # 全局安装再加 -g
安装全程在应用内完成,无需打开终端,也不需要预装 Node.js 环境——桌面端已内置运行环境。安装成功后,新技能会立刻出现在对应作用域分组中。
第三步:一键开关,控制技能何时生效
Pi Agent 的技能开关不是"删除/保留",而是精确修改 SKILL.md 文件头部的 disable-model-invocation 字段:
- 开启:技能内容会注入模型提示,智能体可主动调用;
- 关闭:文件保留但"隐身",模型看不到,随时可再打开。
这个开关只动一个 frontmatter 字段,你自定义的格式和注释都不会被破坏(见 settings-ui.md)。面板还支持"全部启用 / 全部禁用"的批量操作,route.ts 会逐个文件处理并独立报告结果,某个文件出错不会拖垮整批。
插件管理:安装、禁用与更新
点击左下角的 Plugins 进入插件面板(PluginsConfig.tsx),支持以下操作:
- 安装:粘贴来源即可,支持 npm 包、Git 仓库 URL 或本地绝对路径三种格式,例如
npm:@scope/pi-plugin(见 PluginsConfig.tsx)。 - 启用 / 禁用:带资源筛选的插件建议使用它自己的开关,避免清空筛选条件;
- 更新 / 移除:与技能一样一键完成,状态实时刷新。
面板底部会汇总当前加载的扩展、技能、提示词、主题总数,让你对"智能体到底带了哪些能力"一目了然。
保持能力常新:检查与更新技能
通过 skills.sh 或 Git 安装的技能,面板支持"检查更新"和"一键更新":
- 更新逻辑在 skill-updates.ts 中构造与安装时一致的参数,确保覆盖安装到原来的作用域;
- 版本号会显示在技能详情页,更新前可先对比版本,避免误操作。
常见问题:新手最容易踩的 3 个坑
- 项目技能装不进去? 项目需要先被标记为"受信任"(Project Trust),否则安装项目级技能会被拦截,详见 install/route.ts 的信任检查逻辑。
- 技能装了却没生效? 检查开关状态:被关闭的技能不会进入模型提示;新装技能建议开启一个新会话验证。
- 全局还是项目? 个人通用方法论选全局;与项目强相关、需要随仓库共享的选项目,这样团队成员打开项目即自动获得同一套技能。
写在最后
Pi Agent 把"给 AI 智能体扩展能力"变成了一次鼠标操作:搜索技能市场、一键安装、开关控制、自动更新,全程不需要敲一行命令。结合 README 中提到的模型管理与定时任务能力,你可以很快搭建出一个懂自己工作流的私人 AI 编程助手。



