claude-code-workflow 6.3.18 → 6.3.19

package/.claude/skills/ccw/specs/intent-classification.md

@@ -0,0 +1,336 @@
+# Intent Classification Specification
+
+CCW 意图分类规范：定义如何从用户输入识别任务意图并选择最优工作流。
+
+## Classification Hierarchy
+
+```
+Intent Classification
+├── Priority 1: Explicit Commands
+│   └── /workflow:*, /issue:*, /memory:*, /task:*
+├── Priority 2: Bug Keywords
+│   ├── Hotfix: urgent + bug keywords
+│   └── Standard: bug keywords only
+├── Priority 3: Issue Batch
+│   └── Multiple + fix keywords
+├── Priority 4: Exploration
+│   └── Uncertainty keywords
+├── Priority 5: UI/Design
+│   └── Visual/component keywords
+└── Priority 6: Complexity Fallback
+    ├── High → Coupled
+    ├── Medium → Rapid
+    └── Low → Rapid
+```
+
+## Keyword Patterns
+
+### Bug Detection
+
+```javascript
+const BUG_PATTERNS = {
+  core: /\b(fix|bug|error|issue|crash|broken|fail|wrong|incorrect|修复|报错|错误|问题|异常|崩溃|失败)\b/i,
+  
+  urgency: /\b(hotfix|urgent|production|critical|emergency|asap|immediately|紧急|生产|线上|马上|立即)\b/i,
+  
+  symptoms: /\b(not working|doesn't work|can't|cannot|won't|stopped|stopped working|无法|不能|不工作)\b/i,
+  
+  errors: /\b(\d{3}\s*error|exception|stack\s*trace|undefined|null\s*pointer|timeout)\b/i
+}
+
+function detectBug(text) {
+  const isBug = BUG_PATTERNS.core.test(text) || BUG_PATTERNS.symptoms.test(text)
+  const isUrgent = BUG_PATTERNS.urgency.test(text)
+  const hasError = BUG_PATTERNS.errors.test(text)
+  
+  if (!isBug && !hasError) return null
+  
+  return {
+    type: 'bugfix',
+    mode: isUrgent ? 'hotfix' : 'standard',
+    confidence: (isBug && hasError) ? 'high' : 'medium'
+  }
+}
+```
+
+### Issue Batch Detection
+
+```javascript
+const ISSUE_PATTERNS = {
+  batch: /\b(issues?|batch|queue|multiple|several|all|多个|批量|一系列|所有|这些)\b/i,
+  action: /\b(fix|resolve|handle|process|处理|解决|修复)\b/i,
+  source: /\b(github|jira|linear|backlog|todo|待办)\b/i
+}
+
+function detectIssueBatch(text) {
+  const hasBatch = ISSUE_PATTERNS.batch.test(text)
+  const hasAction = ISSUE_PATTERNS.action.test(text)
+  const hasSource = ISSUE_PATTERNS.source.test(text)
+  
+  if (hasBatch && hasAction) {
+    return {
+      type: 'issue',
+      confidence: hasSource ? 'high' : 'medium'
+    }
+  }
+  return null
+}
+```
+
+### Exploration Detection
+
+```javascript
+const EXPLORATION_PATTERNS = {
+  uncertainty: /\b(不确定|不知道|not sure|unsure|how to|怎么|如何|what if|should i|could i|是否应该)\b/i,
+  
+  exploration: /\b(explore|research|investigate|分析|研究|调研|评估|探索|了解)\b/i,
+  
+  options: /\b(options|alternatives|approaches|方案|选择|方向|可能性)\b/i,
+  
+  questions: /\b(what|which|how|why|什么|哪个|怎样|为什么)\b.*\?/i
+}
+
+function detectExploration(text) {
+  const hasUncertainty = EXPLORATION_PATTERNS.uncertainty.test(text)
+  const hasExploration = EXPLORATION_PATTERNS.exploration.test(text)
+  const hasOptions = EXPLORATION_PATTERNS.options.test(text)
+  const hasQuestion = EXPLORATION_PATTERNS.questions.test(text)
+  
+  const score = [hasUncertainty, hasExploration, hasOptions, hasQuestion].filter(Boolean).length
+  
+  if (score >= 2 || hasUncertainty) {
+    return {
+      type: 'exploration',
+      confidence: score >= 3 ? 'high' : 'medium'
+    }
+  }
+  return null
+}
+```
+
+### UI/Design Detection
+
+```javascript
+const UI_PATTERNS = {
+  components: /\b(ui|界面|component|组件|button|按钮|form|表单|modal|弹窗|dialog|对话框)\b/i,
+  
+  design: /\b(design|设计|style|样式|layout|布局|theme|主题|color|颜色)\b/i,
+  
+  visual: /\b(visual|视觉|animation|动画|responsive|响应式|mobile|移动端)\b/i,
+  
+  frontend: /\b(frontend|前端|react|vue|angular|css|html|page|页面)\b/i
+}
+
+function detectUI(text) {
+  const hasComponents = UI_PATTERNS.components.test(text)
+  const hasDesign = UI_PATTERNS.design.test(text)
+  const hasVisual = UI_PATTERNS.visual.test(text)
+  const hasFrontend = UI_PATTERNS.frontend.test(text)
+  
+  const score = [hasComponents, hasDesign, hasVisual, hasFrontend].filter(Boolean).length
+  
+  if (score >= 2) {
+    return {
+      type: 'ui',
+      hasReference: /参考|reference|based on|像|like|模仿|imitate/.test(text),
+      confidence: score >= 3 ? 'high' : 'medium'
+    }
+  }
+  return null
+}
+```
+
+## Complexity Assessment
+
+### Indicators
+
+```javascript
+const COMPLEXITY_INDICATORS = {
+  high: {
+    patterns: [
+      /\b(refactor|重构|restructure|重新组织)\b/i,
+      /\b(migrate|迁移|upgrade|升级|convert|转换)\b/i,
+      /\b(architect|架构|system|系统|infrastructure|基础设施)\b/i,
+      /\b(entire|整个|complete|完整|all\s+modules?|所有模块)\b/i,
+      /\b(security|安全|scale|扩展|performance\s+critical|性能关键)\b/i,
+      /\b(distributed|分布式|microservice|微服务|cluster|集群)\b/i
+    ],
+    weight: 2
+  },
+  
+  medium: {
+    patterns: [
+      /\b(integrate|集成|connect|连接|link|链接)\b/i,
+      /\b(api|database|数据库|service|服务|endpoint|接口)\b/i,
+      /\b(test|测试|validate|验证|coverage|覆盖)\b/i,
+      /\b(multiple\s+files?|多个文件|several\s+components?|几个组件)\b/i,
+      /\b(authentication|认证|authorization|授权)\b/i
+    ],
+    weight: 1
+  },
+  
+  low: {
+    patterns: [
+      /\b(add|添加|create|创建|simple|简单)\b/i,
+      /\b(update|更新|modify|修改|change|改变)\b/i,
+      /\b(single|单个|one|一个|small|小)\b/i,
+      /\b(comment|注释|log|日志|print|打印)\b/i
+    ],
+    weight: -1
+  }
+}
+
+function assessComplexity(text) {
+  let score = 0
+  
+  for (const [level, config] of Object.entries(COMPLEXITY_INDICATORS)) {
+    for (const pattern of config.patterns) {
+      if (pattern.test(text)) {
+        score += config.weight
+      }
+    }
+  }
+  
+  // File count indicator
+  const fileMatches = text.match(/\b\d+\s*(files?|文件)/i)
+  if (fileMatches) {
+    const count = parseInt(fileMatches[0])
+    if (count > 10) score += 2
+    else if (count > 5) score += 1
+  }
+  
+  // Module count indicator
+  const moduleMatches = text.match(/\b\d+\s*(modules?|模块)/i)
+  if (moduleMatches) {
+    const count = parseInt(moduleMatches[0])
+    if (count > 3) score += 2
+    else if (count > 1) score += 1
+  }
+  
+  if (score >= 4) return 'high'
+  if (score >= 2) return 'medium'
+  return 'low'
+}
+```
+
+## Workflow Selection Matrix
+
+| Intent | Complexity | Workflow | Commands |
+|--------|------------|----------|----------|
+| bugfix (hotfix) | * | bugfix | `lite-fix --hotfix` |
+| bugfix (standard) | * | bugfix | `lite-fix` |
+| issue | * | issue | `issue:plan → queue → execute` |
+| exploration | * | full | `brainstorm → plan → execute` |
+| ui (reference) | * | ui | `ui-design:imitate-auto → plan` |
+| ui (explore) | * | ui | `ui-design:explore-auto → plan` |
+| feature | high | coupled | `plan → verify → execute` |
+| feature | medium | rapid | `lite-plan → lite-execute` |
+| feature | low | rapid | `lite-plan → lite-execute` |
+
+## Confidence Levels
+
+| Level | Description | Action |
+|-------|-------------|--------|
+| **high** | Multiple strong indicators match | Direct dispatch |
+| **medium** | Some indicators match | Confirm with user |
+| **low** | Fallback classification | Always confirm |
+
+## Tool Preference Detection
+
+```javascript
+const TOOL_PREFERENCES = {
+  gemini: {
+    pattern: /用\s*gemini|gemini\s*(分析|理解|设计)|让\s*gemini/i,
+    capability: 'analysis'
+  },
+  qwen: {
+    pattern: /用\s*qwen|qwen\s*(分析|评估)|让\s*qwen/i,
+    capability: 'analysis'
+  },
+  codex: {
+    pattern: /用\s*codex|codex\s*(实现|重构|修复)|让\s*codex/i,
+    capability: 'implementation'
+  }
+}
+
+function detectToolPreference(text) {
+  for (const [tool, config] of Object.entries(TOOL_PREFERENCES)) {
+    if (config.pattern.test(text)) {
+      return { tool, capability: config.capability }
+    }
+  }
+  return null
+}
+```
+
+## Multi-Tool Collaboration Detection
+
+```javascript
+const COLLABORATION_PATTERNS = {
+  sequential: /先.*(分析|理解).*然后.*(实现|重构)|分析.*后.*实现/i,
+  parallel: /(同时|并行).*(分析|实现)|一边.*一边/i,
+  hybrid: /(分析|设计).*和.*(实现|测试).*分开/i
+}
+
+function detectCollaboration(text) {
+  if (COLLABORATION_PATTERNS.sequential.test(text)) {
+    return { mode: 'sequential', description: 'Analysis first, then implementation' }
+  }
+  if (COLLABORATION_PATTERNS.parallel.test(text)) {
+    return { mode: 'parallel', description: 'Concurrent analysis and implementation' }
+  }
+  if (COLLABORATION_PATTERNS.hybrid.test(text)) {
+    return { mode: 'hybrid', description: 'Mixed parallel and sequential' }
+  }
+  return null
+}
+```
+
+## Classification Pipeline
+
+```javascript
+function classify(userInput) {
+  const text = userInput.trim()
+  
+  // Step 1: Check explicit commands
+  if (/^\/(?:workflow|issue|memory|task):/.test(text)) {
+    return { type: 'explicit', command: text }
+  }
+  
+  // Step 2: Priority-based classification
+  const bugResult = detectBug(text)
+  if (bugResult) return bugResult
+  
+  const issueResult = detectIssueBatch(text)
+  if (issueResult) return issueResult
+  
+  const explorationResult = detectExploration(text)
+  if (explorationResult) return explorationResult
+  
+  const uiResult = detectUI(text)
+  if (uiResult) return uiResult
+  
+  // Step 3: Complexity-based fallback
+  const complexity = assessComplexity(text)
+  return {
+    type: 'feature',
+    complexity,
+    workflow: complexity === 'high' ? 'coupled' : 'rapid',
+    confidence: 'low'
+  }
+}
+```
+
+## Examples
+
+### Input → Classification
+
+| Input | Classification | Workflow |
+|-------|----------------|----------|
+| "用户登录失败，401错误" | bugfix/standard | lite-fix |
+| "紧急：支付网关挂了" | bugfix/hotfix | lite-fix --hotfix |
+| "批量处理这些 GitHub issues" | issue | issue:plan → queue |
+| "不确定要怎么设计缓存系统" | exploration | brainstorm → plan |
+| "添加一个深色模式切换按钮" | ui | ui-design → plan |
+| "重构整个认证模块" | feature/high | plan → verify |
+| "添加用户头像功能" | feature/low | lite-plan |

