ponytail-debt について
ponytail-debt は、リポジトリ内の意図的な簡略化を示すコメントを集め、ファイル別の台帳にまとめる読み取り専用スキルです。アップグレード経路やトリガーの欠落も示し、先送りした作業の追跡に役立ちます。
主な機能
- 01リポジトリ内のコメントマーカーを検索
- 02ファイル別に台帳を整理
- 03上限とアップグレード経路を抽出
- 04トリガーのない項目を表示
- 05読み取り専用のレポート
活用シーン
- 01先送りした実装作業の確認
- 02アップグレード経路のない簡略化の発見
- 03追跡用の技術的負債台帳の作成
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/ponytail-debtを入力して読み込まれたか確認します。
詳細
意図的に行ったポニーテールの簡略化にはすべて、上限と改善への道筋を示す shortcut: コメントが付いています（古いコードでは ponytail: と記されている場合があります）。これらをひとつの台帳にまとめることで、先送りした項目がいつの間にか恒久化するのを防ぎます。
スキャン
.git と、.gitignore ファイルで無視されるすべての項目（あらゆるスタックの依存関係、ビルド出力、キャッシュ）を除外して、リポジトリ内を grep します。
git grep --no-index --exclude-standard -nE '(#|//|/[*]) ?(shortcut|ponytail):' （スタックで別のコメント接頭辞を使う場合は追加してください）
ユーザーが独自のマーカー語（/ponytail-debt TODO）を指定した場合は、代わりにその語を grep します。
ヒットした項目がそれぞれ台帳の1行になります。コメント接頭辞により、この規約に言及しているだけの文章が台帳に入ることはありません。キーボードショートカットについてのメモなど、先送りではないヒットは除外してください。
出力
ファイルごとにまとめ、マーカー1つにつき1行を出力します。
<file>:<line>, <簡略化した内容>. ceiling: <指定された上限>. upgrade: <見直しのきっかけ>.
規約は shortcut: <上限>, <改善への道筋> なので、上限ときっかけはコメントからそのまま抜き出します。各行に担当者も必要ですか？その場合は git blame -L<line>,<line> を追加してください。
劣化のリスクにも注意します。改善への道筋やきっかけが書かれていないマーカーコメントには no-trigger タグを付けます。これらは気付かないうちに放置される項目です。
最後に <N> markers, <M> with no trigger. と出力します。見つからなかった場合は No shortcut debt. Clean ledger. と出力します。
境界
読み取りと報告のみを行い、変更は加えません。内容を保存する場合は依頼してください。たとえば PONYTAIL-DEBT.md などのファイルに台帳を書き込みます。1回限りです。