分类处理
通过一个由分类角色组成的简单状态机,在项目的议题跟踪器中移动议题。
在分类处理期间,发布到议题跟踪器的每条评论或议题必须以以下免责声明开头:
> *此内容由AI在分类处理期间生成。*
参考文档
- AGENT-BRIEF.md — 如何编写持久的智能体简报
- OUT-OF-SCOPE.md —
.out-of-scope/知识库的工作原理
角色
两个分类角色:
bug— 某功能已损坏enhancement— 新功能或改进
五个状态角色:
needs-triage— 需要维护者评估needs-info— 等待报告人提供更多信息ready-for-agent— 已完全指定,可供离线智能体处理ready-for-human— 需要人工实现wontfix— 不处理
每个经过分类的议题应恰好携带一个分类角色和一个状态角色。如果状态角色冲突,请标记冲突并向维护者请示,然后再进行其他操作。
这些是规范的角色名称——议题跟踪器中实际使用的标签字符串可能有所不同。映射关系应已提供给您——如果尚未提供,请运行 /setup-matt-pocock-skills。
状态转换:未标记的议题通常首先进入needs-triage;从那里移动到needs-info、ready-for-agent、ready-for-human或wontfix。一旦报告人回复,needs-info会返回needs-triage。维护者可以随时覆盖——请标记看起来异常的转换,并在继续操作前请示。
调用方式
维护者调用/triage并用自然语言描述他们的需求。解释请求并执行。示例:
- “显示所有需要我关注的内容”
- “我们来看看 #42”
- “将 #42 移至 ready-for-agent”
- “哪些议题已经准备好供智能体处理?”
显示需要关注的内容
查询议题跟踪器并按以下三个分组呈现,旧的在前:
- 未标记 — 从未经过分类。
needs-triage— 正在评估中。needs-info且自上次分类记录后有报告人活动 — 需要重新评估。
显示每个分组的计数以及每个议题的单行摘要。让维护者选择。
分类特定议题
-
收集上下文。 阅读完整的议题(正文、评论、标签、报告人、日期)。解析任何先前的分类记录,避免重复提问已解决的问题。使用项目的领域术语表探索代码库,尊重相关区域的架构决策记录(ADR)。阅读
.out-of-scope/*.md,找出任何与当前议题类似的先前被拒绝的议题并予以呈现。 -
推荐。 向维护者告知您的分类和状态推荐并附上理由,同时提供与该议题相关的简要代码库摘要。等待指示。
-
复现(仅限 bug)。 在任何追问之前,尝试复现:阅读报告人的步骤,跟踪相关代码,运行测试或命令。报告发生了什么——成功复现并附带代码路径、复现失败,或信息不足(这是一个强烈的
needs-info信号)。确认的复现能使智能体简报更加强大。 -
追问(如果需要)。 如果议题需要补充细节,请同时运行
/grilling和/domain-modeling技能——一次一个问题地询问议题细节,逐步明确领域术语,并在决策确定时内联更新CONTEXT.md/ADR。 -
应用结果:
ready-for-agent— 发布智能体简报评论(AGENT-BRIEF.md)。ready-for-human— 结构与智能体简报相同,但需说明为何不能委托(判断性决策、外部访问、设计决策、手动测试)。needs-info— 发布分类记录(模板见下文)。wontfix(bug) — 礼貌解释,然后关闭。wontfix(enhancement) — 写入.out-of-scope/,在评论中链接到它,然后关闭(OUT-OF-SCOPE.md)。needs-triage— 应用角色。可选地添加评论以记录部分进展。
快速状态覆盖
如果维护者说“将 #42 移至 ready-for-agent”,请信任他们并直接应用角色。确认您将要执行的操作(角色更改、评论、关闭),然后执行。跳过追问步骤。如果移动到 ready-for-agent 但未经过追问环节,请询问他们是否要编写智能体简报。
需要信息模板
## 分类记录
**目前我们已经确定的内容:**
- 要点 1
- 要点 2
**我们仍需要的来自您(@报告人)的信息:**
- 问题 1
- 问题 2
在“已确定的内容”下捕捉追问期间解决的所有内容,以确保工作不会丢失。问题必须具体且可操作,而非“请提供更多信息”。
恢复之前的会话
如果议题上存在先前的分类记录,请阅读它们,检查报告人是否已回答了任何未解决的问题,并在继续之前呈现更新的状态。不要重复提问已解决的问题。