zhaoxuya520/reverse-skill
Пакет-маршрутизатор навыков на базе ИИ для реверс-инжиниринга, тестирования на проникновение и исследований в области безопасности. Направляет ИИ-агентов к нужным методологиям и разворачивает по требованию цепочки инструментов для задач с APK, бинарными файлами, JS, прошивками и CTF.
<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/8814/abab1a33f37d5940076470ea863d219a7b57df6e3b0f42f087ed1581b499c345.png" alt="reverse-skill" width="140" />
</p>
<h1 align="center">reverse-skill</h1>
<h3 align="center">Маршрутизатор навыков кибербезопасности · Пакет маршрутизации навыков реверс-инжиниринга</h3>
<p align="center"><em style="font-family: Georgia, serif; font-size: 1.2em; color: #777;">Плыви по тёмным водам, иди против течения.</em></p>
<p align="center">
<a href="https://github.com/zhaoxuya520/reverse-skill/releases"><img src="https://img.shields.io/badge/release-v1.0.1-blue" alt="release v1.0.1"></a>
<a href="https://github.com/zhaoxuya520/reverse-skill/stargazers"><img src="https://img.shields.io/github/stars/zhaoxuya520/reverse-skill?style=flat&logo=github" alt="stars"></a>
<a href="https://github.com/zhaoxuya520/reverse-skill/forks"><img src="https://img.shields.io/github/forks/zhaoxuya520/reverse-skill?style=flat&logo=github" alt="forks"></a>
<a href="https://github.com/zhaoxuya520/reverse-skill/issues"><img src="https://img.shields.io/github/issues/zhaoxuya520/reverse-skill?style=flat&logo=github" alt="issues"></a>
<a href="https://github.com/zhaoxuya520/reverse-skill/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="license"></a>
<a href="https://github.com/zhaoxuya520/reverse-skill/blob/main/CHANGELOG.md"><img src="https://img.shields.io/badge/changelog-Keep%20a%20Changelog-orange" alt="changelog"></a>
</p>
<p align="center">
<a href="https://trendshift.io/repositories/43969?utm_source=repository-badge&utm_medium=badge&utm_campaign=badge-repository-43969" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/repositories/43969" alt="zhaoxuya520%2Freverse-skill | Trendshift" width="250" height="55"/></a>
<a href="https://trendshift.io/repositories/43969?utm_source=trendshift-badge&utm_medium=badge&utm_campaign=badge-trendshift-43969" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/trendshift/repositories/43969/daily" alt="zhaoxuya520%2Freverse-skill | Trendshift" width="250" height="55"/></a>
</p>
<br/>
<p align="center">
<a href="#about">О проекте</a> ·
<a href="#getting-started">Начало работы</a> ·
<a href="#usage">Использование</a> ·
<a href="https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/MASTER-ROUTING.md">Быстрый маршрут</a> ·
<a href="https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/routing.md">Маршрутизация</a> ·
<a href="https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/ops">Операционные контракты</a> ·
<a href="https://github.com/zhaoxuya520/reverse-skill/blob/main/README_AI.md">AI-бутстрап</a> ·
<a href="#sponsors">Спонсоры</a> ·
<a href="#contributing">Участие</a>
</p>
<p align="center">
🌐 <a href="https://github.com/zhaoxuya520/reverse-skill/blob/main/README_zh.md">中文</a>
</p>
<br/>
<a id="about"></a>
## О проекте
> **Если вы ИИ-агент, перейдите к [README_AI.md](https://github.com/zhaoxuya520/reverse-skill/blob/main/README_AI.md) и строго следуйте инструкциям.**
Когда ИИ-агент (Claude Code, Codex, Cursor, OpenCode или другой совместимый клиент) сталкивается с APK, бинарным файлом, шифрованием фронтенд-JS, задачей CTF или целью пентеста, этот пакет направляет его к нужной методологии, проверяет доступные инструменты и выполняет воспроизводимый рабочий процесс вместо угадывания команд.
```
User task
→ RULES.md
→ MASTER-ROUTING / master-route.ps1 (PRIMARY)
→ case-init / scope.md (auth + network_profile; no target ACT until ready)
→ Scenario skill → tools / MCP / scripts
→ timeline + Evidence→Finding→Path → report + field-journal
```
**Зачем это нужно:**
- ИИ-агенты не знают, использовать ли jadx, apktool, Frida, IDA или BurpSuite для конкретной задачи
- Задачи с APK, ELF, JS, PCAP и CTF требуют разных плейбуков
- Инструменты, MCP-серверы и скрипты разбросаны по разным машинам
- Одни и те же ошибки повторяются, потому что опыт не переиспользуется
### Текущий статус
| Правила маршрутизации | Регрессионный бенчмарк | Базовые модули навыков | CI-платформы | Модель клиента |
|---:|---:|---:|---|---|
| 41 (R0–R40) | 163 кейса | 42 отслеживаемых модуля | Windows + Ubuntu | Нейтральная к клиенту |
Ядро маршрутизации управляется одной структурированной конфигурацией, проверяется кроссплатформенным CI и хранится отдельно от опциональных адаптеров клиентов.
Основной маршрут (PRIMARY): [skills/MASTER-ROUTING.md](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/MASTER-ROUTING.md) · Полная матрица: [skills/routing.md](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/routing.md) · Операции: [skills/ops/](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/ops)
<br/>
<div align="center">
<a href="https://afterglow.watch"><img src="https://afterglow.watch/badge/zhaoxuya520/reverse-skill" alt="star velocity"></a>
</div>
<br/>
<p align="right">(<a href="#about">наверх</a>)</p>
### Создано с помощью
<p align="left">
<img src="https://skillicons.dev/icons?i=py,nodejs,powershell,bash,java,docker,git&theme=light" /><br/>
<code>IDA Pro</code> · <code>radare2</code> · <code>Ghidra</code>
</p>
<p align="right">(<a href="#about">наверх</a>)</p>
<a id="getting-started"></a>
## Начало работы
### Предварительные требования
- **Java / JDK** — для jadx и apktool
- **Node.js 22.12+** — для JS-тулчейна и MCP-серверов
- **Python 3.x** — для Frida и вспомогательных скриптов
- **ИИ-клиент для кода** — Claude Code, Codex, Cursor, OpenCode или другой совместимый клиент
### Установка
```
git clone https://github.com/zhaoxuya520/reverse-skill.git
```
Затем обновите индекс инструментов для своей платформы:
| Платформа | Команда |
|----------|---------|
| Windows | `powershell -File skills/scripts/refresh-tool-index.ps1` |
| Linux / macOS | `bash skills/scripts/refresh-tool-index.sh` |
| Kali Linux | `bash kali/scripts/refresh-tool-index.sh` |
Проверьте [skills/tool-index.md](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/tool-index.md), чтобы увидеть обнаруженные инструменты.
Документация для конкретных платформ:
- **Kali Linux** → [kali/README-kali.md](https://github.com/zhaoxuya520/reverse-skill/blob/main/kali/README-kali.md)
- **Ubuntu/Debian** → [docs/platforms/linux.md](https://github.com/zhaoxuya520/reverse-skill/blob/main/docs/platforms/linux.md)
- **macOS** → [docs/platforms/macos.md](https://github.com/zhaoxuya520/reverse-skill/blob/main/docs/platforms/macos.md)
<p align="right">(<a href="#getting-started">наверх</a>)</p>
<a id="usage"></a>
## Использование
### Поддерживаемые сценарии
| Сценарий | Точка входа |
|----------|-------|
| APK / анализ Android | `skills/apk-reverse/` |
| iOS / мобильные устройства | `skills/mobile-reverse/` |
| Реверс бинарных файлов (exe/dll/so/elf) | `skills/ida-reverse/` / `skills/radare2/` |
| .NET / C# | `skills/dotnet-reverse/` |
| Фронтенд-JS / шифрованные параметры | `skills/js-reverse/` |
| DSL VM / кастомная JS-VM с опкодами | `skills/reverse-engineering/dsl-vm-reverse/` |
| Перехват HTTP / повтор запросов | anything-analyzer, Reqable MCP + `js-reverse/` |
| Вредоносное ПО / YARA | `skills/malware-analysis/` |
| Тестирование на проникновение / сканирование | `skills/pentest-tools/` |
| Цепочка атак / оркестрация red-team | `skills/attack-chain/` |
| Разбор доказательств кейса / передача отчётов | `skills/case-review/` |
| Соревнования CTF | `CTF-Sandbox-Orchestrator/` (42 поднавыка) |
| Прошивки / IoT | `skills/firmware-pentest/` |
| Патч-дифф / N-day | `skills/patch-diff-exploit/` |
| Pwn / разработка эксплойтов | `skills/pwn-chain/` |
| Обход EDR | `skills/edr-bypass-re/` |
| API / GraphQL | `skills/api-security/` |
| Цепочка поставок / SBOM | `skills/supply-chain-security/` |
| Безопасность LLM / ИИ | `skills/llm-security/` |
| Деобфускация OLLVM | `skills/reverse-engineering/references/ollvm-deobfuscation.md` |
| Диаграммы / отчёты | `skills/diagram-generator/` / `skills/docs-generator/` |
### Ключевые файлы
| Файл | Назначение |
|------|---------|
| [README_AI.md](https://github.com/zhaoxuya520/reverse-skill/blob/main/README_AI.md) | ИИ-агент: бутстрап и конфигурация |
| [RULES.md](https://github.com/zhaoxuya520/reverse-skill/blob/main/RULES.md) | Глобальные правила маршрутизации (шлюз области работ перед ACT) |
| [skills/MASTER-ROUTING.md](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/MASTER-ROUTING.md) | Основной быстрый маршрут (PRIMARY) |
| [skills/routing.md](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/routing.md) | Матрица маршрутизации «задача → навык» |
| [skills/SKILL.md](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/SKILL.md) | Главная точка входа |
| [skills/INDEX.md](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/INDEX.md) | Автогенерируемый, нейтральный к клиенту индекс навигации по навыкам |
| [skills/config/routing.json](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/config/routing.json) | **Единый источник правды по маршрутизации** (41 правило, R0–R40) |
| [skills/tool-index.md](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/tool-index.md) | Локальный статус инструментов (автогенерируемый) |
| [skills/scripts/master-route.ps1](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/scripts/master-route.ps1) | Разовая первичная сортировка (PRIMARY) (читает routing.json) |
| [skills/scripts/case-init.ps1](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/scripts/case-init.ps1) | Каталог кейса: scope / timeline / workitems |
| [skills/case-review/](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/case-review) | Просмотр графа доказательств и проверки целостности артефактов (только чтение) |
| [skills/scripts/test-routing.ps1](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/scripts/test-routing.ps1) | Запуск регрессионных тестов маршрутизации (163 бенчмарк-кейса) |
| [skills/scripts/verify-routing-coherence.ps1](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/scripts/verify-routing-coherence.ps1) | Проверки структуры + шлюз пининга цепочки поставок |
| [skills/scripts/extract-summaries.ps1](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/scripts/extract-summaries.ps1) | Перегенерирует INDEX.md из frontmatter навыков |
| [AGENTS.md](https://github.com/zhaoxuya520/reverse-skill/blob/main/AGENTS.md) | Инструкции по репозиторию, нейтральные к платформе |
| [skills/ops/](https://github.com/zhaoxuya520/reverse-skill/blob/main/skills/ops) | Область работ, цепочка доказательств, роли, таймлайн (форма skill-router) |
### Тестирование (запускайте после любых изменений маршрутизации/конфигурации)
```powershell
# 1. Routing regression — 163 (hint → expected PRIMARY) cases, fails CI on any mismatch
powershell -NoProfile -ExecutionPolicy Bypass -File skills/scripts/test-routing.ps1
# 2. Structure coherence + supply-chain pin gate (unpinned auto-install fails)
powershell -NoProfile -ExecutionPolicy Bypass -File skills/scripts/verify-routing-coherence.ps1
# 3. Smoke: verify + script parse + quick route matrix
powershell -NoProfile -ExecutionPolicy Bypass -File skills/scripts/smoke.ps1
# 4. INDEX.md drift check (regenerate with extract-summaries.ps1 if dirty)
powershell -NoProfile -ExecutionPolicy Bypass -File skills/scripts/extract-summaries.ps1 -Check
```
CI в GitHub Actions запускает всё вышеперечисленное на **Windows + Ubuntu** при каждом push/PR.
### Интеграция, нейтральная к клиенту
Ядро маршрутизации, регрессионный набор, манифесты и рабочий процесс кейсов не зависят от конкретного ИИ-клиента. Claude Code, Codex, Cursor, OpenCode и другие клиенты должны загружать репозиторий через собственный адаптер или механизм инструкций проекта. Клиент-специфичная конфигурация должна оставаться опциональной и находиться вне основного контракта маршрутизации.
### Структура репозитория
```
.
├── README.md / README_zh.md / README_AI.md
├── RULES.md / RULES_zh.md
├── skills/
│ ├── MASTER-ROUTING.md / SKILL.md / routing.md
│ ├── ops/ # ops contracts
│ ├── scripts/ # master-route, case-init, bootstrap, verify
│ ├── field-journal/
│ ├── apk-reverse/ mobile-reverse/ js-reverse/ dotnet-reverse/
│ ├── ida-reverse/ radare2/ reverse-engineering/ malware-analysis/
│ ├── pentest-tools/ attack-chain/ pwn-chain/ firmware-pentest/
│ ├── api-security/ supply-chain-security/ llm-security/
│ └── ...
├── CTF-Sandbox-Orchestrator/
├── docs/
├── kali/ # see kali/README-kali.md
└── work/ # local cases (gitignored)
```
<p align="right">(<a href="#usage">наверх</a>)</p>
<a id="sponsors"></a>
## Спонсоры
Спонсорство помогает поддерживать бенчмарки маршрутизации, кроссплатформенный CI, документацию и публичную библиотеку рабочих процессов по безопасности.
### Текущий спонсор
<table align="center">
<tr>
<td align="center" width="440">
<a href="https://www.atlascloud.ai/?ref=W3Q77C">
<img src="https://www.atlascloud.ai/oss-program/powered-by-atlas-cloud.svg" alt="Powered by Atlas Cloud" height="44" />
</a>
<br />
<strong>Atlas Cloud</strong>
<br />
<sub>Провайдер услуг больших языковых моделей</sub>
</td>
</tr>
</table>
### Спонсируйте этот проект
<p align="center">
<a href="mailto:[email protected]?subject=%5BSponsorship%5D%20reverse-skill">
<img src="https://img.shields.io/badge/Email%[email protected]?style=for-the-badge&logo=gmail&logoColor=white" alt="Email us — [email protected]" />
</a>
</p>
<p align="center"><sub>Подтверждённые спонсоры могут быть указаны здесь с именем, логотипом и ссылкой на проект.</sub></p>
<p align="right">(<a href="#sponsors">наверх</a>)</p>
<a id="contributing"></a>
## Участие в разработке
Вклад приветствуется! Форкните репозиторий, создайте ветку функции и откройте PR.
1. Форкните проект
2. `git checkout -b feature/AmazingFeature`
3. `git commit -m 'Add some AmazingFeature'`
4. `git push origin feature/AmazingFeature`
5. Откройте Pull Request
### Участники
<a href="https://github.com/zhaoxuya520/reverse-skill/graphs/contributors">
<img src="https://contrib.rocks/image?repo=zhaoxuya520/reverse-skill" alt="участники" />
</a>
<p align="right">(<a href="#contributing">наверх</a>)</p>
<a id="license"></a>
## Лицензия
Этот проект (`reverse-skill`) в основном распространяется под лицензией **MIT** (см. [LICENSE](https://github.com/zhaoxuya520/reverse-skill/blob/main/LICENSE)).
**Субмодули и сторонние зависимости:**
- **CTF-Sandbox-Orchestrator/**: **GNU GPLv3**
- **Pentest Swarm AI**: оригинальный проект имеет лицензию **AGPL-3.0**. Этот репозиторий лишь вызывает его через CLI или MCP и не включает его исходный код
- Остальные инструменты (jadx, frida, nmap, burpsuite-mcp и др.) подчиняются соответствующим официальным лицензиям
<p align="right">(<a href="#license">наверх</a>)</p>
<a id="acknowledgments"></a>
## Благодарности
Спасибо всем авторам инструментов с открытым исходным кодом. Этот проект объединяет инструменты из области реверс-инжиниринга, тестирования на проникновение, CTF и анализа безопасности — каждый инструмент — плод труда сообщества.
Особая благодарность участникам экосистемы деобфускации OLLVM и всем, кто присылал тестовые образцы, issues и PR.
<p align="right">(<a href="#acknowledgments">наверх</a>)</p>
## Контакты
- **Email:** [[email protected]](mailto:[email protected])
- **QQ-группа:** 942400892
- **Discord:** [сообщество reverse-skill](https://discord.gg/TECd3bMRR)
- **Issues:** [GitHub Issues](https://github.com/zhaoxuya520/reverse-skill/issues)