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-05 16:13:08 +08:00 · 2026-03-03 23:35:41 +08:00
parent a7ed0365f7
commit 26bda9c634
188 changed files with 9332 additions and 3512 deletions
--- a/.claude/skills/team-ultra-analyze/role-specs/analyst.md
+++ b/.claude/skills/team-ultra-analyze/role-specs/analyst.md
@@ -0,0 +1,90 @@
+---
+prefix: ANALYZE
+inner_loop: false
+additional_prefixes: [ANALYZE-fix]
+subagents: []
+message_types:
+  success: analysis_ready
+  error: error
+---
+
+# Deep Analyst
+
+Perform deep multi-perspective analysis on exploration results via CLI tools. Generate structured insights, discussion points, and recommendations with confidence levels.
+
+## Phase 2: Context Loading
+
+| Input | Source | Required |
+|-------|--------|----------|
+| Task description | From task subject/description | Yes |
+| Session path | Extracted from task description | Yes |
+| Exploration results | `<session>/explorations/*.json` | Yes |
+
+1. Extract session path, topic, perspective, dimensions from task description
+2. Detect direction-fix mode: `type:\s*direction-fix` with `adjusted_focus:\s*(.+)`
+3. Load corresponding exploration results:
+
+| Condition | Source |
+|-----------|--------|
+| Direction fix | Read ALL exploration files, merge context |
+| Normal ANALYZE-N | Read exploration matching number N |
+| Fallback | Read first available exploration file |
+
+4. Select CLI tool by perspective:
+
+| Perspective | CLI Tool | Rule Template |
+|-------------|----------|---------------|
+| technical | gemini | analysis-analyze-code-patterns |
+| architectural | claude | analysis-review-architecture |
+| business | codex | analysis-analyze-code-patterns |
+| domain_expert | gemini | analysis-analyze-code-patterns |
+| direction-fix (any) | gemini | analysis-diagnose-bug-root-cause |
+
+## Phase 3: Deep Analysis via CLI
+
+Build analysis prompt with exploration context:
+
+```
+PURPOSE: <Normal: "Deep analysis of '<topic>' from <perspective> perspective">
+         <Fix: "Supplementary analysis with adjusted focus on '<adjusted_focus>'">
+Success: Actionable insights with confidence levels and evidence references
+
+PRIOR EXPLORATION CONTEXT:
+- Key files: <top 5-8 files from exploration>
+- Patterns found: <top 3-5 patterns>
+- Key findings: <top 3-5 findings>
+
+TASK:
+- <perspective-specific analysis tasks>
+- Generate structured findings with confidence levels (high/medium/low)
+- Identify discussion points requiring user input
+- List open questions needing further exploration
+
+MODE: analysis
+CONTEXT: @**/* | Topic: <topic>
+EXPECTED: Structured analysis with: key_insights, key_findings, discussion_points, open_questions, recommendations
+CONSTRAINTS: Focus on <perspective> perspective | <dimensions>
+```
+
+Execute: `ccw cli -p "<prompt>" --tool <cli-tool> --mode analysis --rule <rule>`
+
+## Phase 4: Result Aggregation
+
+Write analysis output to `<session>/analyses/analysis-<num>.json`:
+
+```json
+{
+  "perspective": "<perspective>",
+  "dimensions": ["<dim1>", "<dim2>"],
+  "is_direction_fix": false,
+  "key_insights": [{"insight": "...", "confidence": "high", "evidence": "file:line"}],
+  "key_findings": [{"finding": "...", "file_ref": "...", "impact": "..."}],
+  "discussion_points": ["..."],
+  "open_questions": ["..."],
+  "recommendations": [{"action": "...", "rationale": "...", "priority": "high"}],
+  "_metadata": {"cli_tool": "...", "cli_rule": "...", "perspective": "...", "timestamp": "..."}
+}
+```
+
+Update `<session>/wisdom/.msg/meta.json` under `analyst` namespace:
+- Read existing -> merge `{ "analyst": { perspective, insight_count, finding_count, is_direction_fix } }` -> write back
--- a/.claude/skills/team-ultra-analyze/role-specs/discussant.md
+++ b/.claude/skills/team-ultra-analyze/role-specs/discussant.md
@@ -0,0 +1,90 @@
+---
+prefix: DISCUSS
+inner_loop: false
+subagents: [cli-explore-agent]
+message_types:
+  success: discussion_processed
+  error: error
+---
+
+# Discussant
+
+Process analysis results and user feedback. Execute direction adjustments, deep-dive explorations, or targeted Q&A based on discussion type. Update discussion timeline.
+
+## Phase 2: Context Loading
+
+| Input | Source | Required |
+|-------|--------|----------|
+| Task description | From task subject/description | Yes |
+| Session path | Extracted from task description | Yes |
+| Analysis results | `<session>/analyses/*.json` | Yes |
+| Exploration results | `<session>/explorations/*.json` | No |
+
+1. Extract session path, topic, round, discussion type, user feedback:
+
+| Field | Pattern | Default |
+|-------|---------|---------|
+| sessionFolder | `session:\s*(.+)` | required |
+| topic | `topic:\s*(.+)` | required |
+| round | `round:\s*(\d+)` | 1 |
+| discussType | `type:\s*(.+)` | "initial" |
+| userFeedback | `user_feedback:\s*(.+)` | empty |
+
+2. Read all analysis and exploration results
+3. Aggregate current findings, insights, open questions
+
+## Phase 3: Discussion Processing
+
+Select strategy by discussion type:
+
+| Type | Mode | Description |
+|------|------|-------------|
+| initial | inline | Aggregate all analyses: convergent themes, conflicts, top discussion points |
+| deepen | subagent | Spawn cli-explore-agent to investigate open questions deeper |
+| direction-adjusted | cli | Re-analyze via `ccw cli` from adjusted perspective |
+| specific-questions | subagent | Targeted exploration answering user questions |
+
+**initial**: Cross-perspective summary -- identify convergent themes, conflicting views, top 5 discussion points and open questions from all analyses.
+
+**deepen**: Spawn cli-explore-agent focused on open questions and uncertain insights:
+```
+Task({
+  subagent_type: "cli-explore-agent",
+  run_in_background: false,
+  prompt: "Focus on open questions: <questions>. Find evidence for uncertain insights. Write to: <session>/discussions/deepen-<num>.json"
+})
+```
+
+**direction-adjusted**: CLI re-analysis from adjusted focus:
+```
+ccw cli -p "Re-analyze '<topic>' with adjusted focus on '<userFeedback>'" --tool gemini --mode analysis
+```
+
+**specific-questions**: Spawn cli-explore-agent targeting user's questions:
+```
+Task({ subagent_type: "cli-explore-agent", prompt: "Answer: <userFeedback>. Write to: <session>/discussions/questions-<num>.json" })
+```
+
+## Phase 4: Update Discussion Timeline
+
+1. Write round content to `<session>/discussions/discussion-round-<num>.json`:
+```json
+{
+  "round": 1, "type": "initial", "user_feedback": "...",
+  "updated_understanding": { "confirmed": [], "corrected": [], "new_insights": [] },
+  "new_findings": [], "new_questions": [], "timestamp": "..."
+}
+```
+
+2. Append round section to `<session>/discussion.md`:
+```markdown
+### Round <N> - Discussion (<timestamp>)
+#### Type: <discussType>
+#### User Input: <userFeedback or "(Initial discussion round)">
+#### Updated Understanding
+**Confirmed**: <list> | **Corrected**: <list> | **New Insights**: <list>
+#### New Findings / Open Questions
+```
+
+Update `<session>/wisdom/.msg/meta.json` under `discussant` namespace:
+- Read existing -> merge `{ "discussant": { round, type, new_insight_count, corrected_count } }` -> write back
--- a/.claude/skills/team-ultra-analyze/role-specs/explorer.md
+++ b/.claude/skills/team-ultra-analyze/role-specs/explorer.md
@@ -0,0 +1,90 @@
+---
+prefix: EXPLORE
+inner_loop: false
+subagents: [cli-explore-agent]
+message_types:
+  success: exploration_ready
+  error: error
+---
+
+# Codebase Explorer
+
+Explore codebase structure through cli-explore-agent, collecting structured context (files, patterns, findings) for downstream analysis. One explorer per analysis perspective.
+
+## Phase 2: Context & Scope Assessment
+
+| Input | Source | Required |
+|-------|--------|----------|
+| Task description | From task subject/description | Yes |
+| Session path | Extracted from task description | Yes |
+
+1. Extract session path, topic, perspective, dimensions from task description:
+
+| Field | Pattern | Default |
+|-------|---------|---------|
+| sessionFolder | `session:\s*(.+)` | required |
+| topic | `topic:\s*(.+)` | required |
+| perspective | `perspective:\s*(.+)` | "general" |
+| dimensions | `dimensions:\s*(.+)` | "general" |
+
+2. Determine exploration number from task subject (EXPLORE-N)
+3. Build exploration strategy by perspective:
+
+| Perspective | Focus | Search Depth |
+|-------------|-------|-------------|
+| general | Overall codebase structure and patterns | broad |
+| technical | Implementation details, code patterns, feasibility | medium |
+| architectural | System design, module boundaries, interactions | broad |
+| business | Business logic, domain models, value flows | medium |
+| domain_expert | Domain patterns, standards, best practices | deep |
+
+## Phase 3: Codebase Exploration
+
+Spawn `cli-explore-agent` subagent for actual exploration:
+
+```
+Task({
+  subagent_type: "cli-explore-agent",
+  run_in_background: false,
+  description: "Explore codebase: <topic> (<perspective>)",
+  prompt: `
+## Analysis Context
+Topic: <topic>
+Perspective: <perspective> -- <strategy.focus>
+Dimensions: <dimensions>
+Session: <session-folder>
+
+## MANDATORY FIRST STEPS
+1. Run: ccw tool exec get_modules_by_depth '{}'
+2. Execute searches based on topic + perspective keywords
+3. Run: ccw spec load --category exploration
+
+## Exploration Focus (<perspective> angle)
+<dimension-specific exploration instructions>
+
+## Output
+Write findings to: <session>/explorations/exploration-<num>.json
+Schema: { perspective, relevant_files: [{path, relevance, summary}], patterns: [string],
+  key_findings: [string], module_map: {module: [files]}, questions_for_analysis: [string],
+  _metadata: {agent, perspective, search_queries, timestamp} }
+`
+})
+```
+
+**ACE fallback** (when cli-explore-agent produces no output):
+```
+mcp__ace-tool__search_context({ project_root_path: ".", query: "<topic> <perspective>" })
+```
+
+## Phase 4: Result Validation
+
+| Check | Method | Action on Failure |
+|-------|--------|-------------------|
+| Output file exists | Read output path | Create empty result, run ACE fallback |
+| Has relevant_files | Array length > 0 | Trigger ACE supplementary search |
+| Has key_findings | Array length > 0 | Note partial results, proceed |
+
+Write validated exploration to `<session>/explorations/exploration-<num>.json`.
+
+Update `<session>/wisdom/.msg/meta.json` under `explorer` namespace:
+- Read existing -> merge `{ "explorer": { perspective, file_count, finding_count } }` -> write back
--- a/.claude/skills/team-ultra-analyze/role-specs/synthesizer.md
+++ b/.claude/skills/team-ultra-analyze/role-specs/synthesizer.md
@@ -0,0 +1,78 @@
+---
+prefix: SYNTH
+inner_loop: false
+subagents: []
+message_types:
+  success: synthesis_ready
+  error: error
+---
+
+# Synthesizer
+
+Integrate all explorations, analyses, and discussions into final conclusions. Cross-perspective theme extraction, conflict resolution, evidence consolidation, and recommendation prioritization. Pure integration role -- no external tools or CLI calls.
+
+## Phase 2: Context Loading
+
+| Input | Source | Required |
+|-------|--------|----------|
+| Task description | From task subject/description | Yes |
+| Session path | Extracted from task description | Yes |
+| All artifacts | `<session>/explorations/*.json`, `analyses/*.json`, `discussions/*.json` | Yes |
+| Decision trail | From wisdom/.msg/meta.json | No |
+
+1. Extract session path and topic from task description
+2. Read all exploration, analysis, and discussion round files
+3. Load decision trail and current understanding from meta.json
+4. Select synthesis strategy:
+
+| Condition | Strategy |
+|-----------|----------|
+| Single analysis, no discussions | simple (Quick mode summary) |
+| Multiple analyses, >2 discussion rounds | deep (track evolution) |
+| Default | standard (cross-perspective integration) |
+
+## Phase 3: Cross-Perspective Synthesis
+
+Execute synthesis across four dimensions:
+
+**1. Theme Extraction**: Identify convergent themes across all analysis perspectives. Cluster insights by similarity, rank by cross-perspective confirmation count.
+
+**2. Conflict Resolution**: Identify contradictions between perspectives. Present both sides with trade-off analysis when irreconcilable.
+
+**3. Evidence Consolidation**: Deduplicate findings, aggregate by file reference. Map evidence to conclusions with confidence levels:
+
+| Level | Criteria |
+|-------|----------|
+| High | Multiple sources confirm, strong evidence |
+| Medium | Single source or partial evidence |
+| Low | Speculative, needs verification |
+
+**4. Recommendation Prioritization**: Sort all recommendations by priority (high > medium > low), deduplicate, cap at 10.
+
+Integrate decision trail from discussion rounds into final narrative.
+
+## Phase 4: Write Conclusions
+
+1. Write `<session>/conclusions.json`:
+```json
+{
+  "session_id": "...", "topic": "...", "completed": "ISO-8601",
+  "summary": "Executive summary...",
+  "key_conclusions": [{"point": "...", "evidence": "...", "confidence": "high"}],
+  "recommendations": [{"action": "...", "rationale": "...", "priority": "high"}],
+  "open_questions": ["..."],
+  "decision_trail": [{"round": 1, "decision": "...", "context": "..."}],
+  "cross_perspective_synthesis": { "convergent_themes": [], "conflicts_resolved": [], "unique_contributions": [] },
+  "_metadata": { "explorations": 3, "analyses": 3, "discussions": 2, "strategy": "standard" }
+}
+```
+
+2. Append conclusions section to `<session>/discussion.md`:
+```markdown
+## Conclusions
+### Summary / Key Conclusions / Recommendations / Remaining Questions
+## Decision Trail / Current Understanding (Final) / Session Statistics
+```
+
+Update `<session>/wisdom/.msg/meta.json` under `synthesizer` namespace:
+- Read existing -> merge `{ "synthesizer": { conclusion_count, recommendation_count, open_question_count } }` -> write back