跳到主內容

Theme / 0.3.2

ThinkRail

圍繞 pi 代理的代理式 IDE

基礎觀念

Agent Skills 與 bundled workflows:手藝就地讀,流程內建好

🟡 中階|你為其他代理準備的 Agent Skills 原地讀取、不用搬家(~/.pi、~/.claude、~/.codex、~/.copilot、~/.gemini 都掃);出貨用的工作流——專案設置、設計發想、開 PR——開箱即有,PR 走你自己的 gh。

Skills:在哪裡,就在哪裡讀

官方部落格(2026-10-01《An agentic IDE that follows Pi’s philosophy》):

Similarly, Pi’s skills and extensions are automatically recognized and usable from ThinkRail.

ThinkRail discovers them in the ~/.pi, ~/.claude, ~/.codex, ~/.copilot, and ~/.gemini, but also - in the case of Pi, Claude, and Gemini - in their counterparts in the specific project you are working on.

白話:全域五個資料夾+專案內對應資料夾都會被掃。你在 Claude Code / Codex / Gemini 環境累積的技能,ThinkRail 直接吃。

Skills 視窗

同一篇文章描述的操作:先選專案與工作區(技能清單隨工作區不同),然後:

…click the “Skills” button in the top-right corner of the main view.

清單分兩段:ThinkRail bundled skills 在前,來自 pi、其他代理與專案定義的在後。磁碟上的技能描述有變更時,會跳 “Skills changes on disk” 通知,按 Reload 重載。

三個相容性注意事項(官方 caveats 逐字重點)

  1. 技能跑在 ThinkRail 內嵌的 pi 上,版本可能與你另外裝的 pi 不同,少數技能可能因此不正常。
  2. 改 pi 視覺介面的擴充不適用(例如 pi themes 是給終端 UI 的);但加引擎側行為的擴充(tools、event hooks、slash commands、簡單 dialogs)可用。
  3. 兩個擴充註冊同一個工具名時,pi 兩個都載、回報衝突,載入順序決定誰生效。

Workflows:三件內建流程

README:

…bundled workflows guide project setup, design brainstorming, and shipping a pull request — pushing the workspace branch and opening or updating its GitHub PR through your own gh.

內建 workflow 做什麼
Project setup 新專案的設置引導
Design brainstorming 動手前的設計發想
Shipping a PR 推工作區分支、開/更新 GitHub PR——透過你自己的 gh

「through your own gh」呼應原則 The user's own tools and credentials.:出貨走你機器上的 gh CLI 與你的 GitHub 憑證,ThinkRail 不經手帳號。

這些能力怎麼來的:pi 擴充

引擎主機啟動時載入 bundled 擴充(packages/server/src/agent/extensions.ts):

extensionPaths: [specGraphPath, workflowPath, todosPath]
  • pi-spec-graph——規格圖七工具(前一課)
  • pi-thinkrail-workflow——上面的 bundled workflows
  • pi-todos——共用的計畫/待辦

官方部落格另列 bundled 清單:pi-web-access、pi-visualize、pi-spec-graph、pi-thinkrail-workflow、pi-todos “and a few others”。另有一組 ThinkRail 自家擴充(ask-user-question、visualize、web-access)在下一課展開。

在哪裡管理

Settings → Extensions 列出代理拿到的全部擴充,可逐一開關;也能從這裡安裝任何 pi 套件(npm / git / 本機資料夾)。詳見下一課。

下一課

擴充與 pi 套件——結構化提問、視覺化、網路存取三件自家的,加上整個 pi 生態。