frida-mcp-workflow

Frida MCP ワークフロー

以下のフェーズを順番に実行してください。フェーズを省略してはいけません。

フェーズ 1：アイデア

• 対象を定義します：プロセス／アプリの識別子、プラットフォーム、セッションタイプ。
• 目的を定義します：観察すべきシグナル／結果。
• 関数を使用する前にドキュメントを確認します。重要な API／ランタイムに関する前提ごとに search_frida_docs を呼び出してください。
• スクリプトを作成する前に、Doc facts used の箇条書きを 2～5 項目記録してください。
• Frida 17 のセマンティクスのみを前提としてください。Frida 16 の前提は使用しないでください。

必ず停止する条件：

• ドキュメントが見つからない、または曖昧な場合は、スクリプトを作成する前にクエリを絞り込んで再試行してください。

フェーズ 2：スクリプト作成

• インラインスクリプトよりも保存済みファイルを優先してください。
• インラインスクリプトを使用できるのは、短い読み取り専用の調査に限ります。
• フック用スクリプトでは、ファイルベースのスクリプトと load_script を必須とします。
• script_id、目的、明示的な対象リスト（モジュール／シンボル、またはクラス／メソッド）を宣言してください。
• 重複インストールを防ぐための冪等性ガードを追加してください。
• ティアダウンの手段（uninstall RPC エクスポートなど）を定義してください。

スクリプトのポリシー：

• スクリプトが 25 行を超える場合、またはフックを書き込む場合は、ファイルに保存してください。
• 既存の動作を変更する場合は、スクリプトにロールバック処理を含めてください。

フェーズ 3：実行

• ロード／実行の前に、以下を事前確認します。
  • セッションが存在し、動作中である
  • ロード済みのスクリプトが一覧表示されている
  • 対象の重複が確認されている
• 対象の重複がある場合は、新しいスクリプトをロードする前に古いスクリプトをアンロード／置換してください。
• 明示的な意図がない限り、同じ対象に複数のスクリプトをアタッチしないでください。
• 目的ごとに 1 つのスクリプト（調査、フック、トレーサー）を使用することを優先してください。

エラー処理：

• Java is not defined が発生した場合は、再試行を中止し、ドキュメント／ランタイムに関する前提を再確認してください。
• アタッチ／スポーンに失敗した場合は、計装を再試行する前に診断を実行してください。
• ドキュメントの出力が大きすぎる場合は、クエリの範囲を絞るかページ分割してください。推測してはいけません。

フェーズ 4：メモ

• 実行サイクルごとに、メモをファイルに保存してください。
• 以下を記録します。
  • 使用したドキュメント上の事実
  • スクリプト台帳（ロード済み／アンロード済み／現在有効）
  • 観察した出力と検証状況
  • エラーと根本原因
  • クリーンアップ状況と次のアクション
• 作業を終了する際は、ティアダウンが完了していることを確認してください。

必須の回答形式

各タスクでは、次の 4 つのセクションをこの順序で出力してください。

1. Idea
2. Scripting
3. Execution
4. Notes

Idea と Scripting が示される前に、Execution でツールを呼び出してはいけません。