github-hunter

GitHub Hunter 技能

自动发现与 BidDeed.AI 和 Life OS 相关的 GitHub 仓库，根据标准按 0-100 分评分，并将其归档到 Supabase，同时提供集成建议。

工作流

1. 发现阶段

使用从以下来源提取的相关关键词搜索 GitHub 仓库：

• 用户请求（“为 X 查找仓库”）
• 视频转录文本（内容中提及的项目）
• 技术领域（止赎数据、ADHD 效率工具等）

2. 评分阶段（0-100）

根据以下标准为每个仓库评分：

• Stars（0-25 分）：对数刻度，10K+ stars = 25
• 近期活跃度（0-20 分）：30 天内更新 = 20，1 年以上 = 0
• 文档（0-15 分）：README 质量、示例、API 文档
• 相关性（0-25 分）：与 BidDeed.AI 或 Life OS 的直接适用程度
• 许可证（0-15 分）：MIT/Apache = 15，GPL = 10，专有许可证 = 0

公式：

score = min(100, 
    (log10(stars + 1) / log10(10000)) * 25 +
    max(0, 20 - (days_since_update / 15)) +
    documentation_score +
    relevance_score +
    license_score
)

3. 归档阶段

将以下内容插入 Supabase insights 表：

{
  "category": "github_discovery",
  "subcategory": "auto_hunter",
  "title": "GitHub Hunter: {repo_name}",
  "content": {
    "repo_url": "https://github.com/{owner}/{name}",
    "score": 85,
    "stars": 1234,
    "description": "...",
    "language": "Python",
    "license": "MIT",
    "last_updated": "2025-12-20",
    "integration_recommendation": "...",
    "relevant_to": ["biddeed", "life-os"]
  }
}

4. 提醒阶段

通过回复通知 Ariel，包含：

• 仓库名称和 URL
• 评分（颜色标记：🟢 80+，🟡 60-79，🟠 40-59，🔴 <40）
• 简要摘要（1-2 句话）
• 集成建议
• 直接操作：“添加到 {repo}？”并提供是/否选项

使用触发条件

明确请求：

• “为 {topic} 查找 GitHub 仓库”
• “搜索关于 {domain} 的项目”
• “发现与 {technology} 相关的仓库”

上下文触发条件：

• 视频转录文本提及 GitHub 项目 → 转录后自动搜索
• 文章/文档中包含 GitHub URL → 提取并评分
• 讨论某个主题后，用户询问“我们可以从中集成什么？”

评分示例

评分 95： fastapi/fastapi

• 75K stars（25），2 天前更新（20），文档出色（15），与 BidDeed.AI API 高度相关（25），Apache 许可证（15）

评分 72： user/small-foreclosure-tool

• 45 stars（8），1 周前更新（18），README 基础（8），相关性极高（25），MIT（15）

评分 38： abandoned/old-project

• 500 stars（15），2 年前更新（0），没有文档（0），相关性较弱（8），MIT（15）

集成建议格式

提供可执行的集成步骤：

### Integration Recommendation

**To BidDeed.AI:**
1. Use {feature} for {existing_workflow_stage}
2. Replace {current_approach} with {repo_approach}
3. Add workflow: `.github/workflows/{new_workflow}.yml`

**To Life OS:**
1. Integrate {tool} for {productivity_feature}
2. Add skill: `.claude/skills/{skill_name}/`
3. Update orchestrator to call {function}

**Estimated effort:** {hours} hours
**Dependencies:** {list}
**Risk level:** {low/medium/high}

提醒模板

🔍 **GitHub Hunter Discovery**

**{repo_name}** [{score_emoji} {score}/100]
https://github.com/{owner}/{name}

{description}

**Stats:** ⭐ {stars} | 📅 {last_updated} | 📜 {license} | 💬 {language}

**Integration:**
{integration_recommendation}

**Add to BidDeed.AI?** [Yes/No]
**Add to Life OS?** [Yes/No]

进阶：批量发现

当用户提供主题列表或领域时：

