🎁 Get the FREE AI Skills Starter Guide — Subscribe →
BytesAgainBytesAgain
🦀 ClawHub

GitHub-Assistant-Skill

by @leonforcode

GitHub Trending查看、项目搜索、Star/Fork/Watch操作、Issues管理、Pull Request操作、代码内容获取、评论管理等完整助手。当用户需要查看GitHub Trending排行榜、搜索GitHub项目、对仓库进行操作、管理Issues/PR、获取代码内容时使用此技能。

Versionv1.0.0
Downloads710
TERMINAL
clawhub install github-assistant-skill

📖 About This Skill


name: github-assistant description: GitHub Trending查看、项目搜索、Star/Fork/Watch操作、Issues管理、Pull Request操作、代码内容获取、评论管理等完整助手。当用户需要查看GitHub Trending排行榜、搜索GitHub项目、对仓库进行操作、管理Issues/PR、获取代码内容时使用此技能。 license: MIT

GitHub Assistant

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

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

能力概览

1. Trending 查询 — 查看每日/每周/每月热门项目 2. 项目搜索 — 搜索仓库、查看详情 3. 仓库操作 — Star/Unstar/Fork/Watch/Unwatch、创建仓库、列出Forks 4. Issues 管理 — 创建、列出、关闭、重新打开、评论、标签管理、锁定 5. Pull Requests — 创建、列出、关闭、合并、审查、评论、请求审查者 6. 代码内容 — 获取文件、目录、README、创建/更新文件 7. 分支管理 — 列出、创建、删除分支 8. Releases 管理 — 列出、创建、更新、删除 Release 9. Actions 操作 — 列出工作流、触发/取消/重新运行工作流 10. 用户操作 — 获取用户信息、列出仓库、关注/取消关注 11. 通知管理 — 列出通知、标记已读 12. 组织操作 — 列出组织、获取组织信息、列出成员 13. 评论管理 — Issue/PR 评论 14. 账户管理 — 登录/登出/状态检查


Onboarding(首次使用必读)

环境准备

cd /scripts
pip install -r requirements.txt

安装浏览器引擎(仅浏览器模式需要)

#### 方式1:智能安装脚本(推荐)

python3 install_browser.py

