GrepAI Trace Callees

このスキルは、grepai trace callees を使用して特定の関数が呼び出すすべての関数を見つけることについて説明します。

このスキルを使用する場合

• 関数の依存関係を理解する
• 関数の動作をマッピングする
• 深くネストされた依存関係を探す
• コードの理解とドキュメント作成

Trace Callees とは?

grepai trace callees が答える質問: 「この関数は何を呼び出しているか?」

func ProcessOrder(order) {
    validateOrder(order)
    calculateTotal(order)
    sendConfirmation(order.email)
}
        │
        ↓
┌───────┴───────────────────┐
│  What does ProcessOrder   │
│  call?                    │
├───────────────────────────┤
│ • validateOrder           │
│ • calculateTotal          │
│ • sendConfirmation        │
└───────────────────────────┘

基本的な使用方法

grepai trace callees "FunctionName"

例

grepai trace callees "ProcessOrder"

出力:

🔍 Callees of "ProcessOrder"

Found 4 callees:

1. validateOrder
   File: services/order.go:45
   Context: validateOrder(order)

2. calculateTotal
   File: services/order.go:48
   Context: total := calculateTotal(order.Items)

3. applyDiscount
   File: services/order.go:51
   Context: total = applyDiscount(total, order.Coupon)

4. sendConfirmation
   File: services/order.go:55
   Context: sendConfirmation(order.Email, total)

JSON出力

grepai trace callees "ProcessOrder" --json

出力:

{
  "query": "ProcessOrder",
  "mode": "callees",
  "count": 4,
  "results": [
    {
      "file": "services/order.go",
      "line": 45,
      "callee": "validateOrder",
      "context": "validateOrder(order)"
    },
    {
      "file": "services/order.go",
      "line": 48,
      "callee": "calculateTotal",
      "context": "total := calculateTotal(order.Items)"
    },
    {
      "file": "services/order.go",
      "line": 51,
      "callee": "applyDiscount",
      "context": "total = applyDiscount(total, order.Coupon)"
    },
    {
      "file": "services/order.go",
      "line": 55,
      "callee": "sendConfirmation",
      "context": "sendConfirmation(order.Email, total)"
    }
  ]
}

コンパクト JSON (AI最適化)

grepai trace callees "ProcessOrder" --json --compact

出力:

{
  "q": "ProcessOrder",
  "m": "callees",
  "c": 4,
  "r": [
    {"f": "services/order.go", "l": 45, "fn": "validateOrder"},
    {"f": "services/order.go", "l": 48, "fn": "calculateTotal"},
    {"f": "services/order.go", "l": 51, "fn": "applyDiscount"},
    {"f": "services/order.go", "l": 55, "fn": "sendConfirmation"}
  ]
}

TOON出力 (v0.26.0+)

TOON形式は JSON よりも約50% 少ないトークンで表現できます:

grepai trace callees "ProcessOrder" --toon

注: --json と --toon は相互に排他的です。

抽出モード

Fast モード (デフォルト)

grepai trace callees "ProcessOrder" --mode fast

Precise モード

grepai trace callees "ProcessOrder" --mode precise

モード	速度	精度	依存関係
fast	⚡⚡⚡	良好	なし
precise	⚡⚡	優秀	tree-sitter

ユースケース

関数の動作を理解する

# この複雑な関数は何をしているか?
grepai trace callees "handleRequest"

# データフローをマッピングする
grepai trace callees "processPayment"

依存関係を見つける

# この関数はどの外部サービスを呼び出しているか?
grepai trace callees "syncData"

# どのデータベース操作が発生しているか?
grepai trace callees "saveUser"

コードレビュー

# この関数のサイドエフェクトは何か?
grepai trace callees "updateProfile"

# この関数は多すぎることをしていないか?
grepai trace callees "doEverything"  # 多くのcallee = コードの臭い

ドキュメント作成

# ドキュメント用の依存関係リストを生成
grepai trace callees "initialize" --json | jq '.results[].callee'

Callers と Callees の比較

