Agent skill

Upgrade Pi

by maotoumao in maotoumao/Cebian

“升级pi-agent-core和pi-ai到最新版本”

— description from SKILL.md by maotoumao
AGPL-3.0Auto-check passedDevelopment

Install Upgrade Pi

skills CLI
$ npx skills add maotoumao/Cebian --skill upgrade-pi -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install maotoumao/Cebian upgrade-pi --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/maotoumao/Cebian.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/upgrade-pi .claude/skills/upgrade-pi && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
upgrade-pi
GitHub stars
164
Token cost
~894 tokens
SKILL.md length
241 words
Files
2
Skills in repo
7
Repo updated
First seen
Licence
AGPL-3.0

At a glance

  • Works in 7 steps: 两个包锁步升级到同一版本。lockfile 里 pi-agent-core… → typebox 跟随 pi,绝不单独升。本项目 package.json 把… → 本项目实际用法(评估破坏性变更时以这些为准) → …
  • SKILL.md covers 变更查询来源(按优先级), 硬性约束(务必遵守) and 工作流
  • Calls pnpm

About this skill

Upgrade Pi is a skill in maotoumao/Cebian (164 stars). Its SKILL.md is about 894 tokens, with 1 other file in the folder. Licence: AGPL-3.0.

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. 两个包锁步升级到同一版本。lockfile 里 pi-agent-core 依赖同版本 pi-ai;只升其中一个会造成版本错配。
  2. typebox 跟随 pi,绝不单独升。本项目 package.json 把 typebox 精确锁死(无 ^),就是为了和 pi 内部捆绑的 typebox 完全一致——两边 TSchema 类型标识必须是同一份,否则本项目用 Type.Object(...) 造出来的…
  3. 本项目实际用法(评估破坏性变更时以这些为准)
  4. 会话树与压缩依赖的 harness 已 vendor,不随 pi 升级。pi 1.0.0 删除了整个实验性 harness(Session 层、压缩函数、session/testing、compactionSummary 等自定义消息类型),本项目把用到的部分冻结在…
  5. 系统提示词与工具不进 agent.state。pi 0.86 起把系统提示词和工具声明作为 transcript 里的 role: 'system' 消息传递;本项目让 agent.state.messages 保持纯对话流(会话树的水位线 / 下标对齐依赖这一点),由…
  6. 版本范围用 ~。package.json 里两个包写 ~x.y.z(只放行 patch),minor 升级必须走本流程,避免一次 pnpm install 悄悄带进破坏性变更并与精确 pin 的 typebox 错位。
  7. 已知上游行为(已核实至 1.0.0,后续升级时重新核对):Copilot 下的 GPT-6 Sol / Luna 可选「关闭思考」,但 Responses 适配器对 github-copilot 不发送 effort: "none",由 Copilot…

What it can do on your machine

Read from SKILL.md and the folder at commit 68c3d16. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • pnpm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com
    • npmjs.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Upgrade Pi loads about 894 tokens when it runs. Until then it costs about 9 tokens; SKILL.md has 241 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~9
When it runs · the whole SKILL.md, loaded when a task matches
~894

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from maotoumao/Cebian at commit 68c3d16, republished under its AGPL-3.0 licence (© maotoumao). 241 words, ~894 tokens.

Download SKILL.mdSave it as .claude/skills/upgrade-pi/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
upgrade-pi
description
升级pi-agent-core和pi-ai到最新版本

帮我调研一下 @earendil-works/pi-agent-core 和 @earendil-works/pi-ai 的最新更新,深入调研我目前安装的版本和最新版本之间的更新内容和细节,确认后,和我讨论能否进行升级。

这是一次调研 + 讨论任务:默认不要改 package.json 或跑安装命令,讨论确认后再动。

变更查询来源(按优先级)

这两个包同属 pi monorepo(github.com/earendil-works/pi),变更日志在仓库里,不在 npm release notes,逐版本读、别只看最新一版:

两个 CHANGELOG 都遵循 Keep a Changelog(Breaking Changes / Added / Changed / Fixed / Removed)。重点抓 Breaking Changes。

