Ponytail 技术债台账

要解决的问题

团队做短期取舍时，常把债务以注释形式埋在代码里：本周五先绕过去，回头再补。问题在于没人记得回头，而随手扫一遍仓库往往得到一长串噪音——注释里提到这个约定的散文、无关的字符串、构建产物全都混在一起。ponytail: 约定把这件事变成一条纪律：每个刻意留下的捷径，用注释标出它的天花板和升级路径，然后收集进一张台账，让“推迟”无法悄悄变成“永久”。

工作原理

核心是一条 grep 命令，跳过 node_modules、.git 和构建产物：

grep -rnE '(#|//) ?ponytail:' .

技术栈若用其他注释前缀，自行扩展模式即可。每个命中即一条台账记录，按文件分组输出，字段包括 ceiling（天花板）和 upgrade（升级路径）。注释前缀本身充当过滤器，把只是提到这个约定的文字挡在台账之外。

每行可附加 git blame -L, 查到的负责人。关键一步是风险标记：任何没有写明升级路径或触发条件的 ponytail: 注释都会被打上 no-trigger 标签——这些才是会默默腐烂的债务；写明了触发条件的，至少知道什么时候该还。

适用边界

该技能只读、只报告，不改动任何文件。需要持久化时，明确要求它才会把台账写入文件（如 PONYTAIL-DEBT.md）。它是一次性的：跑完即结束，输入 stop ponytail-debt 或 normal mode 即退回正常状态。台账本身是诊断工具，怎么安排修复节奏仍然是团队自己的事。