コマンド	質問	ユースケース
trace callers	誰が私を呼び出しているか?	影響分析
trace callees	私は何を呼び出しているか?	動作分析

# 統合分析
grepai trace callers "processOrder"   # これは誰が使っているか?
grepai trace callees "processOrder"   # これは何をしているか?

結果をフィルタリングする

ファイルタイプで絞り込む

# callees を取得し、.go ファイルのみをフィルタリング
grepai trace callees "main" --json | jq '.results[] | select(.file | endswith(".go"))'

テスト関数を除外する

grepai trace callees "Login" --json | jq '.results[] | select(.callee | startswith("Test") | not)'

カテゴリ別に集計する

# データベースと API 呼び出しの個数を集計
grepai trace callees "processOrder" --json | jq '.results[].callee' | grep -c "db"

Callees が含むもの

トレースは以下を検出します:

• 直接関数呼び出し
• メソッド呼び出し
• ビルトイン関数呼び出し (モードに依存)

例

func ProcessOrder(order Order) error {
    // 直接呼び出し
    validateOrder(order)

    // メソッド呼び出し
    order.Validate()

    // パッケージ関数
    utils.Log("processing")

    // ビルトイン (キャプチャされる可能性あり)
    fmt.Println("done")

    return nil
}

検出される Callees:

• validateOrder
• Validate (メソッド)
• Log (utils から)
• Println (モードに依存)

制限事項

Callees が見落とす可能性があるもの

• 動的/実行時呼び出し
• コールバックとクロージャ
• インターフェースメソッド呼び出し (インターフェースが表示され、実装ではない可能性)
• リフレクションベースの呼び出し

検出されない呼び出しの例

func process(fn func()) {
    fn()  // Callee は静的分析時に不明
}

Trace Graph との組み合わせ

再帰的な依存関係分析の場合は、trace graph を使用します:

# 直接の callee のみ
grepai trace callees "main"

# 完全な依存関係ツリー (再帰的)
grepai trace graph "main" --depth 3

スクリプト例

すべての Callees をリストアップ

grepai trace callees "main" --json | jq -r '.results[].callee' | sort -u

特定の Callee を確認

# processOrder は sendEmail を呼び出しているか?
grepai trace callees "processOrder" --json | jq -e '.results[] | select(.callee == "sendEmail")' && echo "Yes" || echo "No"

依存関係レポートを生成

#!/bin/bash
echo "# Function Dependencies Report"
echo ""
for fn in main initialize processOrder; do
    echo "## $fn"
    grepai trace callees "$fn" --json | jq -r '.results[].callee' | sed 's/^/- /'
    echo ""
done

よくある問題

❌ 問題: 関数が見つからない ✅ 解決策: スペルを確認し、関数がインデックス対象ファイルに存在することを確認

❌ 問題: callees が見つからない (ただし関数には呼び出しがある) ✅ 解決策:

• --mode precise を試す
• 言語が enabled_languages に含まれているか確認
• symbols.gob が最新か確認 (grepai watch)

❌ 問題: いくつかの callees が不足している ✅ 解決策: より高い精度のため --mode precise を使用

ベストプラクティス

1. 理解のために使用: 新しいコードベースの学習に最適
2. callers と組み合わせる: 完全な依存関係像を得る
3. 深い分析には graph を使用: 再帰が必要な場合
4. 結果をフィルタリング: 関連する callees に焦点を絞る
5. 結果を文書化: マークダウンにエクスポートしてドキュメント化

出力形式

Trace callees の結果:

🔍 Callees of "ProcessOrder"

Mode: fast
Function found in: services/order.go:40

Found 4 callees:

1. validateOrder
   File: services/order.go:45
   Context: validateOrder(order)

2. calculateTotal
   File: services/order.go:48
   Context: total := calculateTotal(order.Items)

3. applyDiscount
   File: services/order.go:51
   Context: total = applyDiscount(total, order.Coupon)

4. sendConfirmation
   File: services/order.go:55
   Context: sendConfirmation(order.Email, total)

Tip: Use 'grepai trace graph ProcessOrder' for recursive analysis