脚本功能:

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

    python3 -m playwright install chromium
    

    #### 方式3:使用国内镜像源(下载失败时使用)

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

    Mac/Linux:

    # 使用淘宝镜像(推荐)
    PLAYWRIGHT_DOWNLOAD_HOST=https://npmmirror.com/mirrors/playwright python3 -m playwright install chromium

    或使用清华大学镜像

    PLAYWRIGHT_DOWNLOAD_HOST=https://mirrors.tuna.tsinghua.edu.cn/playwright python3 -m playwright install chromium

    Windows (PowerShell):

    $env:PLAYWRIGHT_DOWNLOAD_HOST="https://npmmirror.com/mirrors/playwright"
    python -m playwright install chromium
    

    Windows (CMD):

    set PLAYWRIGHT_DOWNLOAD_HOST=https://npmmirror.com/mirrors/playwright
    python -m playwright install chromium
    

    常用镜像源:

  • 淘宝:https://npmmirror.com/mirrors/playwright
  • 清华:https://mirrors.tuna.tsinghua.edu.cn/playwright
  • 华为云:https://mirrors.huaweicloud.com/playwright
  • 登录 GitHub(二选一)

    #### 方式A:浏览器手动登录(推荐)

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

    执行步骤: 1. 运行 python3 github_login.py browser 2. 等待用户在浏览器中完成登录 3. 登录成功后会自动保存 session

    > 注意:浏览器模式仅用于 Trending 页面抓取。API操作(Star/Fork/Watch)仍需 Token。

    #### 方式B:Token 登录(支持全部操作)

    支持两种 Token 类型:Fine-grained PAT(推荐)或 Classic PAT


    选项 1:Fine-grained Personal Access Token(推荐)

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

    1. 打开设置页面 - 访问 https://github.com/settings/tokens?type=beta - 或 GitHub → Settings → Developer settings → Personal access tokens → Fine-grained tokens

    2. 生成新 Token - 点击 "Generate new token" - 输入 Token 名称(如:GitHub-Assistant-Skill) - 设置过期时间(建议 90 天或更长) - 描述:用于 GitHub Assistant Skill 的完整操作

    3. 配置权限(重要!)

    Repository permissions(仓库权限)- 全部设置为 Read and Write: | 权限 | 用途 | |------|------| | Actions | 读取工作流运行状态 | | Administration | 读取仓库管理信息 | | Checks | 读取检查运行状态 | | Commit statuses | 读取提交状态 | | Contents | 读取/创建/更新/删除文件 | | Dependabot alerts | 读取安全警报 | | Deployments | 读取部署信息 | | Discussions | 读取/创建讨论(如需要) | | Environments | 读取环境信息 | | Issues | 读取/创建/更新/关闭 Issues | | Metadata | 读取基础仓库信息(必需)| | Packages | 读取包信息 | | Pages | 读取 GitHub Pages 信息 | | Pull requests | 读取/合并/审查 PR | | Repository security advisories | 读取安全公告 | | Secret scanning alerts | 读取密钥扫描警报 | | Workflows | 读取工作流 |

    Account permissions(账户权限): - 保持默认即可

    4. 选择仓库访问范围 - All repositories - 访问所有仓库(推荐) - Only select repositories - 仅访问指定仓库

    5. 生成并保存 Token - 点击 "Generate token" - ⚠️ 立即复制 Token(页面关闭后无法再次查看) - 运行 python3 github_login.py token - 验证成功后 Token 会被安全存储到本地


    选项 2:Classic Personal Access Token

    传统的 Token 类型,使用 scopes 权限模型。

    1. 打开设置页面 - 访问 https://github.com/settings/tokens - 或 GitHub → Settings → Developer settings → Personal access tokens → Tokens (classic)

    2. 生成新 Token - 点击 "Generate new token (classic)" - 输入 Token 名称(如:GitHub-Assistant-Skill) - 设置过期时间(建议 90 天或更长)

    3. 选择 Scopes(权限范围)

    必需 Scopes: | Scope | 用途 | |-------|------| | repo | 完全控制私有仓库(包含所有仓库操作)| | public_repo | 访问公共仓库 | 推荐 Scopes(根据需要使用): | Scope | 用途 | |-------|------| | workflow | 更新 GitHub Actions 工作流文件 | | read:org | 读取组织成员信息 | | read:user | 读取用户资料信息 | | read:discussion | 读取团队讨论 |

    4. 生成并保存 Token - 点击 "Generate token" - ⚠️ 立即复制 Token(页面关闭后无法再次查看) - 运行 python3 github_login.py token - 验证成功后 Token 会被安全存储到本地


    Token 类型对比:

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

    验证登录状态

    运行 python3 github_login.py check 查看当前登录状态。


    功能指令映射

    1. 查看 Trending(核心功能)

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

    | 参数 | 值 | |------|-----| | since | daily(默认)/ weekly / monthly | | language | python / javascript / go / rust 等(可选)|

    Agent 执行流程:

    > ⚠️ 必须使用浏览器模式 以获取完整数据(含贡献者和期间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 输出必须严格遵循以下格式模板,不得自行创造其他格式。 > 这是本 Skill 的标准输出规范,确保一致性和可读性。 > > 默认行为:Agent 在输出 Trending 项目时,必须严格按照下方「标准输出模板」的格式输出,包括: > - 标题格式和日期 > - 热榜概览结构 > - 每个仓库的详解格式(含深度解读) > - 今日洞察部分 > > 除非用户明确提出了额外的格式要求或特殊指令,否则必须完全按照模板输出,不得: > - 省略任何部分 > - 更改输出格式 > - 使用 Markdown 表格(IM 聊天平台禁止使用) > - 简化或合并内容

    新模板结构: 1. 标题 — 带日期和表情符号 2. 热榜概览 — 统计数据和亮点总结 3. 仓库详解 — 每个仓库的详细分析(含深度解读) 4. 今日洞察 — 核心主题、趋势信号、实用推荐

    标准输出模板(IM聊天平台,不使用Markdown表格):

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

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

    ━━━━━━━━━━━━━━━━━━━━━━━━━ 🏆 Trending 仓库详解 ━━━━━━━━━━━━━━━━━━━━━━━━━

    1. anthropics/claude-code ⭐ 105,566 ⭐ Stars: 105,566 | 🍴 Forks: 16,781 | 💻 语言: Shell | 📅 今日上榜 🔗 项目链接: https://github.com/anthropics/claude-code 📝 项目简介: 一款运行在终端中的智能编程工具,能理解你的代码库,通过自然语言命令帮你更快写代码——执行常规任务、解释复杂代码、处理 Git 工作流。 🔍 深度解读: • 项目定位:Anthropic 官方推出的 AI 编程 Agent 终端工具,Claude Code 正式开源仓库 • 核心功能:终端内 AI 编程助手,代码理解、自动修改、Git 操作全自然语言驱动 • 为何火爆:Claude Code 此前为闭源工具,社区高度关注。今日 +8,764 星标创近期绝对记录,表明开发者对官方开源的热情极高 • 适用场景:所有日常编程开发工作,尤其是需要频繁操作 Git 和代码审查的场景 • 推荐指数:⭐⭐⭐⭐⭐(今日无可争议的第一名)

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

    2. openai/codex ⭐ 72,448 ⭐ Stars: 72,448 | 🍴 Forks: 10,140 | 💻 语言: Rust | 📅 今日上榜 🔗 项目链接: https://github.com/openai/codex 📝 项目简介: 一款运行在终端中的轻量级编程 Agent。 🔍 深度解读: • 项目定位:OpenAI 官方的终端编程 Agent,Claude Code 的直接竞争对手 • 核心功能:用 Rust 编写的高性能终端 AI 助手,聚焦轻量和速度 • 为何火爆:与 Claude Code 同日上榜,AI 编程 Agent 赛道竞争白热化的标志 • 适用场景:偏好 OpenAI 生态、追求极致性能的终端编程开发者 • 推荐指数:⭐⭐⭐⭐⭐

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

    3. microsoft/VibeVoice ⭐ 34,994 ⭐ Stars: 34,994 | 🍴 Forks: 3,977 | 💻 语言: Python | 📅 今日上榜 🔗 项目链接: https://github.com/microsoft/VibeVoice 📝 项目简介: 微软开源的前沿语音 AI 项目。 🔍 深度解读: • 项目定位:微软出品的开源语音 AI 框架,持续霸榜多日 • 核心功能:前沿语音合成、语音识别能力,面向研究者和开发者 • 为何火爆:微软品牌背书 + 语音 AI 赛道持续升温,连续多日上榜说明热度不减 • 适用场景:语音助手开发、语音 AI 研究、多模态应用 • 推荐指数:⭐⭐⭐⭐

    ━━━━━━━━━━━━━━━━━━━━━━━━━ 💡 今日洞察 🎯 核心主题:AI 编程 Agent 正式进入「双雄时代」 今日 Trending 最大看点是 anthropics/claude-code 和 openai/codex 首次同日上榜: • Anthropic Claude Code 今日 +8,764 ⭐,创近期单日最高纪录,官方开源引爆社区 • OpenAI Codex 以 +1,416 ⭐ 紧随其后,Rust 实现主打轻量高性能 • 两家 AI 巨头在同一赛道正面交锋,标志着 AI 编程工具从萌芽期进入全面竞争阶段

    📈 三大趋势信号: 1️⃣ AI 编程工具全面开源化:Claude Code 官方仓库今日上榜,加上此前社区的逆向工程和 Python 重写版本,整个生态正在从闭源走向开放 2️⃣ AI 基础模型领域扩展加速:google-research/timesfm 将基础模型从 NLP/CV 扩展到时间序列,预示更多垂直领域基础模型将涌现 3️⃣ 语音 AI 持续火热:microsoft/VibeVoice 连续多日上榜,语音作为 AI 交互的重要入口正在被各大厂商押注

    🔧 实用推荐: • 如果你在用 Claude Code → claude-howto 配套教程值得收藏 • 如果你在做时间序列 → google-research/timesfm 是官方优选 • 如果你在做 OCR → zai-org/GLM-OCR 新晋选手值得关注

    📡 数据来源:GitHub Trending (browser) | 下次推送:2026-04-03 22:00 CST

    关键规则(⚠️ 必须严格遵守): > 🔴 所有输出必须严格遵循上述模板格式,不得使用Markdown表格或其他格式。 > 这是本 Skill 的唯一标准输出规范。

  • 每个项目之间用 ━━━━━━━━━━━━━━━━━━━━━━━━━ 分隔,提升可读性
  • 仓库信息必须包含:名称、链接、描述、语言、Star/Fork、贡献者、新增 Star
  • 每个仓库必须有 🔍 深度解读 部分,包含:
  • - 项目定位(一句话说明这是什么) - 核心功能(技术亮点) - 为何火爆(上榜原因分析) - 适用场景(谁应该用) - 推荐指数(1-5星)
  • 输出末尾必须有 💡 今日洞察 部分,包含:
  • - 🎯 核心主题(今日最大看点) - 📈 趋势信号(2-3个行业趋势) - 🔧 实用推荐(针对不同用户的建议) - 📡 数据来源和下次推送时间
  • 所有标签使用中文
  • since 参数映射:每日→daily、每周→weekly、每月→monthly
  • 输出标题使用中文并带日期
  • 2. 搜索项目

    触发词: 搜索、查找、search

    python3 github_search.py repos "机器学习" 10    # 搜索仓库
    python3 github_search.py repos "stars:>10000 language:python"
    python3 github_search.py users "octocat"         # 搜索用户
    python3 github_search.py info microsoft vscode   # 查看仓库详情
    

    输出格式:

    🔍 搜索结果:「关键词」(共 xxx 个)

    1. owner/repo 🔗 https://github.com/owner/repo 📝 项目描述... 🔤 Python | ⭐ 12,345 | 🍴 1,234 | Updated: 2024-xx-xx

    3. 仓库操作

    触发词: star、fork、watch、unwatch、取消关注

    > ⚠️ 需要 Token 登录 或 浏览器模式登录

    python3 github_operations.py star microsoft/vscode
    python3 github_operations.py unstar owner/repo
    python3 github_operations.py fork owner/repo
    python3 github_operations.py watch owner/repo
    python3 github_operations.py unwatch owner/repo
    python3 github_operations.py info owner/repo      # 获取仓库信息
    python3 github_operations.py starred              # 列出已star的仓库
    

    操作反馈:

    ⭐ 已收藏: microsoft/vscode
    🍴 已克隆: owner/repo → your-username/repo
    👁️ 已关注: owner/repo
    

    4. Issues 管理

    触发词: issue、问题、缺陷、bug

    > ⚠️ 需要 Token 登录,权限:Issues (Read and Write)

    # 列出 Issues
    python3 github_operations.py issues microsoft/vscode open      # open/closed/all
    python3 github_operations.py issue microsoft/vscode 1234       # 获取指定 Issue

    创建 Issue

    python3 github_operations.py create-issue owner/repo "Bug标题" "详细描述"

    关闭/重新打开 Issue

    python3 github_operations.py close-issue owner/repo 1234 python3 github_operations.py reopen-issue owner/repo 1234

    5. Pull Requests 操作

    触发词: pr、pull request、合并请求

    > ⚠️ 需要 Token 登录,权限:Pull requests (Read and Write)

    # 列出 PRs
    python3 github_operations.py prs microsoft/vscode open         # open/closed/all
    python3 github_operations.py pr microsoft/vscode 1234          # 获取指定 PR

    创建 PR

    python3 github_operations.py create-pr owner/repo "PR标题" feature-branch main ["描述"]

    关闭/重新打开 PR

    python3 github_operations.py close-pr owner/repo 1234 python3 github_operations.py reopen-pr owner/repo 1234

    合并 PR

    python3 github_operations.py merge-pr owner/repo 1234 "合并标题"

    审查 PR

    python3 github_operations.py approve-pr owner/repo 1234 "LGTM!"

    PR 详情

    python3 github_operations.py pr-files owner/repo 1234 # 列出修改的文件 python3 github_operations.py pr-commits owner/repo 1234 # 列出提交记录 python3 github_operations.py pr-reviews owner/repo 1234 # 列出审查记录

    6. 代码内容获取

    触发词: 代码、文件、内容、readme

    > ⚠️ 需要 Token 登录,权限:Contents (Read)

    # 获取文件内容
    python3 github_operations.py file owner/repo path/to/file.py [分支/标签]

    获取 README

    python3 github_operations.py readme owner/repo [分支/标签]

    列出目录

    python3 github_operations.py ls owner/repo [path] [分支/标签]

    创建/更新文件(需要 Contents Write 权限)

    python3 github_operations.py create-file owner/repo "path/file.py" "提交信息" "文件内容"

    7. 评论管理

    触发词: 评论、comment

    > ⚠️ 需要 Token 登录,权限:Issues (Write) 或 Pull requests (Write)

    # Issue 评论
    python3 github_operations.py comments owner/repo 1234          # 列出评论
    python3 github_operations.py comment owner/repo 1234 "评论内容"
    

    8. 用户操作

    触发词: 用户、user、followers、关注

    > ⚠️ 需要 Token 登录,部分操作需要 user 权限

    # 获取用户信息
    python3 github_operations.py user              # 当前登录用户
    python3 github_operations.py user torvalds     # 指定用户

    列出用户的仓库

    python3 github_operations.py my-repos owner # 当前用户的仓库 python3 github_operations.py user-repos torvalds # 指定用户的仓库

    粉丝和关注

    python3 github_operations.py followers # 当前用户的粉丝 python3 github_operations.py following # 当前用户关注的人 python3 github_operations.py follow username # 关注用户 python3 github_operations.py unfollow username # 取消关注

    9. 仓库管理

    触发词: 创建仓库、create repo

    > ⚠️ 需要 Token 登录,权限:Contents (Write)

    # 创建新仓库
    python3 github_operations.py create-repo my-new-repo "仓库描述"

    列出仓库的 Forks

    python3 github_operations.py forks owner/repo

    列出 Stargazers

    python3 github_operations.py stargazers owner/repo

    10. 分支管理

    触发词: 分支、branch

    > ⚠️ 需要 Token 登录,创建分支需要 Contents (Write)

    # 列出分支
    python3 github_operations.py branches owner/repo

    获取分支信息

    python3 github_operations.py branch owner/repo main

    创建分支

    python3 github_operations.py create-branch owner/repo new-branch main

    11. Releases 管理

    触发词: release、发布

    > ⚠️ 需要 Token 登录,创建需要 Contents (Write)

    # 列出 Releases
    python3 github_operations.py releases owner/repo

    获取指定 Release

    python3 github_operations.py release owner/repo

    创建 Release

    python3 github_operations.py create-release owner/repo v1.0.0 "Release名称" "发布说明"

    12. Actions 操作

    触发词: workflow、工作流、actions

    > ⚠️ 需要 Token 登录,权限:Actions (Read)、Contents (Read/Write)

    # 列出工作流运行
    python3 github_operations.py workflows owner/repo

    获取指定工作流

    python3 github_operations.py workflow owner/repo

    触发工作流

    python3 github_operations.py trigger-workflow owner/repo ci.yml main

    13. Issue Labels 管理

    触发词: label、标签

    > ⚠️ 需要 Token 登录,权限:Issues (Write)

    # 列出 Issue 标签
    python3 github_operations.py labels owner/repo 1234

    添加标签

    python3 github_operations.py add-labels owner/repo 1234 bug priority

    锁定/解锁 Issue

    python3 github_operations.py lock-issue owner/repo 1234 "off-topic" python3 github_operations.py unlock-issue owner/repo 1234

    14. 通知管理

    触发词: 通知、notification

    > ⚠️ 需要 Token 登录,权限:Notifications

    # 列出通知
    python3 github_operations.py notifications          # 未读通知
    python3 github_operations.py notifications --all    # 所有通知

    仓库通知

    python3 github_operations.py repo-notifications owner/repo

    标记已读

    python3 github_operations.py mark-read

    15. 组织操作

    触发词: 组织、org

    # 列出当前用户的组织
    python3 github_operations.py orgs

    获取组织信息

    python3 github_operations.py org github

    列出组织仓库

    python3 github_operations.py org-repos github

    列出组织成员

    python3 github_operations.py org-members github

    16. 其他操作

    # 查看提交历史
    python3 github_operations.py commits owner/repo [文件路径]

    检查登录状态

    python3 github_operations.py check

    查看 API 限流

    python3 github_operations.py rate-limit

    17. 浏览器自动化操作(API 不支持的功能)

    触发词: 贡献图、insights、流量、网络图、blame、设置页面、探索、marketplace

    > ⚠️ 这些功能 GitHub REST API 不支持,需要通过浏览器自动化实现 > 浏览器操作过程可见,操作结束后浏览器保持打开,用户可继续手动操作

    # 用户相关(API 不支持)
    python3 github_browser_ops.py contributions torvalds    # 查看贡献图
    python3 github_browser_ops.py activity torvalds         # 查看活动时间线
    python3 github_browser_ops.py stars torvalds            # 查看 Star 列表页面
    python3 github_browser_ops.py followers torvalds        # 查看粉丝列表页面
    python3 github_browser_ops.py sponsors torvalds         # 查看赞助页面

    仓库 Insights(需要 push 权限)

    python3 github_browser_ops.py insights owner/repo # Pulse 概览 python3 github_browser_ops.py traffic owner/repo # 流量统计 python3 github_browser_ops.py network owner/repo # Fork 网络图 python3 github_browser_ops.py dependents owner/repo # 依赖者列表

    代码相关

    python3 github_browser_ops.py blame owner/repo path/file.py # Git Blame python3 github_browser_ops.py history owner/repo path/file.py # 文件提交历史 python3 github_browser_ops.py compare owner/repo main dev # 分支比较 python3 github_browser_ops.py codesearch owner/repo "keyword" # 仓库内代码搜索

    设置页面

    python3 github_browser_ops.py settings # 用户设置 python3 github_browser_ops.py settings owner/repo # 仓库设置

    导航

    python3 github_browser_ops.py notifications # 通知页面 python3 github_browser_ops.py explore # Explore 页面 python3 github_browser_ops.py marketplace # Marketplace python3 github_browser_ops.py search "query" # GitHub 搜索 python3 github_browser_ops.py goto "https://..." # 导航到指定 URL

    浏览器控制

    python3 github_browser_ops.py close # 关闭浏览器

    操作反馈:

    🌐 正在导航到: https://github.com/torvalds
       📋 查看用户 @torvalds 的个人资料
    ✅ 页面加载完成: https://github.com/torvalds

    💡 浏览器保持打开,您可以继续手动操作。 浏览器将保持打开状态,您可以继续手动操作。 如需关闭浏览器,请运行: python3 github_browser_ops.py close


    浏览器模式指南(Agent专用)

    当需要使用 Playwright 浏览器(browser_* 工具)时,遵循以下流程:

    Trending 页面数据提取

    URL 格式:

  • 全语言:https://github.com/trending?since={daily|weekly|monthly}
  • 按语言:https://github.com/trending/{language}?since={daily|weekly|monthly}
  • 页面 CSS 选择器映射:

    | 数据项 | 选择器 / 提取方式 | |--------|------------------| | 仓库名 | article h2 a → href 去掉前导 / | | 描述 | article p → innerText | | 语言 | article [itemprop="programmingLanguage"] → innerText | | 总Stars | article a[href*="/stargazers"] → innerText | | Forks | article a[href*="/forks"] → innerText | | 贡献者 | article a 中 textContent 以 @ 开头的链接 | | 期间Stars | 正则匹配 innerText: (\d[\d,]*) stars (today\|this week\|this month) |

    浏览器执行 Star 操作(备选方案)

    1. 导航到 https://github.com/{owner}/{repo}
    2. 找到 "Star" 按钮(已登录状态)
    3. 点击 Star
    4. 确认按钮变为 "Starred"
    

    浏览器执行 Watch 操作(备选方案)

    1. 导航到 https://github.com/{owner}/{repo}
    2. 找到 "Watch" 下拉按钮
    3. 选择 "Custom" → "Issues, Pull Requests" 等
    4. 确认已变为 "Watching"
    


    权限速查表

    | 操作 | 所需权限 | 权限级别 | |------|---------|---------| | Trending 查看 | 无需登录 | - | | 项目搜索 | 无需登录 | - | | Star/Unstar | Token | - | | Fork | Token | - | | Watch/Unwatch | Token | Metadata (Read) | | 查看仓库信息 | Token | Metadata (Read) | | 创建仓库 | Token | Contents (Write) | | 列出 Issues | Token | Issues (Read) | | 创建/关闭 Issue | Token | Issues (Write) | | Issue Labels | Token | Issues (Write) | | 锁定 Issue | Token | Issues (Write) | | 列出 PRs | Token | Pull requests (Read) | | 创建/关闭 PR | Token | Pull requests (Write) | | 合并 PR | Token | Pull requests (Write) | | PR 审查 | Token | Pull requests (Write) | | 获取文件内容 | Token | Contents (Read) | | 创建/更新文件 | Token | Contents (Write) | | 分支管理 | Token | Contents (Write) | | Release 管理 | Token | Contents (Write) | | 查看 Actions | Token | Actions (Read) | | 触发工作流 | Token | Contents (Write) | | 用户信息 | Token | - | | 关注用户 | Token | user:follow | | 通知 | Token | Notifications | | 组织信息 | Token | read:org |


    文件结构

    github-assistant/
    ├── SKILL.md                    ← 你正在读的文件
    ├── README.md                   ← GitHub项目介绍
    ├── LICENSE                     ← MIT 许可证
    ├── scripts/
    │   ├── github_trending.py      ← Trending抓取(浏览器模式)
    │   ├── github_search.py        ← 项目搜索
    │   ├── github_operations.py    ← 完整操作(Star/Fork/Issues/PR/代码/评论)
    │   ├── github_browser_ops.py   ← 浏览器自动化操作(API不支持的功能)
    │   ├── github_login.py         ← 登录管理
    │   ├── install_browser.py      ← 浏览器安装脚本
    │   ├── config.py               ← 集中配置管理
    │   └── requirements.txt        ← Python依赖
    ├── references/
    │   └── github_api_endpoints.md ← API参考
    └── assets/

    ~/.github-assistant/ ← 用户数据目录(不在skill文件夹内) ├── github_token.txt ← Token存储 ├── github_auth.json ← 浏览器session └── browser_data/ ← 浏览器持久化数据

    > ⚠️ 安全说明:敏感数据(Token、浏览器会话)存储在用户目录 ~/.github-assistant/,不会出现在 skill 文件夹中,可安全上传到公开仓库。

    注意事项

  • Token 存储在本地文件 github_token.txt,请勿上传到公开仓库
  • GitHub API 限流:未认证 60次/小时,认证后 5000次/小时
  • 浏览器模式首次需安装 Chromium:playwright install chromium
  • Trending 查询优先使用浏览器模式以获取完整数据(含贡献者和期间Star数)
  • IM 聊天平台禁止使用 Markdown 表格,使用 emoji + 列表格式
  • Fine-grained PAT 权限需要仔细配置,权限不足会导致操作失败