Communityコーディング&開発github.com

AgentTeam - 技術的負債台帳エクストラクタ

コード内のショートカットコメントを収集し、追跡可能な負債台帳として一括報告します。先送りが忘れ去られるのを防ぎます。

AgentTeam - 技術的負債台帳エクストラクタ とは?

このスキルは、リポジトリ内の `shortcut:` または `ponytail:` コメントを自動的に検出し、一元管理された負債台帳を生成することで、技術的負債(意図的なショートカット)の追跡を容易にします。開発者がコードベース全体で「今は妥協したが、いつか直すべき点」を可視化し、その上限やアップグレード条件を把握し、忘れ去られるリスク(トリガー欠落)を検出します。対応プラットフォームは、`git grep` と標準的なコメント構文(`#`, `//`, `/*`)をサポートするあらゆるGitリポジトリです。スキルは読み取り専用で、結果はグループ化された行として出力され、トリガーなしのマーカーには `no-trigger` タグが付与され、サイレントな腐敗を警告します。ユーザーの要望に応じて、結果をファイル(例: PONYTAIL-DEBT.md)に永続化することも可能です。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/toolbyautoit-arch/AgentTeam/tree/HEAD/AgentData/ponytail/.openclaw/skills/ponytail-debt

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

意図的なポニーテールショートカットはすべて、その上限とアップグレードパスを指定する shortcut: コメントでマークされます(古いコードでは ponytail: と書かれている場合があります)。これにより、それらを一つの台帳にまとめ、先送りが静かに恒久化されるのを防ぎます。

スキャン

リポジトリ内のコメントマーカーをgrepします。.git と .gitignore ファイルで無視されるすべての項目(依存関係、ビルド出力、キャッシュ、任意のスタック)はスキップします。

git grep --no-index --exclude-standard -nE '(#|//|/[*]) ?(shortcut|ponytail):' (使用しているスタックに応じて他のコメントプレフィックスを追加可能)

ユーザーが独自のマーカーワード(例: /ponytail-debt TODO)を指定した場合は、そちらをgrepします。

ヒットした行はそれぞれ台帳の一行になります。コメントプレフィックスにより、単に規約に言及しているだけの散文は台帳から除外されます。先送り(deferral)でないヒット(例: キーボードショートカットに関するメモ)はスキップします。

出力

マーカーごとに一行、ファイルごとにグループ化:

<ファイル>:<行番号>, <簡略化された内容>. ceiling: <指定された上限>. upgrade: <再検討するトリガー>.

規約は shortcut: <ceiling>, <upgrade path> ですので、ceilingとトリガーをコメントからそのまま取得します。行ごとに所有者も表示したい場合は、git blame -L<行番号>,<行番号> を追加してください。

腐敗リスクにフラグを立てます:アップグレードパスやトリガーを指定していないマーカーコメントには no-trigger タグを付けます。これらは静かに腐敗するものです。

最後に <N> markers, <M> with no trigger. と出力します。何も見つからなかった場合: No shortcut debt. Clean ledger.

制限

読み取りと報告のみ行い、何も変更しません。永続化したい場合は、依頼すると台帳をファイル(例: PONYTAIL-DEBT.md)に書き込みます。ワンショットで実行されます。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

関連スキル