SuperAPI AI 工具集

learn-investigate

测试与质量

查看项目

更新于 10-15 20:10

技能介绍

用途:围绕一个待调查的问题,按“框定问题→收集证据→形成并检验假设→综合报告”的流程推进,形成带证据链的结论,并在确认后把发现沉淀到 learnings.md。\n\n主要能力与用法:传入问题作为第一个参数;可用 --scope <path> 限定目录,--max-hypotheses N 限制假设数(默认 3),--no-persist 跳过写入 learnings.md,-y 跳过确认。过程中检索既有知识(maestro search、learnings.md、debug-notes),用代码搜索、文件阅读、依赖追踪与 git log --oneline -10 -- <relevant-files> 收集证据,逐条写入 evidence.ndjson(字段含 ts、type、source、relevance、content、note),并更新 understanding.md。\n\n输出:.workflow/knowhow/KNW-investigate-{slug}/ 下的 evidence.ndjson、understanding.md、report.md,以及 .workflow/specs/learnings.md。限制:仅允许写入上述路径,绝不修改源码或路径外文件;阶段门为强制阻塞条件(如证据少于 3 条需先扩大搜索,假设未全部检验则阻塞,全部失败触发 3 次升级)。错误码:E001 未提供问题,E002 范围路径不存在,W001 无既有知识,W002 证据过少,W003 假设均无定论。确认门槛默认要求用户确认后才追加 learnings。