用途:Deep Read 是一个“源码优先”的代码库阅读协议,用于系统理解现有代码如何工作。核心原则是源码即真相,文档、注释和函数名都可能误导,因此必须阅读实际实现。
主要能力:按严格顺序执行六个阶段,每阶段设门禁,未满足不得推进。1)SCOPE:解析阅读目标(模块、流程、问题或路径),读取 CLAUDE.md、MEMORY.md 作为线索而非事实,用 Glob/Grep 估算范围;若超过 50 个源文件,按候选集内 import 扇入的中心性排序、以 git log -1 --format=%ct 的最近性打破平局,保留前 49 个并记录覆盖上限。2)MAP:用 Glob 梳理目录,从配置文件(package.json、Cargo.toml、go.mod、requirements.txt 等)识别技术栈,通过实际读取验证入口点,用 Grep 构建内部依赖图并识别核心文件。3)TRACE:从入口点沿调用链追踪到终端操作(数据库、API、文件 I/O、返回值),记录每个分支点,输出带 file:line 的完整路径。4)DEEP READ:完整阅读关键文件,逐函数记录逻辑、公式、条件、状态变更与已处理/未处理的边界情况,并交叉核对调用方与被调方的一致性。5)CONNECT:用 sequential-thinking MCP 综合,识别至少 3 个模式,绘制端到端数据流,评估风险与假设。6)REPORT:输出结构化报告,所有结论引用 file:line。
使用方式:以 /deep-read 加目标调用,例如 /deep-read payment processing flow from checkout to settlement、/deep-read src/services/billing/ 或 /deep-read how are sales commissions calculated and distributed?。该技能以 fork 方式运行以隔离上下文,只返回报告;因此不能向用户提问,范围收窄采用确定性规则,并行指把独立工具调用批量放入一条消息,而非启动子代理。
限制:需要用户选择的事项会作为开放问题写入报告。可选的代码图加速器仅在仓库规模大(数百文件以上)或多语言、且问题属于全仓库传递性或聚合性时才值得一次性建立;否则使用 LSP、Grep、Read 更快。代码图与 LSP 都可能是过期快照,任何命中都必须在实时源码中确认后才能引用。资料未提供具体安装命令、收费与平台信息。