ponytail-debt 是一个用于追踪代码库中 ponytail 有意遗留下来的简化与推迟项的 Skill。
用途
按照其说明，每个有意的 ponytail 简化捷径都会用一个 ponytail: 注释标记，并在注释中注明它的天花板（ceiling）和升级路径（upgrade path）。ponytail-debt 的目标是把这些标记收集到一个统一的债务台账中，从而让某个被推迟的事项不会悄无声息地变成永久遗留。
扫描方式
工具使用 grep 在仓库中查找注释标记，并跳过 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” 来恢复原状。
适用场景
适合在维护或审计代码库时，集中梳理并跟踪那些有意的技术简化与推迟决定，尤其是当希望确保这些推迟项不会因缺少触发条件而被长期遗忘时。
限制
资料未提供收费、价格、平台支持范围或运行性能等信息；其能力仅限于读取和生成报告，不修改代码或注释。