名称: phx:triage 描述: 交互式审查发现的分类。为每个发现呈现以供人类决策 — 批准、跳过或自定义优先级。在 /phx:review 之后使用,以在修复前过滤发现。 参数提示: [审查文件路径]
Triage — 交互式审查解决
在提交修复之前,逐一遍历审查发现以供人类决策。
使用方法
/phx:triage .claude/plans/user-auth/reviews/user-auth-review.md
/phx:triage # 使用最近的审查
为什么需要 Triage
在 /phx:review 产生发现后,你有三个选项:
- 修复所有 —
/phx:plan .claude/plans/{slug}/reviews/... - 先进行分类 —
/phx:triage(过滤,然后修复重要的) - 手动处理 — 阅读审查,自己选择修复什么
当审查有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 (如果发现已解决的模式)
铁律
- 批量选择优于逐个 — 使用 multiSelect 提高效率
- 用户决定,而非代理 — 呈现事实,不推动
- BLOCKERs 不能无声跳过 — 如果用户尝试,则警告
- 捕获用户上下文 — 每个“修复”应包括任何用户指导以改善修复
- 分类后建议化合物 — 如果分类揭示已解决的模式(根本原因已识别,修复已知),提及
/phx:compound
与工作流的集成
/phx:review
|
/phx:triage ← 你在这里 (交互式过滤)
|
/phx:plan (带分类文件) → /phx:work → /phx:compound
参考
references/triage-patterns.md— 常见分类决策