评分明细
适用场景
reverse-skill 快速入门：先建立离线分析边界，再选择工具
这是什么？适合谁？
reverse-skill 是面向编码 Agent 的安全分析技能路由包。它把 Android、二进制、JavaScript、证据整理等不同场景连到各自的分析方法和外部工具，而不是自己替代反编译器、扫描器或调试器。
它的重要设计是先确认任务范围，再决定主要技能和工具，最后留下可核对的证据与报告。对于已有授权样本的安全工程师和学习者，这比让模型随机尝试命令更容易复盘；但路由命中并不保证结论正确。
本站按合集收录。仓库涉及的能力不等于对任何目标的使用许可，安装也不代表本机已经具备所有依赖。本文只介绍项目配置与获授权离线样本的准备流程，不提供第三方目标攻击、绕过防护或凭据获取步骤。
与 Trail of Bits Skills 相比，它的入口更侧重场景路由与本地工具协同；与 Semgrep 相比，它是跨工具的方法与交接层，不是规则扫描引擎。先有清楚的问题与合法样本，才能判断是否需要它。
核验日期：2026-10-20。依据为官方 README、配置说明与范围契约。
准备工作
- 一个支持读取项目技能的编码助手，以及已掌握的基础 Git 操作。
- 官方列出 Node.js 22.12+、Python 3.x；涉及 jadx、apktool 时还要 Java/JDK。
- 只准备自己拥有或书面获准分析的样本；不要使用真实客户凭据、生产数据库或个人隐私数据。
- 使用隔离目录，保留样本原件和授权记录，限制 Agent 可访问的文件与网络。
- 主项目采用 MIT 许可；
CTF-Sandbox-Orchestrator子模块为 GPLv3，其他外部工具依各自许可，模型与商业软件另计费用。 - 先读脚本再决定是否执行，安装缺失软件和注册 MCP 都需单独授权。
可先检查本机基础环境。
git --version
node --version
python --version
JDK 等依赖按所选场景准备，不需要为了阅读技能包安装所有工具。
安装、配置与首次使用
第一步：获取仓库，只读查看入口
在专门的分析目录中获取官方仓库。
git clone https://github.com/zhaoxuya520/reverse-skill.git
cd reverse-skill
git rev-parse HEAD
记录提交号，阅读 README_AI.md、RULES.md 与对应操作系统文档。此阶段仅获取和阅读文档，不运行 bootstrap、不写助手全局配置。
成功判定：能找到配置入口、平台文档和 skills/MASTER-ROUTING.md。克隆成功不是工具安装完成。
官方配置说明明确把“查看仓库”和“启用技能”分开；阅读到要求执行的文档，也不自动代表你同意执行。
第二步：明确同意后生成工具索引
先审阅 refresh 脚本和它将探测的工具，再在自己的环境中选择对应命令。索引写入仓库下的 skills/tool-index.md 与 skills/tool-index.json。
Windows 在 PowerShell 中使用：
powershell -File skills/scripts/refresh-tool-index.ps1
Linux/macOS 使用：
bash skills/scripts/refresh-tool-index.sh
预期结果是生成本机工具清单，列出可用与缺失项。索引不是安装器的完成证明，缺失工具不能凭模型一句“已配置”变成可用。
此命令会写文件。如果你只是在评审项目，不需要执行它；也不要把当前机器的索引当作另一台机器的事实。
第三步：以自己编译的离线样本建立案例
选用你自己编译的 Android 测试 APK，命名为 app.apk 放入分析项目。样本准备不涉及安装到真实设备，也不涉及连接外部站点。
以下是官方离线样本初始化的 Linux/macOS 示例；仅在已审阅脚本、确认写入位置后执行。
bash skills/scripts/case-init.sh \
--hint "offline apk" --case-name "my-sample" \
--preset offline-sample --sample ./app.apk
Windows 对应 skills/scripts/case-init.ps1，参数形式为 -Hint、-CaseName、-Preset offline-sample 与 -Sample，不要照搬 Bash 参数。
案例文件默认属于调用者的分析项目，位于 work/<case>/。从其他目录调用时，使用文档中的 --project-root 或 -ProjectRoot 显式指定归属。
打开生成的 scope.md，逐项确认授权依据、样本路径、允许活动、禁止活动和网络模式。不要为了让流程继续而把未知授权改成 granted。
成功判定：案例目录存在，scope 中的样本与真实文件一致，网络模式为 offline，授权和交付范围完整。
第四步：先做可核对的只读交接
把下面的任务交给助手，限制它只读案例文档和工具索引。
阅读本案例 scope.md 与本机 tool-index。
只列出这个自有离线 APK 所需的主要技能与缺失工具。
核对样本路径、授权依据、offline 网络模式和禁止活动。
不执行样本、不安装软件、不启动 MCP、不进行任何网络请求。
输出准备完成项、缺失项及对应文档路径，不给攻击步骤。
预期结果是一份准备报告，而不是“已安全通过”的结论。你应能从每条报告回到 scope 或工具索引验证。
后续分析只在授权与环境条件满足后另行开展，不能用初始化成功代替授权审查。
常见踩坑
以下是按官方契约推导的排查清单，不是本站独立运行记录。
踩坑 1：刚克隆就缺 tool-index
- 现象：助手找不到本机工具清单。
- 原因：官方说明该索引被 Git 忽略，新克隆不会自带。
- 解决：审阅并同意 refresh 操作后生成，不下载别人的机器索引冒充本机状态。
- 依据：配置说明。
踩坑 2：没有范围契约就开始分析目标
- 现象：助手准备扫描或执行工具，但授权和对象仍不清楚。
- 原因：跳过了
scope.md前置条件。 - 解决：保持只读准备状态，先补齐授权与明确样本；不得用强制参数绕过。
- 依据：范围契约。
踩坑 3：把工具索引当自动安装结果
- 现象：路由选择了 jadx，但本机没有可执行程序。
- 原因：方法、探测结果与外部工具是三层不同对象。
- 解决：根据索引确认依赖，再按批准范围安装；缺项如实标注。
- 依据：官方入门说明。
踩坑 4：案例文件落到错误项目
- 现象：分析项目中找不到新生成的 scope。
- 原因：从不同目录调用脚本，却没有指定案例归属根目录。
- 解决：核对当前目录与
ProjectRoot；只在确认的项目内保存样本和记录。 - 依据：初始化路径说明。
踩坑 5：报告写了结论，却没有证据链
- 现象：只有“发现问题”或“未发现问题”，无法重放。
- 原因：遗漏证据、发现与路径之间的对应关系。
- 解决：保留原始产物和时间线，按 case-review 文档检查交接完整性；完整性通过也不等于分析正确。
- 依据：证据契约目录。
初级用法
1. 清点分析环境
先用工具索引确认本机有什么，按任务列缺项。把“不需要”和“未安装”分开，避免无目的安装整套工具链。
2. 只读检查 scope
核对授权依据、离线样本、禁止活动与交付物。任何一项未知就停在准备环节，不让模型自行扩展范围。
3. 整理案例交接
使用 case-review 的文档核对证据引用和交接内容。先让另一位同事能够理解已有记录，再谈复杂自动化。
高级玩法
1. 将路由与证据层分开管理
路由回答“该用哪类方法”，evidence-finding-path 回答“结论如何被支持”。两层都要有记录，不能只靠选对技能名称。
2. 按平台准备最小工具集合
Windows、Linux、macOS 有各自入口。围绕当前离线样本安装必要依赖，避免因一项可选工具缺失就误判整包无法使用。
3. 固定提交号复盘
把技能包提交号、样本版本、工具版本与报告一起记录。升级后若路由不同，先对照变更，不直接覆盖旧案例结论。
小技巧
- 用自己编译的教学样本，而不是来源不明的可执行文件。
offline是明确的禁止对外发包边界，不是“尽量少联网”。- 缺失工具直接列明，禁止用模型推测的输出充当分析证据。
- 报告中区分“没有检查”和“检查后未发现”，两者含义不同。
- 不把项目规则批量注入所有客户端的全局配置，适配只针对批准的客户端。
常见问题 FAQ
Q1：这是免费的一键逆向工具吗？
A：它是 MIT 开源的技能路由合集；模型、商业分析软件和算力另计，也不会因克隆成功就安装全部依赖。见官方仓库。
Q2：与 Semgrep 有什么区别？
A：Semgrep 主要提供代码规则扫描能力；reverse-skill 负责跨场景方法与工具路由。它们不是可互相替代的单一产品，参见Semgrep 文档。
Q3：只有阅读需求，可以不执行脚本吗？
A：可以。官方 README_AI.md 明确要求查看、比较和总结时保持只读，配置或使用需额外明确同意。
Q4：有一个 APK 文件是否就代表可以分析？
A：不是。还要确认拥有或获得分析权限，写清授权依据与允许活动；不清楚时只整理材料，不开展目标操作。
Q5：工具索引与 case-review 通过能证明安全吗？
A：不能。索引反映依赖情况，case-review 检查交接证据；两者都不能代替人工判断、完整测试或软件本身的安全保证。
功能学习路径
- 先读
MASTER-ROUTING，理解场景如何选择主要技能，不以路由名称代替分析结果。 - 再读
scope-contract，练习为自有离线样本填写授权、范围与网络边界。 - 最后看
case-review和evidence-finding-path，把方法、证据与结论连成可交接的链路。
资料边界
本文基于官方文档和公开资料整理，AI辅助生成，MagicNetWorld 尚未完成独立实测。没有运行仓库脚本、执行样本或开展渗透测试；本文不授予任何目标的测试权限。
参考链接
📊 评分与标签
核验口径：已按现行口径通过，待按新证据契约复核
评分说明
总分 8.2/10 · P_优选
核验日期：2026-10-20。按技能合集评价其安装说明、方法组织与证据交接，不为任何渗透能力背书。评分依据可追溯至公开来源，每项分数均有明确理由和数据支撑。
📊 可观测社区指标（采集日期：2026-10-20）
- 公开 API：42,672 Stars、6,232 Fork、35 个开放事项，开放事项含 PR。
- pushed_at 为 2026-09-22T06:43:21Z，即北京时间 2026-09-22 14:43:21，距核验不足三个月，无长期未更新提示。
- LICENSE为 MIT。关注指标不证明方法正确、实战效果或无刷星。
📦 可安装性 1.9/2.5
- 官方给出 Git 克隆和 Windows、Linux/macOS 的 refresh-tool-index 入口，本机索引在用户同意后生成，缺失项可被明确列出。来源：README、配置说明。
- Java、Node.js、Python 和具体分析工具分别有前提；克隆不是依赖安装完成，商业工具需另备许可，因此扣除环境准备成本。
- 竞品对比 1（Trail of Bits Skills）：同样是安全技能集合，但以审计插件组织入口；reverse-skill 还需要围绕场景建立机器工具索引。来源：Trail of Bits。
- 竞品对比 2（Semgrep）：扫描引擎入口更聚焦；reverse-skill 是多工具路由层，配置更广而非一对一替代。来源：Semgrep 文档。
🎯 实用性 2.3/2.5
- 以场景选择主要技能，结合 scope、工具索引、时间线与证据交接，能减少方法选择与交接记录脱节。来源：README。
- 授权范围契约要求目标操作前确认授权和网络边界；这是流程设计，不是本站已经验证无法绕过的强制隔离。来源：Scope 契约。
- 竞品对比 1（Trail of Bits Skills）：更适合围绕其审计方法与插件选择；本合集的特色是跨样本类型的路由和案例交接。来源：Trail of Bits。
- 竞品对比 2（Semgrep）：适合规则驱动的代码扫描；本合集可组织更广的方法，但没有因此获得同等确定性的扫描结论。来源：Semgrep。
📖 文档质量 1.8/2.0
- 提供 README_AI、Scope 契约和 ops 导航，明确区分只读查看与真正启用，适合在有授权的案例里复用。来源：配置说明、ops 入口。
- README 的概览与文件表中规模数字存在不同表述，因此不引用精确模块数；读者仍需以具体文件和当前提交为准。
- 竞品对比 1（Trail of Bits Skills）：以插件和各技能文档提供审计方法；本合集在统一案例 scope 和证据归属方面更集中。来源：Trail of Bits。
- 竞品对比 2（Semgrep）：官方文档围绕引擎、规则与扫描结果展开；本合集面向 Agent 方法路由，不能替代具体工具操作手册。来源：Semgrep 文档。
👥 社区活跃 1.1/1.5
- 公开 API 显示有一定关注与 Fork 规模，最近 pushed_at 位于核验前一个月内，存在当前维护信号。来源：公开 API。
- 未统计维护者响应时效、独立贡献人数或生产案例，社区分不据此给满。
- 竞品对比 1（Trail of Bits Skills）：具有不同的维护组织背景；没有统一口径的数据，不能将本合集 Stars 较多写成支持能力更强。来源：Trail of Bits。
- 竞品对比 2（Semgrep）：具有独立引擎与文档生态；本合集的关注度不等同于该工具的稳定性与支持服务。来源：Semgrep。
🔗 兼容性 1.1/1.5
- 官方提供 Windows 与通用 Linux/macOS 等平台入口，并将核心路由与客户端适配分开。来源：README_AI。
- 外部工具、MCP 服务和宿主权限仍需逐机验证，不能因客户端能读 Markdown 就宣称全流程兼容。
- 竞品对比 1（Trail of Bits Skills）：也要按宿主安装方式加载安全技能；本合集的平台原生脚本不意味着所有分析工具跨平台一致。来源：Trail of Bits。
- 竞品对比 2（Semgrep）：其扫描器自身有明确工具边界；本合集的兼容性还取决于所选分析工具，依赖组合更复杂。来源：Semgrep 文档。
🏷️ 标签说明
- 合集：多个安全分析场景与技能入口构成路由包。来源：README。
- 开源免费：主项目为 MIT；CTF-Sandbox-Orchestrator 子模块为 GPLv3，外部工具仍依各自许可，不能把主项目许可套到整个依赖集合。来源：README 许可说明。
- 安全分析：围绕授权样本分析、范围契约和证据交接组织方法，不授予第三方测试权限。来源：Scope 契约。
- Agent Skills：以技能路由与客户端适配供编码 Agent 调用。来源：配置说明。
局限与未实测声明
未运行 refresh、bootstrap、case-init 或任何目标分析工具；没有渗透、漏洞利用、绕过或样本执行测试。授权闸门、回归案例与平台支持均为官方材料描述，不是本站验证的安全保证。
📋 来源核实
- 已核对：README、README_AI、Scope 契约、MIT 许可、API。
- 比较依据：Trail of Bits Skills、Semgrep 文档。
- 核验日期：2026-10-20；全部运行效果保持未独立实测状态。