sf-debug: Salesforce デバッグログ分析とトラブルシューティング

このスキルは、ユーザーが デバッグログからの根本原因分析 が必要な場合に使用してください：ガバナー制限の診断、スタックトレースの解釈、低速クエリの調査、ヒープ/CPU圧力の分析、またはログエビデンスに基づく再現～修正のループ。

このスキルがタスクを担当する場合

以下の作業が含まれる場合は sf-debug を使用してください：

• Salesforce からの .log ファイル
• スタックトレースと例外分析
• ガバナー制限
• SOQL / DML / CPU / ヒープのトラブルシューティング
• ログから抽出されたクエリプランまたはパフォーマンスエビデンス

以下の場合は別のスキルに委譲してください：

• Apex テストの実行または修復 → sf-testing
• コード修正の実装 → sf-apex
• Agentforce セッショントレース / parquet テレメトリのデバッグ → sf-ai-agentforce-observability

---

最初に収集すべき必須コンテキスト

以下を確認するか推測してください：

• org エイリアス
• 失敗するトランザクション / ユーザーフロー / テスト名
• 大体のタイムスタンプまたはトランザクション期間
• ユーザー / レコード / リクエスト ID（既知の場合）
• 目標が診断のみか、診断 + 修正ループかどうか

---

推奨ワークフロー

1. ログを取得

sf apex list log --target-org <alias> --json
sf apex get log --log-id <id> --target-org <alias>
sf apex tail log --target-org <alias> --color

2. この順序で分析

1. エントリーポイントとトランザクションタイプ
2. 例外 / 致命的エラー
3. ガバナー制限
4. 繰り返される SOQL / DML パターン
5. CPU / ヒープのホットスポット
6. コールアウトタイミングと外部障害

3. 重大度を分類

• Critical — ランタイム失敗、ハード制限、破損リスク
• Warning — 制限に近い、非選択的クエリ、低速パス
• Info — 最適化機会または衛生問題

4. 最小限の正しい修正を推奨

修正は以下を優先してください：

• 根本原因志向
• バルク対応
• テスト可能
• 再実行で簡単に検証できる

拡張ワークフロー：references/analysis-playbook.md

---

高シグナル問題パターン

問題	主要シグナル	デフォルト修正方向
ループ内の SOQL	繰り返された呼び出しパス内の反復する SOQL_EXECUTE_BEGIN	クエリを1回実行し、マップ / グループ化されたコレクションを使用
ループ内の DML	繰り返される DML_BEGIN パターン	行を収集し、バルク DML を1回実行
非選択的クエリ	スキャン行が多い / 選択性が低い	インデックス付きフィルターを追加、スコープを削減
CPU 圧力	CPU 使用量が同期制限に近づいている	アルゴリズムの複雑さを軽減、キャッシュ、有効な場合は非同期化
ヒープ圧力	ヒープ使用量が同期制限に近づいている	SOQL for-ループでストリーム処理、メモリ内データを削減
Null ポインタ / 致命的エラー	EXCEPTION_THROWN / FATAL_ERROR	null 仮定をガード、空クエリ処理を修正

拡張例：references/common-issues.md

---

出力フォーマット

分析を完了したら、この順序で報告してください：

1. 何が失敗したか
2. どこで失敗したか（クラス / メソッド / 行 / トランザクションステージ）
3. なぜ失敗したか（症状ではなく根本原因）
4. どの程度深刻か
5. 推奨される修正
6. 検証ステップ

推奨形式：

Issue: <概要>
Location: <クラス / 行 / トランザクション>
Root cause: <説明>
Severity: Critical | Warning | Info
Fix: <具体的なアクション>
Verify: <テストまたは再実行ステップ>

---

クロススキル統合

必要性	委譲先	理由
Apex 修正の実装	sf-apex	コード変更生成 / レビュー
テストで再現	sf-testing	テスト実行とカバレッジループ
修正をデプロイ	sf-deploy	デプロイメントオーケストレーション
デバッグデータを作成	sf-data	ターゲット化されたシード / 再現データ

---

リファレンスマップ

ここから始める

• references/analysis-playbook.md
• references/common-issues.md
• references/cli-commands.md

深掘りリファレンス

• references/debug-log-reference.md
• references/log-analysis-tools.md
• references/benchmarking-guide.md

ルーブリック

• references/scoring-rubric.md

---

スコアガイド

スコア	意味
90+	強い修正ガイダンスを備えた専門家分析
80–89	軽微なギャップがある良好な分析
70–79	許容可能だが二次的な問題を見落とす可能性がある
60–69	部分的な診断のみ
< 60	不完全な分析