代码调研
给一个陌生仓库,系统性梳理出架构拓扑、依赖、数据流、代码约定和热点文件,产出分析报告
功能与用途
刚接手一个项目,或者要在老系统里改一个功能,最耗时间的是搞清楚代码到底怎么长、数据从哪进从哪出。这个 Skill 不是随便翻文件,而是按固定流程走:先探目录和入口摸清地形,再理依赖,再顺着一个功能把数据流从入口追到存储和副作用,然后总结命名、错误处理、测试这些约定,最后用 git log 挑出最常改、最复杂、最容易被引用的热点文件,输出一份带架构图和风险清单的报告。它只做理解,不改代码。
适用场景
- 刚入职接手一个几万行的老项目,要在几天内搞清楚整体结构和入口:刚入职接手一个几万行的老项目,要在几天内搞清楚整体结构和入口在哪
- 线上一个功能出了问题,得先弄清楚它从请求进来一路经过哪些文件:线上一个功能出了问题,得先弄清楚它从请求进来一路经过哪些文件才动得了手
- 要做技术方案评审,需要先摸清现有系统的模块依赖和数据流向再写:要做技术方案评审,需要先摸清现有系统的模块依赖和数据流向再写设计文档
适用人群
- 新入职的开发工程师
- 接手遗留系统的维护者
- 需要评估外采代码的技术负责人
使用步骤
- 给出仓库路径,让 AI 先做拓扑扫描,产出语言、框架、入口点和目录用途地图
- 继续做依赖分析与数据流追踪,拿到具体到 file:line 的链路和流程图
- 取用约定发现部分,对照命名、错误处理、测试写法这些既有惯例
- 查看热点文件与风险项,结合建议排一下改造或排障的优先级
- 把整份报告作为后续开发或设计文档的参考底稿
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 进阶
- 版本
- main
- 最近更新
- 2026-09-09
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
Use when produce structured understanding of unfamiliar codebases — architecture,
使用前准备
- 运行环境需能执行 find、grep、git log 等 shell 命令
- 需要基本的开发经验来读懂依赖关系和项目结构
依赖与权限
- 读取用户主动提供的内容