Triage

Triage 帮助维护者核查 Issue 依据、按仓库约定标记状态,并为能交给 Agent 的任务整理说明。

为一个 Issue 取证并建议分诊状态

先检查 Issue 证据,再建议类别和状态。分诊结论与跟踪器的实际更新分别确认。

提供链接、仓库约定和已经做过的复现。

复制请求,在 Floatboat 新对话中粘贴,并提供所需资料。

下载 Floatboat

带入 Floatboat 的请求

请求可预览和复制,不会从此处自动发送。

参考来源: Triage
https://github.com/mattpocock/skills/blob/main/skills/engineering/triage/SKILL.md

先阅读原始说明并核对当前环境与依赖。需要安装或连接新工具时,先提出方案。

我的任务:
用 Matt Pocock 的 Triage 审阅 Issue #42。核查复现、相关代码和历史决定,给出一个类别和一个状态。证据充分时起草 Agent 任务书,获得确认后再发到跟踪器。

期望交付:
一份带依据的状态建议,以及 Agent 任务书或一个有针对性的追问。

Triage 如何工作

Matt Pocock 的 Triage Skill 为 Issue 确定一种类别和一个状态。它先读问题、代码、术语表和历史决定,再建议补充依据、编写任务书、交给维护者或关闭请求。仓库启用外部 PR 分诊时,相关 PR 也可进入待办。跟踪器和标签映射来自 Setup Matt Pocock Skills。

Triage 的使用场景

分诊要交代问题已经证实到哪一步、还缺什么依据、接下来由谁处理。只有预期行为和验收方式都清楚时,才适合交给 Agent 实施。

向报告者索取有效复现

问题缺少版本或预期结果时,先确定哪条信息最能推进诊断。只问需要补充的证据,避免让报告者重写整份问题。

识别仓库已经支持的需求

按领域概念查找现有实现,不能只搜索 Issue 原文。记录功能的位置和核查依据,再建议维护者是否关闭这条请求。

给 Agent 准备有边界的任务

行为和范围已明确时,在说明里列出相关文件、预期行为、验收方式及必须保留的现有行为,让结果可以独立复核。

处理外部 Pull Request

仓库启用外部 PR 分诊后,同时查看描述、差异和检查状态。把 Agent 可以跟进的小改动与需要维护者判断的合并决定分开。

如何使用 Triage

从一条明确的 Issue 或 PR 开始,读取项目里的角色映射。把取证结果、建议状态和外部评论草案分开交给维护者,确认后再写入跟踪器。

  1. 读取跟踪器和标签配置

    查看仓库现有分诊配置,并确认这次要审阅的 Issue 或 PR。

  2. 先取证再给出状态

    阅读讨论和相关代码,检查标签冲突、已有实现、历史决定及仍缺少的证据。

  3. 展示建议更新

    给出类别、状态和任务书或追问草案,确认后通过已配置的跟踪器更新。

探索更多 Agent Skills

查看其他 Skill 指南,并在使用前核对原始来源。

Triage 常见问题

类别和状态有什么区别?
类别区分缺陷与增强请求。状态说明工作接下来需要什么,以及下一步由谁负责。
一条 Issue 有多个相互冲突的状态怎么办?
按上游指引先指出冲突,由维护者确认正确状态后再执行后续操作。
需要先配置仓库吗?
Triage 需要跟踪器与角色标签映射。缺少这些配置时,先运行 Setup Matt Pocock Skills。
可以分诊外部 PR 吗?
仓库启用这类请求后可以。查找待处理 PR 时,上游规则区分外部贡献者和仓库协作者。
可交给 Agent 的任务书应该包含什么?
写明预期行为、已核实的依据和验证方式,并标出仍然需要人决定的问题。
发布的分诊评论会标明由谁生成吗?
上游要求其发出的评论或 Issue 声明由 AI 分诊生成。发布前先审阅内容并确认授权。