SuperAPI AI 工具集

dev-debug

测试与质量

查看项目

更新于 10-15 20:08

技能介绍

用途:以系统化方式调试问题,先理解再修复。通过 “/dev-debug <description of the issue>” 调用,围绕 $ARGUMENTS 中的问题描述展开。

主要能力与流程:

  1. 理解问题:从问题描述生成简短 slug(如 “login fails after redirect” 对应 login_redirect_fail),创建 .llm/debug_<slug>/ 目录;阅读相关代码路径并追踪逻辑,列出 2-5 个按概率排序的可能根因,写入 .llm/debug_<slug>/tmp_root_causes.md,内容包含问题重述、根因排序、原因解释、代码证据和相关文件路径;随后向用户展示根因并询问是否同意排序或指定优先修复项。
  2. 修复最可能根因:在用户确认后(或默认采用第 1 项)实施最小且聚焦的修改,遵循现有代码模式与约定,不做顺带重构。
  3. 测试:运行覆盖受影响代码路径的现有测试;若没有测试或未覆盖该情况,告知用户需手动测试的内容及预期行为;测试失败则修复并重新测试。
  4. 提交:暂存并提交,命令为 git add -A && git commit -m "fix: <concise description of what was fixed and why>"。
  5. 检查剩余问题:若未完全解决或存在相关问题,更新 .llm/debug_<slug>/tmp_root_causes.md,标记第 1 项已处理并重新排序剩余根因,回到第 2 步处理下一根因,每次修复后提交;问题解决后告知用户:Debug complete. Fixed in N commit(s). See .llm/debug_<slug>/tmp_root_causes.md for the full analysis.

适用场景:需要基于代码证据定位并修复缺陷,且希望保留分析记录和逐次提交的调试任务。

限制:资料未提供所支持的语言、框架、平台、收费方式或性能保证;流程依赖用户确认根因排序,且需要可用的测试与 Git 环境。