技能 编程开发 缺陷分类结果展示与命令解析

缺陷分类结果展示与命令解析

v20260423
triage-display
该技能是内部代理流程,用于将缺陷分类(triage)的结果格式化为终端markdown。它负责生成结构化的摘要视图、详细的证据展示,并解析用户输入的审核命令(如标记、归档、升级),从而驱动整个缺陷管理和工作流。它不直接供用户调用。
获取技能
162 次下载
概览

Triage Display Process

Step-by-step procedure for formatting triage results as terminal-ready markdown and handling interactive review command parsing.

Instructions

Step 1: Render Summary

Produce the initial triage summary as terminal markdown:

X Bug Triage — Run {date} {time} UTC
Account: @{account} · Window: last {window} · {count} posts ({unique} unique, {dedup_groups} duplicate groups)
⚠ Data quality: {warning}                  ← show ONLY when date_confidence is low or medium

--- Sources ---                             ← show ALWAYS between header and clusters
{source_name}      {status}    {count} posts   (rate limit: {remaining}/{limit})
...

--- {n} clusters ({new} new, {existing} existing) ---

{icon} {#} · {bug_signature}
     {report_count} reports · {severity} severity · {status_note}
     Owner: {team}
     Evidence: {t1} Tier 1, {t2} Tier 2, {t3} Tier 3, {t4} Tier 4 · Top: {description}

--- Commands ---
details <#>  ·  file <#>  ·  dismiss <#>  ·  merge <#> <issue>
escalate <#>  ·  monitor <#>  ·  snooze <#> <duration>
split <#>  ·  reroute <#>  ·  full-report

Step 2: Render Detail View (for details command)

When showing a single cluster in detail:

  • Family, surface, feature area
  • Report count, confidence percentage
  • Severity + rationale (always show rationale for high/critical)
  • Status and time range (firstseen to lastseen)
  • Evidence summary line: "Evidence: {t1} Tier 1, {t2} Tier 2, {t3} Tier 3, {t4} Tier 4" (omit tiers with 0 count)
  • Evidence listed by tier (all tiers, highest first)
  • 3 representative posts (highest quality, most distinct, most recent) — truncate at 100 chars
  • Routing with ranked assignees and confidence percentages

Step 3: Parse Review Commands

When receiving a command string, call mcp__triage__parse_review_command:

  • Returns structured ParsedCommand with command, clusterNumber, args, valid, error
  • If invalid: display the error message to the user
  • If valid: return the parsed command to the orchestrator for execution

Step 4: Render Action Confirmation

After each successfully executed review command, display a confirmation line using formatActionConfirmation() from mcp/triage-server/lib.ts. Examples:

  • dismiss 1 noise → "Cluster #1 dismissed (noise). Suppression rule created."
  • file 2 → "Draft issue created for cluster #2. Use "confirm file 2" to submit."
  • escalate 3 → "Cluster #3 escalated. Severity raised."

Formatting Rules

  • Severity icons: redcircle = critical/high, yellowcircle = medium, green_circle = low
  • Cluster cap: Show top 5 by severity. If >5, append "{N} more — type full-report"
  • Line budget: Max 20 lines for <=5 clusters in summary view
  • Post truncation: Representative posts capped at 100 chars with "..." suffix
  • Large clusters: >50 reports — show count + top 3 posts only
  • Evidence display: Summary shows per-tier counts + top evidence description. Detail shows per-tier counts + full evidence list, ranked. Omit tiers with 0 count from the summary line.
  • Routing display: Summary shows team name only. Detail shows ranked assignees with source and confidence.

References

Load override and memory policy for review command processing:

!cat skills/x-bug-triage/references/review-memory-policy.md
信息
分类 编程开发
名称 triage-display
版本 v20260423
大小 3.84KB
更新时间 2026-04-28
语言