icpg

icpg skillの概要

icpg skillで何ができるか

icpg skill は、コード理解に「WHYレイヤー」を加えます。構造を対応づけるだけでなく、関数・クラス・モジュールが「なぜ存在するのか」「誰が所有しているのか」「本来の意図と今も合っているのか」まで結びつけます。Code Review、リファクタリング、あるいは自律的な保守のために icpg を使うなら、最大の価値は変更前の迷いを減らせることです。

どんな人に向いているか

icpg は、動き続けるコードベースで作業し、構文の速い確認よりも、挙動・所有権・設計意図が重要になるエンジニアやエージェントに向いています。特に、リポジトリにドリフトが溜まっている、履歴が不明瞭、あるいは「これはなぜ書かれたのか？」という確認が何度も必要になる場合に効果を発揮します。

何が違うのか

この skill の中心にあるのは、ReasonNodes、形式的な契約、そして複数の観点にわたるドリフト検出です。つまり icpg は単なるコードマップではなく、作業前の分析を支える意思決定レイヤーです。実務上の利点は、変更の安全性が高まり、レビューの文脈が明確になり、元の意図に気づかないまま反してしまう編集を減らせることです。

icpg skillの使い方

インストールしてコアファイルを見つける

リポジトリの skill インストール手順を使ったら、まず skills/icpg/SKILL.md を開いてください。このリポジトリには補助スクリプトや支援フォルダが公開されていないため、skill ファイル自体が主な信頼できる情報源です。素早く導入判断したいなら、最初に frontmatter と冒頭のセクションを読んでください。

あいまいな目的を使えるプロンプトに変える

icpg usage は、具体的な作業内容、対象パス、望む出力の形を与えるほど効果が出ます。良い入力例は、「src/payments/charge.ts の retry ロジックを変える前に意図のドリフトを確認してほしい」や「auth フローの ReasonNodes を初期化して、不足している所有権リンクを特定してほしい」です。「このリポジトリを分析して」のような弱い入力は範囲が広すぎて、この skill の意図追跡の強みを活かしにくくなります。

初回利用のおすすめワークフロー

まず対象コードの本来の目的を尋ね、次にそれを守っている制約や契約を確認し、そのあとでドリフトが起こりそうな箇所を見ます。この順番は skill の設計に合っており、エージェントが構造から意図、そしてリスクへ移りやすくなります。icpg guide のワークフローでは、リポジトリ全体ではなく、1つのモジュールか1つの変更セットに絞って依頼してください。

リポジトリで最初に読むべき箇所

まずは SKILL.md を読みます。特に、目的の説明、CLI 例、コア原則、標準的な作業前クエリ、ReasonNode、edge types を扱うセクションが重要です。これらは導入判断に影響しやすく、Code Review における icpg の出力品質にも直結しやすい部分です。

icpg skill FAQ

icpg は自律エージェント専用ですか？

いいえ。icpg は人間にもエージェントにも有用ですが、特に再現性のある作業前推論が必要な場面で真価を発揮します。単発の要約だけ欲しいなら通常のプロンプトで足りることもありますが、意図を踏まえた code review や変更計画が必要なら、icpg のほうが適しています。

icpg は一般的な code prompt とどう違いますか？

一般的な prompt でもコードの要約はできますが、icpg はタスクをまたいで意図・所有権・ドリフトの文脈を保持できるように設計されています。そのため、「このコードは何のためにあるのか？」を変更前に答える必要がある場面で、単に「このコードは何をしているのか？」を知りたいだけの場合よりも役立ちます。

icpg は初心者にも使えますか？

初心者でも使えますが、最も良い結果が出るのは、ファイル名、機能、変更境界を正確に指定できるユーザーです。リポジトリに慣れていない場合は、まず単一モジュールから始めて、システム全体の分析ではなく、意図・制約・レビュー上のリスクを尋ねるのがよいでしょう。

どんなときに icpg を使わないほうがいいですか？

作業が単純な場合、コードが独立している場合、あるいは表面的な素早い説明だけで足りる場合は、icpg は不要です。また、対象領域や変更の文脈を一切出せない場合も相性が悪くなります。というのも、この skill の価値は「コードが存在する具体的な理由」と結びつけることにあるからです。

icpg skillを改善するには

タスクの文脈をもっと強く与える

icpg の結果を最も良くするのは、変更の目的、影響を受けるファイル、壊してはいけないものを含むプロンプトです。たとえば「新しい税ルールの後で src/billing のドリフトを確認してほしい」は、「billing code を見て」よりもはるかに強い指示です。これにより、icpg for Code Review に必要な ReasonNodes と制約を、より適切に引き出せます。

実装より先に意図を聞く

よくある失敗は、コードが何を守るつもりだったのかを確認せずに、すぐ編集に入ってしまうことです。出力を改善したいなら、まず本来の目的、現在の契約、疑われるドリフトを尋ね、そのあとで変更計画を求めてください。この順序にすると、うっかりした regression を減らし、レビュー結果も信頼しやすくなります。

最初の回答を使って次の質問を絞り込む

最初の回答が広すぎるなら、モジュール単位、ワークフローのステップ単位、所有権の境界単位で範囲を狭めてください。逆に答えが浅いなら、足りない契約、起こりそうなドリフトの種類、あるいはそのタスクに最も合う標準的な作業前クエリを尋ねてください。この反復のほうが、単に長い返答を求めるよりも、たいてい信号が良くなります。

skill の設計に合わせてプロンプトを保つ

icpg skill が最も強いのは、単なるコード説明ではなく、理由の追跡、ドリフト検出、作業前分析を求めるときです。より良い icpg usage を目指すなら、「完了」の定義、検討している変更の種類、対象となるコードベースの範囲を含めてください。