SuperAPI AI 工具集

clonedeps

编程与开发

查看项目

更新于 10-25 16:17

技能介绍

clonedeps 是一个面向 OpenCode 的工作流技能,目标是把项目中少量关键依赖的源码仓库克隆到本地被忽略的工作区,使 OpenCode 能够直接阅读库的内部实现,从而辅助调试或扩展代码。它强调“工作流”而非命令行封装:依赖识别、引用校验、克隆、状态记录和清理都由编排者与 @librarian 按步骤完成,不使用辅助脚本。

用途与定位 该技能解决的是“阅读第三方库源码”的需求。多数依赖不值得克隆,只有当某依赖的源码比文档或当前仓库本身更有助于理解代码库或处理实现/调试任务时,才建议将其克隆到本地。

主要能力

  • 检查已有状态:先读取 .slim/clonedeps.json,确认已列出的仓库路径是否存在,可复用已克隆仓库,避免重复规划。
  • 依赖规划:由 @librarian 先理解项目功能、架构、集成点与实际依赖,再推荐 0–3 个强推荐(最多 3–5 个核心依赖),并给出仓库名、URL、建议的 ref/tag/commit、克隆理由、适用时机和注意事项。
  • 方案校验与确认:编排者负责最终审批,尽可能用 git ls-remote 验证引用,优先使用固定 tag 或 commit SHA;默认仅使用 HTTPS 的 GitHub/GitLab 风格仓库地址,拒绝 file://、SSH、本地路径、含凭据或需认证的私有仓库(除非用户明确批准);克隆前向用户展示方案并请求确认。
  • 手工克隆:在 .slim/clonedeps/repos/<safe-repo-name>/ 下每个源仓库建一个文件夹,安全名取自仓库 owner/name(如 opencode-ai__opencode),同一 monorepo 只克隆一次,用 packagePath 区分多个包;先克隆到临时目录,检出成功后再移动;不执行克隆仓库中的依赖安装、构建或测试脚本。
  • 本地状态记录:写入 .slim/clonedeps.json 结构化清单,记录名称、解析版本、仓库 URL、ref、路径、packagePath 与理由;部分克隆失败时仍记录成功项。该文件不应加入 .gitignore。
  • 忽略规则更新:在 .gitignore 与 .ignore 中以幂等标记块分别忽略克隆内容、允许 OpenCode 读取克隆源码。
  • 注册到 AGENTS.md:克隆成功后更新仓库根目录 AGENTS.md 的 "Cloned Dependency Source" 章节,列出只读克隆仓库及用途,方便后续智能体了解。
  • 清理:用户要求时删除克隆目录及标记块;删除 .slim/clonedeps.json 或 AGENTS.md 章节前需先询问。

使用方式 用户提出克隆依赖源码的需求后,技能按“检查状态→请求 @librarian 规划→校验并确认方案→手工克隆→写状态→更新忽略文件→注册 AGENTS.md→按需清理”的顺序执行,全程不依赖辅助脚本,并由编排者直接执行获批的文件系统与 git 操作。

适用场景 需要深入阅读核心框架、SDK、ORM、运行时/插件 API 或构建/运行时工具源码的调试与扩展任务;不适用于小型工具、传递依赖或仅在明确相关时才考虑的纯开发工具。

限制 默认只使用 HTTPS 公共仓库;需要用户确认后才进行网络克隆;不运行克隆仓库中的安装、构建或测试脚本;克隆源码为只读,不应编辑。