用途:对指定代码库进行并行探索并生成结构化文档,适合快速了解陌生仓库或深入学习复杂项目。
主要能力:
- 支持多种输入:URL、slug(来自 ψ/memory/slugs.yaml)、本地仓库路径或仓库名。
- 深度模式:--fast 为 1 个代理生成 1 份概览;默认 3 个代理生成架构、代码片段、快速参考 3 份文档;--deep 为 5 个代理,额外生成测试与 API 表面文档。
- 使用 ghq 克隆仓库,并在 ψ/learn/owner/repo/origin 建立符号链接指向源码,文档写入带时间前缀(HHMM_)的日期目录。
- 维护 .origins 清单,/learn --init 可在 git clone 后恢复所有 origin 链接。
使用方式:
- 基本命令:/learn [url|slug|repo-path|repo-name],可加 --fast 或 --deep。
- 关键要求:为子代理提供两个字面绝对路径——SOURCE_DIR(readlink 解析后的 ghq 路径,不能是嵌套符号链接路径)和 DOCS_DIR(日期目录)。
- 每次代理提示需前置隔离规则,要求只引用 SOURCE_DIR 下文件可验证的内容,无法引用时写“not present”,不得填充。
- 生成后需做污染检查(grep 本仓库特有词汇),命中则核实更正。
适用场景:需要快速摸清外部仓库、构建可检索的本地文档库、或将学习记录接入 /trace 知识层时使用。
限制:依赖 ghq、rg 等工具;文档质量受代理隔离执行情况影响,可能出现污染;无测试的项目对应章节可合法为空,不应填充;具体收费、平台支持等信息暂未提供。