claude-code-workflow 6.3.37 → 6.3.39

package/.codex/skills/ccw-loop-b/phases/orchestrator.md

@@ -0,0 +1,257 @@
+# Orchestrator (Hybrid Pattern)
+
+协调器负责状态管理、worker 调度、结果汇聚。
+
+## Role
+
+```
+Read state -> Select mode -> Spawn workers -> Wait results -> Merge -> Update state -> Loop/Exit
+```
+
+## State Management
+
+### Read State
+
+```javascript
+function readState(loopId) {
+  const stateFile = `.workflow/.loop/${loopId}.json`
+  return fs.existsSync(stateFile)
+    ? JSON.parse(Read(stateFile))
+    : null
+}
+```
+
+### Create State
+
+```javascript
+function createState(loopId, taskDescription, mode) {
+  const now = new Date().toISOString()
+
+  return {
+    loop_id: loopId,
+    title: taskDescription.substring(0, 100),
+    description: taskDescription,
+    mode: mode,
+    status: 'running',
+    current_iteration: 0,
+    max_iterations: 10,
+    created_at: now,
+    updated_at: now,
+    skill_state: {
+      phase: 'init',
+      action_index: 0,
+      workers_completed: [],
+      parallel_results: null
+    }
+  }
+}
+```
+
+## Mode Handlers
+
+### Interactive Mode
+
+```javascript
+async function runInteractiveMode(loopId, state) {
+  while (state.status === 'running') {
+    // 1. Show menu
+    const action = await showMenu(state)
+    if (action === 'exit') break
+
+    // 2. Spawn worker
+    const worker = spawn_agent({
+      message: buildWorkerPrompt(action, loopId, state)
+    })
+
+    // 3. Wait for result
+    const result = wait({ ids: [worker], timeout_ms: 600000 })
+
+    // 4. Handle timeout
+    if (result.timed_out) {
+      send_input({ id: worker, message: 'Please converge and output WORKER_RESULT' })
+      const retryResult = wait({ ids: [worker], timeout_ms: 300000 })
+      if (retryResult.timed_out) {
+        console.log('Worker timeout, skipping')
+        close_agent({ id: worker })
+        continue
+      }
+    }
+
+    // 5. Process output
+    const output = result.status[worker].completed
+    state = processWorkerOutput(loopId, action, output, state)
+
+    // 6. Cleanup
+    close_agent({ id: worker })
+
+    // 7. Display result
+    displayResult(output)
+  }
+}
+```
+
+### Auto Mode
+
+```javascript
+async function runAutoMode(loopId, state) {
+  const sequence = ['init', 'develop', 'debug', 'validate', 'complete']
+  let idx = state.skill_state?.action_index || 0
+
+  while (idx < sequence.length && state.status === 'running') {
+    const action = sequence[idx]
+
+    // Spawn and wait
+    const worker = spawn_agent({ message: buildWorkerPrompt(action, loopId, state) })
+    const result = wait({ ids: [worker], timeout_ms: 600000 })
+    const output = result.status[worker].completed
+    close_agent({ id: worker })
+
+    // Parse result
+    const workerResult = parseWorkerResult(output)
+    state = processWorkerOutput(loopId, action, output, state)
+
+    // Determine next
+    if (workerResult.loop_back_to) {
+      idx = sequence.indexOf(workerResult.loop_back_to)
+    } else if (workerResult.status === 'failed') {
+      break
+    } else {
+      idx++
+    }
+
+    // Update action index
+    state.skill_state.action_index = idx
+    saveState(loopId, state)
+  }
+}
+```
+
+### Parallel Mode
+
+```javascript
+async function runParallelMode(loopId, state) {
+  // Spawn all workers
+  const workers = {
+    develop: spawn_agent({ message: buildWorkerPrompt('develop', loopId, state) }),
+    debug: spawn_agent({ message: buildWorkerPrompt('debug', loopId, state) }),
+    validate: spawn_agent({ message: buildWorkerPrompt('validate', loopId, state) })
+  }
+
+  // Batch wait
+  const results = wait({
+    ids: Object.values(workers),
+    timeout_ms: 900000
+  })
+
+  // Collect outputs
+  const outputs = {}
+  for (const [role, id] of Object.entries(workers)) {
+    if (results.status[id].completed) {
+      outputs[role] = results.status[id].completed
+    }
+    close_agent({ id })
+  }
+
+  // Merge analysis
+  state.skill_state.parallel_results = outputs
+  saveState(loopId, state)
+
+  // Coordinator analyzes merged results
+  return analyzeAndDecide(outputs)
+}
+```
+
+## Worker Prompt Template
+
+```javascript
+function buildWorkerPrompt(action, loopId, state) {
+  const roleFiles = {
+    init: '~/.codex/agents/ccw-loop-b-init.md',
+    develop: '~/.codex/agents/ccw-loop-b-develop.md',
+    debug: '~/.codex/agents/ccw-loop-b-debug.md',
+    validate: '~/.codex/agents/ccw-loop-b-validate.md',
+    complete: '~/.codex/agents/ccw-loop-b-complete.md'
+  }
+
+  return `
+## TASK ASSIGNMENT
+
+### MANDATORY FIRST STEPS
+1. **Read role definition**: ${roleFiles[action]}
+2. Read: .workflow/project-tech.json
+3. Read: .workflow/project-guidelines.json
+
+---
+
+## CONTEXT
+- Loop ID: ${loopId}
+- Action: ${action}
+- State: ${JSON.stringify(state, null, 2)}
+
+## TASK
+${state.description}
+
+## OUTPUT FORMAT
+\`\`\`
+WORKER_RESULT:
+- action: ${action}
+- status: success | failed | needs_input
+- summary: <brief>
+- files_changed: []
+- next_suggestion: <action>
+- loop_back_to: <action or null>
+
+DETAILED_OUTPUT:
+<action-specific output>
+\`\`\`
+`
+}
+```
+
+## Result Processing
+
+```javascript
+function parseWorkerResult(output) {
+  const result = {
+    action: 'unknown',
+    status: 'unknown',
+    summary: '',
+    files_changed: [],
+    next_suggestion: null,
+    loop_back_to: null
+  }
+
+  const match = output.match(/WORKER_RESULT:\s*([\s\S]*?)(?:DETAILED_OUTPUT:|$)/)
+  if (match) {
+    const lines = match[1].split('\n')
+    for (const line of lines) {
+      const m = line.match(/^-\s*(\w+):\s*(.+)$/)
+      if (m) {
+        const [, key, value] = m
+        if (key === 'files_changed') {
+          try { result.files_changed = JSON.parse(value) } catch {}
+        } else {
+          result[key] = value.trim()
+        }
+      }
+    }
+  }
+
+  return result
+}
+```
+
+## Termination Conditions
+
+1. User exits (interactive)
+2. Sequence complete (auto)
+3. Worker failed with no recovery
+4. Max iterations reached
+5. API paused/stopped
+
+## Best Practices
+
+1. **Worker 生命周期**: spawn → wait → close，不保留 worker
+2. **结果持久化**: Worker 输出写入 `.workflow/.loop/{loopId}.workers/`
+3. **状态同步**: 每次 worker 完成后更新 state
+4. **超时处理**: send_input 请求收敛，再超时则跳过

package/.codex/skills/ccw-loop-b/phases/state-schema.md

@@ -0,0 +1,181 @@
+# State Schema (CCW Loop-B)
+
+## Master State Structure
+
+```json
+{
+  "loop_id": "loop-b-20260122-abc123",
+  "title": "Implement user authentication",
+  "description": "Full task description here",
+  "mode": "interactive | auto | parallel",
+  "status": "running | paused | completed | failed",
+  "current_iteration": 3,
+  "max_iterations": 10,
+  "created_at": "2026-01-22T10:00:00.000Z",
+  "updated_at": "2026-01-22T10:30:00.000Z",
+
+  "skill_state": {
+    "phase": "develop | debug | validate | complete",
+    "action_index": 2,
+    "workers_completed": ["init", "develop"],
+    "parallel_results": null,
+    "pending_tasks": [],
+    "completed_tasks": [],
+    "findings": []
+  }
+}
+```
+
+## Field Descriptions
+
+### Core Fields (API Compatible)
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `loop_id` | string | Unique identifier |
+| `title` | string | Short title (max 100 chars) |
+| `description` | string | Full task description |
+| `mode` | enum | Execution mode |
+| `status` | enum | Current status |
+| `current_iteration` | number | Iteration counter |
+| `max_iterations` | number | Safety limit |
+| `created_at` | ISO string | Creation timestamp |
+| `updated_at` | ISO string | Last update timestamp |
+
+### Skill State Fields
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `phase` | enum | Current execution phase |
+| `action_index` | number | Position in action sequence (auto mode) |
+| `workers_completed` | array | List of completed worker actions |
+| `parallel_results` | object | Merged results from parallel mode |
+| `pending_tasks` | array | Tasks waiting to be executed |
+| `completed_tasks` | array | Tasks already done |
+| `findings` | array | Discoveries during execution |
+
+## Worker Output Structure
+
+Each worker writes to `.workflow/.loop/{loopId}.workers/{action}.output.json`:
+
+```json
+{
+  "action": "develop",
+  "status": "success",
+  "summary": "Implemented 3 functions",
+  "files_changed": ["src/auth.ts", "src/utils.ts"],
+  "next_suggestion": "validate",
+  "loop_back_to": null,
+  "timestamp": "2026-01-22T10:15:00.000Z",
+  "detailed_output": {
+    "tasks_completed": [
+      { "id": "T1", "description": "Create auth module" }
+    ],
+    "metrics": {
+      "lines_added": 150,
+      "lines_removed": 20
+    }
+  }
+}
+```
+
+## Progress File Structure
+
+Human-readable progress in `.workflow/.loop/{loopId}.progress/{action}.md`:
+
+```markdown
+# Develop Progress
+
+## Session: loop-b-20260122-abc123
+
+### Iteration 1 (2026-01-22 10:15)
+
+**Task**: Implement auth module
+
+**Changes**:
+- Created `src/auth.ts` with login/logout functions
+- Added JWT token handling in `src/utils.ts`
+
+**Status**: Success
+
+---
+
+### Iteration 2 (2026-01-22 10:30)
+
+...
+```
+
+## Status Transitions
+
+```
+          +--------+
+          | init   |
+          +--------+
+               |
+               v
++------> +---------+
+|        | develop |
+|        +---------+
+|             |
+|    +--------+--------+
+|    |                 |
+|    v                 v
+| +-------+       +---------+
+| | debug |<------| validate|
+| +-------+       +---------+
+|    |                 |
+|    +--------+--------+
+|             |
+|             v
+|       [needs fix?]
+|        yes |  | no
+|            v  v
++------------+  +----------+
+               | complete  |
+               +----------+
+```
+
+## Parallel Results Schema
+
+When `mode === 'parallel'`:
+
+```json
+{
+  "parallel_results": {
+    "develop": {
+      "status": "success",
+      "summary": "...",
+      "suggestions": []
+    },
+    "debug": {
+      "status": "success",
+      "issues_found": [],
+      "suggestions": []
+    },
+    "validate": {
+      "status": "success",
+      "test_results": {},
+      "coverage": {}
+    },
+    "merged_at": "2026-01-22T10:45:00.000Z"
+  }
+}
+```
+
+## Directory Structure
+
+```
+.workflow/.loop/
++-- loop-b-20260122-abc123.json          # Master state
++-- loop-b-20260122-abc123.workers/
+|   +-- init.output.json
+|   +-- develop.output.json
+|   +-- debug.output.json
+|   +-- validate.output.json
+|   +-- complete.output.json
++-- loop-b-20260122-abc123.progress/
+    +-- develop.md
+    +-- debug.md
+    +-- validate.md
+    +-- summary.md
+```