关于 triage
用于端到端处理 Bug 报告的技能,面向需要复现问题、诊断原因并评估行为是否符合预期的开发流程。根据复现和验证结果决定是否尝试修复,并在基础设施受阻时限制重试。
主要功能
- 01根据输入或 GitHub Issue 获取报告
- 02隔离上下文复现问题
- 03诊断根因并验证行为预期
- 04按结论决定是否尝试修复
适用场景
- 01调查 GitHub 上的 Bug 报告
- 02确认问题是否可复现
- 03区分预期行为与缺陷后尝试修复
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ withastro/ astro --skill triage安装后在 Claude Code 中输入/triage确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
diagnose.mdfix.mdreproduce.mdverify.mdevals/evals.json详细介绍
问题分诊
端到端地处理错误报告:重现错误、诊断根本原因、确认此行为是否符合预期,并尝试修复。
通用规则
不要被基础设施问题拖住。 如果服务无法启动、端口被占用,或者 CI 环境中无法使用某个工具,请在尝试 2 次后停止,并使用已有数据撰写报告。反复重启服务或寻找缺失的 CLI 工具,会耗尽你的全部时间预算。与其因为耗尽时间而没有报告,不如提交一份有可靠发现的部分报告。
输入
你需要满足以下任一条件:
- 在参数中提供
issueTitle和issueBody(首选——直接将其作为错误报告),或 - 在对话中提及 GitHub issue 编号或 URL(使用
gh issue view获取详情)
如果参数中提供了 triageDir,请将其用作分诊工作目录。否则,默认使用 triage/gh-<issue_number>(如果有 issue 编号),或 triage/current。
步骤 1:重现
阅读并遵循 reproduce.md。使用子 Agent 执行此步骤,以隔离上下文。
完成重现后,检查结果:
- 如果问题被跳过(特定于主机、不支持的版本等),请跳到输出。
- 如果问题无法重现,请跳到输出。
- 如果问题已重现,请继续步骤 2。
步骤 2:诊断
阅读并遵循 diagnose.md。使用子 Agent 执行此步骤,以隔离上下文。
完成诊断后,检查你的置信度:
- 如果置信度为低,请跳到输出。
- 如果置信度为中或高,请继续步骤 3。
步骤 3:验证
阅读并遵循 verify.md。使用子 Agent 执行此步骤,以隔离上下文。
完成验证后,检查结论:
- 如果结论是预期行为,请跳到输出。该问题不是错误;不要尝试修复。
- 如果结论是错误或不明确,请继续步骤 4。
步骤 4:修复
阅读并遵循 fix.md。使用子 Agent 执行此步骤,以隔离上下文。
无论修复成功还是失败,都请继续输出。
输出
完成问题分诊(或提前退出)后,返回结构化结果,以便编排器发布评论并管理标签。
评论
支持 Markdown