| name | code-tracer |
| description | コードベース内の特定シンボル、関数、メソッド、型、モジュールについて、callers / callees / both の呼び出し経路を根拠付きで追跡し、Markdown や Mermaid で可視化するときに使う。言語ごとの構造化された解析手順を選び、根拠と限界を明示する。 |
Code Tracer
目的
特定のシンボル、関数、メソッド、型、モジュールについて、呼び出し経路を根拠付きで可視化する。
- どこから呼ばれているか（callers）と何を呼んでいるか（callees）を整理する。
- 静的に確定できる経路と、動的ディスパッチや DI などによる推定経路を分ける。
- 出力は Markdown と Mermaid を基本とし、必要に応じて dot / png などを使う。
入力
最低限、次を確認する。
symbol: 対象シンボル、関数、メソッド、型、モジュール名。direction: callers、callees、both のいずれか。未指定なら both。language: 対象言語。既存ファイルや拡張子から推定できる場合はそれを使う。
任意で次を確認する。
depth: 追跡深度。未指定なら 2。scope: 調査対象のディレクトリ、パッケージ、モジュール。format: markdown、mermaid、dot、png など。未指定なら markdown + mermaid。exclude: テスト、生成コード、vendor、mock などの除外条件。
言語別リファレンス
対象言語が分かる場合は、必要な参照だけ読む。
- Go: references/go.md を必ず読む。
- このファイルは、この SKILL.md と同じディレクトリの references/ 配下にある。
- 見つからない場合は ~/.claude/skills/code-tracer/references/go.md を試す。
- それでも見つからない場合はユーザーに報告し、references なしで進めない。
該当するリファレンスがない場合は、言語サーバー、静的解析、参照検索、ビルドツール、既存 IDE 設定から使える根拠を選ぶ。
解析原則
- grep だけで呼び出し関係を断定しない。
- language server、AST、型情報、call hierarchy、references、callgraph など、より構造化された根拠を優先する。
- 動的ディスパッチ、reflection、DI、イベント、設定駆動の呼び出しは、確実な線と推定の線を分ける。
- 調査範囲、除外条件、使ったコマンド、根拠の限界を明記する。
- 大規模コードベースでは、まず scope と depth を狭めてから必要に応じて広げる。
手順
- 対象シンボル、方向、深度、調査範囲、除外条件を決める。
- 対象言語のリファレンスがあれば読み、利用できる解析手段を選ぶ。
- 参照、call hierarchy、callgraph、関連定義を集める。
- 確実な経路、推定経路、未確定の候補を分ける。
- Markdown に要約、解析条件、呼び出し経路、Mermaid 図、根拠、限界をまとめる。
Mermaid 表現
- 確実なエッジは実線で表す。
- 推定エッジは破線（
-.->）で表す。
- ノード名は短くし、必要に応じて完全修飾名を本文に補足する。
flowchart TD
A[entrypoint] --> B[service]
B --> C[repository]
B -.-> D[dynamic target]:::maybe
classDef maybe stroke-dasharray: 5 5;
出力
成果物には次を含める。
- 対象、方向、深度、scope、除外条件。
- 呼び出し経路の要約。
- callers / callees のリスト。
- Mermaid 図。
- 確実 / 推定 / 未確定の区分。
- 根拠として使ったコマンドやファイル。
- 解析上の限界と追加調査候補。
