GitHub-Assistant-Skill — GitHub-助手-技能

GitHub 助手

🌐 默认输出语言：中文 除非用户明确要求使用其他语言，所有回复、Trending 展示、搜索结果、操作反馈均使用中文。 项目描述、贡献者用户名、仓库名等原始英文内容保持不变。

通过 GitHub REST API + Playwright 浏览器双模式，提供 GitHub Trending、搜索、仓库操作、Issues/PR管理、代码内容获取等完整能力。

能力概览 Trending 查询 — 查看每日/每周/每月热门项目 项目搜索 — 搜索仓库、查看详情 仓库操作 — Star/Unstar/Fork/Watch/Unwatch、创建仓库、列出Forks Issues 管理 — 创建、列出、关闭、重新打开、评论、标签管理、锁定 Pull 请求s — 创建、列出、关闭、合并、审查、评论、请求审查者 代码内容 — 获取文件、目录、README、创建/更新文件 分支管理 — 列出、创建、删除分支 Releases 管理 — 列出、创建、更新、删除 Release Actions 操作 — 列出工作流、触发/取消/重新运行工作流 用户操作 — 获取用户信息、列出仓库、关注/取消关注 通知管理 — 列出通知、标记已读 组织操作 — 列出组织、获取组织信息、列出成员 评论管理 — Issue/PR 评论 账户管理 — 登录/登出/状态检查 Onboarding（首次使用必读） 环境准备 cd <技能-dir>/scripts pip 安装 -r requirements.txt

安装浏览器引擎（仅浏览器模式需要）

方式1：智能安装脚本（推荐） python3 安装_browser.py

脚本功能：

✅ 自动检测前10秒下载进度 ✅ 无进度时提示选择国内镜像源 ✅ 自动验证浏览器安装状态 ✅ 支持淘宝/清华/华为云镜像 方式2：默认安装 python3 -m playwright 安装 chromium

方式3：使用国内镜像源（下载失败时使用）

Playwright 支持通过环境变量 PLAYWRIGHT_下载_HOST 设置浏览器下载镜像源。

Mac/Linux:

# 使用淘宝镜像（推荐） PLAYWRIGHT_下载_HOST=https://npmmirror.com/mirrors/playwright python3 -m playwright 安装 chromium

# 或使用清华大学镜像 PLAYWRIGHT_下载_HOST=https://mirrors.tuna.tsinghua.edu.cn/playwright python3 -m playwright 安装 chromium

Windows (PowerShell):

$env:PLAYWRIGHT_下载_HOST="https://npmmirror.com/mirrors/playwright" python -m playwright 安装 chromium

Windows (CMD):

设置 PLAYWRIGHT_下载_HOST=https://npmmirror.com/mirrors/playwright python -m playwright 安装 chromium

常用镜像源：

淘宝：https://npmmirror.com/mirrors/playwright 清华：https://mirrors.tuna.tsinghua.edu.cn/playwright 华为云：https://mirrors.huaweicloud.com/playwright 登录 GitHub（二选一） 方式A：浏览器手动登录（推荐）

告诉用户："我来帮你打开浏览器登录 GitHub，请在弹出的窗口中手动输入账号密码完成登录。"

执行步骤：

运行 python3 github_记录in.py browser 等待用户在浏览器中完成登录 登录成功后会自动保存 会话

注意：浏览器模式仅用于 Trending 页面抓取。API操作（Star/Fork/Watch）仍需 令牌。

方式B：令牌 登录（支持全部操作）

支持两种 令牌 类型：Fine-grAIned PAT（推荐）或 Classic PAT

选项 1：Fine-grAIned Personal 访问 令牌（推荐）

更安全的权限控制，可为每个仓库单独配置权限。

打开设置页面

访问 https://github.com/设置tings/令牌s?type=beta 或 GitHub → 设置tings → Developer 设置tings → Personal 访问 令牌s → Fine-grAIned 令牌s

生成新 令牌

点击 "生成 new 令牌" 输入 令牌 名称（如：GitHub-助手-技能） 设置过期时间（建议 90 天或更长） 描述：用于 GitHub 助手 技能 的完整操作

配置权限（重要！）

仓库 权限s（仓库权限）- 全部设置为 Read and Write：

权限 用途 Actions 读取工作流运行状态 Administration 读取仓库管理信息 检查s 读取检查运行状态 Commit 状态es 读取提交状态 Contents 读取/创建/更新/删除文件 Dependa机器人 alerts 读取安全警报 部署ments 读取部署信息 Discussions 读取/创建讨论（如需要） 环境s 读取环境信息 Issues 读取/创建/更新/关闭 Issues Metadata 读取基础仓库信息（必需） Packages 读取包信息 Pages 读取 GitHub Pages 信息 Pull 请求s 读取/合并/审查 PR 仓库 security advisories 读取安全公告 Secret 扫描ning alerts 读取密钥扫描警报 工作流s 读取工作流

