jww-bounded-investigation

有界调查

通过委派广泛探索并记录验证结论所需的证据，让多文件调查保持在合理范围内。我们默认你会进行有针对性的阅读并运行范围有限的命令；这些并非本技能新增的内容。

使用时机

当工作内容是调查，且尚未定位相关代码时，使用此技能，例如：

• 没有明显归属文件的堆栈跟踪或错误
• 提出某种行为但未指明源码的“为什么会发生 X”问题
• 涉及许多文件的审计或考古式梳理

相关文件已确定后，或对已知代码进行常规编辑时，请跳过此技能。

委派扇出搜索

当执行环境提供只读搜索 Agent、允许委派，且同时满足以下两个条件时，将全面搜索委派出去：

• 位置未知——存在许多候选文件、命名不确定，或需要搜索整个代码仓库
• 你需要的是结论，而不是周边代码

如果目标足够具体、输出量较小，或判断周边代码比定位文件更重要，则自行搜索。 由主 Agent 负责综合与验证：在依赖委派所得结论之前，先检查其引用的源码。

保留证据台账

将台账保存在工作笔记或本次会话的临时文件中；不要提交。每条发现记录一行：来源、观察结果，以及该结果支持或排除的可能性。

src/Session/Store.swift:88 — writes cache off the main actor — explains the
crash, rules out the decoder path

记录已排除的分支，以及检查过但没有发现有用信息的来源。 否则，在同一项调查中，之后可能会再次阅读同一个文件。

台账是交接材料的原始素材：其中的条目会成为 jww-handoff 的 Decisions 和 Touched 部分，因此保留台账能让交接文档几乎无需额外编写。

报告

先给出结论，然后列出支持结论的证据和影响可信度的注意事项。引用文件和行号，让读者无需重新搜索即可复核推理。