用途:当调查工作尚未定位到相关代码时使用,例如没有明显归属文件的堆栈跟踪或错误、只描述行为却不知源码位置的“为什么 X 会发生”问题,以及会跨越许多文件的审计或代码考古。一旦相关文件已确定,或只是对已知代码做普通编辑,则跳过此技能。
主要能力:把大范围发现工作委派出去,并记录验证结论所需的证据。定向读取和窄范围命令属于默认前提,不是本技能新增的内容。
委派扇出搜索:当运行环境提供只读搜索代理、委派已获授权,且同时满足“位置未知(候选文件多、命名不确定或需要全仓库代码搜索)”和“只需要结论而非周边代码”时,可把扫描委派出去。若目标足够具体、输出很小,或判断周边代码比找到它更重要,则自行运行搜索。综合与验证保留在主代理:依赖委派结论前,先检查其引用的源码。
证据台账:在工作笔记或会话临时文件中维护台账,不提交。每条发现记录一行:来源、观察结果、以及它排除了什么或确认了什么。例如:src/Session/Store.swift:88 — writes cache off the main actor — explains the crash, rules out the decoder path。也要记录被排除的分支和已检查但无收获的来源,否则同一调查中稍后会重复读取同一文件。台账是交接的原材料,其条目会成为 jww-handoff 的 Decisions 与 Touched 部分。
报告:先给结论,再给支持结论的证据,以及影响可信度的注意事项。按文件和行号引用,以便无需重现搜索即可复核推理。
限制:资料未提供具体安装命令、平台支持、收费方式或效果数据。