claude-code-workflow 6.3.18 → 6.3.19

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

@@ -0,0 +1,201 @@
+# Action: Issue Workflow
+
+Issue 批量处理工作流：规划 + 队列 + 批量执行
+
+## Pattern
+
+```
+issue:plan → issue:queue → issue:execute
+```
+
+## Trigger Conditions
+
+- Keywords: "issues", "batch", "queue", "多个", "批量"
+- Multiple related problems
+- Long-running fix campaigns
+- Priority-based processing needed
+
+## Execution Flow
+
+```mermaid
+sequenceDiagram
+    participant U as User
+    participant O as CCW Orchestrator
+    participant IP as issue:plan
+    participant IQ as issue:queue
+    participant IE as issue:execute
+    
+    U->>O: Multiple issues / batch fix
+    O->>O: Classify: issue
+    
+    Note over IP: Phase 1: Issue Planning
+    O->>IP: /issue:plan
+    IP->>IP: Load unplanned issues
+    IP->>IP: Generate solutions per issue
+    IP->>U: Review solutions
+    U->>IP: Bind selected solutions
+    
+    Note over IQ: Phase 2: Queue Formation
+    IP->>IQ: /issue:queue
+    IQ->>IQ: Conflict analysis
+    IQ->>IQ: Priority calculation
+    IQ->>IQ: DAG construction
+    IQ->>U: High-severity conflicts?
+    U->>IQ: Resolve conflicts
+    IQ->>IQ: Generate execution queue
+    
+    Note over IE: Phase 3: Execution
+    IQ->>IE: /issue:execute
+    IE->>IE: DAG-based parallel execution
+    IE->>IE: Per-solution progress tracking
+    IE-->>U: Batch execution complete
+```
+
+## When to Use
+
+✅ **Ideal scenarios**:
+- 多个相关 Bug 需要批量修复
+- GitHub Issues 批量处理
+- 技术债务清理
+- 安全漏洞批量修复
+- 代码质量改进活动
+
+❌ **Avoid when**:
+- 单一问题 → `/workflow:lite-fix`
+- 独立不相关的任务 → 分别处理
+- 紧急生产问题 → `/workflow:lite-fix --hotfix`
+
+## Issue Lifecycle
+
+```
+draft → planned → queued → executing → completed
+         ↓           ↓
+      skipped    on-hold
+```
+
+## Conflict Types
+
+| Type | Description | Resolution |
+|------|-------------|------------|
+| File | 多个解决方案修改同一文件 | Sequential execution |
+| API | API 签名变更影响 | Dependency ordering |
+| Data | 数据结构变更冲突 | User decision |
+| Dependency | 包依赖冲突 | Version negotiation |
+| Architecture | 架构方向冲突 | User decision (high severity) |
+
+## Configuration
+
+```javascript
+const issueConfig = {
+  plan: {
+    solutionsPerIssue: 3,  // Generate up to 3 solutions
+    autoSelect: false,  // User must bind solution
+    planningAgent: 'issue-plan-agent'
+  },
+  
+  queue: {
+    conflictAnalysis: true,
+    priorityCalculation: true,
+    clarifyThreshold: 'high',  // Ask user for high-severity conflicts
+    queueAgent: 'issue-queue-agent'
+  },
+  
+  execute: {
+    dagParallel: true,
+    executionLevel: 'solution',  // Execute by solution, not task
+    executor: 'codex',
+    resumable: true
+  }
+}
+```
+
+## Example Invocations
+
+```bash
+# From GitHub Issues
+ccw "批量处理所有 label:bug 的 GitHub Issues"
+→ issue:new (import from GitHub)
+→ issue:plan (generate solutions)
+→ issue:queue (form execution queue)
+→ issue:execute (batch execute)
+
+# Tech debt cleanup
+ccw "处理所有 TODO 注释和已知技术债务"
+→ issue:discover (find issues)
+→ issue:plan (plan solutions)
+→ issue:queue (prioritize)
+→ issue:execute (execute)
+
+# Security vulnerabilities
+ccw "修复所有 npm audit 报告的安全漏洞"
+→ issue:new (from audit report)
+→ issue:plan (upgrade strategies)
+→ issue:queue (conflict resolution)
+→ issue:execute (staged upgrades)
+```
+
+## Queue Structure
+
+```json
+{
+  "queue_id": "QUE-20251227-143000",
+  "status": "active",
+  "execution_groups": [
+    {
+      "id": "P1",
+      "type": "parallel",
+      "solutions": ["SOL-ISS-001-1", "SOL-ISS-002-1"],
+      "description": "Independent fixes, no file overlap"
+    },
+    {
+      "id": "S1",
+      "type": "sequential",
+      "solutions": ["SOL-ISS-003-1"],
+      "depends_on": ["P1"],
+      "description": "Depends on P1 completion"
+    }
+  ]
+}
+```
+
+## Output Artifacts
+
+```
+.workflow/issues/
+├── issues.jsonl              # All issues (one per line)
+├── solutions/
+│   ├── ISS-001.jsonl         # Solutions for ISS-001
+│   └── ISS-002.jsonl
+├── queues/
+│   ├── index.json            # Queue index
+│   └── QUE-xxx.json          # Queue details
+└── execution/
+    └── {queue-id}/
+        ├── progress.json
+        └── results/
+```
+
+## Progress Tracking
+
+```javascript
+// Real-time progress during execution
+const progress = {
+  queue_id: "QUE-xxx",
+  total_solutions: 5,
+  completed: 2,
+  in_progress: 1,
+  pending: 2,
+  current_group: "P1",
+  eta: "15 minutes"
+}
+```
+
+## Resume Capability
+
+```bash
+# If execution interrupted
+ccw "继续执行 issue 队列"
+→ Detects active queue: QUE-xxx
+→ Resumes from last checkpoint
+→ /issue:execute --resume
+```

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