# Example: "Find repos for foreclosure data scraping, PDF parsing, and workflow orchestration"

Topics:
1. foreclosure data scraping
2. PDF parsing  
3. workflow orchestration

For each topic:
- Search GitHub API with 3-5 keyword variations
- Score top 10 results per topic
- Archive scores 60+ to Supabase
- Alert Ariel with top 3 across all topics

添加仓库工作流

用户批准某个仓库后：

1. 确定目标仓库：

   • BidDeed.AI → breverdbidder/biddeed-conversational-ai
   • Life OS → breverdbidder/life-os
   • 两者 → 添加到两个仓库

2. 制定集成计划：

   • 如果是库：添加到 requirements.txt 或 package.json
   • 如果是工作流：创建 .github/workflows/{name}.yml
   • 如果是技能：创建 .claude/skills/{name}/SKILL.md
   • 如果是脚本：添加到 src/integrations/ 或 agents/

3. 在 README 中记录：

   • 添加到“集成”部分
   • 链接到仓库
   • 注明版本和许可证

4. 归档决策：

   • 使用 integration_status: "added" 更新 Supabase insight
   • 记录添加到哪个（些）仓库
   • 注明 commit SHA

筛选条件

排除以下仓库：

• 已归档
• 2 年以上没有提交（除非是传奇级/基础性项目）
• 核心 BidDeed.AI 功能使用专有许可证
• <10 stars 且创建时间 <30 天（可能是垃圾项目）

优先考虑以下仓库：

• Python（BidDeed.AI）、JavaScript/TypeScript（Life OS）
• AI/ML、网页抓取、文档处理、工作流自动化
• 维护活跃（最近 60 天内有提交）
• 文档清晰
• 宽松许可证（MIT、Apache、BSD）

GitHub API 用法

使用 web_search 查找仓库，然后使用 web_fetch 获取详情：

# Search
query = "foreclosure auction data scraping language:python"
search_url = f"https://github.com/search?q={query}&type=repositories&s=stars&o=desc"

# Fetch repo details
repo_url = "https://api.github.com/repos/{owner}/{name}"
# Get: stars, last_updated, description, language, license, topics

Supabase 架构

将内容插入 mocerqjnksmhcjzxrewo.supabase.co 上的 insights 表：

INSERT INTO insights (category, subcategory, title, content, created_at)
VALUES (
  'github_discovery',
  'auto_hunter',
  'GitHub Hunter: {repo_name}',
  '{
    "repo_url": "...",
    "score": 85,
    "stars": 1234,
    "description": "...",
    "language": "Python",
    "license": "MIT",
    "last_updated": "2025-12-20",
    "integration_recommendation": "...",
    "relevant_to": ["biddeed"],
    "integration_status": "pending"
  }'::jsonb,
  NOW()
);

示例会话

User: "Find GitHub repos for PDF form filling and data extraction"

Claude: [triggers github-hunter skill]

1. Search: "PDF form filling python", "PDF data extraction", "fillable pdf automation"
2. Discover: 
   - PyPDF2 (8.2K stars, score: 78)
   - pdfplumber (6.1K stars, score: 82)
   - pdf-form-fill (234 stars, score: 71)
3. Archive top 2 to Supabase
4. Alert:

🔍 **GitHub Hunter Discovery**

**pdfplumber** [🟢 82/100]
https://github.com/jsvine/pdfplumber

Plumb a PDF for detailed information about tables, text, images. Maintained, excellent docs.

**Stats:** ⭐ 6.1K | 📅 2025-12-15 | 📜 MIT | 💬 Python

**Integration:**
Replace manual PDF parsing in BECA scraper with pdfplumber for structured table extraction.
Use for tax certificate downloads from RealTDM.

**Add to BidDeed.AI?** [Yes/No]

注意事项

• 始终先归档到 Supabase，再请求批准
• 提醒评分门槛：60+
• 批量发现：只提醒排名前 3 的仓库，将所有 60+ 分的仓库归档
• 如果仓库已存在于我们的代码库中，将其标记为 integration_status: "existing"