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」可恢復正常模式。






