claude-code-workflow 6.3.47 → 6.3.49

package/.claude/commands/ccw-coordinator.md

@@ -47,14 +47,30 @@ Interactive orchestration tool: analyze task → discover commands → recommend
 
 | Unit Name | Commands | Purpose | Output |
 |-----------|----------|---------|--------|
-| **Code Review (Session)** | review-session-cycle → review-fix | Complete review cycle and apply fixes | Fixed code |
-| **Code Review (Module)** | review-module-cycle → review-fix | Module review cycle and apply fixes | Fixed code |
+| **Code Review (Session)** | review-session-cycle → review-cycle-fix | Complete review cycle and apply fixes | Fixed code |
+| **Code Review (Module)** | review-module-cycle → review-cycle-fix | Module review cycle and apply fixes | Fixed code |
+
+**Issue Units** (Issue单元):
+
+| Unit Name | Commands | Purpose | Output |
+|-----------|----------|---------|--------|
+| **Issue Workflow** | discover → plan → queue → execute | Complete issue lifecycle | Completed issues |
+| **Rapid-to-Issue** | lite-plan → convert-to-plan → queue → execute | Bridge lite workflow to issue workflow | Completed issues |
+| **Brainstorm-to-Issue** | from-brainstorm → queue → execute | Bridge brainstorm session to issue workflow | Completed issues |
+
+**With-File Units** (文档化单元):
+
+| Unit Name | Commands | Purpose | Output |
+|-----------|----------|---------|--------|
+| **Brainstorm With File** | brainstorm-with-file | Multi-perspective ideation with documentation | brainstorm.md |
+| **Debug With File** | debug-with-file | Hypothesis-driven debugging with documentation | understanding.md |
+| **Analyze With File** | analyze-with-file | Collaborative analysis with documentation | discussion.md |
 
 ### Command-to-Unit Mapping (命令与最小单元的映射)
 
 | Command | Can Precede | Atomic Units |
 |---------|-----------|--------------|
-| lite-plan | lite-execute | Quick Implementation |
+| lite-plan | lite-execute, convert-to-plan | Quick Implementation, Rapid-to-Issue |
 | multi-cli-plan | lite-execute | Multi-CLI Planning |
 | lite-fix | lite-execute | Bug Fix |
 | plan | plan-verify, execute | Full Planning + Execution, Verified Planning + Execution |
@@ -62,9 +78,17 @@ Interactive orchestration tool: analyze task → discover commands → recommend
 | replan | execute | Replanning + Execution |
 | test-gen | execute | Test Generation + Execution |
 | tdd-plan | execute | TDD Planning + Execution |
-| review-session-cycle | review-fix | Code Review (Session) |
-| review-module-cycle | review-fix | Code Review (Module) |
+| review-session-cycle | review-cycle-fix | Code Review (Session) |
+| review-module-cycle | review-cycle-fix | Code Review (Module) |
 | test-fix-gen | test-cycle-execute | Test Validation |
+| issue:discover | issue:plan | Issue Workflow |
+| issue:plan | issue:queue | Issue Workflow |
+| convert-to-plan | issue:queue | Rapid-to-Issue |
+| issue:queue | issue:execute | Issue Workflow, Rapid-to-Issue, Brainstorm-to-Issue |
+| issue:from-brainstorm | issue:queue | Brainstorm-to-Issue |
+| brainstorm-with-file | issue:from-brainstorm (optional) | Brainstorm With File, Brainstorm-to-Issue |
+| debug-with-file | (standalone) | Debug With File |
+| analyze-with-file | (standalone) | Analyze With File |
 
 ### Atomic Group Rules
 
