SuperAPI AI 工具集

repo-research

写作与研究

查看项目

更新于 10-16 06:42

技能介绍

用途:调研外部仓库的源代码、issue、PR、release 与 git 历史,帮助理解某个库如何实现特定功能。

主要能力与选择方式:

  1. 针对单个 GitHub 仓库的概念性问题(如“库 X 如何实现 Y”):使用 mcp__plugin_ora_morph__github_codebase_search。引用是真实的,但综合结论可能误读代码,转述关键结论前应先阅读被引用的文件核实。
  2. 跨仓库的精确标识符搜索、GitLab/Bitbucket 目标、符号导航、git 历史:使用 Sourcegraph MCP,可用 keyword_search、nls_search、read_file、go_to_definition、find_references、commit_search、diff_search。
  3. 深挖(3 个以上文件、分支式追问、ast-grep):运行 bash scripts/git-clone.sh <repo>,会浅克隆到 ~/.cache/clio-repos/ 缓存并回显路径。接受 owner/repo、HTTPS 或 SSH,--refresh 取最新提交。
  4. issue / PR / release / 已知单个文件:使用 gh CLI,如 gh issue view、gh pr view、gh release view|list、gh api repos/.../contents/<path>。

注意事项:不要用 WebFetch 访问 github.com 或 raw.githubusercontent.com,gh 能返回同样的结构化内容;release 页面的相对时间戳(如“2 weeks ago”)容易被误当训练期日期。

Sourcegraph 细节:keyword_search 是 AND 加字面匹配,一个错误词就会归零,用于具体标识符;nls_search 是 OR 加词干,不是语义搜索,传 2 至 5 个提取的关键词而非句子。仓库过滤要锚定,如 repo:^github.com/foo/bar$,未锚定会匹配到 fork。搜索结果为 repo@revision,读取文件时需分别传 repo 与 revision,否则会静默读取默认分支 HEAD。约 24 小时内的新代码未被索引;未索引的仓库或遇到 401/403 时,改用 git-clone 回退。