claude-code-workflow 7.2.15 → 7.2.16

package/.codex/skills/team-ultra-analyze/roles/explorer/role.md

@@ -0,0 +1,74 @@
+---
+role: explorer
+prefix: EXPLORE
+inner_loop: false
+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. Load debug specs: Run `ccw spec load --category debug` for known issues and root-cause notes
+2. 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
+
+Use CLI tool for codebase exploration:
+
+```javascript
+Bash({
+  command: `ccw cli -p "PURPOSE: Explore codebase for <topic> from <perspective> perspective; success = structured findings with relevant files and patterns
+TASK: • Run module depth analysis • Search for topic-related patterns • Identify key files and their relationships • Extract architectural insights
+MODE: analysis
+CONTEXT: @**/* | Memory: Session <session-folder>, perspective <perspective>
+EXPECTED: JSON output with: relevant_files (path, relevance, summary), patterns, key_findings, module_map, questions_for_analysis, _metadata (perspective, search_queries, timestamp)
+CONSTRAINTS: Focus on <perspective> angle - <strategy.focus> | Write to <session>/explorations/exploration-<num>.json
+" --tool gemini --mode analysis --rule analysis-analyze-code-patterns`,
+})
+```
+
+**ACE fallback** (when CLI produces no output):
+```javascript
+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

package/.codex/skills/team-ultra-analyze/roles/synthesizer/role.md

@@ -0,0 +1,78 @@
+---
+role: synthesizer
+prefix: SYNTH
+inner_loop: false
+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

package/.codex/skills/team-ultra-analyze/specs/pipelines.md

@@ -0,0 +1,64 @@
+# Pipeline Definitions — Team Ultra Analyze
+
+## Pipeline Modes
+
+### Quick Mode (3 tasks, serial)
+
+```
+EXPLORE-001 -> ANALYZE-001 -> SYNTH-001
+```
+
+| Task | Role | Dependencies |
+|------|------|-------------|
+| EXPLORE-001 | explorer | (none) |
+| ANALYZE-001 | analyst | EXPLORE-001 |
+| SYNTH-001 | synthesizer | ANALYZE-001 |
+
+### Standard Mode (2N+2 tasks, parallel windows)
+
+```
+[EXPLORE-001..N](parallel) -> [ANALYZE-001..N](parallel) -> DISCUSS-001 -> SYNTH-001
+```
+
+| Task | Role | Dependencies |
+|------|------|-------------|
+| EXPLORE-001..N | explorer | (none, parallel) |
+| ANALYZE-001..N | analyst | corresponding EXPLORE-N |
+| DISCUSS-001 | discussant | all ANALYZE tasks |
+| SYNTH-001 | synthesizer | DISCUSS-001 |
+
+### Deep Mode (2N+1 tasks initially, dynamic loop)
+
+Same as Standard but SYNTH-001 is omitted at dispatch. Created dynamically after discussion loop completes.
+
+Dynamic tasks created during discussion loop:
+- `DISCUSS-N` (round N) — created based on user feedback
+- `ANALYZE-fix-N` (direction fix) — created when user requests adjusted focus
+- `SYNTH-001` — created after final discussion round
+
+## Task Metadata Registry
+
+| Task ID | Role | Dependencies | Description |
+|---------|------|-------------|-------------|
+| EXPLORE-1..depth | explorer | (none) | Parallel codebase exploration, one per perspective |
+| ANALYZE-1..depth | analyst | EXPLORE-1..depth (all) | Parallel deep analysis, one per perspective |
+| DISCUSS-001 | discussant | ANALYZE-1..depth (all) | Process analysis results, identify gaps |
+| ANALYZE-fix-N | analyst | DISCUSS-N | Re-analysis for adjusted focus (Deep mode) |
+| DISCUSS-002..N | discussant | ANALYZE-fix-N | Subsequent discussion rounds (Deep mode, max 5) |
+| SYNTH-001 | synthesizer | Last DISCUSS-N | Cross-perspective integration and conclusions |
+
+## Discussion Loop Control
+
+| Mode | Max Rounds | Trigger |
+|------|-----------|---------|
+| quick | 0 | No discussion |
+| standard | 1 | After DISCUSS-001 |
+| deep | 5 | After each DISCUSS-N |
+
+## Checkpoints
+
+| Trigger | Location | Behavior |
+|---------|----------|----------|
+| Discussion round (Deep mode) | After DISCUSS-N completes | Pause, AskUser for direction/continuation |
+| Discussion loop limit | >5 rounds | Force synthesis, offer continuation |
+| Pipeline stall | No ready + no running | Check missing tasks, report to user |

package/.codex/skills/team-ultra-analyze/specs/team-config.json

@@ -0,0 +1,129 @@
+{
+  "team_name": "ultra-analyze",
+  "version": "1.0.0",
+  "description": "深度分析团队 - 将单体分析工作流拆分为5角色协作：探索→分析→讨论→综合，支持多管道模式和讨论循环",
+  "skill_entry": "team-ultra-analyze",
+  "invocation": "Skill(skill=\"team-ultra-analyze\", args=\"--role=coordinator ...\")",
+
+  "roles": {
+    "coordinator": {
+      "name": "coordinator",
+      "responsibility": "Orchestration",
+      "task_prefix": null,
+      "description": "分析团队协调者。话题澄清、管道选择、会话管理、讨论循环驱动、结果汇报",
+      "message_types_sent": ["pipeline_selected", "discussion_round", "direction_adjusted", "task_unblocked", "error", "shutdown"],
+      "message_types_received": ["exploration_ready", "analysis_ready", "discussion_processed", "synthesis_ready", "error"],
+      "commands": ["dispatch", "monitor"]
+    },
+    "explorer": {
+      "name": "explorer",
+      "responsibility": "Orchestration (代码库探索编排)",
+      "task_prefix": "EXPLORE-*",
+      "description": "代码库探索者。通过 cli-explore-agent 多角度并行探索代码库，收集上下文",
+      "message_types_sent": ["exploration_ready", "error"],
+      "message_types_received": [],
+      "commands": ["explore"],
+      "cli_tools": ["gemini"]    },
+    "analyst": {
+      "name": "analyst",
+      "responsibility": "Read-only analysis (深度分析)",
+      "task_prefix": "ANALYZE-*",
+      "description": "深度分析师。基于探索结果，通过 CLI 多视角深度分析，生成结构化洞察",
+      "message_types_sent": ["analysis_ready", "error"],
+      "message_types_received": [],
+      "commands": ["analyze"],
+      "cli_tools": ["gemini", "codex", "claude"]
+    },
+    "discussant": {
+      "name": "discussant",
+      "responsibility": "Analysis + Exploration (讨论处理)",
+      "task_prefix": "DISCUSS-*",
+      "description": "讨论处理者。根据用户反馈调整分析方向，执行深入探索或补充分析",
+      "message_types_sent": ["discussion_processed", "error"],
+      "message_types_received": [],
+      "commands": ["deepen"],
+      "cli_tools": ["gemini"],
+      "cli_tools": ["gemini"]    },
+    "synthesizer": {
+      "name": "synthesizer",
+      "responsibility": "Read-only analysis (综合结论)",
+      "task_prefix": "SYNTH-*",
+      "description": "综合整合者。跨视角整合所有探索、分析、讨论结果，生成最终结论和建议",
+      "message_types_sent": ["synthesis_ready", "error"],
+      "message_types_received": [],
+      "commands": ["synthesize"]
+    }
+  },
+
+  "pipeline_modes": {
+    "quick": {
+      "description": "快速分析：单探索→单分析→直接综合",
+      "stages": ["EXPLORE", "ANALYZE", "SYNTH"],
+      "entry_role": "explorer",
+      "estimated_time": "10-15min"
+    },
+    "standard": {
+      "description": "标准分析：多角度并行探索→多视角分析→讨论→综合",
+      "stages": ["EXPLORE-multi", "ANALYZE-multi", "DISCUSS", "SYNTH"],
+      "entry_role": "explorer",
+      "parallel_stages": [["EXPLORE-001", "EXPLORE-002"], ["ANALYZE-001", "ANALYZE-002"]],
+      "estimated_time": "30-60min"
+    },
+    "deep": {
+      "description": "深度分析：多探索→多分析→讨论循环→综合",
+      "stages": ["EXPLORE-multi", "ANALYZE-multi", "DISCUSS-loop", "SYNTH"],
+      "entry_role": "explorer",
+      "parallel_stages": [["EXPLORE-001", "EXPLORE-002", "EXPLORE-003"], ["ANALYZE-001", "ANALYZE-002", "ANALYZE-003"]],
+      "discussion_loop": { "max_rounds": 5, "participants": ["discussant", "analyst"] },
+      "estimated_time": "1-2hr"
+    }
+  },
+
+  "discussion_loop": {
+    "max_rounds": 5,
+    "trigger": "user feedback via coordinator",
+    "participants": ["discussant", "analyst"],
+    "flow": "coordinator(AskUser) → DISCUSS-N(deepen) → [optional ANALYZE-fix] → coordinator(AskUser) → ... → SYNTH"
+  },
+
+  "shared_memory": {
+    "file": "shared-memory.json",
+    "fields": {
+      "explorations": { "owner": "explorer", "type": "array" },
+      "analyses": { "owner": "analyst", "type": "array" },
+      "discussions": { "owner": "discussant", "type": "array" },
+      "synthesis": { "owner": "synthesizer", "type": "object" },
+      "decision_trail": { "owner": "coordinator", "type": "array" },
+      "current_understanding": { "owner": "coordinator", "type": "object" }
+    }
+  },
+
+  "collaboration_patterns": [
+    "CP-1: Linear Pipeline (Quick mode)",
+    "CP-3: Fan-out (Explorer/Analyst parallel exploration)",
+    "CP-2: Review-Fix Cycle (Discussion loop: Discussant ↔ Analyst)",
+    "CP-8: User-in-the-loop (Coordinator ↔ User discussion rounds)"
+  ],
+
+  "session_directory": {
+    "pattern": ".workflow/.team/UAN-{slug}-{date}",
+    "subdirectories": ["explorations", "analyses", "discussions"]
+  },
+
+  "analysis_dimensions": {
+    "architecture": ["架构", "architecture", "design", "structure", "设计"],
+    "implementation": ["实现", "implement", "code", "coding", "代码"],
+    "performance": ["性能", "performance", "optimize", "bottleneck", "优化"],
+    "security": ["安全", "security", "auth", "permission", "权限"],
+    "concept": ["概念", "concept", "theory", "principle", "原理"],
+    "comparison": ["比较", "compare", "vs", "difference", "区别"],
+    "decision": ["决策", "decision", "choice", "tradeoff", "选择"]
+  },
+
+  "analysis_perspectives": {
+    "technical": { "tool": "gemini", "focus": "Implementation, code patterns, technical feasibility" },
+    "architectural": { "tool": "claude", "focus": "System design, scalability, component interactions" },
+    "business": { "tool": "codex", "focus": "Value, ROI, stakeholder impact, strategy" },
+    "domain_expert": { "tool": "gemini", "focus": "Domain-specific patterns, best practices, standards" }
+  }
+}