package/.claude/skills/ccw-help/SKILL.md

@@ -0,0 +1,177 @@
+---
+name: ccw-help
+description: Workflow command guide for Claude Code Workflow (78 commands). Search/browse commands, get next-step recommendations, view documentation, report issues. Triggers "CCW-help", "CCW-issue", "ccw-help", "ccw-issue", "ccw"
+allowed-tools: Read, Grep, Glob, AskUserQuestion
+version: 6.0.0
+---
+
+# CCW-Help Skill
+
+CCW 命令帮助系统，提供命令搜索、推荐、文档查看和问题报告功能。
+
+## Trigger Conditions
+
+- 关键词: "CCW-help", "CCW-issue", "ccw-help", "ccw-issue", "帮助", "命令", "怎么用"
+- 场景: 用户询问命令用法、搜索命令、请求下一步建议、报告问题
+
+## Execution Flow
+
+```mermaid
+graph TD
+    A[User Query] --> B{Intent Classification}
+    B -->|搜索| C[Command Search]
+    B -->|推荐| D[Smart Recommendations]
+    B -->|文档| E[Documentation]
+    B -->|新手| F[Onboarding]
+    B -->|问题| G[Issue Reporting]
+    B -->|分析| H[Deep Analysis]
+
+    C --> I[Query Index]
+    D --> J[Query Relationships]
+    E --> K[Read Source File]
+    F --> L[Essential Commands]
+    G --> M[Generate Template]
+    H --> N[CLI Analysis]
+
+    I & J & K & L & M & N --> O[Synthesize Response]
+```
+
+## Operation Modes
+
+### Mode 1: Command Search 🔍
+
+**Triggers**: "搜索命令", "find command", "planning 相关", "search"
+
+**Process**:
+1. Query `index/all-commands.json` or `index/by-category.json`
+2. Filter and rank results based on user context
+3. Present top 3-5 relevant commands with usage hints
+
+### Mode 2: Smart Recommendations 🤖
+
+**Triggers**: "下一步", "what's next", "after /workflow:plan", "推荐"
+
+**Process**:
+1. Query `index/command-relationships.json`
+2. Evaluate context and prioritize recommendations
+3. Explain WHY each recommendation fits
+
+### Mode 3: Full Documentation 📖
+
+**Triggers**: "参数说明", "怎么用", "how to use", "详情"
+
+**Process**:
+1. Locate command in index
+2. Read source file via `source` path (e.g., `commands/workflow/lite-plan.md`)
+3. Extract relevant sections and provide context-specific examples
+
+### Mode 4: Beginner Onboarding 🎓
+
+**Triggers**: "新手", "getting started", "如何开始", "常用命令"
+
+**Process**:
+1. Query `index/essential-commands.json`
+2. Assess project stage (从0到1 vs 功能新增)
+3. Guide appropriate workflow entry point
+
+### Mode 5: Issue Reporting 📝
+
+**Triggers**: "CCW-issue", "报告 bug", "功能建议", "问题咨询"
+
+**Process**:
+1. Use AskUserQuestion to gather context
+2. Generate structured issue template
+3. Provide actionable next steps
+
+### Mode 6: Deep Analysis 🔬
+
+**Triggers**: "详细说明", "命令原理", "agent 如何工作", "实现细节"
+
+**Process**:
+1. Read source documentation directly
+2. For complex queries, use CLI for multi-file analysis:
+   ```bash
+   ccw cli -p "PURPOSE: Analyze command documentation..." --tool gemini --mode analysis --cd ~/.claude
+   ```
+
+## Index Files
+
+CCW-Help 使用 JSON 索引实现快速查询（无 reference 文件夹，直接引用源文件）：
+
+| 文件 | 内容 | 用途 |
+|------|------|------|
+| `index/all-commands.json` | 完整命令目录 | 关键词搜索 |
+| `index/all-agents.json` | 完整 Agent 目录 | Agent 查询 |
+| `index/by-category.json` | 按类别分组 | 分类浏览 |
+| `index/by-use-case.json` | 按场景分组 | 场景推荐 |
+| `index/essential-commands.json` | 核心命令 | 新手引导 |
+| `index/command-relationships.json` | 命令关系 | 下一步推荐 |
+
+### Source Path Format
+
+索引中的 `source` 字段是从 `index/` 目录的相对路径（先向上再定位）：
+
+```json
+{
+  "name": "workflow:lite-plan",
+  "source": "../../../commands/workflow/lite-plan.md"
+}
+```
+
+路径结构: `index/` → `ccw-help/` → `skills/` → `.claude/` → `commands/...`
+
+## Configuration
+
+| 参数 | 默认值 | 说明 |
+|------|--------|------|
+| max_results | 5 | 搜索返回最大结果数 |
+| show_source | true | 是否显示源文件路径 |
+
+## CLI Integration
+
+| 场景 | CLI Hint | 用途 |
+|------|----------|------|
+| 复杂查询 | `gemini --mode analysis` | 多文件分析对比 |
+| 文档生成 | - | 直接读取源文件 |
+
+## Slash Commands
+
+```bash
+/ccw-help                    # 通用帮助入口
+/ccw-help search <keyword>   # 搜索命令
+/ccw-help next <command>     # 获取下一步建议
+/ccw-issue                   # 问题报告
+```
+
+## Maintenance
+
+### 更新索引
+
+```bash
+cd D:/Claude_dms3/.claude/skills/ccw-help
+python scripts/analyze_commands.py
+```
+
+脚本功能：
+1. 扫描 `commands/` 和 `agents/` 目录
+2. 提取 YAML frontmatter 元数据
+3. 生成相对路径引用（无 reference 复制）
+4. 重建所有索引文件
+
+## System Statistics
+
+- **Commands**: 78
+- **Agents**: 14
+- **Categories**: 5 (workflow, cli, memory, task, general)
+- **Essential**: 14 核心命令
+
+## Core Principle
+
+**⚠️ 智能整合，非模板复制**
+
+- ✅ 理解用户具体情况
+- ✅ 整合多个来源信息
+- ✅ 定制示例和说明
+- ✅ 提供渐进式深度
+- ❌ 原样复制文档
+- ❌ 返回未处理的 JSON

