Skip to content

Reverse Engineering / Authorized Penetration Testing / Security Research Skill Router Pack AI-powered routing + On-demand toolchain bootstrapping + Self-evolving knowledge base Supports Claude Code, Kiro, Cursor, Cline, and other AI coding clients 逆向/渗透/安全技能路由包 - AI 自动路由 + 按需自举工具链 + 自动进化经验库 | 支持 Claude Code / Kiro / Cursor / Cline 等代码 AI 客户端

Shell

Merge pull request #94 from HarryPD168/fix/coherence-clamp

zhaoxuya520f0903fb2a85a
diff --cc RULES_zh.md
index 3c6f23c,e736d17..d1a9831
--- a/RULES_zh.md
+++ b/RULES_zh.md
@@@ -134,11 -127,11 +127,12 @@@
> **检测方法**:找到本文件(`RULES.md`)所在目录即为包根目录。不要假设固定盘符。
--按顺序读取:
++按热路径执行:
--1. `skills/SKILL.md` — 总控入口,了解所有模块
--2. `skills/routing.md` — 路由矩阵,三维度匹配(目标类型/用户意图/工具链)
--3. `skills/tool-index.md` — 本机工具状态
++1. `skills/scripts/master-route.ps1 -Hint "<任务>"` — 从 `skills/config/routing.json` 选出 PRIMARY
++2. `skills/<PRIMARY>/SKILL.md` — 进入目标模块并执行 ACTION REQUIRED
++3. `skills/tool-index.md` — 需要本机工具时查询真实状态与路径
++4. `skills/routing.md` — 仅在 PRIMARY 歧义时读取的三轴附录,不是第二套路由器
---
@@@ -236,7 -229,7 +230,7 @@@
- 将搜索到的有价值内容写入对应 skill 的 references/
- 标注来源 URL 和日期
- 如果发现了新工具 → 更新 bootstrap-manifest
-- - 如果发现了新场景 → 更新 routing.md + RULES.md 关键词
++ - 如果发现了新场景 → 先更新 routing-benchmark.json,再更新 routing.json;按需同步 MASTER-ROUTING.md 和 routing.md 附录
□ 5. 询问社区贡献
- "是否将本次经验贡献到社区主仓库?数据已脱敏,只提交 field-journal 文件。"
@@@ -245,7 -238,7 +239,7 @@@
□ 6. 更新系统索引
- 更新 field-journal/_index.md(新增条目)
-- - 检查是否需要更新:routing.md / bootstrap-manifest / tool-index
++ - 检查是否需要更新:routing.json / routing-benchmark / MASTER-ROUTING.md / routing.md 附录 / bootstrap-manifest / tool-index
- 如果发现新工具或新场景 → 执行对应更新
```
@@@ -371,7 -364,7 +365,7 @@@ gamma -> --destructive fals
`MUST`:关键动作不要埋在中段;`MUST` 放在开头或结尾高注意区域。
## 禁止行为
--- ❌ 不要在没有读 routing.md 的情况下直接开始逆向/渗透操作
++- ❌ 不要在没有运行 master-route.ps1、确定 PRIMARY 的情况下直接开始逆向/渗透操作
- ❌ 不要猜测工具路径(如 `C:\Tools\ida\ida64.exe`),必须从 tool-index 获取
- ❌ 不要跳过 field-journal 查询直接开始任务
- ❌ 不要在任务完成后跳过 Checklist
@@@ -380,7 -373,7 +374,7 @@@
- ❌ 不要反复重试已失败 2 次的自动安装
- ❌ 不要沉默 — 遇到问题必须立即告知用户
- ❌ 不要自己编造工具版本号或功能描述
--- ❌ 不要读完 RULES.md 后只回复"已理解,请告诉我具体任务" — 正确做法是执行全局注入 → 读 SKILL.md → 读 routing.md → 确定入口 → 开始干活
++- ❌ 不要读完 RULES.md 后只回复"已理解,请告诉我具体任务" — 正确做法是运行 master-route.ps1 → 打开 PRIMARY SKILL.md → 开始执行;仅在歧义时查 routing.md
- ❌ 不要说"步骤 1-4 已经完成"但实际只是读了一遍 — 区分"已读文档"和"已执行操作",后者产生实际副作用
- ❌ 不要在每一步都等用户确认 — 确定性的步骤直接执行同时告知用户,只在真正需要用户决策的节点暂停
@@@ -414,7 -407,7 +408,7 @@@
- 特定工具用法 → 对应 skill 的 references/ 或 SKILL.md
- 踩坑经验 → field-journal/
- 新工具发现 → bootstrap-manifest.json + ToolDiscovery.ps1
-- - 新场景发现 → routing.md + RULES.md 关键词
++ - 新场景发现 → routing-benchmark.json + routing.json;同步 MASTER-ROUTING.md,必要时补 routing.md 附录
5. 标注来源(URL + 日期),便于后续验证时效性
6. 如果信息量足够大(新领域),提议新增独立 skill
```
@@@ -435,12 -428,12 +429,13 @@@
### 自动注册进路由
--当搜索发现了一个全新的技术领域(现有 routing.md 完全没覆盖),AI 应该:
++当搜索发现了一个全新的技术领域(现有 `routing.json` 完全没覆盖),AI 应该:
--1. 在 routing.md 的"按用户意图"表中添加对应行
--2. 在 RULES.md 的触发关键词中添加相关词
--3. 如果内容足够独立,按 CONTRIBUTING.md 流程新增 skill 目录
--4. 更新 skills/SKILL.md 的模块表
++1. 先在 `routing-benchmark.json` 添加失败用例
++2. 在 `routing.json` 添加关键词或新 PRIMARY,并同步 `MASTER-ROUTING.md` 优先级表
++3. 按需在 `routing.md` 三轴附录中补充说明;不得把它当作事实源
++4. 如果内容足够独立,按 CONTRIBUTING.md 流程新增 skill 目录
++5. 更新 skills/SKILL.md 的模块表
### 搜索质量要求
@@@ -495,11 -488,11 +490,11 @@@ bash <本包根目录>/kali/scripts/ref
## 新增 Skill
--当发现路由矩阵无法覆盖当前任务类型时,按 `CONTRIBUTING.md` 流程新增 skill。
++当发现 `routing.json` 无法覆盖当前任务类型时,按 `CONTRIBUTING.md` 流程新增 skill。
路径:`<本包根目录>/skills/CONTRIBUTING.md`
--新增后必须同步更新:routing.md、bootstrap-manifest.json、ToolDiscovery.ps1、refresh-tool-index.ps1。
++新增后必须同步更新:routing-benchmark.json、routing.json、MASTER-ROUTING.md、skills/SKILL.md;涉及工具时再更新 bootstrap-manifest.json、ToolDiscovery.ps1 和 refresh-tool-index.ps1。`routing.md` 仅作为歧义附录按需同步。
---
diff --cc skills/CONTRIBUTING.md
index bbe7cd8,ef1d8ea..98b2ffa
--- a/skills/CONTRIBUTING.md
+++ b/skills/CONTRIBUTING.md
@@@ -322,7 -324,7 +324,8 @@@ bash "<项目根目录>/kali/scripts/re
**通用(必须)**:
- [ ] `<new-skill>/SKILL.md` 存在且包含所有必需章节
--- [ ] 路由矩阵(`routing.md`)已更新,能正确路由到新 skill
++- [ ] `routing-benchmark.json` 已先添加用例,`routing.json` 已更新且能正确路由到新 skill
++- [ ] `MASTER-ROUTING.md` 优先级表已同步;`routing.md` 歧义附录已按需更新
- [ ] 根 `SKILL.md` 的模块表已更新
- [ ] `.kiro/steering/reverse-routing.md` 触发关键词已更新(如果使用 Kiro)
- [ ] `RULES.md` 触发关键词已更新
diff --cc skills/ida-reverse/SKILL.md
index 8a36921,1aebc76..fbc00e9
--- a/skills/ida-reverse/SKILL.md
+++ b/skills/ida-reverse/SKILL.md
@@@ -226,14 -244,26 +244,29 @@@ ERR:open_timeout_600
```
powershell -File "scripts/start.ps1"
```
- 输出 `OK:72` 表示就绪。
+ 输出 `OK:<工具数>`(当前约 65)表示就绪。
+
+ **路径 B — GUI + 插件(idalib license 失败或需要交互分析时)**
+ ```
+ powershell -File "scripts/start-gui.ps1" -Path "C:\目标.exe"
+ ```
-或双击便携版 `Launch-IDA-Pro.cmd`,在 IDA 中打开样本。
-确认 Output 窗口出现 `[MCP] ... port=13337` 后,MCP 工具即可用。
++或双击便携版 `Launch-IDA-Pro.cmd`,在 IDA 中打开样本。
++
++确认 Output 窗口出现 `[MCP] ... port=13337` 后,MCP 工具即可用。
++
+ 通用对接步骤见 `LOCAL-SETUP.md`。
### Step 2: 打开文件
+
+ Headless:
```
powershell -File "scripts/open.ps1" -Path "C:\目标.exe" -TimeoutSeconds 600
```
-输出 `OK:文件名:session_id` 表示成功(后带 `(temp copy)` 表示自动降级到临时副本)。
+输出 `OK:文件名:session_id` 表示成功(后带 `(temp copy)` 表示自动降级到临时副本)。
- 若分析时间较长,会周期性输出 `INFO:opening:...`;若达到超时则输出 `ERR:open_timeout_xxs`。
++
+ 若出现 `ERR:idalib_license:...`,改用路径 B(GUI 模式),不要反复重试 open.ps1。
+
+ GUI 模式:在 IDA 里直接 Open 样本即可,无需 open.ps1。
### Step 3: 全局概览(含导入表硬门)
```