用途
triage-issue 是一个用于问题分诊(triage)的技能。它的目标是在用户报告缺陷或问题时:探索代码库找到根本原因,然后创建一个包含基于 TDD(测试驱动开发)修复计划的 GitHub issue。适用场景为用户报告 bug、希望定位问题并形成可执行的修复计划。整个过程以尽量少向用户提问为原则,整体偏自动化。
主要能力
- 捕获问题:获取一段简要的问题描述;如果没有描述,则询问:“你看到的问题是什么?”,随后开始调查。
- 探索、诊断并规划修复:使用 Agent 工具(subagent_type=Explore)查找缺陷显现的位置、相关的代码路径、失败原因(关注根本原因而非表面症状),以及相关的测试和可用的工作模式;同时检查 git log。之后确定最小修复方案、受影响的模块和所需的测试覆盖。
- 设计 TDD 修复计划:列出有序的 RED-GREEN 循环,每个循环是一个垂直切片:RED——为损坏或缺失的行为编写测试;GREEN——做最小改动使其通过。断言针对公共接口,而非内部实现。方法论参见 tdd 技能。
- 创建 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 修复任务的开发工作流。
限制
资料中未提供该技能的安装方式、支持的平台、收费与价格、实现细节等内容,暂未提供相关信息。