SuperAPI AI 工具集

investigation-loop

通用与其它

查看项目

更新于 10-16 07:16

技能介绍

用途:针对根因不明显、需要跨多个关联工单、代码路径与 Confluence 页面逐层排查的 Jira(或类似)工单做长时调查,最终交付物是一份带证据引用的书面假设,而不是修复代码。

主要能力:把工单交给智能体后,借由 cooking 的 Stop hook 在自然停顿处自动继续迭代;满足条件即终止:对话中存在回答工单核心问题的书面假设、至少 3 条可核验的具体证据引用(代码 path:line、工单 key、文档 URL、commit SHA 或测试结果)、明确说出“I have enough to write up findings”触发字符串或迭代计数达到 10 次,并删除标记文件。

使用方式:确定目标工单 key(如 RF-9421)与入口(堆栈、失败 PR、回归点);创建带 PID 的标记文件:mkdir -p ~/.claude/cooking;PID=$$;START_EPOCH=$(ps -p $PID -o lstart= | sed 's/^ *//;s/ *$//');printf '{"start_epoch": "%s"}' "$START_EPOCH" > ~/.claude/cooking/active-$PID;然后让 Claude “Investigate JIRA <TICKET-KEY> in cook mode. Goal: written hypothesis with at least 3 evidence citations.”。终止时执行 rm -f ~/.claude/cooking/active-$PID ~/.claude/cooking/iter-$PID。可用 /cook-status 检查标记是否活跃,迭代计数文件应 ≤ 10。

适用场景:工单根因不直观、调查预计 30 分钟以上且不希望人工盯守、需要书面调查结论作为交付物。限制与反模式:修复方案显而易见时应直接修复,不要启动循环;机械性工作(测试修复、重构)应用 test-fix-loop 或 cross-repo-refactor;无法访问 Jira、仓库等系统时循环会空转;不要把假设直接改成修复;不要把“大概是 X”当作证据;不要为提前终止而跳过引用要求,找不到 3 条就老实跑到第 10 次并写明缺失项;假设写在对话记录中而非仓库文件。与 test-fix-loop、cross-repo-refactor、dreaming-consolidator 为同级技能。