@@ -0,0 +1,104 @@
+# Action: Rapid Workflow
+
+快速迭代工作流组合：多模型协作分析 + 直接执行
+
+## Pattern
+
+```
+lite-plan → lite-execute
+```
+
+## Trigger Conditions
+
+- Complexity: Low to Medium
+- Intent: Feature development
+- Context: Clear requirements, known implementation path
+- No uncertainty keywords
+
+## Execution Flow
+
+```mermaid
+sequenceDiagram
+    participant U as User
+    participant O as CCW Orchestrator
+    participant LP as lite-plan
+    participant LE as lite-execute
+    participant CLI as CLI Tools
+    
+    U->>O: Task description
+    O->>O: Classify: rapid
+    O->>LP: /workflow:lite-plan "task"
+    
+    LP->>LP: Complexity assessment
+    LP->>CLI: Parallel explorations (if needed)
+    CLI-->>LP: Exploration results
+    LP->>LP: Generate plan.json
+    LP->>U: Display plan, ask confirmation
+    U->>LP: Confirm + select execution method
+    
+    LP->>LE: /workflow:lite-execute --in-memory
+    LE->>CLI: Execute tasks (Agent/Codex)
+    CLI-->>LE: Results
+    LE->>LE: Optional code review
+    LE-->>U: Execution complete
+```
+
+## When to Use
+
+✅ **Ideal scenarios**:
+- 添加单一功能（如用户头像上传）
+- 修改现有功能（如更新表单验证）
+- 小型重构（如抽取公共方法）
+- 添加测试用例
+- 文档更新
+
+❌ **Avoid when**:
+- 不确定实现方案
+- 跨多个模块
+- 需要架构决策
+- 有复杂依赖关系
+
+## Configuration
+
+```javascript
+const rapidConfig = {
+  explorationThreshold: {
+    // Force exploration if task mentions specific files
+    forceExplore: /\b(file|文件|module|模块|class|类)\s*[:：]?\s*\w+/i,
+    // Skip exploration for simple tasks
+    skipExplore: /\b(add|添加|create|创建)\s+(comment|注释|log|日志)/i
+  },
+  
+  defaultExecution: 'Agent',  // Agent for low complexity
+  
+  codeReview: {
+    default: 'Skip',  // Skip review for simple tasks
+    threshold: 'medium'  // Enable for medium+ complexity
+  }
+}
+```
+
+## Example Invocations
+
+```bash
+# Simple feature
+ccw "添加用户退出登录按钮"
+→ lite-plan → lite-execute (Agent)
+
+# With exploration
+ccw "优化 AuthService 的 token 刷新逻辑"
+→ lite-plan -e → lite-execute (Agent, Gemini review)
+
+# Medium complexity
+ccw "实现用户偏好设置的本地存储"
+→ lite-plan -e → lite-execute (Codex)
+```
+
+## Output Artifacts
+
+```
+.workflow/.lite-plan/{task-slug}-{date}/
+├── exploration-*.json      # If exploration was triggered
+├── explorations-manifest.json
+└── plan.json               # Implementation plan
+```

