前言¶
用 AI 寫代碼時，模型很容易順手加一層抽象、多引一個依賴，或者把三行能做完的事擴成一個小框架。你明明只想修一個 bug，diff 卻越變越長。Ponytail 是一套面向編碼任務的「最少可用方案」約束：YAGNI、優先標準庫、最短 diff。但它往往綁定在特定智能體產品裏；部分工具（SkillHub 簡介裏提到的 trea 等）並不能直接接入。
下面介紹社區包 ponytaill-skill：把 Ponytail v4.8.4 的核心提示詞抽成一份通用 SKILL.md，通過 SkillHub 安裝到 Cursor、Claude Code 等支持 Skills 的客戶端，讓 Agent 在會話裏按同一套規則幹活。
這是什麼¶
ponytaill-skill 在 SkillHub 上的座標是 @user_f3f6053c/ponytail5424，當前版本 1.0.4，分類 dev-programming，來源 community，發佈者 user_f3f6053c，不需要 API Key（requires_api_key=false）。
包內說明寫明：內容來自 Ponytail v4.8.4（MIT），由發佈者整理爲 Skill 形態，方便無法接入原版 Ponytail 的 Agent 使用。SkillHub 頁面當前統計爲評分 100000、下載 1673（以商店頁爲準，會隨時間變化）。
一句話定位：強制採用最簡單、最短、最精簡的可用方案，並附帶審查、審計、技術債與幫助等子能力說明，合併在一份技能文檔裏。
核心功能¶
安裝後，Agent 讀取的是一份「六合一」技能說明（主技能 + 五個專項技能）。各子技能職責如下，觸發方式以文檔中的口令爲準。
ponytail（主技能）¶
默認 full 強度，貫穿每次編碼相關回復，直到用戶說 stop ponytail 或 normal mode。強度可用 /ponytail lite|full|ultra 切換。
核心行爲是 梯子決策框架：先問是否需要做（YAGNI）→ 複用本倉庫已有代碼 → 標準庫 → 原生平臺能力 → 已安裝依賴 → 一行解法 → 最後才寫最少實現。輸出習慣是 代碼優先，再用最多三行說明「跳過了什麼、何時再加」。
自然語言也可觸發，例如：ponytail、be lazy、yagni、simplest solution 等。文檔明確 不用於 純非編碼請求（百科、翻譯、菜譜等）。
ponytail-review（過度工程審查）¶
針對 diff 做複雜度審查，只找可刪、可換標準庫/原生能力、可壓縮的實現。每條一行，格式類似 L12: stdlib: ...，結尾給出 net: -<N> lines possible.。觸發：/ponytail-review 或「review for over-engineering」等。
ponytail-audit（全倉庫審計）¶
與 review 同類標籤，但掃描 整個倉庫，按「能刪多少」排序，一次性報告，不自動改代碼。觸發：/ponytail-audit、audit this codebase 等。
ponytail-debt（技術債追蹤）¶
掃描代碼裏 ponytail: 註釋（主技能要求對刻意簡化標註上限與升級路徑），彙總成臺賬。可用類似下面的命令思路（文檔示例）：
grep -rnE '(#|//) ?ponytail:' .
觸發：/ponytail-debt、ponytail ledger 等。只讀報告；若要落盤可請 Agent 寫到例如 PONYTAIL-DEBT.md。
ponytail-gain（收益展示）¶
一次性展示 Ponytail 官方基準的中位數記分牌（5 個日常任務、3 個模型），說明代碼量、成本、速度的區間對比；不是當前倉庫的真實節省統計。觸發：/ponytail-gain。
ponytail-help（幫助參考）¶
打印強度級別、子技能與觸發詞對照表，以及默認模式配置方式。觸發：/ponytail-help。
文檔中還提到原版 Ponytail 的默認模式配置（在完整 Ponytail 集成時生效；作爲 Skill 使用時，以 Agent 是否遵循 SKILL.md 爲準）：
export PONYTAIL_DEFAULT_MODE=ultra
{ "defaultMode": "lite" }
配置文件路徑：~/.config/ponytail/config.json（Windows：%APPDATA%\ponytail\config.json）。優先級：環境變量 > 配置文件 > full。
安裝與啓用¶
先做 SkillHub CLI 檢查；未安裝則按官方安裝文檔執行（見 SkillHub 安裝說明）。
command -v skillhub && skillhub --version
安裝 ponytaill-skill 時，必須用 --dir 指向當前 Agent 的 skills 目錄，否則技能可能落在 ./skills/ 而不會被識別：
skillhub install @user_f3f6053c/ponytail5424 --dir <你的 skills 目錄>
常見路徑（來自 SkillHub 安裝文檔）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
SkillHub 技能頁也支持把下面這句交給 AI，讓其按安裝文檔完成安裝：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_f3f6053c/ponytail5424`。
安裝完成後，按你所用客戶端的要求刷新或重啓 Agent，使新技能被加載。
典型用法¶
經過上面的步驟啓用技能後，可以在編碼會話裏直接用文檔約定的觸發詞，無需再背一長段 system prompt。
- 日常寫代碼 / 重構：開啓懶惰模式並開始任務。
/ponytail full
給這個 API 響應加緩存，儘量別引入新依賴。
期望 Agent 先走梯子（例如優先 functools.lru_cache），並簡短說明跳過的方案。
- 只看 PR 是否過度設計：
/ponytail-review
審查當前 diff，只報 over-engineering。
- 老項目減負：
/ponytail-audit
全倉庫審計，按能刪的行數排序。
- 覈對之前留下的簡化標記：
/ponytail-debt
- 查命令與強度：
/ponytail-help
關閉懶惰模式：stop ponytail 或 normal mode。
適用場景與注意¶
適合誰：希望 Agent 在寫碼、修 bug、選型依賴時默認「少寫、少引庫、少抽象」的團隊或個人；需要在 Cursor 等環境複用 Ponytail 規則、又無法接原版集成時，這個 Skill 包是對齊思路的捷徑。
限制與注意：
- 技能效果是 提示詞約束，取決於模型與客戶端是否穩定加載
SKILL.md；與原生 Ponytail 插件的環境變量、持久模式未必一一對應。 ponytail-review/ponytail-audit只管複雜度，正確性、安全、性能問題應走常規 review。ponytail-gain展示的是 公開基準中位數，不要當成「本倉庫已省下的行數」。- 主技能要求信任邊界上的校驗、安全、顯式需求不能省；「懶」體現在解法長度，不是跳過讀代碼和理解問題。
結尾¶
ponytaill-skill 把 Ponytail 的懶惰開發模式與六個相關能力收成一份可安裝的 Agent Skill，解決「工具接不上 Ponytail、又想統一 YAGNI 風格」的問題。安裝與詳情以 SkillHub 爲準：
- 技能頁：https://www.skillhub.cn/skills/user_f3f6053c/ponytail5424
- API 條目：https://api.skillhub.cn/user_f3f6053c/ponytail5424
更完整的原版文檔與示例見：https://github.com/DietrichGebert/ponytail
