feat: 添加工作流执行文档，支持从会话文件夹顺序执行任务

2026-02-10 02:24:35 +08:00 · 2025-12-15 14:32:08 +08:00
parent 3ffb907a6f
commit 82dcafff00
2 changed files with 376 additions and 0 deletions
--- a/.codex/prompts/workflow/execute.md
+++ b/.codex/prompts/workflow/execute.md
@@ -0,0 +1,212 @@
+---
+description: Execute workflow tasks sequentially from session folder
+argument-hint: SESSION=<path-to-session-folder>
+---
+
+# Workflow Execute (Codex Version)
+
+## Core Principle
+
+**Serial Execution**: Execute tasks ONE BY ONE in dependency order. Complete current task fully before moving to next. Continue autonomously until ALL tasks complete.
+
+## Input
+
+Session folder path via `$SESSION` (e.g., `.workflow/active/WFS-auth-system`)
+
+## Autonomous Execution Loop
+
+```
+INIT: Validate session folder structure
+
+WHILE tasks remain:
+  1. Read TODO_LIST.md → Get task statuses
+  2. Find FIRST pending task with met dependencies
+  3. Read task JSON from .task/{task-id}.json
+  4. Execute task fully (pre-analysis → implementation → verification)
+  5. Update task JSON status to "completed"
+  6. Output progress: "[X/N] ✓ {task.title}"
+  7. CONTINUE to next task (DO NOT STOP)
+
+WHEN all tasks completed:
+  Output final summary
+```
+
+## Execution Steps
+
+### Step 1: Validate Session
+
+Check required files exist:
+```
+$SESSION/
+├── IMPL_PLAN.md        ← Required
+├── TODO_LIST.md        ← Required
+└── .task/              ← Required, must have IMPL-*.json
+```
+
+If missing, report error and stop.
+
+### Step 2: Parse TODO_LIST.md
+
+Extract task list with current statuses:
+```markdown
+- [x] IMPL-1: Task 1 title (completed)
+- [ ] IMPL-1.1: Task 2 title (pending) ← Execute this
+- [ ] IMPL-2: Task 3 title (pending, depends on IMPL-1.1)
+```
+
+### Step 3: Find Next Executable Task
+
+```javascript
+// Sequential scan for first eligible task
+for (task of todoList) {
+  if (task.completed) continue
+  
+  // Check dependencies from task JSON
+  taskJson = read(`$SESSION/.task/${task.id}.json`)
+  if (taskJson.depends_on?.every(dep => isCompleted(dep))) {
+    return task  // Execute this one
+  }
+}
+return null  // All done or all blocked
+```
+
+### Step 4: Load Task Context
+
+```bash
+# Read task definition
+cat $SESSION/.task/$TASK_ID.json
+
+# Read context package if exists
+cat $SESSION/.process/context-package.json
+```
+
+### Step 5: Execute Task
+
+#### 5A: Pre-Analysis (if flow_control.pre_analysis exists)
+```markdown
+## Pre-Analysis for: [task.title]
+
+Execute each step:
+1. [Read referenced files]
+2. [Search for patterns]
+3. [Load dependencies]
+```
+
+#### 5B: Implementation
+```markdown
+## Implementing: [task.title]
+
+**Objective**: [context.objective]
+
+**Steps**:
+1. [flow_control.execution_steps[0]]
+2. [flow_control.execution_steps[1]]
+...
+
+**Deliverables**:
+- [ ] [context.deliverables[0]]
+- [ ] [context.deliverables[1]]
+```
+
+#### 5C: Verification
+```markdown
+## Verifying: [task.title]
+
+**Acceptance Criteria**:
+- [x] [context.acceptance_criteria[0]]
+- [x] [context.acceptance_criteria[1]]
+
+All criteria met: YES → Mark completed
+```
+
+### Step 6: Update Status
+
+Update task JSON:
+```json
+{
+  "id": "IMPL-1.1",
+  "status": "completed",  // Changed from "pending"
+  "completed_at": "2025-12-15T..."
+}
+```
+
+### Step 7: Continue Immediately
+
+**DO NOT STOP. Return to Step 2 to find next task.**
+
+Output progress:
+```
+✓ [3/7] Completed: IMPL-1.1 - [task title]
+→ Next: IMPL-2 - [next task title]
+```
+
+## Task JSON Structure
+
+```json
+{
+  "id": "IMPL-1.1",
+  "title": "Task Title",
+  "status": "pending|completed",
+  "meta": {
+    "type": "feature|test|docs",
+    "execution_group": "group-id"
+  },
+  "context": {
+    "objective": "What to achieve",
+    "deliverables": ["output 1", "output 2"],
+    "acceptance_criteria": ["check 1", "check 2"]
+  },
+  "flow_control": {
+    "pre_analysis": ["step 1", "step 2"],
+    "execution_steps": ["impl step 1", "impl step 2"]
+  },
+  "depends_on": ["IMPL-1"]
+}
+```
+
+## Execution Rules
+
+1. **Never stop mid-workflow** - Continue until all tasks complete
+2. **One task at a time** - Fully complete before moving on
+3. **Respect dependencies** - Skip blocked tasks, find next eligible
+4. **Update status immediately** - Mark completed right after verification
+5. **Self-verify** - All acceptance criteria must pass before marking done
+6. **Handle blocked state** - If all remaining tasks blocked, report and stop
+
+## Final Summary
+
+When ALL tasks completed:
+
+```markdown
+## Workflow Execution Complete
+
+**Session**: $SESSION
+**Total Tasks**: N
+**Completed**: N
+
+### Execution Log
+| # | Task ID | Title | Status |
+|---|---------|-------|--------|
+| 1 | IMPL-1 | ... | ✓ |
+| 2 | IMPL-1.1 | ... | ✓ |
+| 3 | IMPL-2 | ... | ✓ |
+
+### Files Modified
+- `src/auth/login.ts`
+- `src/utils/validator.ts`
+
+### Summary
+[What was accomplished across all tasks]
+```
+
+## Error Handling
+
+| Situation | Action |
+|-----------|--------|
+| Session folder not found | Error and stop |
+| Missing required files | Error: specify which file missing |
+| Task JSON not found | Error, skip task, continue |
+| Task blocked (deps not met) | Skip, find next eligible task |
+| All tasks blocked | Report circular dependency, stop |
+| Execution error | Report, mark task failed, continue to next |
+| Verification failed | Retry once, then report and continue |