GitHub Study Finder

github-study-finder 是一个用于发现 GitHub 学习项目的 WorkBuddy/Codex skill。它不是简单找热门仓库，而是帮助开发者按技术栈、当前水平、项目类型和学习目标，筛选真正值得阅读、抄写和研究的开源项目。

功能概览

• 按技术栈搜索学习项目，例如 React Native、Vue3、Flutter、Rust。
• 在搜索前先收集学习需求，避免只按 trending 或 star 数推荐。
• 支持 beginner、intermediate、advanced 三档难度过滤。
• 从文档质量、活跃度、社区支持、学习适配度等维度评估学习价值。
• 支持搜索候选项目、深度分析指定仓库、生成学习建议和学习路径。
• 支持 awesome-list 精选模式和 JSON 输出，方便进一步处理。

目录结构

github-study-finder/
  SKILL.md
  README.md
  references/
    search_guide.md
  scripts/
    search_repos.py
    analyze_repo.py

依赖

• Python 3.8+
• GitHub CLI gh
• 已登录的 GitHub CLI 会获得更好的搜索和分析能力：

gh auth login

如果没有安装或登录 gh，搜索脚本可降级使用 GitHub REST API，但会受到更严格的速率限制；深度分析功能建议使用已认证的 gh。

使用方式

把本目录放到你的 skill 目录中，例如：

C:\Users\<you>\.workbuddy\skills\github-study-finder

或兼容的 Codex/WorkBuddy skills 目录。

然后在对话中请求：

使用 github-study-finder 帮我找适合学习 React Native 的开源项目。

skill 会先补全关键需求，例如：

• 想学什么技术栈？
• 当前水平是刚入门、有基础，还是想进阶？
• 想找完整应用、组件库、后台管理，还是工具类项目？
• 学习目标是面试、技能迁移、做产品，还是纯兴趣？

脚本示例

搜索候选项目：

python scripts/search_repos.py \
  --topic "react native" \
  --difficulty intermediate \
  --language TypeScript \
  --limit 10

深度分析指定仓库：

python scripts/analyze_repo.py \
  --repo owner/repo \
  --depth full

输出 JSON：

python scripts/search_repos.py --topic vue3 --difficulty beginner --json

搜索策略

详细搜索语法、topic 选择、awesome-list 策略和项目质量判断标准见：

references/search_guide.md

设计原则

这个 skill 的重点是“找到适合学习的项目”，而不是“找到最火的项目”。推荐时会尽量结合用户水平、学习目标、项目复杂度、文档质量、活跃度和可读性，给出更适合投入时间研究的选择。