package/.claude/skills/ccw-help/index/all-agents.json

@@ -0,0 +1,82 @@
+[
+  {
+    "name": "action-planning-agent",
+    "description": "|",
+    "source": "../../../agents/action-planning-agent.md"
+  },
+  {
+    "name": "cli-execution-agent",
+    "description": "|",
+    "source": "../../../agents/cli-execution-agent.md"
+  },
+  {
+    "name": "cli-explore-agent",
+    "description": "|",
+    "source": "../../../agents/cli-explore-agent.md"
+  },
+  {
+    "name": "cli-lite-planning-agent",
+    "description": "|",
+    "source": "../../../agents/cli-lite-planning-agent.md"
+  },
+  {
+    "name": "cli-planning-agent",
+    "description": "|",
+    "source": "../../../agents/cli-planning-agent.md"
+  },
+  {
+    "name": "code-developer",
+    "description": "|",
+    "source": "../../../agents/code-developer.md"
+  },
+  {
+    "name": "conceptual-planning-agent",
+    "description": "|",
+    "source": "../../../agents/conceptual-planning-agent.md"
+  },
+  {
+    "name": "context-search-agent",
+    "description": "|",
+    "source": "../../../agents/context-search-agent.md"
+  },
+  {
+    "name": "doc-generator",
+    "description": "|",
+    "source": "../../../agents/doc-generator.md"
+  },
+  {
+    "name": "issue-plan-agent",
+    "description": "|",
+    "source": "../../../agents/issue-plan-agent.md"
+  },
+  {
+    "name": "issue-queue-agent",
+    "description": "|",
+    "source": "../../../agents/issue-queue-agent.md"
+  },
+  {
+    "name": "memory-bridge",
+    "description": "Execute complex project documentation updates using script coordination",
+    "source": "../../../agents/memory-bridge.md"
+  },
+  {
+    "name": "test-context-search-agent",
+    "description": "|",
+    "source": "../../../agents/test-context-search-agent.md"
+  },
+  {
+    "name": "test-fix-agent",
+    "description": "|",
+    "source": "../../../agents/test-fix-agent.md"
+  },
+  {
+    "name": "ui-design-agent",
+    "description": "|",
+    "source": "../../../agents/ui-design-agent.md"
+  },
+  {
+    "name": "universal-executor",
+    "description": "|",
+    "source": "../../../agents/universal-executor.md"
+  }
+]