Account 权限s（账户权限）：

保持默认即可

选择仓库访问范围

All repositories - 访问所有仓库（推荐） Only select repositories - 仅访问指定仓库

生成并保存 令牌

点击 "生成 令牌" ⚠️ 立即复制 令牌（页面关闭后无法再次查看） 运行 python3 github_记录in.py 令牌 <令牌> 验证成功后 令牌 会被安全存储到本地

选项 2：Classic Personal 访问 令牌

传统的 令牌 类型，使用 scopes 权限模型。

打开设置页面

访问 https://github.com/设置tings/令牌s 或 GitHub → 设置tings → Developer 设置tings → Personal 访问 令牌s → 令牌s (classic)

生成新 令牌

点击 "生成 new 令牌 (classic)" 输入 令牌 名称（如：GitHub-助手-技能） 设置过期时间（建议 90 天或更长）

选择 Scopes（权限范围）

必需 Scopes：

Scope 用途 repo 完全控制私有仓库（包含所有仓库操作） public_repo 访问公共仓库

推荐 Scopes（根据需要使用）：

Scope 用途 工作流 更新 GitHub Actions 工作流文件 read:org 读取组织成员信息 read:user 读取用户资料信息 read:discussion 读取团队讨论

生成并保存 令牌

点击 "生成 令牌" ⚠️ 立即复制 令牌（页面关闭后无法再次查看） 运行 python3 github_记录in.py 令牌 <令牌> 验证成功后 令牌 会被安全存储到本地

令牌 类型对比：

特性 Fine-grAIned PAT Classic PAT 权限粒度 按仓库、按权限细粒度控制 全局 scopes 安全性 更高，可限制访问范围 较低，全局权限 组织仓库 需要组织管理员批准 直接可用 推荐度 ⭐⭐⭐⭐⭐ ⭐⭐⭐ 适用场景 生产环境、团队协作 个人使用、快速测试 验证登录状态

运行 python3 github_记录in.py 检查 查看当前登录状态。

功能指令映射

• 查看 Trending（核心功能）

触发词: trending、热门、排行榜、最火

参数 值 since dAIly（默认）/ weekly / monthly language python / javascript / go / rust 等（可选）

代理 执行流程：

⚠️ 必须使用浏览器模式 以获取完整数据（含贡献者和期间Star数）。 API 模式仅作为 fallback，不包含 built_by 和 period_stars。

# 浏览器模式（推荐，自动滚动获取所有项目） python3 github_trending.py dAIly "" browser # 今日所有Trending项目 python3 github_trending.py weekly python browser # 本周Python所有Trending项目 python3 github_trending.py monthly "" browser # 本月所有Trending项目

💡 自动加载所有项目：脚本会自动滚动页面，加载 当日/当周/当月的所有 Trending 项目（不仅仅是首页显示的），直到没有新项目加载为止。

⭐ Trending 输出格式规范（⚠️ 必须严格遵守）

🔴 重要：所有 Trending 输出必须严格遵循以下格式模板，不得自行创造其他格式。 这是本 技能 的标准输出规范，确保一致性和可读性。

默认行为：代理 在输出 Trending 项目时，必须严格按照下方「标准输出模板」的格式输出，包括：

标题格式和日期 热榜概览结构 每个仓库的详解格式（含深度解读） 今日洞察部分

除非用户明确提出了额外的格式要求或特殊指令，否则必须完全按照模板输出，不得：

省略任何部分 更改输出格式 使用 Markdown 表格（IM 聊天平台禁止使用） 简化或合并内容

新模板结构：

标题 — 带日期和表情符号 热榜概览 — 统计数据和亮点总结 仓库详解 — 每个仓库的详细分析（含深度解读） 今日洞察 — 核心主题、趋势信号、实用推荐

标准输出模板（IM聊天平台，不使用Markdown表格）：

🔥 GitHub 今日 Trending (2026-04-02)

📊 今日热榜概览 • 总上榜仓库数：8个 • 最大热点：anthropics/claude-code 正式发布，单日 +8,764 ⭐ 爆棚！ • AI 编程 代理 双雄：Claude Code + OpenAI Codex 同日霸榜 • 热门语言：Python 领跑（5/8），Shell/Rust/JavaScript 跟进 • 数据来源：GitHub Trending 页面（browser 模式）

━━━━━━━━━━━━━━━━━━━━━━━━━