小白学 AI Agent 第 6 期：Extension 和 Pi Package 是什么

前一期的 Skill 主要告诉 Pi“应该怎样做”。如果你想增加一个新命令、一个工具按钮，或者把 Skill、模板、主题和扩展打包分享，就会遇到 Extension 和 Pi Package。

一、Extension 负责增加行为

Extension 是可以被 Pi 加载的扩展代码。它能够注册命令、工具、事件处理和界面组件。

例如，一个扩展可以增加 /hello 命令，也可以在工具调用前提醒你确认。它比 Skill 更像程序，因为它能执行代码并改变交互过程。

这也意味着风险更高。安装扩展前要先看来源、代码和它需要的权限。

二、Pi Package 是一组可分发资源

Pi Package 可以把 Extension、Skill、提示模板和主题放在一起，形成一个可安装的工作包。

你可以把它理解成一个工具箱，而不是单独的一把螺丝刀。安装后，工具箱里的资源是否启用，还要看 Pi 的配置。

三、先认识命令，不急着安装

Pi 支持这些包管理命令：

pi install <source>
pi list
pi config
pi remove <source>

pi install 安装包，pi list 查看已安装内容，pi config 管理资源，pi remove 移除包。

第一次练习可以先运行：

pi list

只查看当前环境，不安装任何东西。

四、为什么扩展要单独审查

一个普通 Markdown Skill 主要提供文字规则。Extension 可能读文件、运行命令、发送网络请求或改变工具行为。

安装前至少检查：

• 来源是否可信。
• 是否有清晰的说明和许可证。
• 代码是否包含未知的网络请求。
• 它会读取哪些文件或环境变量。
• 是否能在项目级别安装，避免影响所有项目。

不要看到“给 Agent 增加能力”就直接安装。能力越多，边界越要清楚。

五、全局安装和项目安装

有些包可以全局安装，也可以只安装到当前项目。项目级安装更适合初次试用，因为影响范围较小。

如果包会加载项目配置，Pi 可能要求你确认项目是否信任。陌生项目不要直接按确认，先阅读它包含的文件和扩展。

六、什么时候值得用扩展

如果你只需要固定提示，先用提示模板。需要稳定工作流程时，用 Skill。只有当你需要新命令、新工具或新界面时，才考虑 Extension。

这是一个简单的选择顺序：先用文字解决，解决不了再加代码。这样能减少安装数量，也更容易排查问题。

下一期我们不安装复杂扩展，而是用 Pi 完成一个小项目，练习如何把需求、文件、工具和检查结果串起来。