GitHub Trending 周报生成器

问题背景

很多团队靠手动刷 GitHub Trending 做技术选型或竞品扫盘：信息分散、难以按语言归档，也不方便把同一套数据交给脚本或 CI 下游消费。Trending 页本身也不提供 star 增长曲线或历史库表，你需要的往往是「某一时间窗口 + 某一语言」下的 Top 仓库清单，并落成可 diff、可归档的文本格式。

工作方式

本技能对应一套以 run.py 为入口的命令行流程：抓取 Trending 页面 HTML，解析仓库名、描述、语言、stars 等字段，再按参数组合输出结果。

• 时间维度：--since daily|weekly|monthly 对齐 Trending 的日/周/月视图。
• 语言过滤：--language python（以及 js、rust 等）只保留目标栈条目。
• 输出形态：--format md|csv|json；Markdown 适合人读周报，JSON/CSV 适合自动化。
• 输出位置与预览：--output 指定目录；--dry-run 只打印将写入的路径与条数摘要，不写盘。
• 稳健性：默认约 1 小时本地缓存，可用 --no-cache 强制刷新；--verbose 便于排查网络或解析问题；--selftest 跑通抓取与断言。

未安装第三方库时会降级到 urllib 与 html.parser，核心抓取链路仍可运行。可通过环境变量调整 GITHUB_TRENDING_URL、SKILL_OUTPUT_DIR、SKILL_CACHE_DIR。

适用边界

• 适合：定期生成周报、按语言做趋势快照、把 JSON 丢进 CI 产物目录供后续分析。
• 不适合：精确 star 时序、私有仓库、需登录的 API 能力、PDF/PPT，以及贡献者/代码质量/许可证合规等深度分析。
• 常见故障：E_NETWORK 多为网络或访问受限；E_PARSE 多为页面结构变化；空文件通常是窗口内无数据或需 --no-cache 重试。