حزمة توجيه مهارات مدعومة بالذكاء الاصطناعي للهندسة العكسية، واختبار الاختراق، وأبحاث الأمن السيبراني. توجّه وكلاء الذكاء الاصطناعي إلى المنهجيات الصحيحة وتُهيّئ سلاسل أدوات عند الطلب لمهام APK، والملفات الثنائية، وJS، والبرامج الثابتة (firmware)، وتحديات 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">إقلاع الذكاء الاصطناعي</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 / أندرويد | `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 / آلة opcode مخصصة للـ JS | `skills/reverse-engineering/dsl-vm-reverse/` |
| التقاط HTTP / إعادة إرسال الطلبات | anything-analyzer, Reqable MCP + `js-reverse/` |
| البرمجيات الخبيثة / YARA | `skills/malware-analysis/` |
| اختبار الاختراق / المسح | `skills/pentest-tools/` |
| سلسلة الهجوم / تنسيق الفريق الأحمر | `skills/attack-chain/` |
| مراجعة أدلة الحالة / تسليم التقرير | `skills/case-review/` |
| مسابقات CTF | `CTF-Sandbox-Orchestrator/` (42 مهارة فرعية) |
| البرمجيات الثابتة / إنترنت الأشياء | `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) | مجلد الحالة: النطاق / الجدول الزمني / عناصر العمل |
| [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) | النطاق، وسلسلة الأدلة، والأدوار، والجدول الزمني (نموذج موجه المهارات) |
### الاختبار (نفّذه بعد أي تغيير في التوجيه/الإعداد)
```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
```
تشغّل GitHub Actions CI كل ما سبق على **Windows + Ubuntu** مع كل push/PR.
### تكامل محايد تجاه العميل
جوهر التوجيه، ومجموعة اختبارات الانحدار، وملفات البيان (manifests)، وسير عمل الحالة لا تعتمد على عميل ذكاء اصطناعي معيّن. يجب على 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="مدعوم من 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>
## المساهمة
المساهمات مرحّب بها! انسخ المستودع (fork)، وأنشئ فرع ميزة، وافتح طلب سحب (PR).
1. انسخ المشروع (Fork)
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 ولكل من قدّم عينات اختبار وقضايا وطلبات سحب (PRs).
<p align="right">(<a href="#acknowledgments">العودة إلى الأعلى</a>)</p>
## التواصل
- **البريد الإلكتروني:** [[email protected]](mailto:[email protected])
- **مجموعة QQ:** 942400892
- **Discord:** [مجتمع reverse-skill](https://discord.gg/TECd3bMRR)
- **القضايا:** [قضايا GitHub](https://github.com/zhaoxuya520/reverse-skill/issues)