免费在 GitHub 公开中文介绍

ponytail-debt

收集代码中标记暂缓改进的注释，按文件整理为台账，记录简化内容、适用上限和重新审视的条件，并标出未写明审视条件的条目。

原文查看原文说明

Harvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.

DietrichGebert/ponytail

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

适用场景

汇总代码仓库中的暂缓事项
查找缺少审视条件的临时处理
用自定义标记收集TODO注释
按请求将台账保存为文件

中文介绍

功能

ponytail-debt收集代码中有意暂缓的改进，整理成一份台账。它查找shortcut:和旧格式的ponytail:注释，按文件汇总文件名、行号、简化了什么、适用上限以及何时需要重新审视。未写明审视条件的条目会标记为no-trigger，报告末尾列出条目总数和缺少条件的数量。

适用场景

当临时处理分散在代码各处，难以跟踪后续改进的约定时，可以使用此技能。它也适合盘点明知存在限制而采用的实现，确认何时需要改进。指定自定义标记后，还可以收集TODO等注释。

使用示例

“请用/ponytail-debt按文件汇总暂缓的改进。”
“请用/ponytail-debt TODO收集TODO注释。”
“请将汇总的台账保存到PONYTAIL-DEBT.md。”

注意事项

通常只读取内容并报告一次；只有请求保存时才会写入文件。搜索使用git grep，跳过.git和被.gitignore排除的内容。上限与审视条件均从注释中提取，不补充未记载的信息。许可证为MIT。

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

客观评估

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

指令清晰度能否看出何时使用、做什么: A良好明确说明目标注释、自定义标记选项及生成一次性台账报告的用途。
步骤具体性步骤、输入输出和示例是否具体: A良好提供git grep命令、台账行格式、no-trigger标记和最终计数。
安全性发送数据、删除文件、执行命令等是否有说明: A良好通常仅限读取和报告，只有收到请求时才保存文件。
安装难易度所需工具和 API 密钥是否少且有说明: B部分不足依赖git grep，但未提供Git安装步骤。

总分按每项 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.

评价

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

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

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

同一仓库的技能