免费在 GitHub 公开中文介绍

ponytail-debt

收集代码中标记简化实现或待改进事项的注释，按文件整理成技术债务台账，列出限制与重新审视的条件，标记缺少条件的条目，不修改代码。

原文查看原文说明

List every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.

DietrichGebert/ponytail

AI 评分100分/ 100 查看安装方法

适用场景

盘点暂缓改进的实现
查找未注明重新审视条件的事项
按文件建立技术债务台账
通过自定义标记收集改进事项

中文介绍

功能

ponytail-debt 收集代码中的 shortcut: 注释及旧格式 ponytail: 注释，建立技术债务台账，记录暂缓实施的改进。条目按文件分组，包含文件名、行号、简化内容、实现限制，以及重新审视的条件。没有升级路径或重新审视条件的条目会标记为 no-trigger，报告末尾列出标记总数和缺少条件的数量。

适用场景

适合盘点短期应对时留下的实现，或检查是否注明启动改进的条件。也可以指定自定义标记词。键盘快捷键说明等与暂缓改进无关的注释会被排除。

使用示例

“用 /ponytail-debt 列出暂缓改进的实现。”
“用 /ponytail-debt TODO 查找我的自定义标记。”
“把台账保存到 PONYTAIL-DEBT.md。”

注意事项

搜索使用 git grep，跳过 .git 及 .gitignore 排除的路径。默认只进行一次读取并生成报告，不修改代码。只有收到保存请求时才会写入文件。

本介绍由 AI（OpenAI Codex）根据公开的 SKILL.md 撰写。准确的规格请查看下方原文。

客观评估

AI 仅根据 SKILL.md 的内容，从 4 个方面进行了评估。星标数和热度不计入评估。

指令清晰度能否看出何时使用、做什么: A良好明确说明收集 shortcut: 等注释标记，生成技术债务台账。
步骤具体性步骤、输入输出和示例是否具体: A良好提供 git grep 搜索表达式、逐行输出格式和 no-trigger 标记条件。
安全性发送数据、删除文件、执行命令等是否有说明: A良好明确限定为读取和报告，仅在收到请求时保存文件。
安装难易度所需工具和 API 密钥是否少且有说明: A良好主要前提是 Git，并提供了要执行的 git grep 命令。

总分按每项 A=25 分、B=15 分、C=5 分相加。由 AI（OpenAI Codex）于 2026年10月20日评估。仅供参考，安装前请同时查看原文。

如果您认为评估有误，请申请复核

包含的文件（1）

SKILL.md1.7 KB

SKILL.md（原文）

安装前可以查看交给 AI 代理的指令内容。

Every deliberate ponytail shortcut is marked with a shortcut: comment naming its ceiling and upgrade path (older code may say ponytail:). This collects them into one ledger so a deferral can't quietly become permanent.

Scan

Grep the repo for comment markers, skipping .git and everything the .gitignore files ignore (dependencies, build output, caches, in any stack):

git grep --no-index --exclude-standard -nE '(#|//|/[*]) ?(shortcut|ponytail):' (add other comment prefixes if your stack uses them)

If the user names their own marker word (/ponytail-debt TODO), grep for that word instead.

Each hit is one ledger row. The comment prefix keeps prose that merely mentions the convention out of the ledger. Skip hits that are not a deferral, like a note about a keyboard shortcut.

Output

One row per marker, grouped by file:

<file>:<line>, <what was simplified>. ceiling: <the limit named>. upgrade: <the trigger to revisit>.

The convention is shortcut: <ceiling>, <upgrade path>, so pull the ceiling and the trigger straight from the comment. Want an owner per row too? add git blame -L<line>,<line>.

Flag the rot risk: any marker comment that names no upgrade path or trigger gets a no-trigger tag, those are the ones that silently rot.

End with <N> markers, <M> with no trigger. Nothing found: No shortcut debt. Clean ledger.

Boundaries

Reads and reports only, changes nothing. To persist it, ask and it writes the ledger to a file (e.g. PONYTAIL-DEBT.md). One-shot.

评价

还没有评价。欢迎分享你的使用感受。

无需登录即可发表。欢迎分享使用感受、提问，或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

同一仓库的技能