代码组件深度剖析
基于项目知识图谱与源码,深度拆解指定文件、函数或模块的架构定位、调用关系和数据流向。
功能与用途
该功能专为需要深入阅读某段代码的开发者设计。它首先读取项目预先生成的代码知识图谱(.ua 目录),校验本地 Git 状态以确保图谱最新;接着定位指定的文件路径或函数节点,追踪其上下游调用、依赖关系及所属架构分层;最后结合真实源码,深入阐释该组件的职责背景、内部实现、数据输入输出以及关键设计模式,帮助开发者免去逐层跳代码的烦恼。
适用场景
- 复杂业务函数上下游排查:输入指定函数名,结合图谱关系追溯调用来源与依赖项,理清其在模块中的协作关系。
- 核心架构组件机制拆解:定位具体文件,结合架构分层与源码深入分析职责边界、输入输出及内部数据流向。
- 跨语言或陌生模块代码重构:在改动高复杂度文件前,结合图谱与源码解析设计模式及调用约束,避免引发副作用。
适用人群
- 接手遗留系统或新开源项目的研发工程师
- 排查复杂核心函数或业务链路的技术负责人
- 准备进行模块重构需要厘清上下游依赖的架构师
使用步骤
- 确保项目根目录下已存在知识图谱文件,若没有需先执行 `/understand` 生成
- 输入 `/understand-explain` 并在参数中指定目标文件路径或带函数名的标识(如 `src/service.ts:handleRequest`)
- 工具自动验证图谱新鲜度并检索依赖拓扑
- 阅读生成的深度报告,包含架构分层、内部结构、依赖上下游及数据流向解析
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 进阶
- 版本
- main
- 最近更新
- 2026-09-23
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
Use when you need a deep-dive explanation of a specific file, function, or module in the codebase
依赖与权限
- 读取用户主动提供的内容