triagelisted

# Triage（分类） 将项目 issue tracker 上的 issue 通过一个小型 state machine 进行 triage 流转。 如果本仓库将外部 PR 作为请求面处理（见 issue-tracker 配置），triage 同样覆盖它们：**PR 是带有代码的 issue** —— 相同的 role、相同的状态、相同的机器，只是下面标注了一些"针对 PR"的差异。将裸 `#42` 解析为 issue 或 PR，按 tracker 配置处理。 Triage 期间发布到 issue tracker 的每条评论**必须**以如下声明开头： ``` > *本文由 AI 在 triage 期间生成。* ``` ## 参考文档 - [AGENT-BRIEF.md](AGENT-BRIEF.md) —— 如何编写持久的 agent brief - [OUT-OF-SCOPE.md](OUT-OF-SCOPE.md) —— `.out-of-scope/` 知识库的工作原理 ## 角色 两个**分类** role： - `bug` —— 有东西坏了 - `enhancement` —— 新功能或改进 五个**状态** role： - `needs-triage` —— maintainer 需要评估 - `needs-info` —— 等待 reporter 提供更多信息 - `ready-for-agent` —— 完全明确，准备好让 AFK agent 接取 - `ready-for-human` —— 需要人类实现 - `wontfix` —— 不会处理 对于 PR，相同的状态适用于附带的代码：`ready-for-agent` 表示已附加 brief，agent 应该在 diff 上执行下一步；`ready-for-human` 表示准备好让人合并。 每个 triage 后的 issue 应恰好携带一个分类 role 和一个状态 role。如果状态 role 冲突，标注出来并在做任何其他事情前询问 maintainer。 这些是规范的 role 名称——issue tracker 中实际使用的标签字符串可能不同。映射关系应该已经提供给你——如果没有，运行 `/setup-rolex-skills`。 状态转换：未标注的 issue 通常先进入 `needs-triage`；然后可以转到 `needs-info`、`ready-for-agent`、`ready-for-human` 或 `wontfix`。`needs-info` 在 reporter 回复后回到 `needs-triage`。maintainer 可以随时覆盖——标记看起来不寻常的转换并在继续前询问。 ## 调用 maintainer 调用 `/triage` 并用自然语言描述他们想要什么。解读请求并执行。示例： - "显示所有需要我关注的内容" - "我们来看 #42"（issue 或 PR） - "把 #42 移到 ready-for-agent" - "哪些准备好了让 agent 接取？" ## 显示需要关注的内容 查询 issue tracker 并按三个桶展示，最早的在最前面： 1. **未标注** —— 从未被 triage 过 2. **`needs-triage`** —— 评估进行中 3. **`needs-info` 且 reporter 在上次 triage 后有活动** —— 需要重新评估 当 PR