claude-code-workflow 6.3.18 → 6.3.19

package/.claude/skills/ccw/phases/actions/bugfix.md

@@ -0,0 +1,218 @@
+# Action: Bugfix Workflow
+
+缺陷修复工作流：智能诊断 + 影响评估 + 修复
+
+## Pattern
+
+```
+lite-fix [--hotfix]
+```
+
+## Trigger Conditions
+
+- Keywords: "fix", "bug", "error", "crash", "broken", "fail", "修复", "报错"
+- Problem symptoms described
+- Error messages present
+
+## Execution Flow
+
+### Standard Mode
+
+```mermaid
+sequenceDiagram
+    participant U as User
+    participant O as CCW Orchestrator
+    participant LF as lite-fix
+    participant CLI as CLI Tools
+    
+    U->>O: Bug description
+    O->>O: Classify: bugfix (standard)
+    O->>LF: /workflow:lite-fix "bug"
+    
+    Note over LF: Phase 1: Diagnosis
+    LF->>CLI: Root cause analysis (Gemini)
+    CLI-->>LF: diagnosis.json
+    
+    Note over LF: Phase 2: Impact Assessment
+    LF->>LF: Risk scoring (0-10)
+    LF->>LF: Severity classification
+    LF-->>U: Impact report
+    
+    Note over LF: Phase 3: Fix Strategy
+    LF->>LF: Generate fix options
+    LF-->>U: Present strategies
+    U->>LF: Select strategy
+    
+    Note over LF: Phase 4: Verification Plan
+    LF->>LF: Generate test plan
+    LF-->>U: Verification approach
+    
+    Note over LF: Phase 5: Confirmation
+    LF->>U: Execution method?
+    U->>LF: Confirm
+    
+    Note over LF: Phase 6: Execute
+    LF->>CLI: Execute fix (Agent/Codex)
+    CLI-->>LF: Results
+    LF-->>U: Fix complete
+```
+
+### Hotfix Mode
+
+```mermaid
+sequenceDiagram
+    participant U as User
+    participant O as CCW Orchestrator
+    participant LF as lite-fix
+    participant CLI as CLI Tools
+    
+    U->>O: Urgent bug + "hotfix"
+    O->>O: Classify: bugfix (hotfix)
+    O->>LF: /workflow:lite-fix --hotfix "bug"
+    
+    Note over LF: Minimal Diagnosis
+    LF->>CLI: Quick root cause
+    CLI-->>LF: Known issue?
+    
+    Note over LF: Surgical Fix
+    LF->>LF: Single optimal fix
+    LF-->>U: Quick confirmation
+    U->>LF: Proceed
+    
+    Note over LF: Smoke Test
+    LF->>CLI: Minimal verification
+    CLI-->>LF: Pass/Fail
+    
+    Note over LF: Follow-up Generation
+    LF->>LF: Generate follow-up tasks
+    LF-->>U: Fix deployed + follow-ups created
+```
+
+## When to Use
+
+### Standard Mode (/workflow:lite-fix)
+✅ **Use for**:
+- 已知症状的 Bug
+- 本地化修复（1-5 文件）
+- 非紧急问题
+- 需要完整诊断
+
+### Hotfix Mode (/workflow:lite-fix --hotfix)
+✅ **Use for**:
+- 生产事故
+- 紧急修复
+- 明确的单点故障
+- 时间敏感
+
+❌ **Don't use** (for either mode):
+- 需要架构变更 → `/workflow:plan --mode bugfix`
+- 多个相关问题 → `/issue:plan`
+
+## Severity Classification
+
+| Score | Severity | Response | Verification |
+|-------|----------|----------|--------------|
+| 8-10 | Critical | Immediate | Smoke test only |
+| 6-7.9 | High | Fast track | Integration tests |
+| 4-5.9 | Medium | Normal | Full test suite |
+| 0-3.9 | Low | Scheduled | Comprehensive |
+
+## Configuration
+
+```javascript
+const bugfixConfig = {
+  standard: {
+    diagnosis: {
+      tool: 'gemini',
+      depth: 'comprehensive',
+      timeout: 300000  // 5 min
+    },
+    impact: {
+      riskThreshold: 6.0,  // High risk threshold
+      autoEscalate: true
+    },
+    verification: {
+      levels: ['smoke', 'integration', 'full'],
+      autoSelect: true  // Based on severity
+    }
+  },
+  
+  hotfix: {
+    diagnosis: {
+      tool: 'gemini',
+      depth: 'minimal',
+      timeout: 60000  // 1 min
+    },
+    fix: {
+      strategy: 'single',  // Single optimal fix
+      surgical: true
+    },
+    followup: {
+      generate: true,
+      types: ['comprehensive-fix', 'post-mortem']
+    }
+  }
+}
+```
+
+## Example Invocations
+
+```bash
+# Standard bug fix
+ccw "用户头像上传失败，返回 413 错误"
+→ lite-fix
+→ Diagnosis: File size limit in nginx
+→ Impact: 6.5 (High)
+→ Fix: Update nginx config + add client validation
+→ Verify: Integration test
+
+# Production hotfix
+ccw "紧急：支付网关返回 5xx 错误，影响所有用户"
+→ lite-fix --hotfix
+→ Quick diagnosis: API key expired
+→ Surgical fix: Rotate key
+→ Smoke test: Payment flow
+→ Follow-ups: Key rotation automation, monitoring alert
+
+# Unknown root cause
+ccw "购物车随机丢失商品，原因不明"
+→ lite-fix
+→ Deep diagnosis (auto)
+→ Root cause: Race condition in concurrent updates
+→ Fix: Add optimistic locking
+→ Verify: Concurrent test suite
+```
+
+## Output Artifacts
+
+```
+.workflow/.lite-fix/{bug-slug}-{timestamp}/
+├── diagnosis.json       # Root cause analysis
+├── impact.json          # Risk assessment
+├── fix-plan.json        # Fix strategy
+├── task.json            # Enhanced task for execution
+└── followup.json        # Follow-up tasks (hotfix only)
+```
+
+## Follow-up Tasks (Hotfix Mode)
+
+```json
+{
+  "followups": [
+    {
+      "id": "FOLLOWUP-001",
+      "type": "comprehensive-fix",
+      "title": "Complete fix for payment gateway issue",
+      "due": "3 days",
+      "description": "Implement full solution with proper error handling"
+    },
+    {
+      "id": "FOLLOWUP-002",
+      "type": "post-mortem",
+      "title": "Post-mortem analysis",
+      "due": "1 week",
+      "description": "Document incident and prevention measures"
+    }
+  ]
+}
+```

