Theme / v5.3.3
Ponytail
讓 AI 編碼代理像最懶的資深工程師
Changelog
版本更新紀錄
收錄 Ponytail 的版本變遷軌跡。每條紀錄以舊值→新值呈現，舊值以紅線劃掉但保留可見，方便對照改動軌跡。
v5.3.3
已同步2026-10-30- 2026-11-06 查核：上游最新 release 仍為 v5.3.3（2026-10-29 發布），其後無新版本。
- 版本定位：v5.3.2→v5.3.3，2026-10-29 發布，官方定位「This one cleans up the band」——延續 5.3 的 band/board 主軸的修復群，無主線新功能。
- Band 修復群：在 Team、Enterprise 與受管理的機器上，第一個 prompt 的警告消失，band 再次顯示 model 與 session 名稱；VS Code 中 band 維持單行（#1302，僅在終端機依 bodyColumns 調整列寬）；其他 plugins 的輸出不再被冠上 ponytail 的名字——band 只監看
/clear、/resume與/branch（#1291）；噪音的「duplicate?」提示移除、改為只計 project files、details view 更緊湊（#1305）；/clear與/resume後 band 重新顯示 level（#1161）；不需 classic hook 也能找到 transcript（#1242）。 - Windows 慢啟動修復：hooks 加上 15 秒 timeout，Windows 上緩慢的 node 啟動不再吞掉 hooks 輸出（#1165）；codebase map 給 3 秒，慢啟動時 map 仍能保留（#1166）。
- 其他修復：map 的
git ls-filesbuffer 加大，大型 repo 的 tracked files 不再被截掉（#1156）；Codex 的 composer icon 從 554 KB logo 換成小圖示（#1164）；benchmark 的 workdir 清理前先等被殺掉的 todo server 退出（#1116）。 - CI 與文件：agentic benchmark selftest 進入 test workflow（#1154）；文件釐清 Cursor mode 的 state scope（#1135）。
- 既有使用者影響：band 使用者在受管理機器上不再看到首 prompt 警告、model/session 名稱恢復顯示；裝了其他 prompt mods 的使用者不再看到自己的輸出被標成 ponytail；Windows 慢啟動環境的 ruleset/map 到達率提升。
v5.3.2
舊版本2026-10-18- 2026-10-28 查核：上游最新 release 仍為 v5.3.2（2026-10-16發布），其後無新版本。
- 版本定位：v5.2.0→v5.3.2，涵蓋 v5.3.0（2026-10-16 07:52 UTC）、v5.3.1（同日 13:40 UTC）與 v5.3.2（同日 23:15 UTC）三個 release。主軸：the band 與 the board——Claude Code prompt 上方的一條狀態帶與跨專案任務看板。
- The band（v5.3.0，#1138）：Claude Code prompt 上方一條 band，顯示當前任務的成本、tokens、agent 時間、重用了多少既有程式碼、測試是否仍通過。一鍵開啟 the board——本地頁面，羅列你所有專案的每個任務，附可分享的卡片。一切預設留在你的機器上；
/ponytail band可隱藏；需要 Claude Code 2.1.290 或更新。 - The band 的三批修復（v5.3.1）：其他 mods 顯示在 band 下方而非消失（#1146）；Windows 無
HOME時回退USERPROFILE（#1144）；寫 task ledger 與 board 不再依賴mkdir（#1145）。 - 舊 session 上看板（v5.3.2，#1152）：
/ponytail band import讀取你過去的 Claude Code sessions 一次，附上各自成本、agent 時間與 tokens，讓今昔可比；board 另顯示每個 session 用的 model。 - 小修（v5.3.0）：Qoder 在
/ponytaildefault turn 保留 ruleset（#1115）；Hermes 在/ponytail off後送出 off 通知（#1121/#1122）；skills 移除誤導的 one-shot revert 說明（#1125）。 - 既有使用者影響：想讓成本與重用可見，升級 Claude Code 至 2.1.290+ 後開啟 band；隱私敏感者留意 band/board 預設全在本機，分享需手動。
- 完整教學見
lessons/v5300-v5320-band-and-board.mdx。
v5.2.0
舊版本2026-10-14- 2026-10-16 查核：上游最新 release 仍為 v5.2.0（2026-10-13 發布），其後無新版本。
- 版本定位：v5.1.0→v5.2.0，涵蓋 v5.1.1（2026-10-12 23:18 UTC，官方定位「A fix release」）與 v5.2.0（2026-10-13 01:48 UTC，官方定位「Mostly fixes for the level you pick」）兩個 release。
- SessionStart map 安全（v5.1.1）：修復 5.0 codebase map 的兩個問題——repo 能把自己的文字塞進隱藏的 session context、repo 內的 symlink 能掛住 session 啟動導致 ruleset 永遠不到達；兩者皆修，且 map 加上一秒上限，rules 必定載入（#1070 @dkorunic、#1082）。hooks 在專案釘舊 Node（Node 12）時仍可載入（#1078）。
- OpenCode 2 三修與 /ponytail-debt（v5.1.1）：compaction hook 註冊 ruleset（#1089）；無 $ARGUMENTS 模板時保留 command arguments（#1090）；丟棄 stale V2 mention offsets（#1097）；/ponytail-debt 改用 git grep、跳過所有 gitignored 資料夾（#1108）。另：bench completeness judge 檢查 agent 實際交付（#1094）、Devin CLI 與 OpenClaw 進 adapter 表（#1066）、Antigravity 對齊（#1083）。
- level 在 compaction 後保留（v5.2.0，#1074）：你選的 level 在 context compaction 後存活，不再退回預設；macOS 上 hooks 輸出同步寫出——process.exit 不再丟失輸出，ruleset 必定到達（#1112）。
- installer 平台修正（v5.2.0）：Cursor installer 保留看不懂的 hooks.json（#1059）與相似名使用者 hooks（#1052）；OpenCode 不再卡 review、支援
/ponytail default（#1103——review 永不存為 level）；pi 自動補全 /ponytail 參數（#1080）；OMP session 切換後恢復模式（#1050）；Qoder QODER_CONFIG_DIR（#1057）；Hermes 手動安裝文件（#1111）並移除 unreachable review mode（#1105）；uninstall 移除 OpenCode mode flag（#1104）；bench crashed cell 不炸 run summary（#1110）。 - 既有使用者影響：OpenCode 使用者的 level 在長 session 壓縮後不再跳回預設；macOS 用戶 ruleset 到達率修復；以 tiered hooks 名稱安裝的 Cursor 用戶升級後自訂 hooks 不再被誤刪。
v5.1.0
舊版本2026-10-12- 2026-10-13 查核：上游最新 release 仍為 v5.1.0（2026-10-08 發布），其後無新版本。
- 版本定位：v4.13.0→v5.1.0，涵蓋 v5.0.0（2026-10-08 03:51 UTC）與 v5.1.0（同日 16:20 UTC）兩個 release——v5.0.0 是主版本，官方定位「Ponytail 5 is rebuilt from the ground up: new rules, a new review, a new audit」。
- 規則重寫、約減半（v5.0.0）：目標是 the smallest complete change——動筆前 agent 先畫出變更必須觸及的一切（callers、tests、config）與可能弄壞什麼；每則回覆以誠實收尾：列它跳過了什麼、沒檢查什麼、以及任何風險。
- Codebase map（v5.0.0）：session 起始時 agent 拿到一份 repo 已存在內容的短地圖——先重用、後新寫，直接攻擊重複造輪子的浪費源。
- /ponytail-review 重建（v5.0.0）：完整審查涵蓋 bugs、security、real load、missing tests、speed 與 what to cut，讀變更觸及的程式碼本體而不只讀 diff；每個 finding 寫明：程式在做什麼、哪裡出問題、怎麼修、不修會怎樣。/ponytail-audit 把同一套檢查套到整個 repo、排好優先順序。
- 新版 agentic benchmark（v5.0.0）：以「同一 agent 不裝 skill」為對照（Claude Code、Opus 5.5、39 任務、含真實 FastAPI + React repo、每項 5 次）：-53% 程式碼、-41% 時間、-26% 成本、-45% 輸出 token，98% 高風險邏輯附測試（對照 68%）；方法與限制公開於 repo 內 benchmarks/results/2026-10-07-agentic.md。
- 中性 shortcut: 標記（v5.1.0，#1068）：Ponytail 不再把名字寫進你的程式碼——刻意捷徑改以
shortcut: <the limit>, <when to upgrade>中性註解標記；/ponytail-debt仍找得到舊ponytail:標記（ledger 不斷帳），可在 CLAUDE.md/AGENTS.md 宣告自訂字後以/ponytail-debt <word>改用。出貨前對 5.0.0 實測：標記數、通過率、成本相同——只改註解文字不通行為。 - 既有使用者影響：v4.x 的
ponytail:標記仍被 ledger 讀取，不需手動遷移；引用 benchmark 數字時改用 v5 agentic 版本；審查流從「看 diff」升級為「讀本體」。
v4.13.0
舊版本2026-10-07- 版本定位：v4.10.0→v4.13.0，涵蓋 v4.10.1～v4.10.3、v4.11.0、v4.12.0、v4.13.0 六個 release（2026-10-02～10-05，無跳號）。主軸：OpenCode 2 支援（v4.10.1）、安全與可靠性（v4.10.2）、per-project mode（v4.10.3）、Codex hook 註冊回歸修復（v4.11.0）、findings 編號與誠實 benchmark（v4.12.0）、等級黏著度與新 host（v4.13.0）。
- OpenCode 2 支援（v4.10.1，#943，@ragokan）：OpenCode plugin 原本在 OpenCode 2 以「Plugin must export a default definition」載入失敗——移植到 OpenCode 2 plugin API 後可載入全部 commands 與 skills；同一 entrypoint 在 OpenCode 1（1.15～1.18.34 實測）仍可運行，OpenCode 2 上
/ponytail <level>切換立即套用到當前訊息。 - 安全與可靠性（v4.10.2）：lifecycle hooks 不再把 plugin 路徑內插進 shell 文字（#827）；
PONYTAIL_SUBAGENT_MATCHER加時限，回溯型 regex 無法掛死 SubagentStart（#890）；npm 發布等待測試綠燈（#831）；Windows/WSL hooks 不再掛起且找得到 scripts（#646/#752）；Pi 以systemPromptOptions.sections注入保留 prompt cache（#963）；Copilot CLI hooks 無 node 時 exit 0 並記載 shared-hook 限制（#655）。11 位首次貢獻者。 - per-project mode 與行為一致化（v4.10.3/v4.13.0）：ponytail mode 改為每個 project 各自保存——一個 repo 的 session 不再改掉另一個 repo 的（#981、#1037）；bare
/ponytail行為到處一致：off 時開啟、on 時回報等級（#982）；Qoder 的 off 跨 prompts 持久（#676）、off-mode SessionStart 靜音（#687）、無效參數保留現有 mode（#677）；/ponytail-review不再持久化 review 結果（#750）。 - Codex/VS Code/Qwen hook 註冊回歸修復（v4.11.0，#1021）：v4.10.2 起 root
plugin.json一行 Agent Plugins$schema宣告使 Codex、VS Code 與 Qwen 把 ponytail 載入為 skills-only Agent Plugin——hooks 未註冊、rules 從未抵達模型。v4.11.0 移除該行恢復完整功能；Codex 切換等級現在同時送達新等級的 rules（v4.13.0 #932）。 - Findings 編號與誠實 benchmark（v4.12.0，#523/#1029）：review 與 audit 的 findings 加編號，可直接回「fix 2 and 4」而不必引用原文；
/ponytail-gain改顯示 agentic benchmark 平均值——54% less code、22% fewer tokens、20% lower cost、27% faster、safety kept——取代被多話 baseline 膨脹的舊 single-shot 數字；README 瘦身、per-agent 安裝步驟移至 INSTALL.md。 - 新 host 與生態：Kimi Code plugin adapter（v4.13.0，#657）；CodeBuddy 經既有 Claude plugin（v4.12.0，#891）；Kilo Code VS Code extension（v4.11.0）；Command Code（v4.11.0，#244）；文件新增 Factory Droid、DeepSeek Harness（原生 AGENTS.md 與 SKILL.md reader）、Freebuff CLI、Muse Code、Qwen Code、Goose（adapter docs 與 schema guard）、Oh My Pi (omp) 安裝/移除、Skills CLI 安裝指令、Cline CLI 原生技能說明；ZCode 支援移除（v4.13.0，#1040）。README 另新增西語、韓語、簡中、日語翻譯（#1039）。
- 其他：statusline badge 指向可在 plugin 更新後存活的副本、不再誤刪相似名稱的 statuslines（#1033/#848）；uninstall 移除 statusline nudge flag 與各 host state dir 的 mode flag（#680/#788）；Hermes 每回合重複注入 ruleset 改為一次（#787）且拒絕 review 作為預設 mode（#700）、支援 UTF-8 BOM 的 default-mode 設定（#873）；pi 的 skill aliases 擴充並轉發參數（#942）、
/tree導覽後恢復 branch mode（#828）；debt scan 認得/* ponytail: */區塊註解並跳過 .git/node_modules/dist/build（#815）；audit 在 delete 前要求全樹 caller 檢查（#714）；review/audit 新增reuse標籤（#881）。 - 既有使用者影響：使用 Codex 的用戶必須升級（v4.10.2～v4.10.3 期間 hooks 未註冊、rules 從未抵達模型）；多專案並行 session 的 mode 不再互踩；ZCode 用戶失去支援；跨 release 的 statusline 與 uninstall 殘留獲得清理。
v4.10.0
舊版本2026-09-14- v4.9.0→v4.10.0：主題是「兩個新家」——原生 Cursor 支援與 Grok Build skills adapter。
- 原生 Cursor 支援（#817/#869）：透過
hooks.json提供原生 Cursor hooks，scripts/cursor-hooks.js install會合併進你既有的 Cursor hooks 檔，且不動檔案裡的其他內容。 - Grok Build skills adapter（#661，revive #561）：新增 Grok Build 原生 skills adapter。
- VS Code Copilot 偵測修正（#528/#579）：透過
CLAUDE_PLUGIN_ROOTfallback 正確偵測 VS Code Copilot，不再在那裡誤秀 Claude Code statusline 提示。 - Claude.ai marketplace 相容（#593/#601）：
hooks.json移除commandWindows以通過 Claude.ai marketplace validator 驗證。 - 新增 Trendshift 徽章與「Built with Ponytail」文件（#801-#803、#830）；兩位新貢獻者（@prayag0one4、@p-clements）首次貢獻。'
v4.8.4
舊版本2026-08-10- 本站此前的記錄版本，已升級至 v4.9.0。
v4.9.0
舊版本2026-08-10- v4.8.4→v4.9.0：53 commits of doing less。五週累積的 53 個 merged PR 一次落地，無中介版本（直接從 v4.8.4 跳到 v4.9.0）。
- 新增
/ponytail default <mode>讓選定模式跨重啟保留;單獨/ponytail改為回報當前 level 而非重置回 default(#329、#99)。 - 新增 Qoder 支援(UserPromptSubmit + PreToolUse hooks)、
PONYTAIL_SUBAGENT_MATCHER子代理範圍控制、可隱藏的 pi status bar 指示。 - 約 30 個 bug fix 橫跨 Windows(stdin EOF 死結
init與update不會再刪除剛產生的 command 檔;OpenCode plugin 修正 Qwen 相容性、MCP server 版本從 package.json 讀取。
圖例
- 當前版本 本站現在記錄的版本
- 舊版本 已被取代，保留作歷史對照
- 已同步 與上游 release 對齊
- 僅上游變動 上游 main 有 commit，但未發佈新版