用途:帮助用户在新仓库或陌生仓库中快速定位结构、上下文与关键符号,完成一次只读的代码库导览。
主要能力:以 SCAN_TARGET 指定子目录或以项目根为扫描范围;检查并运行 Serena onboarding 与记忆读取;查找并阅读 CLAUDE.md、.llmdocs/ 下文档;读取最近 20 条提交;检查配置、包清单、构建任务、容器、IaC、CI/CD、README 等文件元数据;生成深度 3 的目录树;按 main/index/app/cli 等模式识别入口文件,用 Serena 获取符号概览与入口函数实现;搜索 main、app、server、router、handler、config、middleware、schema、model 等架构符号并做引用查询;对源码目录做符号映射并盘点 interface、type、enum、struct 等类型;识别测试框架与风格。
使用方式:由用户触发该技能;如指定路径则作为 SCAN_TARGET。核心命令包括 PROJECT_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || pwd)、git log --oneline -20 以及若干 find 命令。Serena 调用失败时设 SERENA=false 并回退到读取文件头 80 行或 60 行测试文件。完成后先列出读取的文件与符号,再输出 10 至 14 段项目概览,涵盖工作原理、价值与局限及上手指南,随后等待指令。
限制:明确不写源码、不创建智能体;跳过测试、生成文件与锁文件;IaC 与 CI/CD 仅列文件名不读内容;Serena 不可用时符号分析能力下降,仅靠文件片段推断。具体构建、运行、测试命令未在资料中提供,需依据实际仓库文件确认。