SuperAPI AI 工具集

dig

编程与开发

查看项目

更新于 10-16 04:06

技能介绍

用途

Dig 用于查询库和包的文档与源代码。当用户提出关于某个库的问题、需要理解某个库的 API,或需要了解库的具体实现时,可以使用该技能。它的核心思路是:通过查找并探索库的源代码仓库来回答关于该库的问题。

主要能力

  • 检查库源码是否已在本地存在。
  • 在本地不存在时,查找并克隆库的仓库。
  • 启动研究型智能体遍历仓库,聚焦 README 与文档文件、源码结构、API 导出与公共接口、示例与测试中的用法模式。
  • 综合研究发现,针对用户关于该库的问题给出清晰、准确的回答。

使用方式

工作流程分为四步:

  1. 检查本地可用性。先检查库源码是否已存在于本地,例如查看常见位置:
ls /tmp/cc-repos/{library-name} 2>/dev/null

如果库已在本地存在,则直接跳到第 3 步。

  1. 克隆仓库。如果本地不可用,则查找并克隆仓库。搜索该库的 GitHub 仓库(大多数库都在 GitHub 上),并克隆到标准位置:
mkdir -p /tmp/cc-repos
git clone https://github.com/{owner}/{repo}.git /tmp/cc-repos/{repo-name}

常见仓库查找模式:

  • npm 包:查看 package.json 的 homepage 或 repository 字段,或搜索 https://github.com/{package-name}
  • Python 包:查看 PyPI 页面上的 "Homepage" 或 "Source" 链接
  • Go 包:导入路径通常就是仓库 URL
  • Rust crate:查看 crates.io 上的 repository 链接
  1. 研究仓库。启动一个 Research 智能体(使用 Task 工具,subagent_type="Explore")遍历仓库并回答问题。给智能体的示例提示词:
Explore the repository at /tmp/cc-repos/{repo-name} to answer: {user's question}

Focus on:
- README and documentation files
- Source code structure
- API exports and public interfaces
- Examples and tests for usage patterns
  1. 综合并回答。使用研究发现,针对用户关于该库的问题提供清晰、准确的回答。

适用场景

  • 用户询问某个库或包的问题。
  • 用户需要理解某个库的 API。
  • 需要基于库的源代码仓库来查找文档或用法。

限制

资料中未提供关于收费、价格、支持平台、效果保证等方面的信息。该技能依赖能够访问并克隆库的源代码仓库(如 GitHub),并依赖研究型智能体遍历仓库;若仓库无法找到或无法克隆,资料中未说明相应的处理方式。