mcpField
E
explore

explore

github.com/terrylica開発280 回インストール2 日前に更新
リポジトリ

explore について

GitNexus Exploreは、GitNexusのナレッジグラフで実行フローを追跡し、未知のコードを理解するためのコマンドラインスキルです。インデックスの確認からシンボルやソースの調査までを案内し、サブシステムの動作を整理できます。

主な機能

  1. 01GitNexusインデックスの鮮度確認
  2. 02実行フローの順位付き検索
  3. 03シンボルの呼び出し元と呼び出し先の調査
  4. 04シンボルの文脈とソースの表示
  5. 05サブシステムの説明の整理

活用シーン

  1. 01機能の実行過程を追跡
  2. 02未知のサブシステムの調査
  3. 03コード変更前の依存関係の把握

MCP 対応

このスキルはMCPサーバーが存在しないと明記し、`gitnexus://` MCPリソースではなくGitNexusコマンドラインを使うよう案内しています。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/terrylica/cc-skills --skill explore

インストール後、Claude Code で/exploreを入力して読み込まれたか確認します。

詳細

GitNexus Explore

CLI のみ — MCP サーバーは存在しません。gitnexus:// URI で readMcpResource を絶対に使用しないでください。

GitNexus のナレッジグラフを使って、実行フローをたどり、コードの仕組みを理解します。

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

使用する場面

  • 「X はどのように動作しますか？」
  • 「Y の実行フローはどうなっていますか？」
  • 「Z サブシステムについて順を追って説明してください」
  • 変更を加える前に、よく知らないコード領域を調べるとき

ワークフロー

ステップ 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

古い場合（インデックス化されたコミット ≠ HEAD）は、続行する前に自動的に再インデックスしてください。ユーザーに確認を求めないでください。

gitnexus analyze

その後、ステータスを再確認して、インデックスが最新であることを確認してください。

ステップ 2：実行フローを見つける
gitnexus query "<concept>" --limit 5

これにより、その概念に関連する実行フロー（プロセスチェーン）が、ランキング順に返されます。

ステップ 3：シンボルの全体像を把握する

関連するシンボルごとに、次を実行します。

gitnexus context "<symbol>" --content

次の情報が表示されます。

  • 呼び出し元 — このシンボルを呼び出すもの
  • 呼び出し先 — このシンボルが呼び出すもの
  • プロセス — このシンボルが関与する実行フロー
  • ソース — 実際のコード（--content を指定）

候補が複数返された場合は、次のコマンドで候補を絞り込んでください。

gitnexus context "<symbol>" --uid "<full-uid>" --content
# or
gitnexus context "<symbol>" --file "<file-path>" --content
ステップ 4：ソースファイルを読む

Read ツールを使用して、GitNexus が特定した行番号のソースファイルを確認します。

ステップ 5：内容をまとめる

次の項目を含め、わかりやすく説明してください。

  • 概要 — 目的と役割
  • 実行フロー — システム内でデータがどのように流れるか
  • 依存関係 — 何に依存し、何がこれに依存しているか
  • 主要なファイル — 理解するうえで最も重要なファイル

例

ユーザー：「kintsugi のギャップ修復はどのように動作しますか？」

gitnexus query "kintsugi gap repair" --limit 5
gitnexus context "KintsugiReconciler" --content
gitnexus context "discover_shards" --content

次に、関連するソースファイルを読み、内容をまとめて説明します。

実行後の振り返り

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

  1. 現在の場所を特定する。 — 編集する前に、この SKILL.md の正式なパスを見つけます。
  2. 何が失敗したか？ — 失敗の原因となった指示を修正します。
  3. 予想以上にうまくいったことは？ — 推奨される方法として取り入れます。
  4. 何が変化していたか？ — 実態と一致しなくなったスクリプト、参照先、依存関係を修正します。
  5. 記録する。 — 発生条件、修正内容、根拠を進化ログに記録します。

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

コメント

Markdown 対応