硬性约束(务必遵守)

  1. 两个包锁步升级到同一版本。lockfile 里 pi-agent-core 依赖同版本 pi-ai;只升其中一个会造成版本错配。

  2. typebox 跟随 pi,绝不单独升。本项目 package.json 把 typebox 精确锁死(无 ^),就是为了和 pi 内部捆绑的 typebox 完全一致——两边 TSchema 类型标识必须是同一份,否则本项目用 Type.Object(...) 造出来的 schema 传给 pi 校验会类型不兼容,还可能产生两份 typebox 副本。

    • 升级 pi 后,去 pnpm-lock.yaml 查 pi 实际解析的 typebox 版本;只有当它变了,才把项目的 typebox 精确 pin 改成同一版本。
    • 参考:pi 的 typebox 迁移发生在 0.69.0(@sinclair/typebox 0.34.x → typebox 1.x);0.86.0 起精确依赖 typebox 1.3.27。
  3. 本项目实际用法(评估破坏性变更时以这些为准):

  4. 会话树与压缩依赖的 harness 已 vendor,不随 pi 升级。pi 1.0.0 删除了整个实验性 harness(Session 层、压缩函数、session/testing、compactionSummary 等自定义消息类型),本项目把用到的部分冻结在 0.84.4 快照,放在 lib/shims/pi-harness/(原因、偏离与维护约定见其 README)。升级 pi 时:

    • 不必再 diff 上游 harness(上游已不存在),但要按 README「维护约定」核对它依赖的 pi 公开 API(uuidv7、Models.completeSimple、retryAssistantCall、contentText、消息类型、CustomAgentMessages 等)没有变。
    • vendored conformance 套件(经 lib/persistence/session-tree.test.ts 运行)必须保持全绿。
  5. 系统提示词与工具不进 agent.state。pi 0.86 起把系统提示词和工具声明作为 transcript 里的 role: 'system' 消息传递;本项目让 agent.state.messages 保持纯对话流(会话树的水位线 / 下标对齐依赖这一点),由 entrypoints/background/agent/factory.ts 的 prepareRequest 按 AgentPreamble 在每次请求前现装 system 头。升级 pi 时:

    • 重点读 agent-loop 的 declareToolChanges、prepareRequest、prepareNextTurn(Agent 选项名为 prepareNextTurnWithContext)、finishTurn 有没有改语义或时序。
    • factory.test.ts 会兜住「每次请求都有头、system 消息永不进 state」这条不变式,必须保持全绿。
  6. 版本范围用 ~。package.json 里两个包写 ~x.y.z(只放行 patch),minor 升级必须走本流程,避免一次 pnpm install 悄悄带进破坏性变更并与精确 pin 的 typebox 错位。

  7. 已知上游行为(已核实至 1.0.0,后续升级时重新核对):Copilot 下的 GPT-6 Sol / Luna 可选「关闭思考」,但 Responses 适配器对 github-copilot 不发送 effort: "none",由 Copilot 服务端决定;Copilot 的 Gemini 条目 supportsReasoningEffort: false,思考档不生效。

工作流

  1. pnpm outdated 看两个包的 Current / Latest。
  2. 逐版本读上面两个 CHANGELOG(把 Current→Latest 之间每个版本都覆盖到),重点抓 Breaking Changes 和公开 API 改动。
  3. 交叉验证:CHANGELOG 与 npm 版本历史日期是否一致;破坏性变更是否命中本项目实际用法(别人眼里的 breaking 我们可能没用到)。
  4. 给结论 + 和我讨论:能否升、要不要顺带动 typebox(按上面约束判断)、升级后需要手动回归哪些链路(发消息 / 流式思考 / 工具调用 / 中止 abort / 模型切换 / 压缩 / 分支回卷)。默认不改 package.json,确认后再动。

© maotoumao, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in .agents/skills/upgrade-pi of maotoumao/Cebian.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit 68c3d16

Compare with similar skills

Upgrade Pi next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Upgrade Pi compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Upgrade Pi this skillmaotoumao/Cebian164—~894Automated safety check: PassAGPL-3.0
Repomix Browser Extension Developeryamadashy/repomix29k1 repos~288Automated safety check: PassMIT
Develop ExtensionPostHog/posthog-js633—~2.3kAutomated safety check: PassCustom licence
Commitbiuworks/bilibili-digest172—~450Automated safety check: PassCustom licence
Nx Run Tasksnomcopter/react-mosaic4.8k8 repos~613Automated safety check: PassCustom licence
Migrate Internal Package into GhostTryGhost/Ghost56k—~3.8kAutomated safety check: PassMIT

