GitHub-Assistant-Skill

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

Security Scan

The skill is broadly consistent with a GitHub assistant (it uses the API + Playwright browser scraping) but it asks users to create and store wide-scoped tokens, writes persistent session/token files under ~/.github-assistant, and recommends DNS/hosts/mirror workarounds and third‑party mirrors — these choices are coherent with the described features but are security-sensitive and not fully disclosed in the registry metadata.

Purpose & Capability

The name/description match the code: the skill implements Trending scraping (via Playwright) and full GitHub API operations (search, star/fork/watch, issues/PRs, contents, actions, etc.). However the registry metadata declares no required credentials/env vars while the code and SKILL.md clearly expect either a stored Personal Access Token (or GITHUB_TOKEN env var) or a browser session. The need for a broad PAT is consistent with the capabilities but the metadata omission is an inconsistency that could confuse users.

Instruction Scope

Runtime instructions ask the agent/user to run scripts that: open real browsers (interactive login), save browser storage state and persistent browser profiles under the user's home directory, and store tokens locally. The docs and scripts also suggest modifying /etc/hosts as a DNS workaround and recommend mirror endpoints for downloads. The skill reads/writes files in ~/.github-assistant and checks GITHUB_TOKEN environment variables even though the skill declared no required env vars. These actions go beyond simple API calls and have privacy/operational implications (saved tokens, persistent browser profiles, possible hosts modifications).

Install Mechanism

There is no platform install spec; installation is user-driven via pip and an included install_browser.py. The installer runs pip commands, queries mirrors and CDN endpoints, and guides the user to run playwright install (which downloads browser binaries). The script provides mirror URLs (npmmirror/registry.npmmirror, mirrors.tuna, etc.) and host/DNS workarounds. Using third‑party mirrors is understandable for connectivity, but downloading browser binaries from non-official endpoints and suggesting hosts-file edits increases risk if users blindly follow instructions.

Credentials

To perform full repository operations the skill properly requires a PAT. However SKILL.md encourages creating tokens with broad 'read & write' repo permissions and recommends 'All repositories' access — a large blast radius. The code stores the token as plaintext in ~/.github-assistant/github_token.txt and keeps persistent browser session data in the same directory. The skill also checks GITHUB_TOKEN env var (not declared), and offers browser login where users may input credentials in the opened browser. Storing unencrypted tokens and recommending wide scopes are security-sensitive and not proportionately restricted by default.

Persistence & Privilege

always:false (not force-included). The skill persists credentials and browser session state under ~/.github-assistant and creates a browser profile directory for persistent contexts. Persisting this data is functional for convenience but means long-lived secrets and browser state are stored on disk in the user's home directory (plaintext token, cookies/localStorage). The skill does not declare modifications to other skills or system-wide configs, but the persistent files and suggestions to change hosts/DNS increase long-term impact if compromised.

What to consider before installing

This skill appears to implement what it claims, but it asks you to provide and store powerful credentials and to install and run browser binaries (possibly from mirrors). Before installing or using it: - Prefer a fine‑grained PAT with the minimal repository access necessary (avoid All repositories / full repo write if you don't need it). - Review the code (github_login.py, config.py, install_browser.py) yourself — note the skill stores tokens as plaintext in ~/.github-assistant/github_token.txt and saves browser session data there. - If running on a server or agent, prefer the Docker workflow (prebuilt Playwright image) instead of running the installer or editing hosts on the host system. - Be cautious about following hosts-file or DNS workarounds; they can redirect traffic and should only be used if you understand the impact. - If you must use this skill, run it in an isolated environment (container or throwaway VM) and consider encrypting stored tokens or using short-lived tokens. Confidence is medium because the code and instructions are coherent but include several security‑sensitive choices (wide token scopes, plaintext storage, mirror/hosts guidance) that raise practical concerns rather than proving malicious intent.

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 <skill-dir>/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>
   • 验证成功后 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 会被安全存储到本地

---

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_id>

# 创建 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 <workflow_id>

# 触发工作流
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 <thread_id>

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 权限需要仔细配置，权限不足会导致操作失败