bestony-pi-preset

Bestony 的 Pi coding agent preset。

通过 Pi Package 打包并分发个人常用的 extensions / skills / prompts / themes，安装后即可在 Pi 中自动加载。

Security: Pi packages 拥有完整系统权限。Extensions 可执行任意代码，skills 可指示模型执行任意操作。安装第三方包前请先审阅源码。

安装

# 从本地路径安装（开发中）
pi install /absolute/path/to/bestony-pi
pi install ./relative/path/to/bestony-pi

# 从 git 安装（发布后）
pi install git:github.com/bestony/bestony-pi
pi install https://github.com/bestony/bestony-pi

# 从 npm 安装（发布后）
pi install npm:bestony-pi-preset

仅当前会话试用（不写入 settings）：

pi -e /path/to/bestony-pi
pi -e git:github.com/bestony/bestony-pi

安装到项目级（写入 .pi/settings.json，可团队共享）：

pi install -l /path/to/bestony-pi

卸载 / 管理

pi remove npm:bestony-pi-preset   # 或对应 source
pi list
pi update --extensions
pi config                         # 启用/禁用具体资源

包结构

bestony-pi/
├── package.json          # pi manifest + pi-package keyword
├── README.md
├── extensions/           # .ts / .js 扩展
├── skills/               # SKILL.md 技能目录
├── prompts/              # .md 提示词模板
└── themes/               # .json 主题

package.json 中的 pi 字段声明资源路径：

{
  "name": "bestony-pi-preset",
  "keywords": ["pi-package"],
  "pi": {
    "extensions": ["./extensions"],
    "skills": ["./skills"],
    "prompts": ["./prompts"],
    "themes": ["./themes"]
  }
}

路径相对于包根目录；数组支持 glob 与 !exclusions。

若省略 pi manifest，Pi 会从同名约定目录自动发现资源。

开发

1. 在对应目录添加资源：
   • extensions/*.ts — 扩展
   • skills/<name>/SKILL.md — 技能
   • prompts/*.md — 提示词
   • themes/*.json — 主题
2. 本地加载验证：

pi -e .
# 或
pi install .

3. 用 pi config 检查资源是否被加载。

依赖约定

• 运行时第三方依赖放在 dependencies（pi install 会执行 npm install）
• 若 import Pi 核心包，放入 peerDependencies 且版本为 "*"，不要打包：
  • @earendil-works/pi-ai
  • @earendil-works/pi-agent-core
  • @earendil-works/pi-coding-agent
  • @earendil-works/pi-tui
  • typebox

内置依赖（bundled pi packages）

安装本 preset 时会一并带上下列 Pi 包，并自动加载其 extensions / skills：

包	提供
pi-web-access	Web 搜索 / URL 抓取 / GitHub / YouTube 等扩展 + librarian skill
pi-init	init skill（生成/更新 AGENTS.md）
pi-mcp-adapter	MCP 协议适配扩展
pi-cache-optimizer	Prompt/KV cache 命中优化
pi-session-name	自动生成会话标题并同步终端标题状态
@lanlance/pi-recap	Claude Code-style session recap / status line above the Pi status bar
@dietrichgebert/ponytail	pi-extension + skills for status line and agent-mode tooling
@narumitw/pi-goal	Autonomous single-objective /goal completion extension
pi-xai-oauth	xAI OAuth provider / authenticated Grok model catalog
@tintinweb/pi-subagents	Claude Code 风格的自主 sub-agents
@tintinweb/pi-tasks	Claude Code-style task tracking and coordination
@quintinshaw/pi-dynamic-workflows	动态 workflow（workflow 工具、/workflows 等）

它们声明在 dependencies + bundledDependencies 中，资源通过 pi.extensions / pi.skills 的 node_modules/... 路径引用。

自动发布

发布使用 npm Trusted Publisher（OIDC），无需在仓库中配置 NPM_TOKEN。Workflow 文件：.github/workflows/daily-release.yml。

触发方式

触发	行为
push 到 main	自动发布。若当前 package.json 版本已在 npm 上存在，则自动 patch 升版、创建 chore(release): x.y.z commit、annotated vX.Y.Z tag 和 GitHub Release 并推回远端
每日北京时间 0:00（cron: 0 16 * * * UTC）	用 npm-check-updates 更新依赖；有变更才升版发布；无变更则跳过
手动 Run workflow	同日更逻辑；可勾选 force_publish 强制发一版

Bot 自己的 chore(release): 提交不会再次触发发布，避免循环。

版本规则

• 你已手动升版且该版本尚未发布 → 直接按该版本发布
• 你未升版（版本已在 npm 上）→ CI 自动 patch 并帮你推送 release commit

手动触发

1. GitHub → Actions → Release → Run workflow
2. 可选勾选 force_publish

首次启用前请确认：

• npm 包 Settings → Trusted Publisher 指向 bestony / bestony-pi / daily-release.yml
• 仓库 Settings → Actions → Workflow permissions 为 Read and write

GitHub Releases and release notes

After npm publish succeeds, the workflow pushes the release commit and its annotated vX.Y.Z tag before creating the matching GitHub Release. When both objects are new, the branch ref and explicit tag ref are pushed atomically so a release cannot be published with only one of them on the remote. The tag annotation is Release vX.Y.Z.

The release body is generated by .github/scripts/generate-release-notes.mjs. It compares the previous reachable version tag with the release commit (or the previous chore(release): commit when tags are not available), filters version-only release commits, and groups Conventional Commits into Features, Fixes, Performance, Documentation, and Maintenance. Direct dependency additions, removals, and range changes are listed separately with npm package links. Every listed commit links to GitHub, and the body ends with a Full Changelog comparison link. A forced release with no commits or direct dependency changes states Maintenance release with no user-facing changes.

If a release with the same tag already exists, the workflow logs the condition and skips creation; any other gh release create failure fails the workflow. Published releases are visible at GitHub Releases.

当前本地资源

类型	状态
Extensions	待添加（./extensions）
Skills	待添加（./skills）
Prompts	待添加（./prompts）
Themes	待添加（./themes）

License

MIT