SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场triage

triage

编程与开发

查看项目

更新于 10-16 08:21

技能介绍

Triage 是 Qwen Code 维护者用于审核 GitHub issue 和 pull request（PR）的技能，充当 PR 与 Issue 的准入门卫（Gatekeeper）。它通过 gh 命令分阶段执行准入检查，并在每个阶段后发布评论，帮助维护者高效、安全地处理社区贡献。

用途

该技能面向 Qwen Code 项目的 GitHub Action issue 分诊、PR 准入检查以及产品方向相关的审核工作。它自动化了 issue 与 PR 的初步审查流程，减少维护者的重复劳动，同时确保审核过程遵循既定规则。

主要能力

  • 解析 issue 或 PR 的编号与仓库信息，编号可来自参数或 ISSUE_NUMBER/PR_NUMBER 环境变量，仓库可来自 --repo 参数、REPOSITORY 环境变量或 GITHUB_REPOSITORY。
  • 使用 gh 命令获取 issue 或 PR 的详细信息，包括编号、标题、正文、作者、标签、评论、URL；对于 PR 还会获取增删行数、变更文件数、基础分支、头部分支、头提交 OID、是否跨仓库、是否草稿、审查决定等。
  • 列出仓库现有标签，最多 200 个。
  • 分阶段发布评论：issue 工作流第一阶段生成一条评论，第二阶段就地更新；PR 工作流生成三条评论，分别对应阶段 1（Gate）、阶段 2（Review + Test）和阶段 3（Final Decision）。
  • 支持双语评论：英文在前，中文放在 <details> 标签内，阻塞性评论会 @ 提及作者。
  • 条件性增强内容（仅 PR）：复杂 PR 可添加序列图和/或变更文件概览表，阶段 3 以一行 Confidence: N/5 开头，每个阶段性评论（终端门审查除外）以 reviewed-commit-SHA 页脚结尾。
  • 重复防护：无人值守 CI 事件（GITHUB_EVENT_NAME 为 issues 或 pull_request_target）且评论中存在 <!-- qwen-triage stage=N --> 标记时直接退出；显式重跑（issue_comment 或 workflow_dispatch）或本地调用则运行所有阶段并就地更新先前评论。每条发布的评论必须包含不可见标记 <!-- qwen-triage stage=N -->。

使用方式

  1. 运行前执行强制预检：PR 工作流必须创建工作树（enter_worktree(name: "triage")）并保存返回的 worktreePath，所有本地文件读取操作（read_file、grep_search、glob、shell 读取命令）都必须以此路径为根目录；gh API 调用不需要工作树。Issue 工作流跳过此步骤。
  2. 根据输入类型读取对应工作流文档：Issue 读取 references/issue-workflow.md，PR 读取 references/pr-workflow.md。
  3. 按 gh 命令获取 issue/PR 数据与标签列表。
  4. 遵循规则进行审核：绝不将 issue/PR 文本插入 shell；仅应用已有标签，不创建新标签，不触碰流程标签（welcome-pr、maintainer、help wanted、good first issue）；评论正文从文件读取，使用 --body-file FILE 或 gh api -F body=@FILE，避免 --body @FILE 或 gh api -f body=@FILE 导致路径被字面发布；跳过草稿 PR。
  5. 批准护栏：跨仓库（fork）PR 若标题为 refactor 类型（以 refactor — refactor:、refactor(scope):、refactor(scope)!: 开头，不区分大小写），不自动批准，按常规审查但升级给维护者。
  6. 在第二阶段评论中明确测试证据：无人值守 CI 运行时不构建或运行 PR 代码，仅通过 API 引用 PR 自身 CI 检查结果（真实检查名称、结论、失败任务日志摘录）；若涉及 TUI 等真实场景覆盖，可注明维护者可触发隔离的 @qwen-code /tmux 任务，不模拟。本地调用时，对于有用户可见行为变更的 PR，需在 tmux 中驱动真实产品并内联粘贴实际 capture-pane 输出；对于文档/类型/重构等无用户可见变更的 PR，标注 N/A。未经验证的内容需明确标注“not verified:”。
  7. 完成后移除工作树：exit_worktree(action: "remove")。

适用场景

  • Qwen Code 维护者在 GitHub Action 中自动分诊 issue。
  • 对 PR 进行准入检查、审查和最终决定。
  • 需要安全、一致地处理社区贡献，避免执行不可信代码或编造策略规则。

限制

  • 该技能仅适用于 Qwen Code 项目的维护者工作流，依赖 gh 命令和 GitHub 环境。
  • 严格禁止执行 PR 派生代码：不运行 npm/node/npx/解释器/构建/测试命令，不执行 gh pr checkout、git apply diff，也不运行 PR 添加或修改的任何脚本。在 CI 中代理环境带有写 PAT，执行代码可能读取该令牌，因此此项为最高优先级规则。
  • 禁止编造策略：不得虚构阻塞规则、行数阈值或命名策略，若对规模或范围有疑虑，只能作为问题在阶段 1 评论中提出，不能作为阻塞或 CHANGES_REQUESTED。升级标准以 references/pr-workflow.md 中定义的为准。
  • 具体的工作流细节、触发器、阈值、转义和模板均在 references/pr-workflow.md 中，需查阅该文件作为唯一事实来源。
  • 当前未提供关于收费、价格、平台支持范围等额外信息。