SuperAPI AI 工具集

triage-issue

通用与其它

查看项目

更新于 10-15 20:35

技能介绍

用途:当用户报告 bug 或异常行为、要求“triage”或“调查此问题”、希望在遇到问题后提交工单,或想了解根因并规划修复时,可使用该技能。它会调查代码库、定位根因,并在 GitLab 或 GitHub 上创建带有 TDD 修复计划的 issue。

前置条件:项目使用 GitHub 时需要 gh(GitHub CLI,可从 https://cli.github.com 安装或 brew install gh);使用 GitLab 时需要 glab(GitLab CLI,可从 https://gitlab.com/gitlab-org/cli 安装或 brew install glab)。

主要流程:先获取问题简述,若用户未提供只问一次“What's the problem you're seeing?”,随后立即调查,尽量少提问。接着探索并诊断:定位缺陷表现入口、追踪涉事代码路径、找出根因、查看相关源码、现有测试、受影响文件的 git log、错误处理及可正常工作的相似模式。然后确定最小修复改动、受影响模块与需验证的行为,判断这是回归、缺失功能还是设计缺陷。之后设计 TDD 修复计划,按 RED-GREEN 垂直切片逐条列出:RED 描述捕获缺陷或缺失行为的测试,GREEN 描述让该测试通过的最小改动;测试应通过公共接口验证行为,一次一个测试,并可在内部重构后依然有效,必要时给出最终重构步骤。

创建 issue 前需检测平台:仓库根存在 .gitlab-ci.yml 或 git remote 含 gitlab 视为 GitLab;存在 .github/ 目录或 remote 含 github.com 视为 GitHub;两者皆无或皆有则询问用户。随后直接在对应平台创建 issue 并分享 URL,不要求用户先审阅。GitHub 使用 gh issue create,GitLab 使用 glab issue create 或 CLI 调用 GitLab API,并需要 project_id(如 group/project 的 URL 编码路径或数字 ID),不确定时从 git remote URL 推导。issue 模板包含 Problem、Root Cause Analysis、TDD Fix Plan、Related Issues、Acceptance Criteria。

限制与规则:先调查后提问;issue 描述不写具体文件路径、行号或与当前代码布局耦合的实现细节,而描述模块、行为和契约;修复计划必须基于 TDD 的 RED-GREEN 循环;每个根因只建一个 issue,多个独立 bug 分别创建;若存在相关 issue 需在 Related Issues 中链接。平台差异:GitHub 可用 bug、triage 等标签,用 #<number> 关联 issue;GitLab 可用 bug、priority::high、status::triage 等作用域标签,同类项目用 #<number>、跨项目用 group/project#<number>,自托管实例使用其 URL。该技能是否有收费或价格信息暂未提供。