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




