mcpField
M
mapping-codebases

mapping-codebases

github.com/oaustegard開発157101 回インストール1 日前に更新
リポジトリ

mapping-codebases について

mapping-codebases は、コードリポジトリのシンボルマップを保存するための非推奨スキルです。README は tree-sitting への移行を案内し、アーカイブ版 v0.8.0 について説明しています。

主な機能

  1. 01非推奨、tree-sitting の使用を推奨
  2. 02以前はディレクトリごとの _MAP.md を生成
  3. 03アーカイブ版 v0.8.0 に codemap.py とパーサー文法を収録

活用シーン

  1. 01アーカイブされた mapping-codebases v0.8.0 の参照
  2. 02保存型コードマップを tree-sitting のクエリに置き換え

インストール

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

$npx skills add https://github.com/oaustegard/claude-skills --skill mapping-codebases

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

同梱ファイルCHANGELOG.md

詳細

コードベースのマッピング（非推奨）

代わりにtree-sittingを使用してください。

理由

このスキルは、ディスク上に _MAP.md ファイルを作成していました。ディレクトリごとのシンボル一覧を一度生成して保存し、何度も読み込む方式です。スキャンにコストがかかっていた頃は、このトレードオフにも意味がありました。しかし、今は違います。tree-sitting は 250 ファイルのリポジトリを約 700ms で解析し、メモリ内の AST に対するクエリに 1 ミリ秒未満で応答します。

保存済みのマップには、実行時スキャンでは不要なコストがかかります。古くなり、再生成が必要になり、コミットされ、ツリーを走査するほかのすべてのツールで除外しなければなりません。それによって得られるものは何もありませんでした。

置き換え用コマンド

TREESIT=/mnt/skills/user/tree-sitting/scripts/treesit.py

# Was: codemap.py /path/to/repo          → root orientation
python3 $TREESIT /path/to/repo

# Was: reading every _MAP.md in the tree → full inventory
python3 $TREESIT /path/to/repo --depth=-1 --detail=sparse

# Was: grepping _MAP.md for a symbol     → direct lookup
python3 $TREESIT /path/to/repo --no-tree 'find:parse_input'

アーカイブ版

最後に動作していたリリースは mapping-codebases-v0.8.0 （2026-03-31）です。scripts/codemap.py と、同梱されている 11 個の parsers/*.so 文法が含まれています。このリリースがスナップショットであり、このディレクトリにはその再現物はありません。

なお、v0.8.0 には潜在的なバグがあります。codemap.py:1216 は、裸の except Exception によって捕捉される try ブロック内で、インポートされていない get_parser() を呼び出しています。そのため、HTML のインライン JavaScript のシンボル抽出は何も返さずに終了していました。この問題は修正されません。

コメント

Markdown 対応