SuperAPI AI 工具集

triage-issue

编程与开发

查看项目

更新于 10-16 10:51

技能介绍

用途

triage-issue 是一个用于问题分诊(triage)的技能。它的目标是在用户报告缺陷或问题时:探索代码库找到根本原因,然后创建一个包含基于 TDD(测试驱动开发)修复计划的 GitHub issue。适用场景为用户报告 bug、希望定位问题并形成可执行的修复计划。整个过程以尽量少向用户提问为原则,整体偏自动化。

主要能力

  1. 捕获问题:获取一段简要的问题描述;如果没有描述,则询问:“你看到的问题是什么?”,随后开始调查。
  2. 探索、诊断并规划修复:使用 Agent 工具(subagent_type=Explore)查找缺陷显现的位置、相关的代码路径、失败原因(关注根本原因而非表面症状),以及相关的测试和可用的工作模式;同时检查 git log。之后确定最小修复方案、受影响的模块和所需的测试覆盖。
  3. 设计 TDD 修复计划:列出有序的 RED-GREEN 循环,每个循环是一个垂直切片:RED——为损坏或缺失的行为编写测试;GREEN——做最小改动使其通过。断言针对公共接口,而非内部实现。方法论参见 tdd 技能。
  4. 创建 GitHub issue:通过 gh issue create 并使用下述模板创建,完成后分享 URL。

使用方式

触发后按上述四步流程执行。issue 模板包含以下部分:

Problem:实际行为、期望行为、复现步骤。

Root Cause Analysis:代码路径、失败原因、促成因素。描述行为/契约,而不是文件路径或行号。

TDD Fix Plan

  • RED: test for [behavior] → GREEN: [minimal change to pass]
  • RED: test for [next behavior] → GREEN: [minimal change to pass]
  • REFACTOR: [any cleanup needed]

Acceptance Criteria

  • Criterion 1
  • Criterion 2
  • All new tests pass
  • Existing tests still pass

最后打印 issue 的 URL 以及一行根本原因摘要。

适用场景

当用户报告 bug、希望排查问题根因并生成 GitHub issue 修复计划时使用。适合需要快速把问题转化为可执行 TDD 修复任务的开发工作流。

限制

资料中未提供该技能的安装方式、支持的平台、收费与价格、实现细节等内容,暂未提供相关信息。