Pi Agent 扩展体系：编写你的第一个 TypeScript Extension 与 Skill

Extensions 与 Skills 的分工

• **Skills (SKILL.md)：面向模型的流程指南**。教模型在特定场景下按什么规范干活。
• **Extensions (.ts)：面向运行时的能力插槽**。编写真实 TypeScript 代码给 Agent 注入全新工具、事件监听与终端 UI 交互。

编写一个最小 TypeScript Extension

在 ~/.pi/agent/extensions/ 下创建一个 .ts 文件：

```typescript import type { ExtensionContext } from "@earendil-works/pi-coding-agent";

export default function myExtension(ctx: ExtensionContext) { // 1. 注册一个自定义工具给模型调用 ctx.registerTool({ name: "notify_slack", description: "发送部署通知到团队 Slack 频道", parameters: { type: "object", properties: { message: { type: "string", description: "通知内容" }, }, required: ["message"], }, execute: async ({ message }) => { console.log("[Slack]", message); return { ok: true, status: "sent" }; }, });

// 2. 监听会话开始事件 ctx.on("session_start", (session) => { console.log("Session started in:", session.cwd); }); } ```

启动 pi 时，扩展会自动热加载，模型立刻拥有了 notify_slack 工具。

打包与分发：Pi Packages

你可以把写好的 Extensions、Skills、Prompt Templates 和自定义 Themes 打包进一个 npm 包或 Git 仓库，其他人只需一行命令即可安装：

bash pi pkg install git@github.com:myorg/team-pi-pack.git

官方来源：Pi Coding Agent Extensions Manual。