用途
Investigation Workflow 是一个系统化的六阶段工作流，用于调查和理解现有系统、代码库与架构。与面向实现的开发工作流不同，它针对探索、理解和知识捕获进行优化，适用于“理解某系统如何工作”“解释某集成”“分析某架构”“研究某流程”等研究类任务。
主要能力
该工作流包含六个阶段：
- 范围定义（Phase 1）：在探索前明确调查边界与成功标准，识别用户明确需求，使用 prompt-writer 代理澄清范围，必要时使用 ambiguity 代理，列出必须回答的问题，划定范围内外，估计调查深度。
- 探索策略（Phase 2）：规划部署哪些代理、调查什么内容，使用 architect 代理设计探索策略，使用 patterns 代理检查过往类似调查，识别关键探索区域，选择并行部署的专用代理，创建带优先级的调查路线图，规划验证方式。
- 并行深潜（Phase 3）：默认并行执行，同时部署多个探索代理高效收集信息，收集所有发现，识别发现之间的连接与依赖，记录意外发现。
- 验证与测试（Phase 4）：基于发现创建假设，设计实际测试验证理解，如手动追踪代码路径、检查日志与输出、测试边界情况与假设、验证配置效果，记录测试内容与结果，识别理解缺口并迭代。
- 综合（Phase 5）：使用 reviewer 代理检查发现完整性，使用 patterns 代理识别可复用模式，将发现综合为连贯解释，创建可视化产物，回答 Phase 1 的每个问题，准备适合用户的清晰说明。
- 知识捕获（Phase 6）：通过 amplihack.memory.discoveries 的 store_discovery() 将发现存入记忆，更新 .claude/context/PATTERNS.md，创建或更新相关文档，添加关键代码注释，可选创建 GitHub issue 或更新架构图，确保未来调查者能轻松找到知识。
使用方式
该技能在调查任务中自动激活。当调用 /ultrathink 时，它会通过关键词自动检测调查任务并建议使用此工作流，随后从 .claude/workflow/INVESTIGATION_WORKFLOW.md 读取工作流并开始 Phase 1。
若调查完成后任务需要实现，可过渡到 DEFAULT_WORKFLOW.md：在 Step 4（研究与设计）恢复，或若调查已提供清晰设计指导则在 Step 5（实现解决方案）恢复，并使用记忆中的调查发现（通过 get_recent_discoveries()）和会话日志指导设计决策。
自定义方式：编辑 ~/.amplihack/.claude/workflow/INVESTIGATION_WORKFLOW.md 可修改、添加或删除阶段，调整代理部署策略，添加项目特定调查模式，更新效率目标，更改立即对未来调查生效。
适用场景
- 调查任务示例：“调查认证系统如何工作”“解释 neo4j 内存集成”“理解 CI 为何持续失败”“分析反射系统架构”“研究会话启动时触发哪些钩子”。
- 开发任务应改用 DEFAULT_WORKFLOW.md，例如：“实现 OAuth 支持”“构建新 API 端点”“添加功能 X”“修复 bug Y”。
- 判断标准：需要理解 X 用调查工作流；需要构建/修复/实现 X 用开发工作流。
限制
该工作流优化的是理解而非实现。其效率目标为相比临时调查减少 30-40% 的消息数（目标值，待验证）。Git 使用为可选，而开发工作流中为必需。相关资源包括源工作流规范（436 行）、knowledge-extractor 技能、代理目录和模式库。