Theme / v4.10.0

Ponytail

讓 AI 編碼代理像最懶的資深工程師

基礎觀念

v4.10.0:Cursor 原生支援與新平台

掌握 v4.10.0 的重點變更:原生 Cursor hooks(hooks.json 合併安裝)、Grok Build skills adapter、VS Code Copilot 偵測修正與 Claude.ai marketplace 驗證修復。

概述

Ponytail v4.10.0(2026-09-14)的主題是「兩個新家」:原生 Cursor 支援與 Grok Build skills adapter。另外修正了 VS Code Copilot 的偵測問題,並讓 Claude.ai marketplace 的 validator 重新接受這個 plugin。

原生 Cursor 支援

這是本版頭條。Ponytail 現在透過 hooks.json 提供原生 Cursor hooks:

scripts/cursor-hooks.js install

安裝腳本的關鍵設計:它合併進你既有的 Cursor hooks 檔案,且不動檔案裡的任何其他內容。

這解決了 hooks 工具最常見的抱怨——安裝器把使用者的既有設定當成自己的地盤,覆蓋或破壞別的工具的 hooks。Cursor 使用者現在可以在保有全部現有 hooks 的情況下,加上 Ponytail 的 7 階「必要才寫」階梯。

Grok Build Skills Adapter

新增 Grok Build 原生 skills adapter(revive #561,#661),把 Ponytail 的精簡紀律帶到 Grok Build CLI。

VS Code Copilot 偵測修正

過去在 VS Code Copilot 環境下,Ponytail 會誤判身分、顯示 Claude Code 的 statusline 提示。v4.10.0 透過 CLAUDE_PLUGIN_ROOT fallback(#528、#579)正確偵測 VS Code Copilot。

環境偵測是跨平台 plugin 的隱形難題:同一個 plugin 跑在不同 host,行為應該跟著 host 變——statusline 提示、路徑解析、hook 觸發時機都可能不同。偵測錯誤時,使用者看到的是「另一個平台的幽靈功能」。

Claude.ai Marketplace 驗證修復

hooks.json 移除了 commandWindows 欄位(#593、#601),讓 Claude.ai marketplace 的 validator 重新接受這個 plugin。

其他變更

  • 新增 Trendshift 日/週/月排名徽章與「Built with Ponytail」文件
  • 兩位新貢獻者(@prayag0one4、@p-clements)首次貢獻

對既有使用者的影響

  • Cursor 使用者:一個指令即可啟用,既有 hooks 不受影響
  • VS Code Copilot 使用者:不再看到誤導的 Claude Code statusline 提示
  • Claude.ai marketplace 使用者:plugin 可再次通過驗證安裝

學習重點

  1. 合併式安裝器:cursor-hooks.js install 示範了 hooks 安裝的正確姿勢——編輯使用者設定檔的工具,責任是「加進去」而不是「換掉」。任何會碰使用者設定檔的自動化都該如此。
  2. 身分偵測要防呆:CLAUDE_PLUGIN_ROOT fallback 說明環境偵測需要多重訊號——單一環境變數在不同 host 間可能撞名,fallback 鏈才能減少誤判。

來源:v4.10.0