Workflow Forensics

Workflow Forensics

用途

• 当一个团队工作流（/team-* 链路）失败、卡住、超时或产出不符合预期时，进行 结构化事后调查。
• 重建工作流时间线，定位失败点，区分 流程问题（角色交接缺失、产出缺失、门禁跳过）和 技术问题（代码错误、环境故障）。
• 为 tech-lead 提供可操作的诊断报告，而不是模糊的"某步出了问题"。

触发信号

• /team-execute 或 /team-review 连续 2 次以上未能推进。
• 角色之间 handoff 被拒绝或回退。
• 同一任务在 /team-plan 和 /team-execute 之间来回超过 2 次。
• 发布后发现关键产出缺失（如无 test-plan、无 deployment-context）。
• 线上事故调查需要追溯"哪一步遗漏了什么"。
• agent 在自主循环中陷入重复（同一工具调用 > 3 次无进展）。

调查流程

Phase 1: 证据收集

收集来源：
├── docs/artifacts/{slug}/     → 正式产出文件
├── docs/memory/sessions/      → 会话日志
├── docs/memory/decisions.md   → 决策记录
├── STATE.md                   → 运行时状态
├── HANDOFF.json               → 暂停/恢复快照
├── git log --oneline -20      → 最近提交历史
└── .claude/memory/            → agent 记忆文件

收集约束：

• 不读不相关任务的文件——按 {slug} 限定范围。
• 对每个证据源标注 时间戳 和 产出角色。

Phase 2: 时间线重建

按时间顺序列出所有工作流事件：