SuperAPI AI 工具集

bug-hunt-swarm

通用与其它

查看项目

更新于 10-16 04:29

技能介绍

用途:对缺陷、回归、崩溃、flaky(不稳定)行为或无法解释的失败做并行只读多智能体根因调查,输出带排序的诊断与最优先推进路径。

主要能力:以诊断优先为原则,不编辑文件、不实施修复。四个只读子智能体分别为:复现与范围调查(确认最窄可靠触发条件、影响边界、确定性或 flaky);代码路径与失败接缝调查(追踪执行路径、状态转换、调用方与被调用方假设不一致、数据流与控制流断裂);近期变更与回归调查(关联最近 diff、配置/依赖/schema/迁移漂移、部分更新、时间上吻合的行为变化);验证计划与可观测性调查(最小现有失败测试、当前日志与 trace、最小非变更命令、缺失证据如何收集)。

使用方式:先收集最小有用的“问题包”——症状、期望行为、实际行为、复现步骤(如已知)、影响范围、相关证据(日志、堆栈、失败测试、截图、近期 diff、环境信息);来源优先级为用户描述、用户提供的文件/堆栈/日志/测试/截图、疑似回归时的当前 git 变更或近期仓库历史、失败周边最小相关代码路径。报告不完整时推断最小问题陈述并说明未知项。启动前阅读相关项目指令与文档,如 AGENTS.md、仓库工作流文档以及受影响子系统的架构、状态、路由、schema 或运行时文档。随后写下调查简报(什么坏了、什么尚未证实、最可能涉及的系统部分、已有证据、何种证据算确认),用只读方式采集证据(rg、git diff、git log、git show,读日志与崩溃追踪与配置,运行现有测试或最小安全复现命令)。问题足够大或模糊时并行启动四个子智能体,给相同问题包与简报,声明只读,禁止编辑文件、apply_patch、暂存或提交等变更操作,要求只返回简洁调查结果:假设、支持证据、缺失证据、最小验证步骤、置信度,并避免无证据的泛泛代码质量反馈与臆测;发现仅回传主智能体。建议角色:子智能体 1 用 reviewer,子智能体 2 广泛追踪用 explorer 或更强的本地推理用 reviewer,子智能体 3 用 reviewer,子智能体 4 用 reviewer。只报告能实质提升找到真实原因概率的假设,宁可给出两个有证据支持的理论,也不要六个模糊猜测。

主智能体负责综合:合并去重、丢弃弱臆测、证据优先于优雅、区分可能根因与单纯促成因素、仅在仍合理时保留备选理论,并按“假设、支持证据、缺失或冲突证据、最小验证步骤、置信度(高/中/低)”归一化。证据太弱无法真正排序时直接说明,转而给出主要开放问题。最后按顺序输出:最可能根因、合理的备选原因(如有)、最快验证步骤、建议修复路径、开放问题或阻塞项;修复尚不明确时推荐下一步验证而非假装诊断已完成,必要时按“现在验证/接下来修复/后续跟进”分组。

适用场景:需要定位根因、追踪回归、理解为何损坏,或希望拿到带排序诊断的任务。

限制:本技能为只读诊断,不实施修复;仅在任务明确匹配其上游来源与本地项目上下文时使用;应用变更前需验证命令、生成代码、依赖、凭据与外部服务行为;示例不能替代环境特定测试、安全审查,以及对破坏性或高成本操作的用户批准。资料未提供安装命令、价格或平台支持信息。