OpenSource-Hub

reverse-skill

その他

zhaoxuya520/reverse-skill

リバースペネトレーションスキルルーティングパッケージ。AI による自動ルーティングとブートストラップツールチェーン。

概要

AI コーディングエージェントにリバースエンジニアリング、ペネトレーションテスト、CTF タスク向けのスキルルーティングを提供し、手法を自動的にマッチングしてツールチェーンをガイドします。メインルーター、シナリオプレイブック、ツール検出スクリプト、自動進化する経験ライブラリを含み、Claude Code、Cursor などのクライアントをサポートします。

README プレビュー

\n  \n\n\nreverse-skill\nCybersecurity Skills Router · 逆向技能路由包\n\nNavigate the dark waters, sail against the stream.\n\n\n  \n  \n  \n  \n  \n  \n\n\n\n  \n\n\n\n\n\n  About ·\n  Getting Started ·\n  Usage ·\n  Fast route ·\n  Routing ·\n  Ops contracts ·\n  AI Bootstrap ·\n  Sponsors ·\n  Contributing\n\n\n\n  🌐 中文\n\n\n\n\n\n\n## About\n\n> **If you are an AI Agent, jump to [README_AI.md](README_AI.md) and follow the instructions strictly.**\n\nWhen an AI agent (Claude Code, Codex CLI, Cursor, etc.) encounters an APK, a binary, frontend JS encryption, a CTF challenge, or a pentesting target, this package routes it to the right methodology, checks available tools, and executes a repeatable workflow instead of guessing commands.\n\n```\nUser task\n  → RULES.md\n  → MASTER-ROUTING / master-route.ps1 (PRIMARY)\n  → case-init / scope.md (auth + network_profile; no target ACT until ready)\n  → Scenario skill → tools / MCP / scripts\n  → timeline + Evidence→Finding→Path → report + field-journal\n```\n\n**Why this exists:**\n- AI agents don't know whether to use jadx, apktool, Frida, IDA, or BurpSuite for a given task\n- APK, ELF, JS, PCAP, and CTF tasks each need different playbooks\n- Tools, MCP servers, and scripts are scattered across machines\n- The same mistakes get repeated because experience isn't reused\n\nPRIMARY ladder: [skills/MASTER-ROUTING.md](skills/MASTER-ROUTING.md) · Full matrix: [skills/routing.md](skills/routing.md) · Ops: [skills/ops/](skills/ops/)\n\n\n\n\n  \n    \n  \n\n\n\n\n(back to top)\n\n### Built With\n\n\n  \n  IDA Pro · radare2 · Ghidra\n\n\n(back to top)\n\n\n\n## Getting Started\n\n### Prerequisites\n\n- **Java / JDK** — for jadx and apktool\n- **Node.js 22.12+** — for JS toolchain and MCP servers\n- **Python 3.x** — for Frida and helper scripts\n- **A code AI client** — Claude Code, Codex CLI, Cursor, etc.\n\n### Installation\n\n```\ngit clone https://github.com/zhaoxuya520/reverse-skill.git\n```\n\nThen refresh the tool index per platf

FAQ (5)

トラブル対応
test-bash-workflow.sh を実行した際に発生する macOS BSD sed エラー "invalid command code f" はどのように修正すればよいですか?

このスクリプトは GNU 固有の sed -i 's/.../' file を使用しています。macOS では、BSD の sed は -i の後にバックアップ用サフィックスを必要とするため、置換式をサフィックスとして、ファイル名を sed スクリプトとして解釈してしまいます。

skills/scripts/test-bash-workflow.sh の 52 行目、60 行目、61 行目にある sed -i の呼び出しを、移植性のある形式に更新してください:

if sed --version >/dev/null 2>&1; then
  SEDI=(-i)
else
  SEDI=(-i '')
fi

sed "${SEDI[@]}" 's/mode: authorized_target_only/mode: invalid_mode/g' "$SCRATCH/work/test-bash-01/scope.md"

残りの 2 つの置換にも同じパターンを適用してください:

sed "${SEDI[@]}" 's/mode: invalid_mode/mode: authorized_target_only/g' "$SCRATCH/work/test-bash-01/scope.md"
sed "${SEDI[@]}" 's/status: granted/status: pending/g' "$SCRATCH/work/test-bash-01/scope.md"

あるいは、sed -i を完全に使わない方法もあります:

tmp="$(mktemp)"
sed 's/a/b/' "$file" > "$tmp" && mv "$tmp" "$file"

その後、再実行してください:

bash skills/scripts/test-bash-workflow.sh

