blacktop/ipsw-skill
GitHub: blacktop/ipsw-skill
基于ipsw CLI的AI代理技能,使Claude Code、Codex CLI等AI助手能够协助完成Apple固件下载提取和逆向工程任务。
Stars: 53 | Forks: 5
# ipsw-skill
一个用于 Apple 固件和二进制逆向工程的 AI 代理技能,基于 [ipsw](https://github.com/blacktop/ipsw) CLI 工具。
支持 **Claude Code**、**Codex CLI**、**Gemini CLI** 和 **Pi (pi-coding-agent)**。
## 此技能提供的功能
此技能使 AI 代理能够协助完成以下任务:
- **下载/提取固件** - IPSW、OTA、kernelcache、dyld_shared_cache
- **用户空间逆向工程** - DSC 反汇编、符号查找、交叉引用、字符串搜索
- **转储** 私有框架中的 **Objective-C 头文件**
- **内核和 KEXT 分析** - 提取、系统调用、版本对比
- **权限研究** - 数据库查询、功能发现
- **Mach-O 二进制分析** - 签名、权限、反汇编
## 安装说明
### 前置条件
安装 `ipsw` CLI 工具:
```
brew install blacktop/tap/ipsw
```
### skills.sh
```
npx skills add https://github.com/blacktop/ipsw-skill --skill ipsw
```
### Claude Code
从市场安装:
```
claude plugin marketplace add blacktop/ipsw-skill
claude plugin install ipsw
```
或手动安装:
```
git clone https://github.com/blacktop/ipsw-skill /tmp/ipsw-skill
# 用户级(在所有项目中可用)
mv /tmp/ipsw-skill/ipsw ~/.claude/skills/ipsw
# 项目特定(添加到您的仓库)
mv /tmp/ipsw-skill/ipsw .claude/skills/ipsw
```
### Codex CLI
使用内置安装程序:
```
$skill-installer https://github.com/blacktop/ipsw-skill --path ipsw
```
或手动安装:
```
git clone https://github.com/blacktop/ipsw-skill /tmp/ipsw-skill
# 用户级
mv /tmp/ipsw-skill/ipsw ~/.codex/skills/ipsw
# 项目特定
mv /tmp/ipsw-skill/ipsw .codex/skills/ipsw
```
### Gemini CLI
直接安装扩展:
```
gemini extensions install https://github.com/blacktop/ipsw-skill
```
### Antigravity
手动安装技能:
```
# 用户级
mv /tmp/ipsw-skill/ipsw ~/.gemini/antigravity/skills/ipsw
# 工作区特定
mv /tmp/ipsw-skill/ipsw /.agent/skills/ipsw
```
### Pi(pi-coding-agent)
```
# 全局(添加包到 ~/.pi/agent/settings.json;克隆到 ~/.pi/agent/git/...)
pi install https://github.com/blacktop/ipsw-skill
# 项目本地(添加包到 ./.pi/settings.json;克隆到 ./.pi/git/...)
pi install -l https://github.com/blacktop/ipsw-skill
```
## 使用示例
安装后,代理将自动将此技能用于 Apple 逆向工程任务:
## 目录
```
ipsw-skill/
├── ipsw/ # The skill (Claude Code / Codex / Gemini all read this)
│ ├── SKILL.md # Main skill instructions
│ └── references/
│ ├── dyld.md # DSC analysis (a2s, xref, dump, str)
│ ├── download.md # Firmware download & extraction
│ ├── kernel.md # Kernel & KEXT analysis
│ ├── macho.md # Mach-O binary analysis
│ ├── class-dump.md # ObjC header dumping
│ └── entitlements.md # Entitlements database & queries
├── gemini-extension.json # Gemini extension config
├── package.json # Pi package manifest
└── .claude-plugin/
└── marketplace.json # Claude marketplace config
```
## 资源
- [ipsw 文档](https://blacktop.github.io/ipsw)
- [ipsw GitHub](https://github.com/blacktop/ipsw)
- [Discord 社区](https://discord.gg/BEamsHAWAh)
## 许可证
MIT
标签:Apple安全, DAST, dyld_shared_cache, Hpfeeds, HTTP工具, iOS安全, ipsw, kernelcache, KEXT, Mach-O, macOS安全, Objective-C, Wayback Machine, 二进制分析, 云安全运维, 云资产清单, 内核分析, 反汇编, 固件分析, 固件提取, 恶意软件分析, 数字取证, 无线安全, 日志审计, 权限分析, 目录枚举, 移动安全, 符号查找, 系统调用, 自动化脚本, 逆向工程