# ショートカット負債台帳 (ponytail-debt)

> リポジトリ内の shortcut:（旧 ponytail:）コメントをすべて集め、何も変更せずに負債台帳として一覧化します。

- カテゴリ: [リファクタリング](https://www.myskills.tools/ja/categories/refactoring/)
- 提供元: コミュニティ · DietrichGebert
- リポジトリ: https://github.com/DietrichGebert/ponytail/tree/main/skills/ponytail-debt (commit 84740e3)
- SKILL.md: https://github.com/DietrichGebert/ponytail/blob/main/skills/ponytail-debt/SKILL.md
- インストールコマンド: `npx skills add DietrichGebert/ponytail --skill ponytail-debt`
- ライセンス: MIT
- 対応ツール: Claude Code, Codex, Cursor
- 権限: read-repo ✓, write-files ✓, shell ✓, network ✗
- 状態: スキャン済み
- ルールスキャンですべてのリスクを検出できるわけではありません。インストール前にこのスキルの SKILL.md を読み、権限を確認してください。

## 基本ルール

読み取りと報告のみを行い、台帳のファイル保存を頼まれない限り何も変更しません。

## 実行フェーズ

1. **コメント走査** — git grep で shortcut:、ponytail:、またはユーザー指定の語を検索し、.git と .gitignore の対象は除外します。
2. **台帳にまとめる** — マーカーごとに 1 行、ファイル別にまとめ、何を簡略化したか・上限・見直しの契機を記します。先送りでないヒットは除き、必要なら git blame で担当者を付けます。
3. **放置リスクを表示** — 見直しの方法や契機が書かれていないマーカーに no-trigger タグを付けます。
4. **集計** — 最後にマーカー数と契機なしの数を示し、何もなければ台帳は空と報告します。PONYTAIL-DEBT.md への書き出しは依頼時のみです。

## 権限の説明（SKILL.md より）

| 機能 | 必要か | 説明 |
|---|---|---|
| ファイル書き込み | 一部で必要 | 既定ではファイルを書かず、依頼されたときだけ台帳を PONYTAIL-DEBT.md などに保存します。 |
| コマンド実行 | 一部で必要 | マーカー検索の git grep と、任意の git blame のみを実行します。 |
| 外部通信 | 不要 | ネットワークアクセスは不要です。 |

## SKILL.md のフロントマター（YAML）

```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.
---
```

ホーム: https://www.myskills.tools/ja/ · URL: https://www.myskills.tools/ja/skills/ponytail-debt/