mcpField
T
triage

triage

github.com/withastro开发63.6k379 次安装1 天前更新
代码仓库

关于 triage

用于端到端处理 Bug 报告的技能,面向需要复现问题、诊断原因并评估行为是否符合预期的开发流程。根据复现和验证结果决定是否尝试修复,并在基础设施受阻时限制重试。

主要功能

  1. 01根据输入或 GitHub Issue 获取报告
  2. 02隔离上下文复现问题
  3. 03诊断根因并验证行为预期
  4. 04按结论决定是否尝试修复

适用场景

  1. 01调查 GitHub 上的 Bug 报告
  2. 02确认问题是否可复现
  3. 03区分预期行为与缺陷后尝试修复

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/withastro/astro --skill triage

安装后在 Claude Code 中输入/triage确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

diagnose.md
fix.md
reproduce.md
verify.md
evals/
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