ponytail-debtcommit 84740e3SKILL.md · 重构
捷径债务清单
收集仓库中所有 shortcut:(及旧版 ponytail:)注释,生成一份技术债务清单,不做任何修改。
npx skills add DietrichGebert/ponytail --skill ponytail-debt已选中命令,请手动复制。
- 权限
- read-repo
- write-files
- shell
- network
- 兼容工具
- Claude Code, Codex, Cursor
- GitHub
- 181.7k
- 来源
- 社区 · DietrichGebert
- 状态
- 扫描通过
- 许可证
- MIT
- 分类
- 重构
核心规则
只读取和报告,不做任何修改;只有被要求时才把清单写入文件。
执行阶段
阶段 01扫描注释
用 git grep 搜索 shortcut:、ponytail: 或用户指定的标记词,跳过 .git 和 .gitignore 忽略的路径。
阶段 02整理成清单
每个标记一行,按文件分组,写明简化了什么、上限和升级触发条件;跳过非推迟类的命中,可选用 git blame 标注负责人。
阶段 03标记腐化风险
未写明升级路径或触发条件的标记打上 no-trigger 标签。
阶段 04汇总
最后给出标记总数和无触发条件的数量,没有发现则报告清单为空;只有被要求时才写入 PONYTAIL-DEBT.md。
权限说明(据 SKILL.md 整理)
| 能力 | 是否需要 | 说明 |
|---|---|---|
| 文件写入 | 部分需要 | 默认不写文件,仅在用户要求时把清单写入 PONYTAIL-DEBT.md 等文件。 |
| 命令执行 | 部分需要 | 只运行 git grep 扫描标记,以及可选的 git blame。 |
| 网络外发 | 不需要 | 不需要网络访问。 |
SKILL.md 头部信息(YAML)
---
name: ponytail-debt
description: >
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.
---相关技能
规则扫描无法覆盖所有风险,安装前请阅读此技能的 SKILL.md,确认权限后再使用。