package/.claude/skills/ccw/phases/actions/coupled.md

@@ -0,0 +1,194 @@
+# Action: Coupled Workflow
+
+复杂耦合工作流：完整规划 + 验证 + 执行
+
+## Pattern
+
+```
+plan → action-plan-verify → execute
+```
+
+## Trigger Conditions
+
+- Complexity: High
+- Keywords: "refactor", "重构", "migrate", "迁移", "architect", "架构"
+- Cross-module changes
+- System-level modifications
+
+## Execution Flow
+
+```mermaid
+sequenceDiagram
+    participant U as User
+    participant O as CCW Orchestrator
+    participant PL as plan
+    participant VF as verify
+    participant EX as execute
+    participant RV as review
+    
+    U->>O: Complex task
+    O->>O: Classify: coupled (high complexity)
+    
+    Note over PL: Phase 1: Comprehensive Planning
+    O->>PL: /workflow:plan
+    PL->>PL: Multi-phase planning
+    PL->>PL: Generate IMPL_PLAN.md
+    PL->>PL: Generate task JSONs
+    PL-->>U: Present plan
+    
+    Note over VF: Phase 2: Verification
+    U->>VF: /workflow:action-plan-verify
+    VF->>VF: Cross-artifact consistency
+    VF->>VF: Dependency validation
+    VF->>VF: Quality gate checks
+    VF-->>U: Verification report
+    
+    alt Verification failed
+        U->>PL: Replan with issues
+    else Verification passed
+        Note over EX: Phase 3: Execution
+        U->>EX: /workflow:execute
+        EX->>EX: DAG-based parallel execution
+        EX-->>U: Execution complete
+    end
+    
+    Note over RV: Phase 4: Review
+    U->>RV: /workflow:review
+    RV-->>U: Review findings
+```
+
+## When to Use
+
+✅ **Ideal scenarios**:
+- 大规模重构
+- 架构迁移
+- 跨模块功能开发
+- 技术栈升级
+- 团队协作项目
+
+❌ **Avoid when**:
+- 简单的局部修改
+- 时间紧迫
+- 独立的小功能
+
+## Verification Checks
+
+| Check | Description | Severity |
+|-------|-------------|----------|
+| Dependency Cycles | 检测循环依赖 | Critical |
+| Missing Tasks | 计划与实际不符 | High |
+| File Conflicts | 多任务修改同文件 | Medium |
+| Coverage Gaps | 未覆盖的需求 | Medium |
+
+## Configuration
+
+```javascript
+const coupledConfig = {
+  plan: {
+    phases: 5,  // Full 5-phase planning
+    taskGeneration: 'action-planning-agent',
+    outputFormat: {
+      implPlan: '.workflow/plans/IMPL_PLAN.md',
+      taskJsons: '.workflow/tasks/IMPL-*.json'
+    }
+  },
+  
+  verify: {
+    required: true,  // Always verify before execute
+    autoReplan: false,  // Manual replan on failure
+    qualityGates: ['no-cycles', 'no-conflicts', 'complete-coverage']
+  },
+  
+  execute: {
+    dagParallel: true,
+    checkpointInterval: 3,  // Checkpoint every 3 tasks
+    rollbackOnFailure: true
+  },
+  
+  review: {
+    types: ['architecture', 'security'],
+    required: true
+  }
+}
+```
+
+## Task JSON Structure
+
+```json
+{
+  "id": "IMPL-001",
+  "title": "重构认证模块核心逻辑",
+  "scope": "src/auth/**",
+  "action": "refactor",
+  "depends_on": [],
+  "modification_points": [
+    {
+      "file": "src/auth/service.ts",
+      "target": "AuthService",
+      "change": "Extract OAuth2 logic"
+    }
+  ],
+  "acceptance": [
+    "所有现有测试通过",
+    "OAuth2 流程可用"
+  ]
+}
+```
+
+## Example Invocations
+
+```bash
+# Architecture refactoring
+ccw "重构整个认证模块，从 session 迁移到 JWT"
+→ plan (5 phases)
+→ verify
+→ execute
+
+# System migration
+ccw "将数据库从 MySQL 迁移到 PostgreSQL"
+→ plan (migration strategy)
+→ verify (data integrity checks)
+→ execute (staged migration)
+
+# Cross-module feature
+ccw "实现跨服务的分布式事务支持"
+→ plan (architectural design)
+→ verify (consistency checks)
+→ execute (incremental rollout)
+```
+
+## Output Artifacts
+
+```
+.workflow/
+├── plans/
+│   └── IMPL_PLAN.md           # Comprehensive plan
+├── tasks/
+│   ├── IMPL-001.json
+│   ├── IMPL-002.json
+│   └── ...
+├── verify/
+│   └── verification-report.md  # Verification results
+└── reviews/
+    └── {review-type}.md        # Review findings
+```
+
+## Replan Flow
+
+When verification fails:
+
+```javascript
+if (verificationResult.status === 'failed') {
+  console.log(`
+## Verification Failed
+
+**Issues found**:
+${verificationResult.issues.map(i => `- ${i.severity}: ${i.message}`).join('\n')}
+
+**Options**:
+1. /workflow:replan - Address issues and regenerate plan
+2. /workflow:plan --force - Proceed despite issues (not recommended)
+3. Review issues manually and fix plan files
+`)
+}
+```

