Triage

Triage

通过一组小型 triage roles state machine，在项目 issue tracker 中移动 issues。

如果这个 repo 把 external pull requests 当作 request surface（见 issue-tracker 配置），triage 也覆盖它们：PR 是带附加代码的 issue，相同的 roles、相同的 states、相同的 machine，只有下面标记为 “for a PR” 的几处差异。按 tracker 配置把裸 #42 解析为 issue 或 PR。

Triage 期间发布到 issue tracker 的每条 comment 或 issue 必须以此 disclaimer 开头：

> *This was generated by AI during triage.*

参考文档

• AGENT-BRIEF.md：如何写持久可用的 agent briefs
• OUT-OF-SCOPE.md：.out-of-scope/ knowledge base 如何工作

Roles

两个 category roles：

• bug：某个东西坏了
• enhancement：新功能或改进

五个 state roles：

• needs-triage：maintainer 需要评估
• needs-info：等待 reporter 提供更多信息
• ready-for-agent：已完整说明，准备给 AFK agent 接手
• ready-for-human：需要人工实现
• wontfix：不会处理

对 PR 而言，相同的 states 对照附加代码来解读：ready-for-agent 表示已附加 brief、agent 应对 diff 采取下一步；ready-for-human 表示已准备好由人类 merge。

每个已 triage 的 issue 应该刚好携带一个 category role 和一个 state role。如果 state roles 冲突，标记出来并先询问 maintainer，再做其他事。

这些是 canonical role names；issue tracker 中实际使用的 label strings 可能不同。映射应该已经提供给你；如果没有，请让用户运行 /setup-matt-pocock-skills。