SuperAPI AI 工具集

triage

通用与其它

查看项目

更新于 10-26 17:43

技能介绍

triage 是一个用于问题分诊的智能体技能,主要面向开源项目维护者。其核心目标是调查问题报告、证明处置结论并主导修复,而不是将实现工作推回给报告者或贡献者。

用途: 该技能适用于问题积压清理、重复/解决状态调查,以及从问题到修复的维护者处理流程。它支持通过 /triage 命令指定问题 URL、编号、范围或查询,也接受粘贴的报告或讨论串。仅审查 PR 的场景属于 pr-triage,已拥有 PR 的 CI/审查属于 pr-ready。

主要能力:

  • 建立证据基础:确定规范上游仓库和代码托管平台,读取仓库说明和贡献政策,固定审查的提交 SHA。
  • 阅读、搜索和聚类:完整阅读问题正文、评论和时间线,搜索相关问题和 PR,按根因或缺陷类别形成聚类。
  • 在固定默认分支上验证现实:追踪调用链,使用最小真实路径测试或探针复现问题,区分已复现、静态证明、未复现和受阻等状态。
  • 选择处置结论:包括 fix、duplicate、resolved、not-a-bug、feature-request、needs-evidence 和 skipped。
  • 一次性修复并整合相关 PR:为每个因果聚类创建专用工作树和分支,将相关提议修复整合为维护者所有的合并目标,保留贡献者署名。
  • 发布与协调:遵循 CPR 流程创建或刷新 PR,在授权范围内关闭被完全取代的源 PR,并验证最终状态。

使用方式: 通过 /triage 后跟问题 URL、编号、范围或查询来调用,也可以在普通文本中提及技能名称。需要宿主智能体具备 shell、文件、搜索和委派能力,使用 gh 处理 GitHub、glab 处理 GitLab 或代码托管平台的认证 API。仓库说明决定测试命令和平台特定验证。

适用场景:

  • 维护者进行问题积压清理和分诊。
  • 调查重复问题或解决状态。
  • 从问题到修复的完整维护者处理流程。
  • 整合多个竞争性 PR 为单一维护者所有的修复。

限制:

  • 仅审查 PR 的场景不属于此技能。
  • 裸 /triage 仅进行调查和给出结论,不进行代码托管平台写入、实现、提交或推送,直到获得授权。
  • “修复”、“发布”、“执行”或“继续”等指令授权商定的实现/发布范围;仅修复请求不授权无关的关闭操作。
  • 不允许因年龄、流行度、推测性产品品味或本地设置失败而自动关闭问题。
  • 安全报告遵循私有披露政策,不进行公开复现评论。
  • 需要宿主提供必要的配套技能(如 cpr、pr-ready),缺失会阻碍安装。
  • 低风险变基自动合并需要基于整体差异和受影响调用路径的评估,缺少证据视为不确定,不能启用。