📊 页面导航

    适用角色与上手难度

    角色推荐度上手难度
    🛠️ 开发★★★★★★★☆☆☆
    🧪 测试★★★★☆★★☆☆☆
    📦 产品★★★☆☆★★★☆☆

    🎯 学习产出： 掌握 issue 分类流转的完整流程，能独立把外部请求处理成 agent-ready 的 brief

    🚀 AI 能力提升： 需求分类、信息提取

    /triage

    预计阅读时间: 5 分钟

    Issue 分类流转。把项目 issue 追踪器上的 issue 走一遍小型状态机：分类（bug / enhancement）+ 状态（5 个角色），验证声明，必要时访谈补充，最后写成 agent-ready 的 brief。

    只处理你没创建的 issue——/to-tickets 产出的票据已经 agent-ready，不要重复 triage。如果仓库把外部 PR 当作请求面，PR 视为"带代码的 issue"，用同一套机器。

    日常使用

    /triage 显示所有需要我注意的东西
/triage 看看 #42
/triage 把 #42 移到 ready-for-agent
/triage 有哪些 ready 了可以给 agent 做？

    角色状态机

    两个分类角色：

    角色含义
    bug有东西坏了
    enhancement新功能或改进

    五个状态角色：

    状态含义
    needs-triage维护者需要评估
    needs-info等报告人补充信息
    ready-for-agent完全明确，可直接交给 AFK agent
    ready-for-human需要人来实现
    wontfix不会处理

    每个 issue 恰好一个分类角色 + 一个状态角色，冲突就标记并先问维护者。未标注的 issue 正常先到 needs-triage，然后流向 needs-info / ready-for-agent / ready-for-human / wontfix；needs-info 在报告人回复后回到 needs-triage。维护者可随时覆盖，异常流转要标记并先问。

    triage 期间对追踪器的每条评论/issue 必须以 > *This was generated by AI during triage.* 开头。

    实战

    展示待办

    查追踪器，按最旧优先展示三桶：未标注（从未 triage）、needs-triage（评估中）、needs-info 且有报告人新活动（需要重新评估）。每行显示计数 + 一行摘要，让维护者挑选。

    处理具体 issue 或 PR

    1. 收集上下文：读全文（正文、评论、标签、作者、日期；PR 还有 diff），解析历史 triage 笔记不重问已解决的问题。跑两个代码库检查：(a) 冗余——按领域概念（不是请求措辞）搜是否已有实现；(b) 先前拒绝——读 .out-of-scope/*.md 找相似请求
    2. 给出建议：分类 + 状态建议及理由 + 相关代码库摘要，等指示
    3. 验证声明：bug 按报告步骤复现；PR 检出确认 diff 做到它声称的事。报告结果：确认（带代码路径）/ 失败 / 信息不足（强 needs-info 信号）
    4. 必要时访谈：调用 grilling + domain-modeling 技能，一轮一轮磨成形状，边谈边更新 CONTEXT.md/ADR
    5. 落地结果：
      • ready-for-agent：贴 agent brief
      • ready-for-human：同样结构，但说明为什么不能委托（判断、外部访问、设计决策、手动测试）
      • needs-info：贴 triage 笔记（模板见下）
      • wontfix：关闭 issue。已实现——指出位置，不写 .out-of-scope/；被拒的 bug——礼貌解释后关闭；被拒的 enhancement——写入 .out-of-scope/ 并链接后关闭

    快速覆盖

    "把 #42 移到 ready-for-agent"——信任维护者，直接应用角色，跳过访谈。移动到 ready-for-agent 而没有访谈时，问是否要写 agent brief。

    Needs-info 模板

    ## Triage Notes

**What we've established so far:**

- point 1
- point 2

**What we still need from you (@reporter):**

- question 1
- question 2

    访谈中解决的一切记入 "established so far" 以免工作丢失。问题必须具体可执行，不要"请提供更多信息"。

    恢复之前的会话

    有历史 triage 笔记就先读，检查报告人是否回答了遗留问题，展示更新后的图景再继续，不重问已解决的问题。

    与其它技能的关系

    • 汇入：产出 agent-ready 的 issue，交给 /implement 拾取
    • 内部调用：grilling（访谈）、domain-modeling（建模）
    • 前置：需要 setup-matt-pocock-skills 配置的标签词汇