# Github Weekly Trending

解读用户粘贴的 GitHub 每周 Trending 或开源项目榜单内容，基于用户提供的候选项目、项目 README、GitHub 项目页和 DeepWiki...

- Repository: https://github.com/digoal/blog (8605 stars)
- Category: Git and review
- License: GPL-2.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add digoal/blog --skill github-weekly-trending -g -a claude-code -y`
Codex: `npx skills add digoal/blog --skill github-weekly-trending -g -a codex -y`
Cursor: `npx skills add digoal/blog --skill github-weekly-trending -g -a cursor -y`
Gemini CLI: `npx skills add digoal/blog --skill github-weekly-trending -g -a gemini-cli -y`

## Description

解读用户粘贴的 GitHub 每周 Trending 或开源项目榜单内容，基于用户提供的候选项目、项目 README、GitHub 项目页和 DeepWiki 生成适合公众号发布的 Markdown 文章，并输出到当前项目 markdown 目录。用于 GitHub 周榜解读、每周开源热点、热门开源项目分析、公众号开源项目推荐。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# GitHub 每周热门项目解读

## 目标

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

工作流：

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

## 触发条件

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

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

## 数据来源优先级

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

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

## 输出文件

默认输出 Markdown 文件：

```text
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 只有愿景、缺少可验证功能的项目
- 主要信息来自营销页面而非代码或文档的项目

The rest: https://github.com/digoal/blog/blob/HEAD/skills/github-weekly-trending/SKILL.md