交互式代码审查分类工具Skill phx:triage

这个技能用于在软件开发过程中,交互式地分类和处理代码审查发现,允许用户批准、跳过或设置优先级,优化修复工作流。特别适用于Phoenix/Elixir项目,帮助团队高效管理缺陷和提高代码质量。关键词:代码审查、triage、交互式、Phoenix框架、Elixir、缺陷管理、工作流自动化、质量保证。

测试 0 次安装 0 次浏览 更新于 3/11/2026

名称: phx:triage 描述: 交互式审查发现的分类。为每个发现呈现以供人类决策 — 批准、跳过或自定义优先级。在 /phx:review 之后使用,以在修复前过滤发现。 参数提示: [审查文件路径]

Triage — 交互式审查解决

在提交修复之前,逐一遍历审查发现以供人类决策。

使用方法

/phx:triage .claude/plans/user-auth/reviews/user-auth-review.md
/phx:triage                  # 使用最近的审查

为什么需要 Triage

/phx:review 产生发现后,你有三个选项:

  1. 修复所有/phx:plan .claude/plans/{slug}/reviews/...
  2. 先进行分类/phx:triage (过滤,然后修复重要的)
  3. 手动处理 — 阅读审查,自己选择修复什么

当审查有5个以上发现,并且你想优先处理时,最好使用此方法。

工作流程

步骤 1: 加载审查

读取审查文件。解析所有发现及其严重性。

自动批准铁律违规: 匹配13个铁律的发现会自动批准为“修复”,无需询问。在 Elixir/Phoenix 开发中,这些是非协商的。

步骤 2: 为批量选择呈现所有发现

使用 AskUserQuestion 并设置 multiSelect: true。从严重性快捷方式开始,然后列出个别发现:

AskUserQuestion:
  question: "你想修复哪些发现?(铁律违规自动包括)"
  header: "Triage"
  multiSelect: true
  options:
    - label: "所有 BLOCKERs ({count})"
      description: "修复所有关键问题"
    - label: "所有 WARNINGs ({count})"
      description: "修复所有应修复问题"
    - label: "[BLOCKER] {title 1}"
      description: "{file}:{line} — {简要描述}"
    - label: "[WARNING] {title 2}"
      description: "{file}:{line} — {简要描述}"

如果选项超过4个,分批成每组4个,并在第一批中包括严重性快捷方式。严重性快捷方式选择该级别的所有发现 — 用户可以混合使用快捷方式和个别选择。

步骤 3: 收集选定项目的上下文

对于选定的项目,询问一个批量后续问题:“对于这些有任何特定方法吗?”如果他们说“直接修复”,则继续。

步骤 4: 生成分类摘要

写入 .claude/plans/{slug}/reviews/{slug}-triage.md,包含修复队列(已批准项目带复选框)、跳过和延迟部分。

步骤 5: 呈现下一步

Triage 完成: {n} 个待修复, {n} 个跳过, {n} 个延迟。

1. 规划修复 — /phx:plan .claude/plans/{slug}/reviews/{slug}-triage.md
2. 直接修复 — /phx:work (适用于简单修复)
3. 稍后审查延迟项目
4. 捕获解决方案 — /phx:compound (如果发现已解决的模式)

铁律

  1. 批量选择优于逐个 — 使用 multiSelect 提高效率
  2. 用户决定,而非代理 — 呈现事实,不推动
  3. BLOCKERs 不能无声跳过 — 如果用户尝试,则警告
  4. 捕获用户上下文 — 每个“修复”应包括任何用户指导以改善修复
  5. 分类后建议化合物 — 如果分类揭示已解决的模式(根本原因已识别,修复已知),提及 /phx:compound

与工作流的集成

/phx:review
       |
/phx:triage  ← 你在这里 (交互式过滤)
       |
/phx:plan (带分类文件) → /phx:work → /phx:compound

参考

  • references/triage-patterns.md — 常见分类决策