mcpField
H
headless-ghidra-intake

headless-ghidra-intake

github.com/bytelandtechnology安全590 次安装25 周前更新
代码仓库

关于 headless-ghidra-intake

用于无界面 Ghidra 流程的接收阶段技能，将二进制文件或归档准备为分析目标。它初始化工作区、发现 Ghidra、检查二进制并记录分析范围，但不执行 Ghidra 分析。

主要功能

  1. 01初始化目标工作区
  2. 02发现 Ghidra 并检查二进制
  3. 03设置和查看分析范围
  4. 04记录接收信息与流程状态
  5. 05检查 P0 阶段门禁

适用场景

  1. 01为 Ghidra 工作流准备二进制文件
  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

详细介绍

无头 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