ponytail-debt

ponytail-debt

熱門

將程式碼庫中每個 `ponytail:` 註解收集到債務清單中,讓 ponytail 留下的刻意捷徑與延後能被追蹤,而不會腐化為「以後再說等於永遠不做」。當使用者說「ponytail debt」、「/ponytail-debt」、「what did ponytail defer」、「list the shortcuts」、「ponytail ledger」或「what did we mark to do later」時使用。一次性報告,不改變任何內容。

8.4萬星標
4575分支
更新於 2026/7/15
SKILL.md
readonlyread-only
name
ponytail-debt
description

Harvest every `ponytail:` comment in the codebase into a debt ledger, so the deliberate shortcuts and deferrals ponytail leaves behind get tracked instead of rotting into "later means never". Use when the user says "ponytail debt", "/ponytail-debt", "what did ponytail defer", "list the shortcuts", "ponytail ledger", or "what did we mark to do later". One-shot report, changes nothing.

每個刻意的 ponytail 捷徑都會以 ponytail: 註解標記,註明其上限與升級路徑。此工具將它們收集到一份清單中,避免延後悄悄變成永久。

掃描

在儲存庫中搜尋註解標記,跳過 node_modules.git 和建置輸出:

grep -rnE '(#|//) ?ponytail:' . (如果你的技術棧使用其他註解前綴,請自行加入)

每個匹配結果即為清單中的一列。註解前綴可避免僅提及此慣例的文字被納入清單。

輸出

每個標記一行,按檔案分組:

<file>:<line>, <what was simplified>. ceiling: <the limit named>. upgrade: <the trigger to revisit>.

慣例是 ponytail: <ceiling>, <upgrade path>,因此直接從註解中提取上限與觸發條件。想為每列加上負責人?請加上 git blame -L<line>,<line>

標示腐化風險:任何未指定升級路徑或觸發條件的 ponytail: 註解會加上 no-trigger 標籤,這些就是會悄悄腐化的項目。

結尾顯示 <N> markers, <M> with no trigger. 若未找到任何內容:No ponytail: debt. Clean ledger.

邊界

僅讀取與報告,不改變任何內容。若要持久化,請要求將清單寫入檔案(例如 PONYTAIL-DEBT.md)。一次性操作。輸入「stop ponytail-debt」或「normal mode」可恢復正常模式。