AIアシスタントとの連携
Claude Code、Codex、またはKiroにcodeknitプラグインをインストールし、最新の状態に保ち、構造や重複コードに関する質問をアシスタントに行います。このプラグインには、codeknitという1つのスキルが含まれています。このスキルは、アシスタントにcodeknit parse、codeknit graph analyze、codeknit fingerprintをいつ実行するか、そして.skt出力をどのように読み取るかを指示します。
codeknitバイナリを自分でインストールする必要はありません。スキルが初めて実行されると、バンドルされたscripts/install-codeknit.shが実行され、以下の処理を行います:
codeknitがすでにPATHまたは~/.local/binに存在する場合は、即座に終了します。- それ以外の場合は、お使いのOSとアーキテクチャに対応した最新のGitHubリリースをダウンロードします。
- ダウンロードをリリースの
checksums.txtと照合して検証します。 - バイナリを
~/.local/binにインストールし、出力の最後の行に絶対パスを表示します。
~/.local/binがPATHに含まれていない場合、アシスタントはセッションの残りの部分でそのフルパスを使用してcodeknitを呼び出します。
インストールを制御するには、以下の環境変数を設定します:
| 変数 | 効果 |
|---|---|
CODEKNIT_VERSION |
リリースを固定します。例:0.6.0。 |
CODEKNIT_INSTALL_DIR |
インストール場所を変更します。 |
代わりに自分でバイナリをインストールする場合は、インストールを参照してください。
プラグインのインストール
Section titled “プラグインのインストール”お使いのアシスタントに応じたセクションを選択してください。
Claude Code
Section titled “Claude Code”シェルで以下のコマンドを実行します。Claude Codeセッション内では、/plugin ...として同じコマンドを実行します。
claude plugin marketplace add awslabs/codeknit --sparse .claude-plugin skillsclaude plugin install codeknit@codeknitcodex plugin marketplace add awslabs/codeknit --sparse .agents --sparse .codex-plugin --sparse skillscodex plugin add codeknit@codeknitKiro IDE
Section titled “Kiro IDE”- Powersパネルを開きます。
- Add Custom Powerを選択し、Import power from GitHubを選択します。
https://github.com/awslabs/codeknitを入力します。
Kiro CLI
Section titled “Kiro CLI”Kiro CLIはローカルパスからインストールするため、まずリポジトリをクローンします:
git clone --depth 1 --filter=blob:none --sparse https://github.com/awslabs/codeknit ~/.codeknit-powergit -C ~/.codeknit-power sparse-checkout set skillskiro-cli powers install ~/.codeknit-power--sparseについて
Section titled “--sparseについて”--sparseオプションは任意です。このオプションは、クローンをプラグインマニフェストとskills/に限定し、ソースツリー全体をクローンしません。
スキルを手動でインストール
Section titled “スキルを手動でインストール”アシスタントがAgent Skillsを読み込むがプラグイン機能がない場合は、skills/codeknit/をアシスタントのスキルディレクトリにコピーします:
~/.claude/skills/~/.codex/skills/~/.kiro/skills/
プラグインの更新
Section titled “プラグインの更新”| アシスタント | コマンドまたは操作 |
|---|---|
| Claude Code | claude plugin marketplace update codeknit |
| Codex | codex plugin marketplace upgrade |
| Kiro IDE | PowersパネルでCheck for updatesを選択します。 |
| Kiro CLI | git -C ~/.codeknit-power pullを実行し、再度kiro-cli powers install ~/.codeknit-powerを実行します。 |
プラグインの更新では、すでにインストールされているバイナリは更新されません。バイナリのバージョンを変更するには、上記のようにCODEKNIT_VERSIONを設定します。
codeknitをアップグレードして抽出内容が変更された場合、シンボルIDも変更される可能性があります。異なる実行からのチャンクを混在させるのではなく、アシスタントにすべての出力を再生成させてください。
スキルがアシスタントに教えること
Section titled “スキルがアシスタントに教えること”このスキルは、アシスタントに以下のルールを教えるため、リクエストごとに繰り返す必要はありません:
- 質問に応じてコマンドを選択。
parseは、何が存在し、どこにあり、何が何を呼び出し、継承し、または含んでいるかを回答します。graph analyzeは、循環依存、ハブ、デッドコード、ゴッドクラス、ボトルネックを見つけます。fingerprintは、コピー&ペーストやリファクタリングの候補を見つけます。
- デフォルトで
directory-flat出力モードを使用。 アシスタントはチャンク化されたファイルを./skeleton/に書き込み、必要なチャンクのみを読み込みます。inline出力モードは、単一のファイルまたは少数のファイルに対してのみ使用します。これは、inlineがすべてをコンテキストウィンドウにダンプするためです。 - 構造に関する質問には、生のソースではなく
.skt出力を読み取る。 アシスタントは、実装の詳細を検査または変更する場合にのみソースファイルを開き、出力の行範囲を使用します。スキルのreferences/output-format.mdに完全なフォーマットが記載されています。出力フォーマットリファレンスも参照してください。 - 類似度の範囲を選択し、マッチをシグナルとして扱う。 フィンガープリントは、意図ではなく構造的な形状を比較します。アシスタントは、リファクタリングを提案する前に、ペアの両方のシンボルを読み取ります。
構造分析を依頼する
Section titled “構造分析を依頼する”- アシスタントにコードベースの構造を分析させます。例:「
./srcの構造をマップし、authパッケージに依存しているモジュールを教えてください。」 - アシスタントはバイナリがインストールされていることを確認し、
codeknit parseをエッジを有効にして実行し、.skt出力を読み取ります。 - 依存関係、呼び出しチェーン、またはデッドコードについてのフォローアップの質問をします。アシスタントは出力から回答します。
- より深い分析のために、構造レビューを依頼します。例:「
./srcの循環依存とゴッドクラスを見つけてください。」アシスタントはcodeknit graph analyzeを実行し、レポートを読み取ります。
出力で[unresolved]または[ambiguous]とマークされた関係は不確定であり、確認された依存関係ではありません。これらに基づく回答は、検証が必要な候補として扱ってください。
これらのリクエストの背後にあるコマンドについては、parseコマンドガイドとgraphコマンドガイドを参照してください。
重複検出を依頼する
Section titled “重複検出を依頼する”- アシスタントに重複コードを見つけさせます。例:「
./src内のコピー&ペーストされた関数を見つけてください。」 - アシスタントは
codeknit fingerprintを実行し、./skeleton/fingerprints.sktの[duplicates]セクションを読み取ります。 - アシスタントは、フラグが付けられた各ペアの両方のシンボルを開き、リファクタリングを提案します。
- 結果がノイズの場合は、類似度の範囲を調整するか、セマンティックな再ランキングを追加するように依頼します。再ランキングには、プルされた埋め込みモデルを持つローカルのOllamaサーバーが必要です。
これらのリクエストの背後にあるオプションについては、fingerprintコマンドガイドを参照してください。
- 構造に関する質問には、生のソースではなく
.sktファイルを読み取るようにアシスタントにリマインドしてください。このフォーマットはコンパクトで、シンボル、関係、行範囲を含んでいるため、コンテキストを小さく保つことができます。 - コード品質の洞察には
graph analyzeを使用します。発見事項はレビューの候補です。外部の呼び出し元や動的ディスパッチによって結果が変わる可能性があるためです。 - 大規模なリファクタリングの前にfingerprintを実行し、統合すべきコピー&ペーストを見つけます。
- アシスタントがすでに
.skt出力を含むディレクトリにparseを再実行する場合、codeknitは書き込みを拒否します。以前の出力を置き換えるために--cleanを渡すように依頼してください。 - バイナリのダウンロードが失敗した場合(オフラインまたはサポートされていないプラットフォーム)、リリースページから手動でリリースを取得するか、インストールを参照してください。
- 実行が部分的な結果を報告した場合は、stderrと
[errors]セクションを確認してください。詳細は分析の信頼性を参照してください。