package/.claude/skills/ccw/phases/actions/review-fix.md

@@ -0,0 +1,84 @@
+# Review-Fix Workflow Action
+
+## Pattern
+```
+review-session-cycle → review-fix
+```
+
+## Trigger Conditions
+
+- 关键词: "review", "审查", "检查代码", "code review", "质量检查"
+- 场景: PR审查、代码质量提升、安全审计
+
+## Execution Flow
+
+```mermaid
+graph TD
+    A[User Input] --> B[review-session-cycle]
+    B --> C{7维度分析}
+    C --> D[Security]
+    C --> E[Performance]
+    C --> F[Maintainability]
+    C --> G[Architecture]
+    C --> H[Code Style]
+    C --> I[Test Coverage]
+    C --> J[Documentation]
+    D & E & F & G & H & I & J --> K[Findings Aggregation]
+    K --> L{Quality Gate}
+    L -->|Pass| M[Report Only]
+    L -->|Fail| N[review-fix]
+    N --> O[Auto Fix]
+    O --> P[Re-verify]
+```
+
+## Configuration
+
+| 参数 | 默认值 | 说明 |
+|------|--------|------|
+| dimensions | all | 审查维度(security,performance,etc.) |
+| quality_gate | 80 | 质量门槛分数 |
+| auto_fix | true | 自动修复发现的问题 |
+| severity_threshold | medium | 最低关注级别 |
+
+## CLI Integration
+
+| 阶段 | CLI Hint | 用途 |
+|------|----------|------|
+| review-session-cycle | `gemini --mode analysis` | 多维度深度分析 |
+| review-fix | `codex --mode write` | 自动修复问题 |
+
+## Slash Commands
+
+```bash
+/workflow:review-session-cycle  # 会话级代码审查
+/workflow:review-module-cycle   # 模块级代码审查
+/workflow:review-fix            # 自动修复审查发现
+/workflow:review --type security  # 专项安全审查
+```
+
+## Review Dimensions
+
+| 维度 | 检查点 |
+|------|--------|
+| Security | 注入、XSS、敏感数据暴露 |
+| Performance | N+1查询、内存泄漏、算法复杂度 |
+| Maintainability | 代码重复、复杂度、命名 |
+| Architecture | 依赖方向、层级违规、耦合度 |
+| Code Style | 格式、约定、一致性 |
+| Test Coverage | 覆盖率、边界用例 |
+| Documentation | 注释、API文档、README |
+
+## When to Use
+
+- PR合并前审查
+- 重构后质量验证
+- 安全合规审计
+- 技术债务评估
+
+## Risk Assessment
+
+| 风险 | 缓解措施 |
+|------|----------|
+| 误报过多 | severity_threshold过滤 |
+| 修复引入新问题 | re-verify循环 |
+| 审查不全面 | 7维度覆盖 |

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

