Files

T

zhaoxuya520 e49eaa7252 Merge pull request #92 from jhuang-tw/fix/cross-platform-case-contract

fix: make case setup consistent across Windows, Linux, and macOS

Owner integration: preserve routing.json SSoT, keep reports optional by default, and require offline samples to resolve to real local files.

2026-08-19 11:46:55 +08:00

2.7 KiB

Raw Blame History

reverse-skill — 平台无关项目入口

本仓库是一个安全任务技能路由包（逆向工程 / 渗透测试 / 安全分析）。RULES.md 是行为链唯一真相源。

路由

用户任务命中安全/逆向关键词时：

skills/MASTER-ROUTING.md 或平台对应入口 → PRIMARY：
- Windows：powershell -NoProfile -ExecutionPolicy Bypass -File skills/scripts/master-route.ps1 -Hint "<任务>"
- Linux / macOS / Kali：bash skills/scripts/master-route.sh --hint "<任务>"
歧义时读 skills/routing.md 全矩阵（三轴：目标类型 / 用户意图 / 工具链）
路由规则唯一事实源：skills/config/routing.json（改路由只改这里）

授权门禁（硬性）

对任何目标动手前，按平台初始化当前分析项目的 work/<case>/scope.md：
- Windows：powershell -File skills/scripts/case-init.ps1 -Hint "<任务>"
- Linux / macOS / Kali：bash skills/scripts/case-init.sh --hint "<任务>"
本地离线样本可使用 offline-sample preset；auth.status=granted + 明确 sample 才可进入 ACT。
auth.status=granted + 合法 network_profile / offline sample 就绪前禁止 ACT；case-guard --force / -Force 不得绕过这个硬门。
证据链：skills/ops/evidence-finding-path.md；角色：skills/ops/role-map.md

首次运行

skills/tool-index.md 是 gitignored 的生成文件，首次使用前按平台运行：

Windows:           powershell -NoProfile -ExecutionPolicy Bypass -File skills/scripts/refresh-tool-index.ps1
Linux / macOS:     bash skills/scripts/refresh-tool-index.sh
Kali:              bash kali/scripts/refresh-tool-index.sh

缺工具 → 使用同平台 bootstrap：Windows skills/scripts/bootstrap-reverse.ps1；Linux / macOS skills/scripts/bootstrap-reverse.sh；Kali kali/scripts/bootstrap-reverse.sh（清单能力，禁止猜路径）。

测试（改动后必跑）

Windows / PowerShell（路由回归读取 routing-benchmark.json）：
  powershell -NoProfile -ExecutionPolicy Bypass -File skills/scripts/test-routing.ps1
  powershell -NoProfile -ExecutionPolicy Bypass -File skills/scripts/verify-routing-coherence.ps1
  powershell -NoProfile -ExecutionPolicy Bypass -File skills/scripts/smoke.ps1

Linux / macOS routing parity:
  bash skills/scripts/test-routing.sh
  bash skills/scripts/test-bootstrap-manifest.sh

客户端边界

路由核心、测试和工具清单必须与具体 AI 客户端解耦。
Claude Code、Codex、Cursor、OpenCode 等客户端只能通过各自适配层接入，不得成为仓库默认身份或核心配置依赖。
skills/INDEX.md 由 extract-summaries.ps1 从全部 SKILL.md 动态生成，不硬编码客户端或模块数量。

2.7 KiB Raw Blame History Unescape Escape