package/.claude/skills/ccw/phases/actions/docs.md

@@ -0,0 +1,93 @@
+# Documentation Workflow Action
+
+## Pattern
+```
+memory:docs → execute  (full)
+memory:update-related  (incremental)
+```
+
+## Trigger Conditions
+
+- 关键词: "文档", "documentation", "docs", "readme", "注释"
+- 变体触发:
+  - `incremental`: "更新", "增量", "相关"
+  - `full`: "全部", "完整", "所有"
+
+## Variants
+
+### Full Documentation
+```mermaid
+graph TD
+    A[User Input] --> B[memory:docs]
+    B --> C[项目结构分析]
+    C --> D[模块分组 ≤10/task]
+    D --> E[execute: 并行生成]
+    E --> F[README.md]
+    E --> G[ARCHITECTURE.md]
+    E --> H[API Docs]
+    E --> I[Module CLAUDE.md]
+```
+
+### Incremental Update
+```mermaid
+graph TD
+    A[Git Changes] --> B[memory:update-related]
+    B --> C[变更模块检测]
+    C --> D[相关文档定位]
+    D --> E[增量更新]
+```
+
+## Configuration
+
+| 参数 | 默认值 | 说明 |
+|------|--------|------|
+| batch_size | 4 | 每agent处理模块数 |
+| format | markdown | 输出格式 |
+| include_api | true | 生成API文档 |
+| include_diagrams | true | 生成Mermaid图 |
+
+## CLI Integration
+
+| 阶段 | CLI Hint | 用途 |
+|------|----------|------|
+| memory:docs | `gemini --mode analysis` | 项目结构分析 |
+| execute | `gemini --mode write` | 文档生成 |
+| update-related | `gemini --mode write` | 增量更新 |
+
+## Slash Commands
+
+```bash
+/memory:docs              # 规划全量文档生成
+/memory:docs-full-cli     # CLI执行全量文档
+/memory:docs-related-cli  # CLI执行增量文档
+/memory:update-related    # 更新变更相关文档
+/memory:update-full       # 更新所有CLAUDE.md
+```
+
+## Output Structure
+
+```
+project/
+├── README.md              # 项目概览
+├── ARCHITECTURE.md        # 架构文档
+├── docs/
+│   └── api/               # API文档
+└── src/
+    └── module/
+        └── CLAUDE.md      # 模块文档
+```
+
+## When to Use
+
+- 新项目初始化文档
+- 大版本发布前文档更新
+- 代码变更后同步文档
+- API文档生成
+
+## Risk Assessment
+
+| 风险 | 缓解措施 |
+|------|----------|
+| 文档与代码不同步 | git hook集成 |
+| 生成内容过于冗长 | batch_size控制 |
+| 遗漏重要模块 | 全量扫描验证 |

