Ponytail 核心指令全解析

在安裝了 Ponytail 外掛之後，AI 代理會被注入一系列的 slash (斜線) 快捷指令。這些指令是人類開發者與「懶惰代理」溝通的重要橋樑。透過這些指令，開發者可以調整代理的「懶惰強度」、啟動代碼審查，或是量化被節省下來的程式碼數量。

核心指令列表

以下是 Ponytail 在系統中註冊的 6 個核心指令：

1. /ponytail

• 用途：核心指令，用於執行極簡優化或查看當前系統狀態。
• 常用語法：
  • /ponytail — v4.9.0 起回報目前生效的強度，不會重設設定。
  • /ponytail <mode> — 立即切換為 lite、full、ultra 或 off。
  • /ponytail default <mode> — 將 lite、full 或 ultra 設為之後啟動時的預設強度。

default 是持久化設定，/ponytail <mode> 則是當前工作階段的立即切換。不要將 review 設成 default mode；它是審查動作，不是強度等級。

2. /ponytail-review

• 用途：對當前工作區中的變更（未提交的代碼）進行極簡度審查。
• 效果：AI 會掃描 git diff，並找出所有符合「過度設計」特徵的段落，並給出具體的重構或刪除建議。它會依據 7 階極簡階梯來挑出無意義的抽象層與重複程式碼。

3. /ponytail-audit

• 用途：對整個專案進行靜態程式碼審查。
• 效果：輸出一個「極簡審查報告」，列出專案中最臃腫的模組，並給出極簡化的重構路線圖。

4. /ponytail-debt

• 用途：量化分析專案中的「代碼債務 (Code Debt)」。
• 效果：列出因為沒有採用極簡寫法而多出來的程式碼行數與潛在的維護開銷。

5. /ponytail-gain

• 用途：回報節省成效。
• 效果：統計並輸出當前分支相對於基準分支（如 master）所節省的程式碼行數、Token 消耗量、API Key 開銷以及預估節省的時間。

6. /ponytail-help

• 用途：顯示說明文件與指南。

強度等級設定 (Intensity Levels)

開發者可以隨時使用 /ponytail set <level> 指令切換強度等級，以適應不同性質的開發階段：

在一般開發流程中，我們建議保持在 full 模式，以在開發速度、可維護性與程式碼體積之間取得最佳平衡。