当 Agent 遇上逆向：拆解 reverse-skill 的技能路由架构

文章目录

引子：能力过剩，经验稀缺
一、它到底是什么：路由器，而非安装器
二、目录即架构：两层结构与读序
三、三维路由矩阵：把"分诊"做到极致
- [3.1 按目标类型分派](#3.1 按目标类型分派)
- [3.2 按用户意图分派](#3.2 按用户意图分派)
- [3.3 按工具链分派](#3.3 按工具链分派)
四、工具索引：一份"活的"共享注册表
- [4.1 为什么不能猜路径](#4.1 为什么不能猜路径)
- [4.2 自举：缺什么就装什么](#4.2 自举：缺什么就装什么)
- [4.3 索引即契约](#4.3 索引即契约)
[五、作战契约层：给自主 Agent 套上缰绳](#五、作战契约层：给自主 Agent 套上缰绳)
[六、经验库：让 Agent 从自己的历史里学习](#六、经验库：让 Agent 从自己的历史里学习)
[七、服从性工程：一场与"AI 惰性"的正面交锋](#七、服从性工程：一场与"AI 惰性"的正面交锋)
- [7.1 借口反驳表](#7.1 借口反驳表)
- [7.2 上下文窗口布局](#7.2 上下文窗口布局)
- [7.3 参数稳定性与"代号"](#7.3 参数稳定性与"代号")
- [7.4 自我审查与循环防护](#7.4 自我审查与循环防护)
[八、与 Agent Skills 的血缘：渐进式披露的一次实践](#八、与 Agent Skills 的血缘：渐进式披露的一次实践)
[九、落地层：MCP 矩阵与多客户端集成](#九、落地层：MCP 矩阵与多客户端集成)
- [9.1 能力接入的两条路](#9.1 能力接入的两条路)
- [9.2 集成到任意客户端只需四样东西](#9.2 集成到任意客户端只需四样东西)
- [9.3 一次完整推演：从一句话到一份报告](#9.3 一次完整推演：从一句话到一份报告)
- [9.4 验证优先的工程习惯](#9.4 验证优先的工程习惯)
十、工程启示：能抄走的和要小心的
[结语：Agent 的下一场竞争，在"经验"层](#结语：Agent 的下一场竞争，在"经验"层)

一个在 GitHub 上短时间冲到一万五千 Star 的项目，凭什么让 Claude Code、Cursor、Codex CLI 这些通用代码 Agent，摇身一变成为能自主完成逆向与渗透任务的"安全专家"？答案不在某个炫酷的工具里，而在一套克制、务实又颇具心机的"技能路由"设计中。

引子：能力过剩，经验稀缺

过去两年，代码 Agent 的进化速度快得让人有些恍惚。它们能读懂几十万行的代码库，能在终端里连续执行命令，能调用文件系统、调试器和各类外部服务。模型本身的"智力"已经不再是瓶颈。

真正的瓶颈是另一样东西------领域经验。

把一个 APK 丢给通用 Agent，让它"分析里面的接口加密逻辑"，你多半会看到这样的场景：它先试着用 unzip 解包，翻到 classes.dex 卡住；接着凭记忆敲出一条 jadx 命令，但路径不对；再换 apktool，参数又记混了；折腾十几个回合，可能还在原地打转。它不是不够聪明，而是缺少一套"遇到这类目标，第一步该做什么、用哪个工具、按什么顺序推进"的程序性知识。

逆向工程、渗透测试、CTF 这类安全任务，恰恰是程序性知识密度最高的领域之一。同样是二进制，ELF 和 .NET 程序集的分析路径天差地别；同样是抓包，浏览器前端签名和固件通信协议需要完全不同的打法。工具散落在不同机器上，方法论藏在老手的肌肉记忆里，而 Agent 每次都在"重新发明轮子"，甚至重复踩同一个坑。

reverse-skill 这个项目，瞄准的正是这道鸿沟。它不提供任何新工具，而是提供一套让 Agent "先想清楚再动手"的调度框架------用作者自己的话说，这是一个安全任务技能路由器（Skills Router）。

本文将深入拆解它的架构设计，重点分析三个我认为最有价值的工程思路：三维路由矩阵、工具自举与共享注册表，以及一套专门用来对抗大模型"偷懒"的提示词工程。文中涉及的安全能力仅在合法授权范围内讨论，本文关注的是其"AI 工程"层面的方法论，而非攻击技术本身。

一、它到底是什么：路由器，而非安装器

先厘清一个最容易被误解的定位。很多人第一眼会把 reverse-skill 当成"一键安装逆向工具全家桶"的脚本集合。这是个误会。

它的自我定位非常明确：这不是单工具安装器，而是面向代码 Agent 的安全任务技能路由器。它要解决的核心动作只有一个------在 Agent 真正调用工具之前，先把任务"分类"到正确的方法论和子技能上去。

用一张流程图能说明它的工作骨架：

复制代码

用户任务
  → 全局规则（判定这是不是安全/逆向类任务）
  → 主路由（快速匹配到某个场景）
  → 作战前置（确认授权范围与网络画像，未就绪不得对目标动手）
  → 场景技能 → 调用工具 / MCP / 脚本
  → 时间线 + 证据链 → 生成报告与经验回写

换句话说，它在 Agent 和工具之间插入了一层"决策中枢"。这一层做三件事：判断任务类型、进入正确工作流、再去调用真实工具执行。它同时兼容 Claude Code、Codex CLI、Cursor、Cline、Windsurf 等多种客户端，因为它依赖的只是这些客户端普遍具备的两项能力------支持自定义规则/系统提示，以及支持 MCP 或等价的外部工具桥接。

这个定位决定了它的价值主张：把散落的本地工具、MCP 服务、脚本入口和工作流，收敛成一份可以在机器之间干净迁移的可复用资产。

二、目录即架构：两层结构与读序

打开项目，你会发现它的组织方式本身就是一种设计表达。整体分成两大块：一块是主技能目录 skills/，另一块是独立的 CTF 编排栈 CTF-Sandbox-Orchestrator/（内含四十多个子技能）。

skills/ 目录里，真正承担"中枢"职责的是几个入口文件：

主控入口：先读全局地图，了解有哪些模块可用；
路由矩阵：按目标类型、用户意图、工具链三个维度分派任务；
工具索引：记录本地有哪些工具、装在哪里、由哪个脚本调用。

围绕这三个入口，是一大批按场景切分的子技能目录：APK 逆向、IDA Pro 深度分析、前端 JS 逆向、radare2 命令行、固件渗透、N-day 补丁比对、pwn 利用链、EDR 绕过研究、恶意样本分析、API 安全、供应链安全、LLM 安全......几乎覆盖了安全研究的主要分支。此外还有几个"横切"模块，比如图表生成、文档报告生成，以及一个会自动进化的经验库。

这套结构最巧妙的地方，是它规定了严格的读序（reading order）。Agent 处理任务时被要求按固定顺序读文件：先读主控入口拿到全局视野，再读路由矩阵定位场景，然后才读对应子目录的技能说明，最后------只有在需要确认本地工具时------才去读工具索引。

为什么读序这么重要？因为它直接对应着上下文预算的分配。如果一上来就把所有子技能的详细说明灌进上下文，一个几千 token 的"技能注册表"会迅速膨胀成几万 token 的负担。读序的本质，是让 Agent 用最小的上下文代价完成"定位"，把昂贵的详细指令留到真正需要时再按需加载。这正是 Anthropic 在 Agent Skills 里提出的"渐进式披露"思想的一次具体落地------关于这一点，后文还会展开。

三、三维路由矩阵：把"分诊"做到极致

路由是整个项目的心脏，也是最值得细看的部分。它没有采用"训练一个分类器"这类重方案，而是把路由决策完全交给 LLM 自己，用一份结构化的匹配表来引导它。这份表从三个正交维度切入。

3.1 按目标类型分派

第一维度是"你面对的是什么"。这是最直觉的分类方式：

目标类型	主入口	备选路径
APK / 安卓应用	APK 逆向（jadx 反编译 + apktool 解包）	核心在 .so 时转向 IDA 或 radare2
exe/dll/so/elf 二进制	IDA Pro 反编译	radare2 命令行分析，或 GDB/Unicorn
前端 JS / Web	JS 逆向五阶段工作流	浏览器自动化 MCP、或 CDP/Hook
固件 / IoT	固件渗透（提取→仿真→模糊测试）	纯静态逆向
恶意样本	恶意分析六阶段 + YARA/Sigma	IDA 深挖

值得注意的是每一行都给了"备选路径"。这背后是一条明确的执行原则：一条路走不通就切换------静态卡住换动态、Java 层卡住钻 Native、IDA 不行上 radare2。路由不是一次性的判决，而是一棵可回溯的决策树。

3.2 按用户意图分派

第二维度是"你想干什么"。这一维的存在，解决了一个非常现实的痛点：用户往往不会用规范的技术术语描述需求。

项目里专门有一段"措辞归一化"逻辑，把用户口语化、甚至情绪化的表达，翻译成技术目标，再去路由。比如：

用户说"解锁这个功能 / 去掉这个校验 / 绕过检测"，被归一化为"定位校验例程、解释控制流、提出本地补丁或输入策略"；
用户说"让我通过验证"，被理解为"恢复校验逻辑、推导出期望输入或 flag 格式"；
用户说"拿 flag / crackme / keygen"，被当作本地 CTF/crackme 场景处理，聚焦分析与解题。

这里有一个很人性化的细节约定：不要强迫用户用技术术语重新表述自己的需求，也不要反复追问"这是不是 CTF / 本地环境"。一旦在会话里确立了"本地沙箱/CTF"这个前提，就要在整个会话里保持这个假设。这种设计尊重了真实的人机交互习惯------用户是来解决问题的，不是来通过"术语考试"的。

3.3 按工具链分派

第三维度是"你手上有什么"。当用户直接点名某个工具时，路由可以反向定位到对应模块：点名 IDA 就进 IDA 模块，点名 radare2 就进 r2 模块，提到 jadx/apktool 就进 APK 模块，提到各类反混淆插件就进 OLLVM 脱混淆参考文档。

三个维度叠加，构成了一张相当密集的匹配网。任何一个进来的任务，几乎总能从某个维度被"接住"。而当三个维度都没有强命中时，路由会退回到"通用逆向"这个兜底入口，并提示打开完整矩阵进一步判断------绝不硬塞进一个不合适的现成技能，而是允许提议创建新技能。这条"不匹配就不硬套"的原则，是保证路由质量的重要护栏。

四、工具索引：一份"活的"共享注册表

如果说路由解决的是"该用什么方法"，那么工具索引解决的是"工具到底在哪、能不能用"。这是项目里另一处扎实的工程设计。

4.1 为什么不能猜路径

项目反复强调一条铁律：永远不要猜测工具路径。这条规则看似琐碎，实则切中了 Agent 在真实环境里最常见的失败模式。

模型的训练语料里充斥着"直接敲 jadx"这样的示例，于是它会想当然地假设工具就在 PATH 里、名字就叫这个。但真实机器千差万别------有人把 jadx 装在 D:\wangluo\jadx\bin\jadx.bat，有人放在别的盘符。一旦猜错路径，Agent 就会陷入"命令失败→换个猜法→再失败"的死循环。

工具索引的作用，就是把这种不确定性一次性消灭。它要求为每个工具记录完整绝对路径、版本号、安装方式和验证命令，让 Agent 在调用前先查表拿到确切位置，而不是靠记忆赌一把。

4.2 自举：缺什么就装什么

更进一步，当索引显示某个工具缺失时，Agent 不应该只是报错停下，而要调用平台对应的自举脚本去自动安装。项目为不同系统准备了不同入口：Windows 走 PowerShell 脚本，Linux/macOS 走 Bash 脚本，Kali 有专属的原生工具链入口。

自举能力还配了一份"能力清单"，明确列出哪些工具支持自动安装（jadx、apktool、frida、radare2、nmap、burpsuite-mcp、pwntools、yara 等等）。这里同样有护栏：不允许 Agent 凭空发明能力名 ，清单外的工具必须走文档里的手动安装步骤。而且，同一个工具自动安装失败两次就必须停止重试，转而输出完整的手动安装指引------这条规则直接掐断了另一种常见的死循环。

4.3 索引即契约

最关键的一点：安装完新工具后，必须运行刷新脚本去更新索引里的路径。这样一来，索引就成了一份在多个 CLI 客户端之间共享的"契约"------所有客户端都从它读取工具状态，所有客户端在装完工具后都往它写入。今天用 Claude Code 装好的 jadx，明天用 Cursor 打开同一个项目时，无需重装即可直接找到。

这个设计把"工具环境"从某个具体客户端里解耦出来，变成了一份可迁移、可共享的持久化状态。它解释了项目为什么反复强调"迁移到新机器后第一件事是刷新索引"------索引里的 yes/no 只代表某台机器某一刻的扫描结果，换了环境就必须重新校准。

五、作战契约层：给自主 Agent 套上缰绳

安全任务和普通编程任务有一个本质区别：它天然带有"可能造成实际影响"的风险。一个能自主执行命令的 Agent，如果不加约束地对目标发起扫描或攻击，后果不堪设想。reverse-skill 用一套"作战契约（ops）"来处理这个问题。

核心是一道授权门闩。在对任何目标采取实质动作之前，Agent 必须先完成"案例初始化"，把授权状态明确标记为"已授权"，并确定网络画像。授权未就绪，就不得对目标动手。这不是一句口号，而是被写进行为链的强制前置步骤。

围绕这道门闩，还有一整套配套约定：

身份边界：明确"我们只是一个路由包，不是某个攻击平台"，避免 Agent 越权自我定位；
证据链：所有结论要沿着"证据→发现→路径"的链条组织，逆向分析必须标注具体地址、偏移和函数名，渗透必须给出可复现的完整 PoC，而不是含糊的"某个函数""大概能打"；
安全边界：所有操作限定在用户授权范围内，不得擅自扩大攻击面；发现高危漏洞要立即告知用户并等待指示；报告和日志里不得保留未脱敏的真实目标信息。

这一层的价值在于，它把"合规"从依赖 Agent 自觉，变成了流程上的硬约束。对于一个越来越自主的系统，这种"先确认边界，再放开手脚"的设计思路，值得所有做 Agent 产品的人借鉴。

六、经验库：让 Agent 从自己的历史里学习

项目有一个我个人非常欣赏的模块------会自动进化的经验库（field-journal）。它试图解决 Agent 的一个根本缺陷：没有跨会话记忆，同样的坑会反复踩。

机制并不复杂，但设计得很到位。它规定了两个方向的动作：

写回（write-back）：当出现下列情况时，Agent 要把经验沉淀成一条日志------任务完成并产出最终结果、发现新的工具链坑点、修复了自举流程的缺陷、遇到路由矩阵没覆盖的新场景、或者任务虽然失败但失败原因有参考价值。每条日志都经过脱敏处理，写进带时间戳的记录里。

复用（reuse） ：在进入任何一条路由之前，Agent 必须先检查经验索引。如果存在相似的历史经验，就去读那条日志、复用已验证的方案；如果历史方案不适用，则要在新日志里说明为什么不适用。

这一读一写，构成了一个闭环。它让整个技能包不再是一份静态文档，而是一个随使用次数增长而不断变强的"活"系统。Anthropic 在讨论 Skills 的未来时提到过一个愿景------"Agent 从经验中书写自己的技能"，field-journal 正是这个愿景在工程上的一次朴素而有效的尝试。

七、服从性工程：一场与"AI 惰性"的正面交锋

如果说前面几节讲的是"架构"，那么这一节讲的是"心理战"。这也是我认为整个项目里最独特、最有启发的部分。

任何用大模型驱动过复杂多步任务的人，都遇到过这样的挫败：你明明给了详细的步骤，模型却擅自"优化"------跳过它认为不必要的环节，凭"判断"省略某个检查，或者干脆在读完规则后来一句"我明白了，请告诉我你的任务"然后就地停摆。

reverse-skill 把对抗这种"惰性"上升成了一门专门的工程，我姑且称之为服从性工程。它的武器库里有好几件精心打磨的工具。

7.1 借口反驳表

这是最直接、也最有意思的一招。项目预判了 Agent 最常用的"偷懒借口"，然后为每一条都写好了强制性的反驳。摘几条感受一下：

Agent 说"我可以跳过这步，直接......"------反驳：**禁止跳过。**行为链的每一步都是必需的；如果你认为可以跳过，请输出具体理由并等待用户确认。
Agent 说"根据我的判断，这步没必要"------反驳：**你的判断在这里不适用。**列出你依据的具体标准，解释它为什么允许跳过一个明确写下的步骤。
Agent 说"我之前用过这个工具，我知道路径"------反驳：**禁止猜路径。**必须从工具索引拿实际路径，不同机器安装位置不同。
Agent 说"任务基本完成了，不用走检查清单"------反驳：**任务完成 = 清单全部勾选。**没勾完就等于没完成。
Agent 说"我明白规则了，请告诉我你的任务"------反驳：**这是最糟糕的失败模式。**正确行为是主动把用户意图匹配到路由表、输出分析、立即开始执行。

这张表的高明之处在于，它不是泛泛地说"请认真执行"，而是精准地"点名"每一种偷懒模式，并当场堵死退路。它本质上是在用提示词，给模型预装一套"反自我合理化"的免疫系统。

7.2 上下文窗口布局

第二件武器基于对大模型注意力分布的观察。项目给出了一个经验模型：LLM 的注意力在长文档里呈"两头高、中间低"的分布------开头约 10% 注意力最高，中间 80% 逐渐衰减，结尾 10% 又回升。

由此推出两条排版规则：**关键的"立即行动"指令要放在文件的开头或结尾 10%，绝不要把重要指令埋在长文档的中段。**于是你会看到，项目里的规则文件普遍把"必须做什么"放在最前面，把"绝不能跳过"的禁令和检查清单压在最后面。

这是一种把"提示词写作"当成"注意力资源分配"来对待的思维。它承认模型不是完美的读者，然后主动顺应这种不完美去排布信息。

7.3 参数稳定性与"代号"

第三件武器针对的是模型另一个隐患------"语义优化"。当某些参数必须原样传递时（比如授权状态、危险动作开关、扫描范围边界），模型有时会自作主张地把 strict/deny 换成它觉得"意思差不多"的近义词，结果把严格模式悄悄改成了宽松模式。

对策是使用不透明的代号（code words） 。先定义一张映射表，用 alpha、beta、gamma 这类没有语义的标识符去代表真正的参数值，只在最终的命令层展开：

复制代码

alpha -> --scope authorized-only
beta  -> --approval required
gamma -> --destructive false

因为代号本身不携带语义，模型也就失去了"优化"它的冲动。这个技巧把安全关键参数从"模型可能改写"变成了"模型只能照搬"，堪称四两拨千斤。

7.4 自我审查与循环防护

最后是一套自我监督机制。每执行若干次工具调用，或者当感觉"卡住"时，Agent 要暂停做一次自检：我是否真的在朝目标推进？能否举出具体证据？我是不是用相同参数调用了同一个工具两次以上（是的话必须换思路）？我能否清楚解释上一条错误信息（不能的话就先理解再动手）？

配套的硬性规则还有：同一方法失败两三次必须换路，单条命令重复三次以上必须停下评估，接近工具调用预算上限时要主动向用户报告、询问是否继续。这些规则合在一起，构成了一道"防打转、防跑偏"的安全网------它承认 Agent 会陷入循环，然后用机械的计数规则强行把它拽出来。

把 7.1 到 7.4 连起来看，你会发现一个耐人寻味的事实：**这个项目相当一部分的工程量，不是花在教 Agent 怎么做逆向，而是花在教 Agent 怎么老实听话、怎么不糊弄、怎么不放弃。**这从一个侧面反映出，当下把大模型投入生产级自主任务时，真正难的往往不是能力，而是可靠性与可控性。

八、与 Agent Skills 的血缘：渐进式披露的一次实践

把视野拉高一层，reverse-skill 其实是一个更大趋势的产物。2025 年 10 月，Anthropic 正式推出了 Agent Skills------一种用文件和文件夹为 Agent 装配专业能力的机制，并在同年 12 月将其作为开放标准发布，以支持跨平台移植。

Agent Skills 的核心创新，是"渐进式披露（Progressive Disclosure）"。它的运作模式大致是这样的：系统提示里只驻留一份轻量的"技能注册表"，每个技能只登记名称、触发描述和文件路径，加起来不过几百 token；LLM 本身就是路由器，它读注册表、匹配用户请求、决定加载哪个技能；完整的详细指令只在真正需要时才通过一次工具调用按需载入。社区的逆向分析显示，这种模式相比"把所有指令塞进一个巨型提示"，能带来极显著的每请求指令 token 削减。

对照来看，reverse-skill 几乎是这套思想在垂直领域的一次教科书式实践：

主控入口 + 路由矩阵，对应"技能注册表"------先用小成本完成定位；
各子目录的详细技能说明，对应"按需加载的完整指令"------用到才读；
强制的读序，对应"渐进式披露"的加载纪律------从粗到细，逐层展开。

它和官方 Skills 的差异，主要在于"深度"和"垂直度"。官方示例多聚焦于文档生成这类通用办公任务，而 reverse-skill 把整套机制塞进了一个高度专业、工具链极其庞杂的安全领域，并额外叠加了授权契约、经验进化、服从性工程这些垂直场景才特别需要的东西。可以说，它是对"Skills 能承载多复杂的领域"这个问题的一次有力回答。

关于 Skills 与 MCP 的关系，也顺带厘清一下常见的混淆：MCP 解决的是"Agent 如何连接外部工具和数据"，是能力的"接口"；Skills 解决的是"Agent 何时、以何种方法论使用这些能力"，是能力的"说明书"。reverse-skill 恰恰同时用到了两者------它用 MCP 桥接 IDA、BurpSuite、浏览器自动化等外部服务，又用 Skills 式的路由决定什么场景该调用哪个 MCP。二者不是替代关系，而是互补的两层。

九、落地层：MCP 矩阵与多客户端集成

前面讲的都是"怎么想"，这一节看看"怎么接"。一套方法论再漂亮，如果 Agent 摸不到真实工具，也只是纸上谈兵。

9.1 能力接入的两条路

项目把外部能力分成两类接入方式。一类是本地命令行 ------jadx、apktool、adb、frida、radare2 这些直接跑在终端里的二进制，通过工具索引拿到绝对路径后由脚本包装调用；另一类是MCP 服务------需要长期驻留、有状态、或者本身就是 GUI 应用的能力。

MCP 那一类尤其值得展开。因为像 IDA Pro、BurpSuite 这类工具天生不适合"一次性命令调用"的模式：打开一个大型样本可能要几分钟，分析过程中的交叉引用、重命名、反编译结果都是带状态的。把它们包成常驻服务，才能让 Agent 像人一样"坐在 IDA 前面持续提问"。

典型的服务矩阵大致长这样：

服务	默认端口	职责	启动方式
IDA Pro 桥	13337 起，多实例递增	反编译、交叉引用、数据流分析	IDA 插件自启动
浏览器分析器	23816	浏览器自动化 + HTTP 抓包	项目目录下 `pnpm dev`
JS Hook 服务	stdio	JS 运行时 / CDP / Hook / AST	`npx` 拉起
Ghidra 桥	8765	开源反编译替代方案	GUI 启动后自动监听
BurpSuite 桥	9876	代理历史 / Repeater / Intruder 等全控	Burp 扩展自动加载

这张表的存在本身就有工程意义：它把"哪个能力在哪个端口"变成了可查的事实。配套的错误处理也很务实------当 MCP 调用报错时，Agent 应先探测服务是否在线，而不是盲目重试；如果端口不匹配，就主动询问用户实际端口并帮忙更新配置。这两条看似普通，却避免了大量"服务没开却反复重试"的无效轮询。

9.2 集成到任意客户端只需四样东西

项目把客户端集成抽象得相当干净。无论你用 Claude Code、Codex CLI、Cursor、Cline 还是 Windsurf，真正需要接的只有四样：

这个包所在的目录；
MCP 或等价的外部工具端点；
一种稳定的提示注入方式（规则文件、项目指令、或 hooks）；
"先路由、后执行"这个原则本身。

其中第三点有个值得学习的细节：写进全局配置的内容，并不是整份规则文件，而是一份精简版 ------只保留触发关键词和触发后的四步执行链。而且精简版里刻意不包含"去读完整规则文件"这条指令。原因很实际：如果包含了，每次会话都会重新触发一遍"首次安装配置"流程，白白烧掉大量上下文。

这个取舍展现了成熟的工程直觉：**常驻上下文里只放"触发器"，详细内容交给按需加载。**它和前文的读序设计是同一套逻辑在不同层面的重复。

9.3 一次完整推演：从一句话到一份报告

把前面所有机制串起来，我们模拟一个完整场景。假设用户在授权的测试环境里丢过来一句话："帮我看看这个 APK 的登录接口签名是怎么算的。"

**第一步，触发与识别。**全局规则里的关键词列表命中了 "APK" 和"签名"，Agent 确认这是安全/逆向类任务，进入路由流程而不是直接上手敲命令。

**第二步，查经验库。**在进入任何路由前，先翻经验索引：以前是否处理过同类型的签名算法？是否记录过某个加壳方案的应对办法？命中就直接复用，省下大量探索成本。

**第三步，主路由分诊。**目标类型维度命中 APK，主入口锁定 APK 逆向模块。用户意图维度又命中了"找前端签名/加密参数"，提示可能需要与 JS 逆向或 Native 分析交叉。路由结果被显式输出给用户，而不是默默进行。

**第四步，授权门闩。**初始化案例目录，写清楚授权状态与目标范围。就本例而言，目标是本地样本的静态分析，不涉及对真实服务器的主动行为，但流程上依然要把边界记录在案。

第五步，查工具。读工具索引，确认 jadx 和 apktool 的绝对路径。假设 jadx 存在而 apktool 缺失，就调用对应平台的自举脚本安装，装完后立即刷新索引------这一步不能省，否则下次换个客户端又要重装。

**第六步，执行与切换。**进入 APK 工作流：解包→看清单→jadx 反编译→定位签名相关调用。如果发现核心算法已下沉到 .so，则按备选路径切换到 IDA 或 radare2 模块继续钻。若 Java 层与 Native 层都看不清，再切到动态 Hook 路线。每次切换都有处可依，而不是拍脑袋。

**第七步，自我审查。**过程中每隔若干次工具调用停一下：真的在推进吗？有没有重复敲同一条命令？上一个报错看懂了吗？一旦命中循环信号，强制换路。

**第八步，收尾清单。**找到答案不等于任务结束。按完成清单，要产出正式报告（带地址、偏移、函数名和可复现步骤），至少一张流程图，一条脱敏后的经验回写，以及必要时对索引和路由表的更新。

把这八步连起来看，你会发现它跟一个熟练安全工程师的实际工作流高度同构------先分类、再回忆经验、确认边界、清点装备、动手、随时复盘、最后写报告。项目做的事情，本质上就是把这套隐性的职业习惯，显式地翻译成了 Agent 能执行的流程。

9.4 验证优先的工程习惯

还有一个容易被忽略但很能说明项目成熟度的细节：它给出了一份明确的验证清单，建议在迁移到新机器后逐条跑一遍：检查 Java、Python、Node 的版本，验证 jadx、apktool、adb 能否正常响应，确认 Frida 能枚举到设备，再启动 IDA 链路并刷新工具索引。

这份清单的意义不在于它列了多少条命令，而在于它传递的一种态度：**不要相信别人机器上的扫描结果，也不要相信自己上周的扫描结果。**对一个依赖真实环境的 Agent 系统而言，"环境假设过期"是最隐蔽也最常见的故障根因。

十、工程启示：能抄走的和要小心的

拆到这里，不妨跳出项目本身，谈谈它对更广泛的 Agent 工程有哪些可迁移的启示，以及有哪些需要警惕的地方。

值得借鉴的地方：

第一，路由优先于执行。当一个 Agent 要面对高度分化的任务空间时，与其让它每次"临场发挥"，不如先建一层显式的路由，把"选方法"和"做执行"拆开。这能显著降低试错成本。

第二，把环境状态外化成共享注册表。工具索引的思路------把"什么工具装在哪"从模型记忆里挪到一份可读可写、跨客户端共享的文件里------可以推广到任何需要 Agent 与真实环境交互的场景。别让模型猜环境，让它查环境。

第三，为自主性配一道流程门闩。授权契约的设计说明，越是放权给 Agent，越要在关键节点设置不可绕过的确认关卡。可靠的自主，建立在明确的边界之上。

第四，把可靠性当成一等公民。服从性工程告诉我们，生产级 Agent 的提示词里，"防止模型偷懒/跑偏/糊弄"的篇幅，可能需要和"教模型做事"相当。这是把 demo 变成产品必须付出的成本。

需要保持清醒的地方：

其一，这套设计高度依赖模型对冗长指令的服从度。借口反驳表、上下文布局这些技巧，本质上是在"哄"和"逼"一个概率模型，它们能提升服从概率，但无法给出确定性保证。不同模型、不同版本，效果可能大相径庭。

其二，安全领域的双刃剑属性无法回避。一套能高效路由渗透与利用能力的框架，其威力完全取决于使用者是否守住授权边界。项目内置的授权门闩是必要的，但终究是"提示词层面"的约束，而非技术强制------这也是所有此类工具共同的伦理与合规软肋。任何使用都应严格限定在获得明确授权的自有系统、靶场或合法众测范围内。

其三，庞大的技能矩阵带来维护成本。几十个场景、上百个工具、大量相对路径的相互引用，一旦某个工具上游变更或某条路径失效，整个链条都可能受影响。"活"的系统需要"活"的维护。

结语：Agent 的下一场竞争，在"经验"层

reverse-skill 之所以值得拆解，不在于它整合了多少安全工具，而在于它相当完整地示范了"如何把一个通用 Agent，改造成某个垂直领域的可靠专家"。

它的答案由几块拼图组成：用三维路由做精准分诊，用共享索引和自举驯服工具环境，用作战契约守住授权边界，用经验库实现跨会话进化，再用一整套服从性工程把这一切钉死在可靠的执行上。这些拼图单看都不算高深，但拼在一起，就构成了一套务实、克制、直面真实工程痛点的完整方法论。

当模型能力逐渐拉平，Agent 之间的竞争会越来越多地转移到"经验"这一层------谁能更高效地把领域知识、工具环境和历史教训，组织成 Agent 随时可调用的结构化资产，谁就能在真实世界的任务里胜出。从这个意义上说，reverse-skill 提供的不只是一个安全工具包，更是一份关于"如何为 Agent 装配专业经验"的参考样本。

它提醒我们：让 AI 变强的下一步，或许不是更大的模型，而是更好的"说明书"。