renef-skills

一个 Claude Code 插件，它让 AI 代理能够正确操作 renef.io — 面向 Android ARM64 的动态插桩引擎：钩取 native 和 Java 函数、扫描/读/写/修补进程内存、跟踪系统调用， 并通过 Lua 5.4 脚本绕过 SSL 证书固定 / root 检测（memfd 注入，无需 ptrace）。

这是一份操作手册，而不是教程。一个已经能编写 Frida 钩子、 GameGuardian (gg.*) 作弊脚本或游戏外挂 Lua 的代理，已经掌握了概念——它只是缺少 renef 的确切 语法和工作流，没有这些它就会生成 Frida JavaScript、带点的 Java 类名、绝对 钩子地址、retval.replace() 或 gg.* 调用，这些在 renef 中统统无效。该技能为代理提供 精确的语法契约、用于自查脚本的自我检查（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）（带有 name + description frontmatter 的 SKILL.md）。它是 按需加载——代理看到技能描述后，只有在任务涉及 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

将此仓库添加为插件源（或添加到你可控制的市场上）并启用 renef 插件—— 捆绑的技能会自动注册。（.claude-plugin/plugin.json 是清单文件。）

其他代理（Cursor、Aider、Cline、Codex，…）

技能的自动发现功能尚不通用。这里有两种可移植的方案：

1. 将代理指向此仓库——AGENTS.md（被许多代理读取，包括 OpenCode/Cursor/Zed） 会引导它了解项目，并告诉它阅读 skills/renef/SKILL.md。
2. 在代理的规则/指令中直接引用 markdown（例如，一个包含 skills/renef/SKILL.md 的 Cursor .cursor/rules/*.mdc）。内容就是纯 Markdown。

用法

只需描述任务——该技能会在涉及 renef 的工作时触发：

• "编写一个 renef 脚本来绕过 com.example.app 中的 SSL 证书固定"
• "把这个 Frida 脚本移植到 renef"
• "钩取 libapp.so 中的 native verify 函数并记录其参数"
• "使用 renef-strace 观察该应用中的文件访问"

范围与伦理

Renef 面向 Android ARM64，用于经授权的安全测试、应用加固评估、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

此插件仅为文档/说明；不附带任何 renef 二进制文件。