GitHub Knowledge Base

核心用法

github-kb 是一个面向开发者的 GitHub 知识库管理技能，主要提供两类能力：

1. GitHub 远程搜索能力 —— 通过 gh CLI 搜索仓库、Issue 和 Pull Request，支持丰富的查询限定符（如 language:python、stars:>1000、topic:mcp 等），无需离开终端即可发现项目。

2. 本地知识库管理 —— 维护一个本地克隆的仓库集合，通过 GITHUB_KB.md 目录文件统一索引。用户可快速查询已克隆项目，或按标准流程将新仓库纳入管理。

典型工作流程：

• 搜索仓库 → 克隆到本地 KB → 阅读 README 生成描述 → 更新 GITHUB_KB.md 目录
• 查询 KB 中已有项目 → 直接浏览本地代码

显著优点

• 离线可用：克隆后的项目可离线浏览，不受网络波动影响
• 结构化索引：GITHUB_KB.md 提供项目速查手册，避免「 cloned 即遗忘」
• 搜索语法强大：继承 GitHub 原生搜索能力，支持多维度筛选
• Token 安全：支持环境变量注入，避免硬编码敏感信息

潜在缺点与局限性

• 依赖外部工具：必须预装 GitHub CLI 并完成认证，否则降级为仅本地模式
• 存储成本：大量克隆会占用本地磁盘空间
• 同步负担：仓库更新需手动 git pull，无自动同步机制
• 权限限制：私有仓库需配置 GITHUB_TOKEN，且 Token 权限决定可见范围

适合人群

• 需要系统管理大量参考仓库的开发者
• 频繁调研开源项目的技术调研人员
• 希望建立个人/团队代码示例库的用户

常规风险

• Token 泄露：若不当配置环境变量，存在凭证泄露风险（已提示用容器密钥）
• 仓库污染：克隆来源不明的仓库可能包含恶意代码，建议先审查再纳入 KB
• 数据残留：删除 KB 目录时需注意彻底清理，避免敏感仓库残留

核心用法

github-kb 是一个纯文档型 Skill，旨在通过 GitHub CLI (gh) 提供 GitHub 搜索能力与本地知识库管理功能。其核心工作流包括：

1. GitHub 搜索：利用 gh search repos|issues|prs 命令检索公开仓库、Issue 或 Pull Request，支持语言、星标数、主题等多维度筛选。
2. 本地 KB 管理：维护位于 GITHUB_KB_PATH（默认 /home/node/clawd/github-kb）的本地目录，通过 GITHUB_KB.md 作为目录索引文件记录所有克隆的项目。
3. 仓库克隆与索引：将新仓库克隆至 KB 目录，自动生成项目描述并更新 GITHUB_KB.md 目录文件，形成结构化的本地代码库。

显著优点

• 零代码安全风险：纯 Markdown 文档实现，无可执行代码、无外部依赖、无网络请求逻辑，六维安全检测全满分通过。
• 灵活的环境配置：GITHUB_TOKEN 和 GITHUB_KB_PATH 通过环境变量注入，遵循敏感信息管理的最佳实践，支持私有仓库访问与自定义存储路径。
• 结构化知识沉淀：强制性的 GITHUB_KB.md 目录机制，确保克隆的仓库有统一的分类与描述，便于长期维护与团队协作。
• 与 GitHub CLI 深度集成：直接复用 gh 的官方搜索语法（如 language:python stars:>1000），无需学习额外 DSL，功能边界清晰。

潜在缺点与局限性

• 依赖外部 CLI：功能完全依赖本地 gh 的安装与认证状态，未安装或未登录时仅可使用本地 KB 只读功能。
• 无自动同步机制：克隆后的仓库不会自动更新，需用户手动执行 git pull 维护代码 freshness。
• 纯手动索引：GITHUB_KB.md 的更新依赖人工执行工作流步骤，无自动化钩子保障目录与文件系统的一致性。
• 无代码分析能力：仅提供仓库级元数据管理，不包含代码语义分析、依赖解析或智能问答能力。

适合人群

• 需要批量管理 GitHub 开源项目的开发者与研究者
• 希望建立私有化代码索引目录的工程师
• 对工具有严格安全合规要求的金融、医疗等企业环境

常规风险

该 Skill 本身无运行时风险，但使用过程中需注意：

• Token 泄露风险：用户需自行保管 GITHUB_TOKEN，避免在日志或共享环境中暴露
• 存储空间管理：克隆大量仓库可能占用显著磁盘空间，建议定期清理不再使用的项目
• 授权范围控制：建议使用最小权限的 GitHub Token（仅 repo 读取权限即可），避免过度授权。