问题分诊助手
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kunlungrowth/kg-triage。
技能介绍
解决什么问题
Issue 跟踪器常沦为愿望清单:每条进来的 issue 都缺上下文、缺复现、缺明确的下一步,维护者被迫反复追问,代理(automation)也没法令牌可打。@kunlungrowth/kg-triage 不做代码改动,只把一个 issue 或外部 PR 推过一个明确的小状态机:先分类,再核验,必要时继续拷问,最后产出一份「代理可读、可长期留存」的简报,让开发者拿到就能上手。
核心能力
- 分类与状态各一:分类二选一(
bug/enhancement),状态五选一(needs-triage/needs-info/ready-for-agent/ready-for-human/wontfix),每个 issue 恰好一个分类和一个状态。 - 待处理三桶展示:查询跟踪器后按
oldest 优先列出未标、needs-triage、needs-info且有新活动的条目,并用一行摘要提示,方便维护者快速点选。 - 上下文收集与两项检查:读全文与 diff,解析既有分诊笔记;随后跑冗余检查(按领域概念搜已有实现)和先验拒绝检查(对照
.out-of-scope/*.md),避免重问与重复拒绝。 - 核验与拷问:bug 按步骤复现,PR 检出 diff 后跑相关命令;如需打磨,则启动
/grilling与/domain-modeling逐问推进,并内联更新CONTEXT.md/ADR。 - 结构化落结果:
ready-for-agent输出含current / desired / acceptance的 agent 简报;ready-for-human附不可代理原因;needs-info留下待补信息笔记;wontfix按「已实现」或「拒绝(bug / enhancement)」分别关闭并记录。
互操作与输出
输入可为 issue/PR 编号,或一句「看需要我注意的」。输出统一为 TriageOutcome(含 category、state、verified、agent_brief 等),其中 ready-for-agent 的简报可直接交给 implement 或 tdd 消费;enhancement 类型的 wontfix 会写入 .out-of-scope/,供日后去重。
适用边界与注意点
- 仅分诊,不修改代码;外部 PR 视为「带代码的 issue」走同一状态机。
- 所有分诊评论须以
> *This was generated by AI during triage.*开头。 needs-info仅在报告者有实际回复时才回流;单次信息不足不足以支撑强信号。- 快速覆盖(如「把 #42 移到
ready-for-agent」)会直接信任用户指示并跳过拷问,但仍需确认即将执行的动作。
使用场景
- issue 跟踪器积压一批新条目,需要按未标 / needs-triage / needs-info 三桶逐条分类并贴上状态标签。
- 收到外部 PR,需要跑冗余检查与相关测试,确认它是重复实现还是可合入的变更,并给出分类建议。
- 报告者提交的 bug 缺复现步骤,需要按 needs-info 流程留下追问笔记,等对方补齐信息后再回流分诊。
- 某个 issue 已明确需求且可以 AFK 代理实现,需要生成含验收标准与范围边界的 ready-for-agent 简报。
适合人员
- 开源项目维护者,每周要清理积压 issue,并决定哪些条目可以交给代理直接实现。
- 小型技术团队负责人,希望代理拿到的不是原始讨论串,而是含验收标准的可执行简报。
- 自动化工程师,需要把分诊结果结构化为 TriageOutcome,供下游 implement 步骤直接消费。
- 技术债管理者,希望 enhancement 类拒绝写入 .out-of-scope/ 持久留档,避免同一需求被反复提出。