package/.claude/skills/ccw/phases/actions/full.md

@@ -0,0 +1,154 @@
+# Action: Full Workflow
+
+完整探索工作流：分析 + 头脑风暴 + 规划 + 执行
+
+## Pattern
+
+```
+brainstorm:auto-parallel → plan → [verify] → execute
+```
+
+## Trigger Conditions
+
+- Intent: Exploration (uncertainty detected)
+- Keywords: "不确定", "不知道", "explore", "怎么做", "what if"
+- No clear implementation path
+
+## Execution Flow
+
+```mermaid
+sequenceDiagram
+    participant U as User
+    participant O as CCW Orchestrator
+    participant BS as brainstorm
+    participant PL as plan
+    participant VF as verify
+    participant EX as execute
+    
+    U->>O: Unclear task
+    O->>O: Classify: full
+    
+    Note over BS: Phase 1: Brainstorm
+    O->>BS: /workflow:brainstorm:auto-parallel
+    BS->>BS: Multi-role parallel analysis
+    BS->>BS: Synthesis & recommendations
+    BS-->>U: Present options
+    U->>BS: Select direction
+    
+    Note over PL: Phase 2: Plan
+    BS->>PL: /workflow:plan
+    PL->>PL: Generate IMPL_PLAN.md
+    PL->>PL: Generate task JSONs
+    PL-->>U: Review plan
+    
+    Note over VF: Phase 3: Verify (optional)
+    U->>VF: /workflow:action-plan-verify
+    VF->>VF: Cross-artifact consistency
+    VF-->>U: Verification report
+    
+    Note over EX: Phase 4: Execute
+    U->>EX: /workflow:execute
+    EX->>EX: DAG-based parallel execution
+    EX-->>U: Execution complete
+```
+
+## When to Use
+
+✅ **Ideal scenarios**:
+- 产品方向探索
+- 技术选型评估
+- 架构设计决策
+- 复杂功能规划
+- 需要多角色视角
+
+❌ **Avoid when**:
+- 任务明确简单
+- 时间紧迫
+- 已有成熟方案
+
+## Brainstorm Roles
+
+| Role | Focus | Typical Questions |
+|------|-------|-------------------|
+| Product Manager | 用户价值、市场定位 | "用户痛点是什么？" |
+| System Architect | 技术方案、架构设计 | "如何保证可扩展性？" |
+| UX Expert | 用户体验、交互设计 | "用户流程是否顺畅？" |
+| Security Expert | 安全风险、合规要求 | "有哪些安全隐患？" |
+| Data Architect | 数据模型、存储方案 | "数据如何组织？" |
+
+## Configuration
+
+```javascript
+const fullConfig = {
+  brainstorm: {
+    defaultRoles: ['product-manager', 'system-architect', 'ux-expert'],
+    maxRoles: 5,
+    synthesis: true  // Always generate synthesis
+  },
+  
+  plan: {
+    verifyBeforeExecute: true,  // Recommend verification
+    taskFormat: 'json'  // Generate task JSONs
+  },
+  
+  execute: {
+    dagParallel: true,  // DAG-based parallel execution
+    testGeneration: 'optional'  // Suggest test-gen after
+  }
+}
+```
+
+## Continuation Points
+
+After each phase, CCW can continue to the next:
+
+```javascript
+// After brainstorm completes
+console.log(`
+## Brainstorm Complete
+
+**Next steps**:
+1. /workflow:plan "基于头脑风暴结果规划实施"
+2. Or refine: /workflow:brainstorm:synthesis
+`)
+
+// After plan completes
+console.log(`
+## Plan Complete
+
+**Next steps**:
+1. /workflow:action-plan-verify (recommended)
+2. /workflow:execute (直接执行)
+`)
+```
+
+## Example Invocations
+
+```bash
+# Product exploration
+ccw "我想做一个团队协作工具，但不确定具体方向"
+→ brainstorm:auto-parallel (5 roles)
+→ plan
+→ execute
+
+# Technical exploration
+ccw "如何设计一个高可用的消息队列系统？"
+→ brainstorm:auto-parallel (system-architect, data-architect)
+→ plan
+→ verify
+→ execute
+```
+
+## Output Artifacts
+
+```
+.workflow/
+├── brainstorm/
+│   ├── {session}/
+│   │   ├── role-{role}.md
+│   │   └── synthesis.md
+├── plans/
+│   └── IMPL_PLAN.md
+└── tasks/
+    └── IMPL-*.json
+```