mcpField
M
map

map

github.com/htlin222開発7837 回インストール3 週間前に更新
リポジトリ

map について

map は、コードベースの調査やリファクタリングに使うシンボルマップ生成スキルです。対応言語を判別し、エクスポートされたシンボルのファイル名と行番号を記録します。

主な機能

  1. 01TypeScript、JavaScript、Python、Rust、Go の判別
  2. 02エクスポートシンボルの抽出
  3. 03ファイル名と行番号の記録
  4. 04Markdown シンボルマップの生成

活用シーン

  1. 01不慣れなコードベースの把握
  2. 02リファクタリング前のシンボル特定

インストール

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

$npx skills add https://github.com/htlin222/dotfiles --skill map

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

同梱ファイルscripts/symbol_map.py

詳細

コードベースのシンボルマップ生成ツール

すべてのエクスポート、クラス、関数、インターフェースの定義場所を示すセマンティックなシンボルマップを生成します。正確な file:line の場所を提示することで、rg を使った推測が不要になります。

使用する場面

  • 不慣れなコードベースで作業を始めるとき
  • 大規模なリファクタリングの前
  • コード構造を把握する必要があるとき
  • rg のテキストマッチングによる混乱（コメントや文字列内に同じ名前がある場合）を避けたいとき

実行方法

ジェネレータースクリプトを実行します。

python3 ~/.claude/skills/map/scripts/symbol_map.py

スクリプトは次の処理を行います。

  1. プロジェクトの言語（TypeScript/JavaScript/Python/Rust/Go）を検出します
  2. すべてのエクスポートされたシンボルとその場所を抽出します
  3. ~/.claude/codebase-maps/{project}_symbols.md に Markdown マップを生成します

出力形式

## Symbol Index by Type

### Classes

| Symbol         | Location                  |
| -------------- | ------------------------- |
| `AuthProvider` | `src/auth/provider.ts:15` |

### Functions

| Symbol       | Location               |
| ------------ | ---------------------- |
| `formatDate` | `src/utils/date.ts:42` |

生成後の使用方法

/map の実行後は、シンボルの場所を直接指定します。

  • 「src/auth/provider.ts:15 を読んで、AuthProvider を確認してください」
  • 「src/utils/date.ts:42 にある formatDate 関数を変更する必要があります」

もう grep して推測する必要はありません。

コメント

Markdown 対応