← 一覧へ
🔍 コードを理解するCC / Codex 両対応難易度: 中級

ポニーテール・デット ponytail-debt

付けっぱなしのコード整理紐を解きほぐす

出典リポの★
126,127
最終更新
28日前
作者
DietrichGebert

これは何?

これは、コード内に残した一時的な簡略化箇所(ポニーテール)を見つけて集計する便利ツールです。開発中に「後で直す」とメモした箇所を自動で検出し、一覧にまとめます。コードの未整理部分を可視化することで、後で確実に見直せるようにサポートします。

ポニーテール・デットの紹介マンガ

これでできること

  • コード内の一時的な簡略化箇所を自動検出できます
  • 見直しが必要な箇所を一覧表にまとめます
  • 期限や見直し条件が設定されていない危険箇所をマークします
  • レポートをファイルに保存してチームで共有できます

こんな時に便利

チームで「この部分は後で修正」とコメントした箇所を管理したい時
プロジェクトの技術的負債を一覧化したい時
レビュー時に関係者全員で未整理箇所を把握したい時
長期プロジェクトで忘れられがちな暫定対処箇所を追跡したい時

使い方

コード内に`ponytail:〈期限〉,〈見直し条件〉`という形式でコメントを残します。ツールを実行すると、これらのコメントを自動で収集し、未整理箇所を一覧表示します。目で見て確認したり、ファイルに保存してチームで共有できます。

使用例(こう頼んでみよう)

ギリギリまで性能最適化は後回しにしたい時: `// ponytail: v1.0, ユーザー500人突破時`テストデータを簡易実装した時: `# ponytail: 2023-12-31, リリース前に正式データに置換`UIの微調整を後で行う時: `/* ponytail: デザインリビジョン3, 次回デザインチェック時 */`

必要なもの

  • 特になし

導入方法

いちばん簡単(AIに頼む)
次のスキルを入れて: https://github.com/DietrichGebert/ponytail/tree/main/.openclaw/skills/ponytail-debt
手動で置く
Claude Code → ~/.claude/skills/ponytail-debt/
Codex → ~/.agents/skills/ponytail-debt/

使いこなしのコツ

  • 必ず期限や見直し条件をセットで記述しましょう。条件なしはリスクです
  • 定期的にレポートを確認して、未解決のポニーテールを減らしましょう