GitHub 每周热门项目解读

目标

读取用户粘贴的 GitHub Trending 周榜或开源项目榜单内容，筛选值得关注的开源项目，先建立可验证的项目事实卡，再生成适合公众号发布的中文 Markdown 文章。

工作流：

用户粘贴榜单内容 -> README / GitHub 项目页 -> DeepWiki -> 项目事实卡 -> 公众号文章 -> 当前项目 markdown 目录 -> 事实校验

触发条件

用户询问以下内容时使用本技能：

• GitHub 每周热门项目
• GitHub Trending 周榜解读
• 每周开源热点分析
• 热门开源项目介绍
• 公众号开源项目推荐文章
• 本周值得关注的开源项目

数据来源优先级

来源	用途	可靠性要求
用户粘贴的榜单内容	获取候选项目、语言、本周热度、简介、用户关注点	必须记录用户提供内容的时间和可解析字段
GitHub 仓库页	stars、license、默认分支、release、issue、贡献活跃度	以页面当前展示为准
README / 官方文档	项目定位、核心能力、安装方式、官方示例	项目功能事实的主要来源
DeepWiki MCP	架构、代码组织、模块关系、实现机制	用于辅助理解，不单独作为商业采用或性能结论来源
官方博客 / 官方案例 / release note	采用案例、路线图、重要变更	有明确链接才可引用

禁止把未验证信息写成事实。尤其不要编造公司采用案例、benchmark 结果、创始团队动机、融资信息、客户信息、性能优劣。

输出文件

默认输出 Markdown 文件：

markdown/github-weekly-trending-YYYY-WW.md

其中 YYYY 为年份，WW 为 ISO 周数，例如 2026-W15。

在当前项目根目录下创建或复用 markdown/ 目录。如用户指定路径或文件名，按用户要求执行。

操作步骤

Step 1 - 解析用户粘贴的榜单内容

不要主动访问 https://github.com/trending?since=weekly&spoken_language_code= 获取榜单。以用户粘贴的内容作为候选项目输入。

内部记录：

• 处理时间和时区
• 输入来源、原始 URL、榜单类型、语言过滤或日期等来源元数据只用于事实校验，不写入最终文章，除非用户明确要求展示
• 若来源元数据缺失，只在内部事实卡中记为未知；最终文章不要写“用户未提供”等过程性表述

从用户粘贴内容中解析候选项目：

• 项目名称：owner/repo
• 项目简介
• 主要语言
• 当前 stars
• 用户粘贴内容中展示的本周新增 stars 或热度指标
• 仓库地址

当用户只提供 owner/repo 或类似 owner / repo 的项目名时，自动补齐：

• 标准项目名：去掉 / 两侧空格，规范为 owner/repo
• GitHub 仓库地址：https://github.com/owner/repo
• DeepWiki MCP repoName 参数：使用同一个标准项目名 owner/repo

示例：用户提供 microsoft / markitdown 时，记录项目名为 microsoft/markitdown，仓库地址为 https://github.com/microsoft/markitdown，并在 DeepWiki MCP 中使用 repoName: "microsoft/markitdown"。

注意：“本周新增 stars”或热度指标以用户粘贴内容为准，不等同于完整历史审计数据。

如果用户粘贴内容无法解析出足够候选项目，先向用户请求补充榜单内容。不要自行抓取 GitHub Trending 页面替代用户输入。

Step 2 - 筛选项目

默认选择 3 个主项目深度解读。用户指定数量时按用户要求执行。

优先选择：

• 周榜排名靠前
• 用户粘贴内容中本周新增 stars 或热度指标明显
• README 和文档信息充分
• 有清晰使用场景
• 对中文开发者或中国技术社区有参考价值

谨慎选择：

• 刚初始化、代码和文档很少的项目
• 没有 license 的项目
• README 只有愿景、缺少可验证功能的项目
• 主要信息来自营销页面而非代码或文档的项目