AI 简明手册Skills、Prompt Templates、Themes 与 Packages
先看全局
Skill、Prompt Template 和 Theme 分别封装按需方法、可复用输入与视觉样式；Pi Package 则把这些资源连同 Extension 一起打包、配置和分发。
沿地图找代码
四类资源职责不同
Skill 用 SKILL.md 描述适用时机和操作方法；Prompt Template 从 slash 命令展开成输入；Theme 定义终端颜色；Extension 执行 TypeScript 代码并接入运行时。
[repo] [docs]
Package 是分发边界
Package 可来自 npm、Git 或本地目录，并在 manifest 中声明 extensions、skills、prompts 和 themes；用户可以逐项启用、禁用或固定来源。
[repo] [docs]
建议阅读顺序
只需要传递工作方法时优先 Skill；需要运行时代码、工具或 UI 时才用 Extension。
团队共享时把互相依赖的资源放进一个 Package，并固定版本或 commit，减少“文档在、扩展没装”的漂移。
这张地图没覆盖什么
Package 统一了分发，不自动提供隔离、签名验证或兼容性保证；其 Extension 与依赖仍会以本地代码运行。
来源与核验
- [repo] Pi 官方源码（固定 revision）
- [docs] Pi 官方文档
Revision：853a80d26c90a14c1886f0ebb8ffaae133ca2185 · 核验日期：2026-08-31