@@ -105,6 +129,14 @@ function detectTaskType(text) {
   if (/测试失败|test fail|fix test|failing test/.test(text)) return 'test-fix';
   if (/generate test|写测试|add test|补充测试/.test(text)) return 'test-gen';
   if (/review|审查|code review/.test(text)) return 'review';
+  // Issue workflow patterns
+  if (/issues?.*batch|batch.*issues?|批量.*issue|issue.*批量/.test(text)) return 'issue-batch';
+  if (/issue workflow|structured workflow|queue|multi-stage|转.*issue|issue.*流程/.test(text)) return 'issue-transition';
+  // With-File workflow patterns
+  if (/brainstorm|ideation|头脑风暴|创意|发散思维|creative thinking/.test(text)) return 'brainstorm-file';
+  if (/brainstorm.*issue|头脑风暴.*issue|idea.*issue|想法.*issue|从.*头脑风暴|convert.*brainstorm/.test(text)) return 'brainstorm-to-issue';
+  if (/debug.*document|hypothesis.*debug|深度调试|假设.*验证|systematic debug/.test(text)) return 'debug-file';
+  if (/analyze.*document|collaborative analysis|协作分析|深度.*理解/.test(text)) return 'analyze-file';
   if (/不确定|explore|研究|what if|brainstorm|权衡/.test(text)) return 'brainstorm';
   if (/多视角|比较方案|cross-verify|multi-cli/.test(text)) return 'multi-cli';
   return 'feature';  // Default
@@ -252,8 +284,8 @@ const commandPorts = {
     output: ['review-findings'],
     tags: ['review']
   },
-  'review-fix': {
-    name: 'review-fix',
+  'review-cycle-fix': {
+    name: 'review-cycle-fix',
     input: ['review-findings', 'review-verified'],  // Accept output from review-session-cycle or review-module-cycle
     output: ['fixed-code'],
     tags: ['review'],
@@ -277,14 +309,81 @@ const commandPorts = {
     input: ['code', 'session'],                 // 可接受代码或会话
     output: ['review-verified'],                // 输出端口:审查通过
     tags: ['review'],
-    atomic_group: 'code-review'                // 最小单元：与 review-fix 绑定
+    atomic_group: 'code-review'                // 最小单元：与 review-cycle-fix 绑定
   },
   'review-module-cycle': {
     name: 'review-module-cycle',
     input: ['module-pattern'],                  // 输入端口:模块模式
     output: ['review-verified'],                // 输出端口:审查通过
     tags: ['review'],
-    atomic_group: 'code-review'                // 最小单元：与 review-fix 绑定
+    atomic_group: 'code-review'                // 最小单元：与 review-cycle-fix 绑定
+  },
+
+  // Issue workflow commands
+  'issue:discover': {
+    name: 'issue:discover',
+    input: ['codebase'],                        // 输入端口：代码库
+    output: ['pending-issues'],                 // 输出端口：待处理 issues
+    tags: ['issue'],
+    atomic_group: 'issue-workflow'             // 最小单元：discover → plan → queue → execute
+  },
+  'issue:plan': {
+    name: 'issue:plan',
+    input: ['pending-issues'],                  // 输入端口：待处理 issues
+    output: ['issue-plans'],                    // 输出端口：issue 计划
+    tags: ['issue'],
+    atomic_group: 'issue-workflow'
+  },
+  'issue:queue': {
+    name: 'issue:queue',
+    input: ['issue-plans', 'converted-plan'],   // 可接受 issue:plan 或 convert-to-plan 输出
+    output: ['execution-queue'],                // 输出端口：执行队列
+    tags: ['issue'],
+    atomic_groups: ['issue-workflow', 'rapid-to-issue']
+  },
+  'issue:execute': {
+    name: 'issue:execute',
+    input: ['execution-queue'],                 // 输入端口：执行队列
+    output: ['completed-issues'],               // 输出端口：已完成 issues
+    tags: ['issue'],
+    atomic_groups: ['issue-workflow', 'rapid-to-issue']
+  },
+  'issue:convert-to-plan': {
+    name: 'issue:convert-to-plan',
+    input: ['plan'],                            // 输入端口：lite-plan 输出
+    output: ['converted-plan'],                 // 输出端口：转换后的 issue 计划
+    tags: ['issue', 'planning'],
+    atomic_group: 'rapid-to-issue'             // 最小单元：lite-plan → convert-to-plan → queue → execute
+  },
+
+  // With-File workflows (documented exploration with multi-CLI collaboration)
+  'brainstorm-with-file': {
+    name: 'brainstorm-with-file',
+    input: ['exploration-topic'],               // 输入端口：探索主题
+    output: ['brainstorm-document'],            // 输出端口：brainstorm.md + 综合结论
+    tags: ['brainstorm', 'with-file'],
+    note: 'Self-contained workflow with multi-round diverge-converge cycles'
+  },
+  'issue:from-brainstorm': {
+    name: 'issue:from-brainstorm',
+    input: ['brainstorm-document'],             // 输入端口：brainstorm 产物（synthesis.json）
+    output: ['converted-plan'],                 // 输出端口：issue + solution
+    tags: ['issue', 'brainstorm'],
+    atomic_group: 'brainstorm-to-issue'        // 最小单元：from-brainstorm → queue → execute
+  },
+  'debug-with-file': {
+    name: 'debug-with-file',
+    input: ['bug-report'],                      // 输入端口：bug 报告
+    output: ['understanding-document'],         // 输出端口：understanding.md + 修复
+    tags: ['bugfix', 'with-file'],
+    note: 'Self-contained workflow with hypothesis-driven iteration'
+  },
+  'analyze-with-file': {
+    name: 'analyze-with-file',
+    input: ['analysis-topic'],                  // 输入端口：分析主题
+    output: ['discussion-document'],            // 输出端口：discussion.md + 结论
+    tags: ['analysis', 'with-file'],
+    note: 'Self-contained workflow with multi-round discussion'
   }
 };
 ```
@@ -306,14 +405,22 @@ async function recommendCommandChain(analysis) {
 // 任务类型对应的端口流
 function determinePortFlow(taskType, constraints) {
   const flows = {
-    'bugfix':     { inputPort: 'bug-report', outputPort: constraints?.includes('skip-tests') ? 'fixed-code' : 'test-passed' },
-    'tdd':        { inputPort: 'requirement', outputPort: 'tdd-verified' },
-    'test-fix':   { inputPort: 'failing-tests', outputPort: 'test-passed' },
-    'test-gen':   { inputPort: 'code', outputPort: 'test-passed' },
-    'review':     { inputPort: 'code', outputPort: 'review-verified' },
-    'brainstorm': { inputPort: 'exploration-topic', outputPort: 'test-passed' },
-    'multi-cli':  { inputPort: 'requirement', outputPort: 'test-passed' },
-    'feature':    { inputPort: 'requirement', outputPort: constraints?.includes('skip-tests') ? 'code' : 'test-passed' }
+    'bugfix':         { inputPort: 'bug-report', outputPort: constraints?.includes('skip-tests') ? 'fixed-code' : 'test-passed' },
+    'tdd':            { inputPort: 'requirement', outputPort: 'tdd-verified' },
+    'test-fix':       { inputPort: 'failing-tests', outputPort: 'test-passed' },
+    'test-gen':       { inputPort: 'code', outputPort: 'test-passed' },
+    'review':         { inputPort: 'code', outputPort: 'review-verified' },
+    'brainstorm':     { inputPort: 'exploration-topic', outputPort: 'test-passed' },
+    'multi-cli':      { inputPort: 'requirement', outputPort: 'test-passed' },
+    // Issue workflow types
+    'issue-batch':      { inputPort: 'codebase', outputPort: 'completed-issues' },
+    'issue-transition': { inputPort: 'requirement', outputPort: 'completed-issues' },
+    // With-File workflow types
+    'brainstorm-file':    { inputPort: 'exploration-topic', outputPort: 'brainstorm-document' },
+    'brainstorm-to-issue': { inputPort: 'brainstorm-document', outputPort: 'completed-issues' },
+    'debug-file':         { inputPort: 'bug-report', outputPort: 'understanding-document' },
+    'analyze-file':       { inputPort: 'analysis-topic', outputPort: 'discussion-document' },
+    'feature':            { inputPort: 'requirement', outputPort: constraints?.includes('skip-tests') ? 'code' : 'test-passed' }
   };
   return flows[taskType] || flows['feature'];
 }
@@ -539,7 +646,7 @@ function formatCommand(cmd, previousResults, analysis) {
     if (latest?.session_id) prompt += ` --session="${latest.session_id}"`;
 
   // Review fix - takes session from review
-  } else if (name === 'review-fix') {
+  } else if (name === 'review-cycle-fix') {
     const review = previousResults.find(r => r.command.includes('review'));
     const latest = review || previousResults.filter(r => r.session_id).pop();
     if (latest?.session_id) prompt += ` --session="${latest.session_id}"`;
@@ -553,6 +660,45 @@ function formatCommand(cmd, previousResults, analysis) {
   } else if (name.includes('test') || name.includes('review') || name.includes('verify')) {
     const latest = previousResults.filter(r => r.session_id).pop();
     if (latest?.session_id) prompt += ` --session="${latest.session_id}"`;
+
+  // Issue workflow commands
+  } else if (name === 'issue:discover') {
+    // No parameters needed - discovers from codebase
+    prompt = `/issue:discover -y`;
+
+  } else if (name === 'issue:plan') {
+    prompt = `/issue:plan -y --all-pending`;
+
+  } else if (name === 'issue:queue') {
+    prompt = `/issue:queue -y`;
+
+  } else if (name === 'issue:execute') {
+    prompt = `/issue:execute -y --queue auto`;
+
+  } else if (name === 'issue:convert-to-plan' || name === 'convert-to-plan') {
+    // Convert latest lite-plan to issue plan
+    prompt = `/issue:convert-to-plan -y --latest-lite-plan`;
+
+  // With-File workflows (self-contained)
+  } else if (name === 'brainstorm-with-file') {
+    prompt = `/workflow:brainstorm-with-file -y "${analysis.goal}"`;
+
+  } else if (name === 'debug-with-file') {
+    prompt = `/workflow:debug-with-file -y "${analysis.goal}"`;
+
+  } else if (name === 'analyze-with-file') {
+    prompt = `/workflow:analyze-with-file -y "${analysis.goal}"`;
+
+  // Brainstorm-to-issue bridge
+  } else if (name === 'issue:from-brainstorm' || name === 'from-brainstorm') {
+    // Extract session ID from analysis.goal or latest brainstorm
+    const sessionMatch = analysis.goal.match(/BS-[\w-]+/);
+    if (sessionMatch) {
+      prompt = `/issue:from-brainstorm -y SESSION="${sessionMatch[0]}" --auto`;
+    } else {
+      // Find latest brainstorm session
+      prompt = `/issue:from-brainstorm -y --auto`;
+    }
   }
 
   return prompt;
@@ -882,7 +1028,10 @@ Task: Implement user registration' --tool claude --mode write
 
 ### Serial Blocking
 
-Commands execute one-by-one. After launching CLI in background, orchestrator stops immediately and waits for hook callback.
+**CRITICAL**: Commands execute one-by-one. After launching CLI in background:
+1. Orchestrator stops immediately (`break`)
+2. Wait for hook callback - **DO NOT use TaskOutput polling**
+3. Hook callback triggers next command
 
 **Prompt Structure**: Command must be first in prompt content
 
@@ -892,26 +1041,29 @@ const prompt = '/workflow:plan -y "Implement user authentication"\n\nTask: Imple
 const taskId = Bash(`ccw cli -p "${prompt}" --tool claude --mode write`, { run_in_background: true }).task_id;
 state.execution_results.push({ status: 'in-progress', task_id: taskId, ... });
 Write(`${stateDir}/state.json`, JSON.stringify(state, null, 2));
-break; // Stop, wait for hook callback
+break; // ⚠️ STOP HERE - DO NOT use TaskOutput polling
 
-// Hook calls handleCliCompletion(sessionId, taskId, output) when done
+// Hook callback will call handleCliCompletion(sessionId, taskId, output) when done
 // → Updates state → Triggers next command via resumeChainExecution()
 ```
 
+
 ## Available Commands
 
-All from `~/.claude/commands/workflow/`:
+All from `~/.claude/commands/workflow/` and `~/.claude/commands/issue/`:
 
 **Planning**: lite-plan, plan, multi-cli-plan, plan-verify, tdd-plan
 **Execution**: lite-execute, execute, develop-with-file
 **Testing**: test-cycle-execute, test-gen, test-fix-gen, tdd-verify
-**Review**: review, review-session-cycle, review-module-cycle, review-fix
+**Review**: review, review-session-cycle, review-module-cycle, review-cycle-fix
 **Bug Fixes**: lite-fix, debug, debug-with-file
 **Brainstorming**: brainstorm:auto-parallel, brainstorm:artifacts, brainstorm:synthesis
 **Design**: ui-design:*, animation-extract, layout-extract, style-extract, codify-style
 **Session Management**: session:start, session:resume, session:complete, session:solidify, session:list
 **Tools**: context-gather, test-context-gather, task-generate, conflict-resolution, action-plan-verify
 **Utility**: clean, init, replan
+**Issue Workflow**: issue:discover, issue:plan, issue:queue, issue:execute, issue:convert-to-plan, issue:from-brainstorm
+**With-File Workflows**: brainstorm-with-file, debug-with-file, analyze-with-file
 
 ### Testing Commands Distinction
 
@@ -937,8 +1089,14 @@ All from `~/.claude/commands/workflow/`:
 | **tdd** | 需求 → tdd-plan → TDD任务 → execute → 代码 → tdd-verify | TDD Planning + Execution |
 | **test-fix** | 失败测试 →【test-fix-gen → test-cycle-execute】→ 测试通过 | Test Validation |
 | **test-gen** | 代码/会话 →【test-gen → execute】→ 测试通过 | Test Generation + Execution |
-| **review** | 代码 →【review-* → review-fix】→ 修复代码 →【test-fix-gen → test-cycle-execute】→ 测试通过 | Code Review + Testing |
+| **review** | 代码 →【review-* → review-cycle-fix】→ 修复代码 →【test-fix-gen → test-cycle-execute】→ 测试通过 | Code Review + Testing |
 | **brainstorm** | 探索主题 → brainstorm → 分析 →【plan → plan-verify】→ execute → test | Exploration + Planning + Execution |
 | **multi-cli** | 需求 → multi-cli-plan → 对比分析 → lite-execute → test | Multi-Perspective + Testing |
+| **issue-batch** | 代码库 →【discover → plan → queue → execute】→ 完成 issues | Issue Workflow |
+| **issue-transition** | 需求 →【lite-plan → convert-to-plan → queue → execute】→ 完成 issues | Rapid-to-Issue |
+| **brainstorm-file** | 主题 → brainstorm-with-file → brainstorm.md (自包含) | Brainstorm With File |
+| **brainstorm-to-issue** | brainstorm.md →【from-brainstorm → queue → execute】→ 完成 issues | Brainstorm to Issue |
+| **debug-file** | Bug报告 → debug-with-file → understanding.md (自包含) | Debug With File |
+| **analyze-file** | 分析主题 → analyze-with-file → discussion.md (自包含) | Analyze With File |
 
 Use `CommandRegistry.getAllCommandsSummary()` to discover all commands dynamically.