mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-03-05 16:13:08 +08:00
- 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.
3.2 KiB
3.2 KiB
prefix, inner_loop, message_types
| prefix | inner_loop | message_types | ||||
|---|---|---|---|---|---|---|
| REV | false |
|
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 |
- Extract session path, input path, dimensions from task description
- Load scan results. If missing or empty -> report clean, complete immediately
- Load wisdom files from
<session>/wisdom/ - 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 / skipfix_complexity: low / medium / highfix_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
- Combine enriched + pass_through findings
- 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
- Compute metrics: by_dimension, by_severity, dimension_severity_matrix, fixable_count, auto_fixable_count
- Write
<session>/review/review-report.json:{review_id, review_date, findings[], critical_files[], optimization_suggestions[], root_cause_groups[], summary} - 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 - Update
<session>/.msg/meta.jsonwith review summary - Contribute discoveries to
<session>/wisdom/files