github-project-recommender
/github-project-recommender
Wyszukuje i ocenia projekty open source na GitHubie dla dowolnego tematu, sortuje je według czterech kryteriów i tworzy raport TOP N.
- Autor
- Mr-ZHJ ↗
- Repozytorium
- AI-Agent-Skills-Collection ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 26.10.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 4
- Skrypty
- 1
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 26.10.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
- 1 skrypt w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.
Skrypty: scripts/find_repos.py
Co robi i kiedy
Wyszukuje i ocenia projekty open source na GitHubie dla dowolnego tematu, sortuje je według czterech kryteriów i tworzy raport TOP N.
Wyzwalacze z opisu
Oryginalny opis (EN)
定制化 GitHub 开源项目发现与推荐。给定任意主题(如 "LLM推理优化"、"红队工具"、"反诈短信治理"),通过 GitHub 官方 Search API 多路抓取相关项目,按四维透明评分(主题相关度/热度/活跃度/成熟度)排序,生成带推荐理由与行动建议的 TOP N 报告。Use when 用户想"找/推荐/调研某主题的 GitHub 开源项目"、"有没有好用的 XX 开源工具"、"帮我找 XX 领域的仓库"、"追踪 XX 主题的新项目"。支持匿名访问(配额受限自动降级)与可选 GITHUB_TOKEN 增强;零第三方依赖,脚本可无交互运行,兼容定时巡查。
Jak działa
- Step 1 主题解析与搜索词扩展
- Step 2 运行脚本
- Step 3 结果复核与定制化加工
- Step 4 生成推荐报告
- 异常处理速查
- 定时巡查复用
- References 按需加载
Podgląd SKILL.md
--- name: github-project-recommender description: 定制化 GitHub 开源项目发现与推荐。给定任意主题(如 "LLM推理优化"、"红队工具"、"反诈短信治理"),通过 GitHub 官方 Search API 多路抓取相关项目,按四维透明评分(主题相关度/热度/活跃度/成熟度)排序,生成带推荐理由与行动建议的 TOP N 报告。Use when 用户想"找/推荐/调研某主题的 GitHub 开源项目"、"有没有好用的 XX 开源工具"、"帮我找 XX 领域的仓库"、"追踪 XX 主题的新项目"。支持匿名访问(配额受限自动降级)与可选 GITHUB_TOKEN 增强;零第三方依赖,脚本可无交互运行,兼容定时巡查。 name_cn: github项目定制化推荐 description_cn: 选定感兴趣的主题,自动抓取 GitHub 相关开源项目,按相关度、热度、活跃度、成熟度四维评分排序,生成带推荐理由的定制化推荐报告。 --- # GitHub 项目定制化推荐 数据流:`用户主题 → 搜索词扩展 → find_repos.py 多路抓取+评分(JSON) → Agent 复核定制 → 推荐报告(落盘+展示)` ## Step 1 主题解析与搜索词扩展 把用户主题转成 **1-3 个核心搜索词**(GitHub 搜索多词为 AND 语义,词越多越严): - **第一个词必须是主题最核心词**——多词组合 0 命中时脚本将自动降级为仅保留它重试。 - **中文主题优先译为英文**(GitHub 英文生态为主;中文词仅作补充——README 中文内容可被搜索索引)。 - 模糊或复合主题(含多个不相关子方向)先向用户确认聚焦点,或拆成两次运行。 | 用户主题 | --topic 取值 | 说明 | |---|---|---| | "LLM推理优化" | `"llm, inference"` | 2 词足够,第 3 词易导致 0 命中 | | "反诈短信治理" | `"anti-fraud, sms"` | 中文译英文核心词 | | "红队工具" | `"red team, security"` | 复合概念取主干词 | | "找几个新出的 Agent 框架" | `"agent, framework"` + `--preset fresh` | "新出"映射 fresh 预设 | 用户偏好到参数的映射:求新→`--preset fresh`;求稳/生产可用→`--preset stable`;默认→balanced;指定语言→`--lang python`;只要近期活跃→`--pushed-within 90`。 ## Step 2 运行脚本 ```bash python <skill_dir>/scripts/find_repos.py --topic "llm, inference" --top 10 --out <工作目录>/reports/result.json ``` | 参数 | 默认 | 说明 | |---|---|---| | `--topic` | 必填 | 逗号分隔 1-3 个核心词 | | `--top` | 10 | 最终推荐数量 | | `--limit` | 30 | 每路抓取候选数(上限 100) | | `--preset` | balanced | balanced / fresh / stable 三档权重 | | `--lang` | 无 | 主语言过滤,如 python | | `--min-stars` | 0 | 最低 star 数 | | `--pushed-within` | 0 | 仅保留最近 N 天有推送的项目 | | `--keep-archived` | 关 | 默认剔除已归档项目 | | `--out` | stdout | JSON 落盘路径(utf-8 无 BOM) | | `--token` | 环境变量 | GitHub Token,缺省读 `GITHUB_TOKEN` | - stdout 输出纯净 JSON,进度日志走 stderr;进度日志可忽略,以 stdout JSON 为准。 - 匿名模式 3 路检索(最佳匹配/经典高星/近期活跃);有 Token 时自动增加第 4 路 topic 精确检索。 - Token 仅需 public repo 只读权限,无需任何写权限。 ## Step 3 结果复核与定制化加工 解析 JSON 后**必须**: 1. **如实转达 `meta.warnings` 与 `meta.degraded`**——降词重试、限流降级都要向用户说明,不得隐瞒结果完整性受限。 2. **相关度复核**:`description` 与主题明显不符的评分假阳性项目,报告中标注"弱相关"并后置或剔除。 3. **定制联结点**:结合用户背景(长期记忆中的职业/学习方向)为每个推荐项目标注"与你场景的联结点";无相关背景时省略此栏。 4. **数字纪律**:stars、分数、天数必须引用 JSON 原值,禁止估算或四舍五入失真。 5. **措辞规范**:引用项目描述数据涉及地区表述时,按"中国台湾/中国香港/中国澳门"规范转写。 ## Step 4 生成推荐报告 报告结构(Markdown): ```markdown # GitHub 项目推荐:<主题> > 检索策略:<关键词> | 预设:<preset> | 候选池 <candidates> 个 | <正常/降级说明> ## TOP <N> 推荐 ### 1. [owner/repo](url) ⭐ <stars> | <language> | <license> <一句人话简介> - **评分 <score>**:相关度 x + 热度 x + 活跃度 x(<N> 天前有推送)+ 成熟度 x - **推荐理由**:<基于评分分解与项目特点的 1-2 句说明> - **与你场景的联结点**:<结合用户背景> - **行动建议**:<clone / 深读 README / 学习路径 / 评估引入> ## 附:检索统计 配额消耗 <requests_used> 次 | 剩余额度 <rate_limit_remaining> | 生成时间 <generated_at> ``` - **双落盘**:报告存 `<工作目录>/reports/github推荐_<主题slug>_<YYYYMMDD_HHMM>.md`,脚本原始 JSON 存同名 `.json`,便于跨会话复用与增量对比。 - 报告全文在对话中同步展示;结尾提供跟进选项(深挖某项目 / 换词重找 / 调整预设)。 ## 异常处理速查 | 情形 | 处理 | |---|---| | 退出码 2(配额耗尽无结果) | 告知用户匿名配额约 60 分钟恢复;建议配置 `GITHUB_TOKEN`(见 references/github-api.md)或稍后再试 | | `degraded=true` | 如实说明部分路线未完成、结果完整性受限 | | 全部 0 命中 | 换更泛的词(减少词数或换上位词)重跑一次 | | 弱相关结果偏多 | 换更精确的词组合重跑 | ## 定时巡查复用 脚本可无交互运行,配合 scheduler 技能实现周期巡查(如每周自动找某主题新项目): 1. 定时任务执行 `python <skill_dir>/scripts/find_repos.py --topic "..." --out <路径>/weekly-<主题>.json` 2. 新 JSON 与历史 JSON 对比(字段已兼容历史数据重算),生成增量推荐(新上榜 / 排名变化 / 星级增长) 3. 巡查发现重大项目变化时在报告中突出提示 ## References 按需加载 - **评分规则或调权**:用户问"为什么它排第一"、需要解释或调整评分模型时 → 读 [references/scoring.md](references/scoring.md) - **配额/Token/语法细节**:配额排查、Token 配置、qualifier 语法、限流原理时 → 读 [references/github-api.md](references/github-api.md)
Pliki w paczce (4)
- SKILL.md 6 KB
- references/github-api.md 4 KB
- references/scoring.md 3 KB
- scripts/find_repos.py 18 KB
Wersje
W bazie nie ma innych skilli o nazwie github-project-recommender.
Migawka bazy z 13.11.2026 · wersja paczki 1d732a472f82 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100github-repo-search
Wyszukuje i filtruje projekty open source na GitHubie i tworzy uporządkowany raport z rekomendacjami. - 100status-code-recommender
Rekomenduje kody statusu HTTP w ramach automatycznie aktywowanej kategorii API Development, reagując na frazy związane z rekomendacją kodów statusu. - 90github
Czyta i zarządza repozytoriami, issues, pull requestami i wyszukuje kod w GitHubie przez REST API. - 100laravel-recommender
Wdraża silnik rekomendacji w aplikacji Laravel: tabele interakcji, podpowiedzi dla użytkownika, wagi i panel recommender. - 100chart-type-recommender
Prawdopodobnie rekomenduje odpowiedni typ wykresu do podanych danych w pracy z analityką danych. - 100github
Klonuje i wypycha repozytoria GitHub przez git i obsługuje issues, pull requests oraz pliki przez API, dla dowolnego zadania.