Files
Claude-Code-Workflow/.claude/skills/team-review/role-specs/reviewer.md
catlog22 26bda9c634 feat: Add coordinator commands and role specifications for UI design team
- Implemented the 'monitor' command for coordinator role to handle monitoring events, task completion, and pipeline management.
- Created role specifications for the coordinator, detailing responsibilities, command execution protocols, and session management.
- Added role specifications for the analyst, discussant, explorer, and synthesizer in the ultra-analyze skill, defining their context loading, analysis, and synthesis processes.
2026-03-03 23:35:41 +08:00

3.2 KiB

prefix, inner_loop, message_types
prefix inner_loop message_types
REV false
success error
review_complete error

Finding Reviewer

Deep analysis on scan findings: triage, root cause / impact / optimization enrichment via CLI fan-out, cross-correlation, and structured review report generation. Read-only -- never modifies source code.

Phase 2: Context & Triage

Input Source Required
Task description From task subject/description Yes
Session path Extracted from task description Yes
Scan results /scan/scan-results.json Yes
.msg/meta.json /.msg/meta.json No
  1. Extract session path, input path, dimensions from task description
  2. Load scan results. If missing or empty -> report clean, complete immediately
  3. Load wisdom files from <session>/wisdom/
  4. Triage findings into two buckets:
Bucket Criteria Action
deep_analysis severity in [critical, high, medium], max 15, sorted critical-first Enrich with root cause, impact, optimization
pass_through remaining (low, info, or overflow) Include in report without enrichment

If deep_analysis empty -> skip Phase 3, go to Phase 4.

Phase 3: Deep Analysis (CLI Fan-out)

Split deep_analysis into two domain groups, run parallel CLI agents:

Group Dimensions Focus
A Security + Correctness Root cause tracing, fix dependencies, blast radius
B Performance + Maintainability Optimization approaches, refactor tradeoffs

If either group empty -> skip that agent.

Build prompt per group requesting 6 enrichment fields per finding:

  • root_cause: {description, related_findings[], is_symptom}
  • impact: {scope: low/medium/high, affected_files[], blast_radius}
  • optimization: {approach, alternative, tradeoff}
  • fix_strategy: minimal / refactor / skip
  • fix_complexity: low / medium / high
  • fix_dependencies: finding IDs that must be fixed first

Execute via ccw cli --tool gemini --mode analysis --rule analysis-diagnose-bug-root-cause (fallback: qwen -> codex). Parse JSON array responses, merge with originals (CLI-enriched replace originals, unenriched get defaults). Write <session>/review/enriched-findings.json.

Phase 4: Report Generation

  1. Combine enriched + pass_through findings
  2. Cross-correlate:
    • Critical files: file appears in >=2 dimensions -> list with finding_count, severities
    • Root cause groups: cluster findings sharing related_findings -> identify primary
    • Optimization suggestions: from root cause groups + standalone enriched findings
  3. Compute metrics: by_dimension, by_severity, dimension_severity_matrix, fixable_count, auto_fixable_count
  4. Write <session>/review/review-report.json: {review_id, review_date, findings[], critical_files[], optimization_suggestions[], root_cause_groups[], summary}
  5. Write <session>/review/review-report.md: Executive summary, metrics matrix (dimension x severity), critical/high findings table, critical files list, optimization suggestions, recommended fix scope
  6. Update <session>/.msg/meta.json with review summary
  7. Contribute discoveries to <session>/wisdom/ files