renef-skills

إضافة لـ Claude Code تجعل وكلاء الذكاء الاصطناعي يتعاملون مع renef.io بشكل صحيح — محرك التنقيب الديناميكي (dynamic instrumentation) لـ Android ARM64: ربط الدوال الأصلية (native) ودوال Java، وفحص/قراءة/كتابة/تعديل ذاكرة العملية، وتتبع استدعاءات النظام (syscalls)، وتجاوز تثبيت SSL (SSL pinning) / كشف الجذر (root detection) عبر نصوص Lua 5.4 (حقن memfd، بدون ptrace).

هذا دليل مشغّل (operator's manual) وليس برنامجًا تعليميًا. الوكيل الذي يستطيع بالفعل كتابة خطافات Frida أو أكواد غش GameGuardian (gg.*) أو نصوص Lua لاختراق الألعاب يمتلك المفاهيم — لكنه ينقصه الصياغة وسير العمل الدقيقان لـ renef، وبدونهما يُخرِج JavaScript من Frida، أو أسماء فئات Java مفصولة بالنقاط، أو عناوين خطاف مطلقة، أو retval.replace()، أو استدعاءات gg.*، ولا يعمل أيٌّ منها في renef. تمنح المهارة الوكيل عقد صياغة (syntax contract) دقيقًا، وأداة فحص ذاتي (self-lint) لتشغيلها على نصوصه الخاصة، وخريطة مهمة ← دليل إجراءات (playbook)، وجداول ترجمة من الأدوات الأخرى، ووصفات جاهزة للنسخ واللصق.

المحتويات

renef-skills/
├── .claude-plugin/
│   └── plugin.json                # plugin manifest
├── CONTRIBUTING.md                # how to contribute VERIFIED findings (no confidential target data)
└── skills/
    └── renef/
        ├── SKILL.md                # operator framing: roles, syntax contract, self-lint, task playbook
        ├── probe.lua               # RUN FIRST — ground-truths the API/behavior of your renef build
        └── references/
            ├── methodology.md      # the investigation loop: solve a NEW bypass yourself
            ├── debugging.md        # renef hides errors — recover them; failure-symptom table; hot-hook race; RASP
            ├── lua-api.md          # full Lua API: Module/Memory/hook/Jni/Java/Thread/File/Syscall/OS/KCov
            ├── cli.md              # commands, flags, connection modes, build/deploy, companion tools
            ├── from-other-tools.md # translate Frida JS + GameGuardian (gg.*) / game-hacking Lua → renef
            ├── recipes.md          # worked examples: SSL/root bypass, WebView, tracing, memory, CTF…
            └── gotchas.md          # pitfalls, doc/runtime discrepancies, troubleshooting

تستخدم المهارة الإفصاح التدريجي (progressive disclosure): يبقى SKILL.md مضغوطًا (يقوم النموذج بتحميله عندما تتضمن مهمة ما renef)، ولا تُستدعى ملفات المرجع الأكبر إلا عند الحاجة.

التثبيت

هذه مهارة وكيل (Agent Skill) قياسية (SKILL.md مع واجهة أمامية (frontmatter) تحتوي name + description). يتم تحميلها عند الطلب — يرى الوكيل وصف المهارة ولا يستدعي المحتوى الكامل إلا عندما تتضمن مهمة ما renef.

نسخة واحدة، وكيلان. يقرأ كلٌّ من Claude Code وOpenCode دليلي .claude/skills/. التثبيت في ~/.claude/skills/renef/ (عام) أو .claude/skills/renef/ (لكل مشروع) يجعل المهارة تعمل في كليهما دون أي تحويل.

Claude Code وOpenCode (موصى به)

# Global — available in all your projects, for both Claude Code and OpenCode:
mkdir -p ~/.claude/skills && cp -r skills/renef ~/.claude/skills/renef

# Or per-project:
mkdir -p .claude/skills && cp -r skills/renef .claude/skills/renef

ثم يكفي أن تصف مهمة تتعلق بـ renef — تُفعَّل المهارة تلقائيًا (في OpenCode تظهر عبر أداة skill الأصلية).

مواقع OpenCode الأصلية تعمل أيضًا إذا كنت تفضّلها: .opencode/skills/renef/SKILL.md (المشروع) أو ~/.config/opencode/skills/renef/SKILL.md (عام). يفحص OpenCode أيضًا .agents/skills/ و ~/.agents/skills/.

Claude Code كإضافة

أضف هذا المستودع كمصدر إضافة (أو إلى سوق (marketplace) تتحكم فيه) وفعّل إضافة renef — تُسجَّل المهارة المرفقة تلقائيًا. (ملف .claude-plugin/plugin.json هو البيان (manifest)).

وكلاء آخرون (Cursor, Aider, Cline, Codex, …)

الاكتشاف التلقائي للمهارات ليس معممًا بعد. إليك خياران قابلان للنقل:

1. وجّه الوكيل إلى هذا المستودع — ملف AGENTS.md (الذي تقرؤه وكلاء عديدون، بما في ذلك OpenCode/Cursor/Zed) يوجّهه إلى المشروع ويطلب منه قراءة skills/renef/SKILL.md.
2. أشر إلى ملف Markdown مباشرةً في قواعد/تعليمات الوكيل (مثل ملف .cursor/rules/*.mdc في Cursor يتضمن skills/renef/SKILL.md). المحتوى هو Markdown عادي.

الاستخدام

فقط صف المهمة — تُفعَّل المهارة عند الأعمال المتعلقة بـ renef:

• "اكتب سكربت renef لتجاوز تثبيت SSL في com.example.app"
• "انقل سكربت Frida هذا إلى renef"
• "اربط الدالة الأصلية verify في libapp.so وسجّل وسائطها (args)"
• "استخدم renef-strace لمراقبة الوصول إلى الملفات في هذا التطبيق"

النطاق والأخلاقيات

يستهدف renef Android ARM64 وهو مخصص لاختبارات الأمن المصرَّح بها، ومراجعة تحصين التطبيقات (app hardening)، ومسابقات CTF، والهندسة العكسية للبرامج التي تملكها أو يُسمح لك بتحليلها. التزم بالقوانين المعمول بها وشروط التطبيق المستهدف.

الاعتمادات

• renef من @ahmeth4n — Apache-2.0. الوثائق: https://renef.io
• خطافات المجتمع: https://hook.renef.io · إضافة r2: https://github.com/ahmeth4n/r2renef · وحدة النشر التلقائي: https://github.com/vichhka-git/magisk-renef

هذه الإضافة هي توثيق/تعليمات فقط؛ ولا تشتمل على أي ملفات ثنائية (binaries) لـ renef.