mcpField
H
headless-ghidra-intake

headless-ghidra-intake

github.com/bytelandtechnologyセキュリティ590 回インストール25 週間前に更新
リポジトリ

headless-ghidra-intake について

ヘッドレスGhidraパイプライン向けに、バイナリやアーカイブを解析対象として準備するインテーク用スキルです。ワークスペースの初期化、Ghidraの検出、バイナリの検査、解析範囲の記録を行い、Ghidra解析自体は実行しません。

主な機能

  1. 01ターゲットワークスペースの初期化
  2. 02Ghidraの検出とバイナリ検査
  3. 03解析範囲の設定と確認
  4. 04インテーク情報と状態の記録
  5. 05P0フェーズゲートの確認

活用シーン

  1. 01Ghidraワークフロー向けのバイナリ準備
  2. 02関数または対象全体の範囲設定
  3. 03ターゲットと環境の準備状況確認
  4. 04初期解析入力の記録

インストール

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

$npx skills add https://github.com/bytelandtechnology/headless-ghidra --skill headless-ghidra-intake

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

planning-brief.md
README.ja-JP.md
README.md
README.zh-CN.md
examples/
intake-speckit-handoff.md

詳細

Headless Ghidra 取り込み — P0

P0 では、ワークフローの残りの工程で使用するターゲットを準備します。入力されたバイナリまたはアーカイブのパスを、有効な ghidra-agent-cli ワークスペースターゲットに変換し、初期分析の範囲を記録します。

必須の ghidra-agent-cli コマンド

  • ghidra-agent-cli workspace init
  • ghidra-agent-cli ghidra discover
  • ghidra-agent-cli inspect binary
  • ghidra-agent-cli scope show
  • ghidra-agent-cli scope set
  • ghidra-agent-cli scope add-entry
  • ghidra-agent-cli scope remove-entry
  • ghidra-agent-cli gate check --phase P0

アーカイブの正規化や、ターゲット固有のブートストラップスクリプトは、CLI から直接実行できるようになるまでは、バックエンドの詳細として扱ってもかまいません。

入力

  • ユーザーが指定したバイナリまたはアーカイブのパス
  • ワークスペースのルート
  • Ghidra の検出に必要なローカル環境

出力

  • targets/<target-id>/ghidra-projects/
  • artifacts/<target-id>/pipeline-state.yaml
  • artifacts/<target-id>/scope.yaml
  • 任意のフェーズ所有の取り込み記録（artifacts/<target-id>/intake/ 以下）

終了時の要件

  • ターゲットのワークスペースが存在し、--target <id> で指定できます。
  • pipeline-state.yaml に選択したバイナリのパスが記録されています。
  • scope.yaml に選択した関数、アドレス、シンボル、またはターゲット全体を対象とする明示的なスコープが記録されています。
  • Ghidra の検出とバイナリの検査が実行され、確認されています。

制約

  • このフェーズでは、実際の Ghidra 分析を実行しないでください。
  • ベースライン、証拠、逆コンパイル、検証の出力を書き込まないでください。
  • サポート対象の手順で ghidra-agent-cli workspace init、ghidra discover、inspect binary を経由しない方法を使わないでください。
  • CLI に機能がない場合、新しい Ghidra スクリプトを作成または実行しないでください。まず一時停止してユーザーに確認してください。

次のステップ

  • P0 ゲートに合格 → headless-ghidra-baseline

コメント

Markdown 対応