跳转到内容
关系图谱

triage(Matt)

391 字 1 分钟

属性 8
repo
mattpocock_skills
skill
triage
source
mattpocock_skills/skills/engineering/triage/SKILL.md
invoke
user
phase
define
cost
low
status
stable
local
outdated
一句话

把 tracker 上别人提的 issue 和外部 PR 过一台小型状态机:一个 category 角色加一个 state 角色,核实、必要时访谈,终点是 agent-ready 的 brief、给报告人的具体问题、或带理由的关闭。

何时用 ​

  • 适合:别人报来的 bug、feature request、不请自来的外部 PR;问「有什么需要我处理」。
  • 不适合:你自己或 matt-to-tickets 生成的票(已是 agent-ready,过了浪费);要根治的 bug 去 matt-diagnosing-bugs。

怎么用 ​

text
/triage 看看有什么需要我处理的
  1. 列三桶:unlabeled、needs-triage、有报告人新回复的 needs-info;外部 PR 标 [PR](协作者的 PR 不算)。
  2. 单个处理:读全上下文,先查两项:代码库里有没有已有实现(redundancy,有就是 wontfix)、.out-of-scope/ 里有没有被否过的类似请求。
  3. 给 category+state 推荐和理由,等 maintainer 指示;需要时先验证 claim:bug 按步骤复现、PR 跑相关测试。
  4. 要展开就连调 matt-grilling 和 matt-domain-modeling。
  5. 落结果:ready-for-agent 贴 agent brief(格式见 AGENT-BRIEF.md);needs-info 贴具体可答的 triage notes;wontfix 关闭,被拒的 enhancement 先写 .out-of-scope/ 再关。

产出 ​

  • 标签变更 + tracker 评论(brief、triage notes 或关闭理由);被拒 enhancement 写 .out-of-scope/。

要点与坑 ​

  • 发到 tracker 的每条评论必须以规定的免责声明开头。
  • 推荐后等拍板;maintainer 说「move #42 to X」可直接执行并跳过访谈。
  • 两个 category(bug、enhancement)加五个 state,每 issue 恰各挂一个。
本机版本差异

术语文件改名:本机 CONTEXT.md → 仓库版 GLOSSARY.md。

关联 ​