GitHub 知识库

概述

此技能管理一个本地GitHub知识库,并提供GitHub搜索功能。它维护已下载仓库的索引目录,并可以使用gh CLI工具搜索GitHub上的issue、PR和仓库。

知识库位置: ~/workspace/github-kb

目录结构: 所有仓库以 owner/repo 格式存储，例如 QwenLM/Qwen3-ASR

仓库索引: 通过 @~/workspace/github-kb/CLAUDE.md 引用 - 包含所有已下载仓库的一句话摘要

核心功能

1. 仓库搜索和访问

当用户提到任何GitHub仓库名称或询问某个仓库时:

1. 首先检查本地知识库:

   • 阅读 @~/workspace/github-kb/CLAUDE.md 查看仓库是否已下载
   • 如果找到,探索本地副本以回答用户的问题
   • 使用 Glob 和 Read 工具在仓库内搜索

2. 如果本地未找到:

   • 使用 gh repo view <owner/repo> 验证仓库是否存在
   • 询问用户是否要将其下载到知识库

2. 下载仓库

当用户请求下载仓库时:

1. 验证知识库目录是否存在:

   ls -la ~/workspace/github-kb
   

   • 如果目录不存在,询问用户正确的路径
   • 如果路径更改,更新SKILL.md中的路径

2. 克隆仓库:

   cd ~/workspace/github-kb
   gh repo clone <owner/repo>
   # 或: git clone https://github.com/<owner/repo>.git
   

   • 克隆后自动创建 owner/repo 目录结构

3. 更新CLAUDE.md:

   • 阅读现有的 @~/workspace/github-kb/CLAUDE.md
   • 为新仓库添加一个条目，使用 owner/repo 格式的链接
   • 摘要应该描述仓库的功能
   • 更新"最后更新"时间戳

条目格式示例:

| [QwenLM/Qwen3-ASR](./QwenLM/Qwen3-ASR) | Qwen3 ASR - 自动语音识别模型 |

3. GitHub搜索

使用 gh 命令搜索GitHub信息:

搜索仓库:

gh search repos <query> --limit 10

搜索issue:

gh search issues <query> --limit 20

搜索拉取请求:

gh search prs <query> --limit 20

搜索代码:

gh search code <query> --limit 20

查看仓库详情:

gh repo view <owner/repo>

查看仓库中的issue/PR:

gh issue list --repo <owner/repo> --limit 20
gh pr list --repo <owner/repo> --limit 20

查看特定issue/PR:

gh issue view <number> --repo <owner/repo>
gh pr view <number> --repo <owner/repo>

4. 回答问题

当用户询问GitHub相关内容时:

1. 分析查询 - 是否涉及:

   • 用户提到的特定仓库?
   • 通用GitHub搜索(issue、PR、仓库)?
   • 仓库内的代码?

2. 选择方法:

   • 本地仓库 → 在 ~/workspace/github-kb/<owner>/<repo>/ 中搜索
   • GitHub搜索 → 使用适当的 gh 命令
   • 两者结合 → 先检查本地,然后回退到GitHub搜索

3. 提供全面的回答,包括:

   • 问题的直接答案
   • 相关issue/PR/仓库的链接
   • 有帮助的代码片段
   • 仓库文档的上下文

工作流程

用户提到GitHub/repo/仓库?
    │
    ├─→ 是: 检查 @~/workspace/github-kb/CLAUDE.md
    │       │
    │       ├─→ 本地找到仓库?
    │       │   ├─→ 是: 探索本地副本,回答问题
    │       │   └─→ 否: 使用gh命令搜索GitHub
    │       │            └─→ 询问用户是否要下载
    │       │
    │       └─→ 用户想下载?
    │           ├─→ 是: gh repo clone → 更新CLAUDE.md
    │           └─→ 否: 仅使用gh搜索命令
    │
    └─→ 否: 仅在出现GitHub上下文时使用此技能

重要说明

• 始终先检查本地索引 - 这比搜索GitHub更快,且用户已经精选了这些仓库
• 保持CLAUDE.md更新 - 每个下载的仓库都应该有一句话摘要
• 使用@引用 - 使用 @~/workspace/github-kb/CLAUDE.md 引用CLAUDE.md文件,以便在需要时加载
• 主动帮助 - 如果本地搜索失败,主动提供搜索GitHub的建议
• 目录验证 - 如果 ~/workspace/github-kb 不存在,询问用户正确的路径并更新此技能的SKILL.md

可用工具

• gh CLI - 用于所有GitHub API交互(搜索、查看、克隆)
• Glob - 在本地仓库中查找文件 (**/*.py, **/README.md 等)
• Grep - 在本地仓库中搜索内容
• Read - 从本地仓库读取特定文件
• mcp__zread__* - 如果可用,用于在线读取GitHub仓库的MCP工具