SuperAPI AI 工具集

github-triage

通用与其它

查看项目

更新于 10-16 08:44

技能介绍

用途:在当前仓库中对 GitHub Issue 做分诊,通过标签状态机管理问题流转。技能从 git remote 推断仓库,所有 GitHub 操作使用 gh 命令。维护者输入 /github-triage 后用自然语言描述需求,例如查看待处理问题、查看并处理某个编号的 Issue、或直接指定移动到某个状态。

标签体系:类别标签为 bug(功能损坏)与 enhancement(新功能或改进);状态标签为 needs-triage(待维护者评估)、needs-info(等待报告者补充信息)、ready-for-agent(已完全明确,可交由自主智能体)、ready-for-human(需人工实现)、wontfix(不予处理)。每个 Issue 应恰好有一个状态标签和一个类别标签;若出现冲突状态(如同时具备 needs-triage 与 ready-for-agent),先标记冲突并请维护者确认后再操作,同时给出建议。

工作流:一、呈现需要关注的内容,按未标记、needs-triage、有新活动的 needs-info 三类分组,显示各组数量,组内按最早优先排序,展示编号、标题、时长与正文一行摘要,由维护者选择深入。二、分诊具体 Issue:先读取正文、全部评论、标签、报告人和时间,解析以往分诊笔记,探索代码库上下文,并检查 .out-of-scope/ 下是否已有被拒绝的相似概念;随后给出类别与状态建议及理由,等待维护者决定;若判定为 bug,尝试复现并报告观察到的行为与代码路径;需要时进行提问式访谈以形成完整规格;最后落实结果:ready-for-agent 发布 agent brief 评论,ready-for-human 发布任务摘要并说明为何需人工,needs-info 发布分诊笔记与具体问题,wontfix 对 bug 礼貌说明后关闭,对 enhancement 写入 .out-of-scope/ 并链接后关闭。维护者明确指定状态时可快速覆盖,跳过访谈并确认将增删的标签、是否评论或关闭。

限制与其他要点:所有发布到 GitHub 的评论或 Issue 顶部必须包含声明“This was generated by AI during triage.”。标签只能沿状态机规定的方向流转,异常流转需提示。恢复既有会话时,解析已确立内容与报告者新回复,继续访谈而不重复已解决问题。参考文档包括 AGENT-BRIEF.md 与 OUT-OF-SCOPE.md,技能未提供具体命令示例以外的实现细节。