Similar skills

  • Use this skill when developing or maintaining browser extension code in the `browser/` directory, including Chrome/Firefox/Edge compatibility, content…

    29k GitHub starsUsed in 1 repo~288 tokens
    DevelopmentAuto-check passed
  • Develop Extension

    PostHog/posthog-js

    Official

    Author a new PostHog browser extension, or port a posthog-js v1 extension, against the @posthog/browser-common Client/Extension contract.

    633 GitHub stars~2.3k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Commit

    biuworks/bilibili-digest

    用户要求提交、commit、把改动入库,或让你生成/润色提交信息时使用。产出 type 英文 + 中文主题行的 Conventional Commits 提交,并执行本仓库约定:运行时文件先跑 npm test、不自动 push、发版用 release: 并同步三处版本号。

    172 GitHub stars~450 tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Nx Run Tasks

    nomcopter/react-mosaic

    Helps with running tasks in an Nx workspace. An agent skill from nomcopter/react-mosaic.

    4.8k GitHub starsUsed in 8 repos~613 tokens
    DevelopmentAuto-check passed
  • Moves a package from another TryGhost repository into Ghost as an internal workspace package while keeping its Git history, with checkpoints for the steps that need an administrator.

    56k GitHub stars~3.8k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Open Code Review CLI

    alibaba/open-code-review

    Runs the ocr command-line tool to review Git changes, a commit or a branch comparison with an AI model, returning line-level comments and optionally applying fixes.

    46k GitHub stars~3.1k tokensUpdated yesterday
    DevelopmentAuto-check passed

More from maotoumao/Cebian

  • Code Review

    maotoumao/Cebian

    A skill your agent uses when completing a coding task to perform senior-level code review.

    164 GitHub stars~3.6k tokensUpdated yesterday
    Auto-check passed
  • I18n Naming

    maotoumao/Cebian

    Cebian project i18n key naming, placeholder, pluralization, file layout, and glossary conventions.

    164 GitHub stars~3.7k tokensUpdated yesterday
    Auto-check passed
  • Skill Creator

    maotoumao/Cebian

    Create new Cebian skills, edit or improve existing ones, scaffold multi-file skill packages, and validate them against the agentskills.io specification.

    164 GitHub stars~3k tokensUpdated yesterday
    Auto-check passed
  • Cl

    maotoumao/Cebian

    审计自上次发版以来的提交,把遗漏的「用户可见变更」补进 CHANGELOG.md 的 [Unreleased];可选地把 [Unreleased] 收口成正式版本节

    164 GitHub stars~428 tokensUpdated yesterday
    Auto-check passed
  • Upgrade Packages

    maotoumao/Cebian

    调研 package.json 所有依赖的最新版本,交叉验证版本差异,给出可升级到最新版的结论. An agent skill from maotoumao/Cebian.

    164 GitHub stars~505 tokensUpdated yesterday
    Auto-check passed
  • Start Task

    maotoumao/Cebian

    Resume execution of an approved plan from the next unchecked subtask, following the gated Task Execution Workflow in AGENTS.md.

    164 GitHub stars~580 tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Upgrade Pi

How do I install Upgrade Pi in Claude Code?

Run `npx skills add maotoumao/Cebian --skill upgrade-pi -a claude-code`. Or copy the skill folder (.agents/skills/upgrade-pi in maotoumao/Cebian) into .claude/skills/upgrade-pi in your project. Claude Code loads it when a task matches its description.

How do I install Upgrade Pi in Codex?

Run `npx skills add maotoumao/Cebian --skill upgrade-pi -a codex`. Or copy the skill folder (.agents/skills/upgrade-pi in maotoumao/Cebian) into .agents/skills/upgrade-pi in your project. Codex loads it when a task matches its description.

Can I use Upgrade Pi in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add maotoumao/Cebian --skill upgrade-pi -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/upgrade-pi, .gemini/skills/upgrade-pi, .github/skills/upgrade-pi and .opencode/skills/upgrade-pi in your project.

What does Upgrade Pi need to run?

Going by SKILL.md and its folder, Upgrade Pi needs the command-line tools its instructions call (pnpm).

Does Upgrade Pi access the network?

SKILL.md names 2 domains. As links in the text: github.com and npmjs.com. This is read from the text; nothing was executed.

Is Upgrade Pi safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Upgrade Pi use?

Upgrade Pi is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Upgrade Pi use?

About 894 tokens (SKILL.md is roughly 3.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Upgrade Pi?

Skills that share tags, products or a category with Upgrade Pi: Repomix Browser Extension Developer (yamadashy/repomix, 29k stars), Develop Extension (PostHog/posthog-js, 633 stars), Commit (biuworks/bilibili-digest, 172 stars) and Nx Run Tasks (nomcopter/react-mosaic, 4.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Upgrade Pi?

maotoumao (a GitHub user) maintains it in maotoumao/Cebian, which has 164 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 10, 2026.

Source: maotoumao/Cebian on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.