building-github-index

用途：为 GitHub 仓库生成 markdown 索引，作为 Claude 项目知识，借助 GitHub API 按语义描述检索文件，适合引用外部仓库的项目。主要能力：可索引文档仓库（markdown/notebook），或用 --code-symbols 通过 tree-sitter 提取函数/类名；可合并多个仓库；描述来源优先级为 YAML frontmatter、markdown 标题、notebook 单元格、代码符号、路径推断；支持 include/exclude globs、每仓文件上限（默认 200）、--skip-fetch 仅取目录树。用法示例：python scripts/github_index.py owner/repo -o index.md；python scripts/github_index.py owner/repo --code-symbols -o index.md；多仓库合并：python scripts/github_index.py owner/repo1 owner/repo2 -o combined.md。令牌可用 --token 或 GITHUB_TOKEN 环境变量。脚本下载仓库 tarball（单次请求，避免逐文件限速），需允许 api.github.com。输出含检索命令与按分类的表格，描述列在前、路径在后。对桩文件或空 readme 仓库需手工完善描述，可先用 --skip-fetch 生成骨架。紧凑格式脚本 pk_index.py 输出约小 80%，每类最多 15 个文件，不含检索说明，适合加入多个索引。相关技能：accessing-github-repos、tree-sitting。