Pi Agent技能与插件:如何10分钟给AI智能体装上新能力

原创2026-10-27 09:40:081,849 阅读

Pi Agent技能与插件:如何10分钟给AI智能体装上新能力

Pi Agent 是一款跨平台的 AI 编程智能体桌面应用,它内置的 Skills(技能) 与 Plugins(插件) 体系,让你无需写代码就能给 AI 智能体"装上新能力":用一句话搜索并安装技能包,用开关控制智能体何时调用它们,还能从 npm、Git 仓库或本地路径安装插件,扩展出提示词、主题和自定义扩展。本文带你 10 分钟走完"搜索 → 安装 → 启用 → 更新"的完整流程。

Pi Agent 桌面端主界面,左下角可见 Skills 与 Plugins 管理入口

技能与插件:两种扩展方式怎么选?

在 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 与 Plugins 入口

  1. 在 Pi Agent 主窗口左下角的工具栏中,点击 Skills(齿轮图标旁)。
  2. 面板左侧按"全局 / 项目 / 路径"三个作用域分组展示已安装的技能,右侧显示当前选中技能的详情。
  3. 面板代码位于 SkillsConfig.tsx,其中 global、project、path 三种作用域决定了技能的可见范围:
    • 全局(global):装到 ~/.agents/skills,所有项目共用;
    • 项目(project):装到项目的 .agents/skills,只对本项目生效,适合团队协作共享。

Pi Agent 深色模式界面,展示会话列表与任务执行过程

第二步:搜索并一键安装技能

面板顶部的搜索框会实时查询 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 会逐个文件处理并独立报告结果,某个文件出错不会拖垮整批。

Pi Agent 模型选择器,展示多模型切换能力,技能安装后可自由搭配模型

插件管理:安装、禁用与更新

点击左下角的 Plugins 进入插件面板(PluginsConfig.tsx),支持以下操作:

  • 安装:粘贴来源即可,支持 npm 包、Git 仓库 URL 或本地绝对路径三种格式,例如 npm:@scope/pi-plugin(见 PluginsConfig.tsx)。
  • 启用 / 禁用:带资源筛选的插件建议使用它自己的开关,避免清空筛选条件;
  • 更新 / 移除:与技能一样一键完成,状态实时刷新。

面板底部会汇总当前加载的扩展、技能、提示词、主题总数,让你对"智能体到底带了哪些能力"一目了然。

保持能力常新:检查与更新技能

通过 skills.sh 或 Git 安装的技能,面板支持"检查更新"和"一键更新":

  • 更新逻辑在 skill-updates.ts 中构造与安装时一致的参数,确保覆盖安装到原来的作用域;
  • 版本号会显示在技能详情页,更新前可先对比版本,避免误操作。

常见问题:新手最容易踩的 3 个坑

  1. 项目技能装不进去? 项目需要先被标记为"受信任"(Project Trust),否则安装项目级技能会被拦截,详见 install/route.ts 的信任检查逻辑。
  2. 技能装了却没生效? 检查开关状态:被关闭的技能不会进入模型提示;新装技能建议开启一个新会话验证。
  3. 全局还是项目? 个人通用方法论选全局;与项目强相关、需要随仓库共享的选项目,这样团队成员打开项目即自动获得同一套技能。

写在最后

Pi Agent 把"给 AI 智能体扩展能力"变成了一次鼠标操作:搜索技能市场、一键安装、开关控制、自动更新,全程不需要敲一行命令。结合 README 中提到的模型管理与定时任务能力,你可以很快搭建出一个懂自己工作流的私人 AI 编程助手。

登录后查看全文
pi-agent-desktop