airdropia-collection/bounty-hunter

# 🎯 Bounty Hunter [](https://github.com/airdropia-collection/bounty-hunter/actions/workflows/ci.yml) [](https://github.com/airdropia-collection/bounty-hunter/actions/workflows/hunt.yml) [](LICENSE) ## 🎯 核心功能 **Bounty Hunter** 是一个由 AI 驱动的系统，它可以： 1. **抓取** Web3 平台（Immunefi, Code4rana, Sherlock, Gitcoin）上的活跃赏金任务 2. **筛选** 可行的赏金任务 —— AI 会评估难度与收益的性价比 3. **分析** 使用 AI + Slither（静态分析）审查智能合约源代码 4. **起草** 包含严重程度、影响范围、PoC 和修复方案的漏洞报告 5. **创建 GitHub Issues** 记录每个有潜力的发现 → 由你审查和批准 6. **追踪** 跨平台的提交状态（已提交、已接受、已支付、已拒绝） 7. **学习** 以往的发现 —— 积累漏洞模式知识库 **你的角色：** 在手机上查看 GitHub Issue → 评论 `/submit` 或 `/reject` → 完成。 ## 🧠 基于 agent-skills 构建 本仓库内置了来自 [`addyosmani/agent-skills`](https://github.com/addyosmani/agent-skills) 的全部 24 项技能（skills）： ``` DEFINE PLAN BUILD VERIFY REVIEW SHIP ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ │ Idea │ ───▶ │ Spec │ ───▶ │ Code │ ───▶ │ Test │ ───▶ │ QA │ ───▶ │ Go │ │Refine│ │ PRD │ │ Impl │ │Debug │ │ Gate │ │ Live │ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ ``` 每个任务都遵循 skill 工作流。有关完整的映射关系，请参阅 [`AGENTS.md`](AGENTS.md)。 **本项目的关键 skills：** - `skills/security-and-hardening/` — 所有代码的强制要求（我们要处理不受信任的 HTML、AI 输出、API 密钥） - `skills/doubt-driven-development/` — 任何提交前的强制要求（对发现进行对抗性审查） - `skills/spec-driven-development/` — 参见 [`SPEC.md`](SPEC.md) - `skills/planning-and-task-breakdown/` — 参见 [`tasks/plan.md`](tasks/plan.md) + [`tasks/todo.md`](tasks/todo.md) ## 🏗️ 架构 ``` ┌─────────────────────────────────────────────────────────────────┐ │ GitHub Actions (every 6h) │ └─────────────────────────────────────────────────────────────────┘ │ ▼ ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐ │ SCRAPERS │ │ ANALYZERS │ │ REPORTERS │ │ │ │ │ │ │ │ • Immunefi │──▶│ • AI (Gemini) │──▶│ • Draft report │ │ • Code4rana │ │ • AI (Groq) │ │ • PoC generator │ │ • Sherlock │ │ • Slither │ │ • GitHub Issue │ │ • Gitcoin │ │ • Doubt review │ │ │ └─────────────────┘ └─────────────────┘ └────────┬────────┘ │ ┌──────────────────────▼──────────────────────┐ │ GitHub Issue created │ │ (you get notification on phone) │ └──────────────────────┬──────────────────────┘ │ ┌──────────────────────▼──────────────────────┐ │ You comment: /submit │ │ (or /reject ) │ └──────────────────────┬──────────────────────┘ │ ┌──────────────────────▼──────────────────────┐ │ TRACKERS │ │ • Submission status │ │ • Earnings tracker │ └─────────────────────────────────────────────┘ ``` ## 🚀 快速开始 ### 前置条件 - Python 3.11+ - GitHub 账号 - Gemini API key (免费：https://aistudio.google.com/app/apikey) - Groq API key (免费：https://console.groq.com/) ### 设置 ``` # 1. Clone git clone https://github.com/airdropia-collection/bounty-hunter.git cd bounty-hunter # 2. Virtual env + install python -m venv .venv source .venv/bin/activate pip install -e ".[dev]" playwright install chromium # 3. Configure cp .env.example .env # 编辑 .env：添加 GEMINI_API_KEY, GROQ_API_KEY, GH_PAT # 4. Health check python -m src.health # 5. 运行测试 pytest -v # 6. 手动运行 pipeline python -m src.pipeline --dry-run ``` ### GitHub Actions（生产环境） Pipeline 每 6 小时自动运行一次。若要手动触发： 1. 进入 **Actions** 标签页 2. 选择 **🎯 Bounty Hunter** workflow 3. 点击 **Run workflow** 4. 选择：`dry_run=true`（安全模式，不进行提交）或 `false`（真实提交） ## 📋 支持的平台 | 平台 | 类型 | 奖金范围 | 难度 | |----------|------|--------------|------------| | [Immunefi](https://immunefi.com) | Bug bounty | $500 - $10M | 中-高 | | [Code4rana](https://code4rana.com) | Audit contest | $2k - $50k 奖池 | 中 | | [Sherlock](https://www.sherlock.xyz) | Audit contest | $5k - $30k 奖池 | 中 | | [Gitcoin](https://gitcoin.co) | 开源赏金 | $50 - $5k | 低-中 | ## 🎯 路线图 有关完整的 Day1/Week1/Month1/Year1 目标，请参阅 [`docs/ROADMAP.md`](docs/ROADMAP.md)。 **第一个里程碑：** 首次赚取 $1（约 30 天） ## 🔐 安全性 本项目涉及处理以下内容： - 不受信任的抓取 HTML - AI 生成的输出（根据 `skills/security-and-hardening/` 视为不受信任） - API 密钥（Gemini, Groq, GitHub PAT, Etherscan） - 钱包地址（绝对不包括私钥） 完整的威胁模型请参阅 [`SECURITY.md`](SECURITY.md)。 ## 📄 许可证 MIT — 参见 [`LICENSE`](LICENSE) **预算：$0 · 运行在 GitHub Actions 免费层 · 使用 agent-skills 构建**

标签：AI智能体, GitHub Actions, Sysdig, Web3, 智能合约审计, 特征检测, 自动化爬虫, 自动笔记, 逆向工具