@@ -0,0 +1,66 @@
+# TDD Workflow Action
+
+## Pattern
+```
+tdd-plan → execute → tdd-verify
+```
+
+## Trigger Conditions
+
+- 关键词: "tdd", "test-driven", "测试驱动", "先写测试", "red-green"
+- 场景: 需要高质量代码保证、关键业务逻辑、回归风险高
+
+## Execution Flow
+
+```mermaid
+graph TD
+    A[User Input] --> B[tdd-plan]
+    B --> C{生成测试任务链}
+    C --> D[Red Phase: 写失败测试]
+    D --> E[execute: 实现代码]
+    E --> F[Green Phase: 测试通过]
+    F --> G{需要重构?}
+    G -->|Yes| H[Refactor Phase]
+    H --> F
+    G -->|No| I[tdd-verify]
+    I --> J[质量报告]
+```
+
+## Configuration
+
+| 参数 | 默认值 | 说明 |
+|------|--------|------|
+| coverage_target | 80% | 目标覆盖率 |
+| cycle_limit | 10 | 最大Red-Green-Refactor循环 |
+| strict_mode | false | 严格模式(必须先红后绿) |
+
+## CLI Integration
+
+| 阶段 | CLI Hint | 用途 |
+|------|----------|------|
+| tdd-plan | `gemini --mode analysis` | 分析测试策略 |
+| execute | `codex --mode write` | 实现代码 |
+| tdd-verify | `gemini --mode analysis` | 验证TDD合规性 |
+
+## Slash Commands
+
+```bash
+/workflow:tdd-plan          # 生成TDD任务链
+/workflow:execute           # 执行Red-Green-Refactor
+/workflow:tdd-verify        # 验证TDD合规性+覆盖率
+```
+
+## When to Use
+
+- 核心业务逻辑开发
+- 需要高测试覆盖率的模块
+- 重构现有代码时确保不破坏功能
+- 团队要求TDD实践
+
+## Risk Assessment
+
+| 风险 | 缓解措施 |
+|------|----------|
+| 测试粒度不当 | tdd-plan阶段评估测试边界 |
+| 过度测试 | 聚焦行为而非实现 |
+| 循环过多 | cycle_limit限制 |

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

@@ -0,0 +1,79 @@
+# UI Design Workflow Action
+
+## Pattern
+```
+ui-design:[explore|imitate]-auto → design-sync → plan → execute
+```
+
+## Trigger Conditions
+
+- 关键词: "ui", "界面", "design", "组件", "样式", "布局", "前端"
+- 变体触发:
+  - `imitate`: "参考", "模仿", "像", "类似"
+  - `explore`: 无特定参考时默认
+
+## Variants
+
+### Explore (探索式设计)
+```mermaid
+graph TD
+    A[User Input] --> B[ui-design:explore-auto]
+    B --> C[设计系统分析]
+    C --> D[组件结构规划]
+    D --> E[design-sync]
+    E --> F[plan]
+    F --> G[execute]
+```
+
+### Imitate (参考式设计)
+```mermaid
+graph TD
+    A[User Input + Reference] --> B[ui-design:imitate-auto]
+    B --> C[参考分析]
+    C --> D[风格提取]
+    D --> E[design-sync]
+    E --> F[plan]
+    F --> G[execute]
+```
+
+## Configuration
+
+| 参数 | 默认值 | 说明 |
+|------|--------|------|
+| design_system | auto | 设计系统(auto/tailwind/mui/custom) |
+| responsive | true | 响应式设计 |
+| accessibility | true | 无障碍支持 |
+
+## CLI Integration
+
+| 阶段 | CLI Hint | 用途 |
+|------|----------|------|
+| explore/imitate | `gemini --mode analysis` | 设计分析、风格提取 |
+| design-sync | - | 设计决策与代码库同步 |
+| plan | - | 内置规划 |
+| execute | `codex --mode write` | 组件实现 |
+
+## Slash Commands
+
+```bash
+/workflow:ui-design:explore-auto   # 探索式UI设计
+/workflow:ui-design:imitate-auto   # 参考式UI设计
+/workflow:ui-design:design-sync    # 设计与代码同步（关键步骤）
+/workflow:ui-design:style-extract  # 提取现有样式
+/workflow:ui-design:codify-style   # 样式代码化
+```
+
+## When to Use
+
+- 新页面/组件开发
+- UI重构或现代化
+- 设计系统建立
+- 参考其他产品设计
+
+## Risk Assessment
+
+| 风险 | 缓解措施 |
+|------|----------|
+| 设计不一致 | style-extract确保复用 |
+| 响应式问题 | 多断点验证 |
+| 可访问性缺失 | a11y检查集成 |