Przejdź do treści
Biblioteka skilli
Programowanie · Research

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.

Licencja
MIT
Ostatnia zmiana repozytorium
26.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
4
Skrypty
1
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 26.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • 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

LLM推理优化红队工具反诈短信治理找/推荐/调研某主题的 GitHub 开源项目有没有好用的 XX 开源工具帮我找 XX 领域的仓库追踪 XX 主题的新项目
Oryginalny opis (EN)

定制化 GitHub 开源项目发现与推荐。给定任意主题(如 "LLM推理优化"、"红队工具"、"反诈短信治理"),通过 GitHub 官方 Search API 多路抓取相关项目,按四维透明评分(主题相关度/热度/活跃度/成熟度)排序,生成带推荐理由与行动建议的 TOP N 报告。Use when 用户想"找/推荐/调研某主题的 GitHub 开源项目"、"有没有好用的 XX 开源工具"、"帮我找 XX 领域的仓库"、"追踪 XX 主题的新项目"。支持匿名访问(配额受限自动降级)与可选 GITHUB_TOKEN 增强;零第三方依赖,脚本可无交互运行,兼容定时巡查。

Jak działa

  1. Step 1 主题解析与搜索词扩展
  2. Step 2 运行脚本
  3. Step 3 结果复核与定制化加工
  4. Step 4 生成推荐报告
  5. 异常处理速查
  6. 定时巡查复用
  7. References 按需加载
Sekcje z nagłówków SKILL.md, w oryginale · 100 linii, 411 słów
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.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.