claude-code-workflow 6.3.53 → 7.0.0

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

@@ -1,257 +0,0 @@
-# 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

@@ -1,181 +0,0 @@
-# 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
-```