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台帳にまとめる
マーカーごとに 1 行、ファイル別にまとめ、何を簡略化したか・上限・見直しの契機を記します。先送りでないヒットは除き、必要なら 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 を読み、権限を確認してください。