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万Star
4575Fork
更新于 2026/7/15
SKILL.md
readonly只读
name
ponytail-debt
description

将代码库中所有 `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" 恢复。