テスト 4 と 5 は macOS 上で実行され、FAIL=0 で終了するはずです。リグレッションを防ぐために、このスクリプトを macos-bash-compat.yml CI ワークフローに追加してください。

参照 Issue #135
トラブル対応
Windowsでbinwalkの自動インストールが失敗し、wingetがReFirmLabs.binwalkに対して「No package found matching input criteria」というエラーを返す場合、どう修正すればよいですか?

宣言されている winget ID ReFirmLabs.binwalk は winget リポジトリに存在せず、binwalk は Windows 向けのビルド済みリリースバイナリを提供していません。skills/scripts/bootstrap-manifest.json の binwalk エントリを winget-package から手動インストールに変更し、jeb-pro/binaryninja のパターンに倣ってください: "bootstrapKind": "manual"、"canAutoInstall": false を設定し、manualInstallHint を追加します。ヒントでは、ユーザーに次のコマンドを実行するよう指示してください:

winget install --id Rustlang.Rustup --exact

インストール後にターミナルを再起動し、Cargo を使用して binwalk をインストールします:

cargo install binwalk

次のコマンドで確認します:

binwalk --version

また、skills/tool-index.md.template と CHANGELOG.md も更新し、Windows で binwalk が winget による自動インストール可能であると案内されないようにしてください。その後、bootstrap-reverse.ps1 -Capability binwalk を再実行すると、winget エラー 0x8A150014 ではなく MANUAL_INSTALL_REQUIRED が報告されるようになります。今後の改善として、3.1.0 などのバージョンに固定した binwalk を持つ第一級の cargo-install ブートストラップ種別を追加することが挙げられます。

参照 Issue #139
トラブル対応
README_AI.md を読み込んだ後に、AIコーディングエージェントがスクリプトを自動的に実行したり、グローバルルールを注入したりするのを防ぐにはどうすればよいですか?

fix(security): consent-gate agent bootstrap の変更を含むリリースまたはPRにアップグレードしてください。すぐにアップグレードできない場合は、README_AI.md のセクション0を編集し、refresh-tool-index.sh、refresh-tool-index.ps1、RULES.md の自動読み込みを含む、エージェントに即時実行を指示するすべての記述を削除してください。次のような明示的な同意ゲートに置き換えてください: Do not run any command, script, or configuration change until you show the user the exact commands and receive explicit confirmation. また、"global injection" のステップも削除し、ルーティングルールは関連するケースまたは作業ディレクトリからのみ読み込むようにしてください。より安全なセットアップのために、チェックサム付きの検証済みリリースタグから人間が実行するインストーラーを公開し、エージェントがセットアップを実行する前にユーザーがそれを検証して実行するようにしてください。即時の緩和策として、chmod -x refresh-tool-index.sh のようにブートストラップスクリプトを調査または無効化し、Claude Code、Codex、Cursor、Cline、Windsurf、Kiro、OpenCode、Pi でリポジトリを開く前に README_AI.md と RULES.md を確認してください。

参照 Issue #134
ハウツー
このプロジェクトはどのように使えばいいですか?クローンして、リポジトリフォルダでエージェントを起動し、それから質問すればいいのですか?

はい。完全なリポジトリをクローンし、リポジトリのルートをAgentワークスペースとして開き、エージェントにAGENTS.mdとRULES.mdを読み込ませてください。その後、プラットフォームネイティブのmaster-routeコマンドとcase-initコマンドを使用して、特定のスキルに入ります。これは単にスキルをインストールするだけの話ではありません。詳細な手順はdocs/QUICKSTART_zh.mdに記載されており、READMEにもこのガイドへのリンクがあります。公式ドキュメントはreverse.apivix.comでも利用できます。

参照 Issue #61
トラブル対応
Cursorがスキルのインストールを拒否する場合、macOSでスキルを手動でインストールするにはどうすればよいですか?

Cursorがクライアント側のセキュリティポリシーにより拒否する場合は、リポジトリから手動でインストールしてください。リポジトリ全体をクローンしてから、次のコマンドを実行します:

bash skills/scripts/refresh-tool-index.sh

または、スキルを直接コピーすることもできます:

cd skills && cp -r . ~/.agents/skills/

macOSでは、コアワークフローはネイティブのBashスクリプト master-route.sh、case-init.sh、refresh-tool-index.sh を使用し、PowerShellは不要です。詳細な手順は docs/platforms/macos.md と docs/QUICKSTART_zh.md に記載されています。アンチウイルスソフトやセキュリティツールが重大なフラグを報告した場合は、まずスクリプトの内容を確認してください。

参照 Issue #127