用途:围绕证据重建“发生了什么”或“某陌生区域做什么”。适用于调查缺陷、追溯事件原因、探索无明确症状的代码区域,或续接已有案件文件。
主要能力:对证据分级为已确认、已推断、已假设;先锁定一处已确认证据(stronghold)再向外扩展,不从理论出发找支持;挑战用户描述的前提;假设按开放/确认/驳回更新状态且不删除;缺失证据本身作为发现记录;调查过程中持续暂停并向用户汇报。
使用方式:输入可为工单 ID、日志路径、诊断归档、错误消息、代码区域名、问题描述或既有案件文件路径,最后一种会恢复先前调查。激活时先运行 uv run {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --project-root {project-root} --key workflow,再依次执行 prepend 步骤、加载持久事实与配置({project-root}/_bmad/gds/config.yaml)、问候用户、执行 append 步骤。输出写入 {implementation_artifacts}/{workflow.case_file_subdir}/{workflow.case_file_filename}。
流程结果从 Outcome 0 到 5:加载既有案件、确定范围与 stronghold、映射证据范围、纪律化推理成因、追踪关键源码,最后定稿报告与交接,并给出后续行动菜单(如 gds-quick-dev、gds-correct-course、gds-create-story、gds-code-review)。
限制:调查止于诊断,不负责实现;缓解措施与变通方案仅在明确请求时生成;路径引用采用 CWD 相对格式;读取 5 个以上文件或超 10K tokens 需委派子代理;若配置中 {implementation_artifacts} 未解析,回退至 ./investigations/ 并说明。