reindex

GitNexus の再インデックス

CLI 専用 — MCP サーバーは存在しません。gitnexus:// URI で readMcpResource を決して使用しないでください。

現在のリポジトリの GitNexus ナレッジグラフを再インデックスし、更新された統計情報を確認します。

自己進化型スキル：このスキルは使用を通じて改善されます。手順に誤りがある、パラメーターが変わった、または回避策が必要になった場合は、先送りせず直ちにこのファイルを修正してください。実際に再現できる問題がある場合にのみ更新してください。

使用するタイミング

• 大規模なリファクタリングの後（5 個以上のファイルを変更した場合）
• ステールネスフックでインデックスの遅れが報告された場合
• 大規模な PR をマージした後
• 「ナレッジグラフを更新して」

ワークフロー

ステップ 0：事前確認 — CLI を呼び出せる状態にする

gitnexus バイナリは npm/mise 経由でインストールされています。現在のプロジェクトで node が有効になっていない場合、mise のシムが失敗することがあります。gitnexus のコマンドを実行する前に、次の事前確認を行ってください。

# Test if gitnexus is actually callable (not just a broken shim)
gitnexus --version 2>/dev/null || mise use [email protected]

以下のすべてのコマンドはリポジトリのルートから実行します。ワークスペースに複数のリポジトリがインデックスされている場合は、--repo <repo-name> を追加して対象を指定してください。それ以外の場合、--repo は省略可能です。

ステップ 1：現在のステータスを確認する

gitnexus status

すでに最新の状態（lastCommit が HEAD と一致する状態）の場合は、「インデックスは最新です」と報告して終了します。

ステップ 2：インデクサーを実行する

gitnexus analyze

インデックスが破損しているように見える場合や、通常の analyze で変更が反映されない場合は、--force を使用してください。

gitnexus analyze --force

コードベースのサイズによっては、30～120 秒かかることがあります。

ステップ 3：新しいインデックスを確認する

gitnexus status

ステップ 4：統計情報を報告する

更新された統計情報を提示してください。

## GitNexus Reindex Complete

| Metric      | Before | After |
| ----------- | ------ | ----- |
| Nodes       | ...    | ...   |
| Edges       | ...    | ...   |
| Communities | ...    | ...   |
| Flows       | ...    | ...   |
| Last Commit | ...    | ...   |

Index is now current with HEAD.

注意事項

• analyze コマンドはローカルで実行され、ネットワークへのアクセスはありません
• KuzuDB データベースはリポジトリのルートにある .gitnexus/ に保存されます
• 大規模なコードベース（1 万ファイル以上）では、2 分以上かかることがあります
• --force フラグを指定すると最初から再構築され、指定しない場合は増分分析が使用されます

実行後の振り返り

このスキルの実行後、タスクを完了する前に振り返ってください。

0. 自分の所在を確認する。 — 編集する前に、この SKILL.md の正規パスを特定します。
1. 何が失敗したか？ — 原因となった手順を修正します。
2. 予想以上にうまくいったことは何か？ — 推奨プラクティスとして取り入れます。
3. 何が実態とずれていたか？ — 現状に合わなくなったスクリプト、参照先、依存関係を修正します。
4. 記録する。 — 発生のきっかけ、修正内容、根拠を含む進化ログのエントリーを追加します。

先送りしないでください。次回の実行では、ここに残した状態が引き継がれます。