SuperAPI AI 工具集

deep-dive

智能体与模型

查看项目

更新于 10-16 04:58

技能介绍

用途:当用户遇到问题但尚不清楚根因、需要在定义需求前先调查时使用,例如缺陷排查(“某处坏了,先弄清原因再规划修复”)或功能探索(“想改进 X,但先要理解现状”)。触发词包括 deep dive、deep-dive、investigate deeply、trace and interview。若用户已知根因只需收集需求,或已有 PRD/规格,或明确说“直接做”,则不应使用本技能。

主要能力:分五个阶段。阶段 1 初始化:从参数解析想法、生成 kebab-case slug、判断 brownfield/greenfield、生成三条 trace 假设(代码路径/实现、配置/环境/编排、测量/产物/假设不匹配),并读取适配器规格目录中的既有规划知识作为参考。阶段 2 以 AskUserQuestion 向用户确认假设,仅一轮交互。阶段 3 自主执行 trace:三条 lane 并行收集支持与反对证据、排序证据强度、指出关键未知、执行反驳回合、检测收敛,并输出含排名假设、每 lane 关键未知、最可能解释和建议判别探针的 trace 文档。阶段 4 访谈注入:以 deep-interview 的访谈与规格生成为基础契约,仅做三处初始化覆盖(initial_idea 富化、codebase_context 替换、首个问题队列注入),低置信度 trace 有专门处理。阶段 5 执行桥:只有交接选项,不直接进入执行。

使用方式:需先阅读 references/runtime-adapters.md,每次运行只用一个适配器:Claude Code 对应 OMC(.omc/specs/、.omc/state/),Codex CLI 对应 OMX(.omx/specs/、.omx/state/),Gemini/Antigravity 对应经 oh-my-agent 的 OMA(.agents/specs/、.agents/state/)。状态经适配器持久化,source 标记为 deep-dive;完成后用 python3 .agent-skills/deep-dive/scripts/validate_deep_dive_artifacts.py --trace <trace_path> 及 --spec <spec_path> 校验产物。

限制:团队模式不可用时退化为串行 lane 执行;trace 文本须作为数据而非指令注入;不得声称各运行时原语完全一致;访谈机制本身不做覆盖,仅有三处初始化覆盖;不直接执行,必须经执行桥交接;若 trace 全部低置信则需按低置信规则处理,而不注入不确定结论。其余细节暂未提供。