feat: Implement workflow phases for test generation and execution

- Added Phase 1: Session Start to detect input mode and create test workflow session. - Added Phase 2: Test Context Gather to gather test context via coverage analysis or codebase scan. - Added Phase 3: Test Concept Enhanced to analyze test requirements using Gemini and generate multi-layered test requirements. - Added Phase 4: Test Task Generate to create test-specific tasks based on analysis results. - Added Phase 5: Test Cycle Execute to manage iterative test execution and fix cycles with adaptive strategies. - Introduced BottomPanel component for terminal dashboard with Queue and Inspector tabs.
2026-02-15 02:42:45 +08:00 · 2026-02-14 21:35:55 +08:00
parent 0d805efe87
commit d535ab4749
27 changed files with 2004 additions and 2363 deletions
--- a/.claude/skills/workflow-test-fix/SKILL.md
+++ b/.claude/skills/workflow-test-fix/SKILL.md
@@ -6,7 +6,7 @@ allowed-tools: Skill, Task, AskUserQuestion, TaskCreate, TaskUpdate, TaskList, R

 # Workflow Test Fix

-Unified test-fix orchestrator that combines **test planning generation** (Phase 1) with **iterative test-cycle execution** (Phase 2) into a single end-to-end pipeline. Creates test sessions with progressive L0-L3 test layers, generates test tasks, then executes them with adaptive fix cycles until pass rate >= 95% or max iterations reached.
+Unified test-fix orchestrator that combines **test planning generation** (Phase 1-4) with **iterative test-cycle execution** (Phase 5) into a single end-to-end pipeline. Creates test sessions with progressive L0-L3 test layers, generates test tasks, then executes them with adaptive fix cycles until pass rate >= 95% or max iterations reached.

 ## Architecture Overview

@@ -14,27 +14,29 @@ Unified test-fix orchestrator that combines **test planning generation** (Phase
 ┌───────────────────────────────────────────────────────────────────────────┐
 │  Workflow Test Fix Orchestrator (SKILL.md)                                │
 │  → Pure coordinator: Route entry point, track progress, pass context      │
-│  → Two phases: Generation (Phase 1) + Execution (Phase 2)                │
+│  → Five phases: Session → Context → Analysis → TaskGen → Execution       │
 └──────────────────────────────────┬────────────────────────────────────────┘
                                   │
-       ┌───────────────────────────┼────────────────────────────┐
-       ↓                                                        ↓
-┌──────────────────────┐                          ┌──────────────────────┐
-│  Phase 1: Test Gen   │                          │  Phase 2: Test Cycle │
-│  (test-fix-gen)      │─── testSessionId ───────→│  (test-cycle-execute)│
-│                      │                          │                      │
-│  1. Session Create   │                          │  1. Discovery        │
-│  2. Context Gather   │                          │  2. Initial Execute  │
-│  3. Test Analysis    │                          │  3. Fix Loop         │
-│  4. Task Generation  │                          │  4. Completion       │
-│  5. Summary          │                          │                      │
-└──────────────────────┘                          └──────────────────────┘
-     sessionId                                       pass_rate >= 95%
-     contextPath                                     or max iterations
-     IMPL_PLAN.md
-     IMPL-*.json
+  ┌────────────┬────────────┬──────┴──────┬────────────┬────────────┐
+  ↓            ↓            ↓             ↓            ↓
+┌──────────┐┌──────────┐┌──────────┐┌──────────┐    ┌──────────────┐
+│ Phase 1  ││ Phase 2  ││ Phase 3  ││ Phase 4  │    │  Phase 5     │
+│ Session  ││ Context  ││ Analysis ││ Task Gen │    │  Test Cycle  │
+│ Start    ││ Gather   ││ Enhanced ││ Generate │    │  Execute     │
+│          ││          ││          ││          │    │              │
+│ Input    ││ Coverage ││ Gemini   ││ IMPL_PLAN│    │  1. Discovery│
+│ Detect + ││ or Code  ││ L0-L3   ││ IMPL-*   │    │  2. Execute  │
+│ Session  ││ Scan     ││ AI Issue ││ TODO_LIST│    │  3. Fix Loop │
+│ Create   ││          ││          ││          │    │  4. Complete │
+└────┬─────┘└────┬─────┘└────┬─────┘└────┬─────┘    └──────────────┘
+     │           │           │           │                  ↑
+     │testSessionId          │           │                  │
+     └──→────────┘contextPath│           │                  │
+                  └──→───────┘AnalysisRes│                  │
+                               └──→──────┘ testSessionId    │
+                                          └──→──(Summary)──→┘

-Task Pipeline (generated in Phase 1, executed in Phase 2):
+Task Pipeline (generated in Phase 4, executed in Phase 5):
 ┌──────────────┐   ┌─────────────────┐   ┌─────────────────┐   ┌──────────────┐
 │  IMPL-001    │──→│  IMPL-001.3     │──→│  IMPL-001.5     │──→│  IMPL-002    │
 │  Test Gen    │   │  Code Validate  │   │  Quality Gate   │   │  Test & Fix  │
@@ -47,7 +49,7 @@ Task Pipeline (generated in Phase 1, executed in Phase 2):

 1. **Unified Pipeline**: Generation and execution are one continuous workflow - no manual handoff
 2. **Pure Orchestrator**: SKILL.md coordinates only - delegates all execution detail to phase files
-3. **Auto-Continue**: Phase 1 completes → Phase 2 starts automatically
+3. **Auto-Continue**: Phase 1→2→3→4→(Summary)→5 automatically
 4. **Task Attachment/Collapse**: Sub-tasks attached during phase execution, collapsed after completion
 5. **Progressive Phase Loading**: Phase docs read **only** when that phase executes, not upfront
 6. **Adaptive Strategy**: Fix loop auto-selects strategy (conservative/aggressive/surgical) based on iteration context
@@ -75,21 +77,35 @@ When `--yes` or `-y`: Auto-select first active session, skip confirmations, auto

 ```
 Entry Point Detection:
-   ├─ /workflow:test-fix-gen → Full Pipeline (Phase 1 → Phase 2)
-   └─ /workflow:test-cycle-execute → Execution Only (Phase 2)
+   ├─ /workflow:test-fix-gen → Full Pipeline (Phase 1→2→3→4→Summary→5)
+   └─ /workflow:test-cycle-execute → Execution Only (Phase 5)

-Phase 1: Test Generation (test-fix-gen)
-   └─ Ref: phases/01-test-fix-gen.md
-      ├─ Step 1.1: Detect input mode (session | prompt)
-      ├─ Step 1.2: Create test session → testSessionId
-      ├─ Step 1.3: Gather test context → contextPath
-      ├─ Step 1.4: Test analysis (Gemini) → TEST_ANALYSIS_RESULTS.md
-      ├─ Step 1.5: Generate test tasks → IMPL_PLAN.md, IMPL-*.json, TODO_LIST.md
+Phase 1: Session Start (session-start)
+   └─ Ref: phases/01-session-start.md
+      ├─ Step 1.0: Detect input mode (session | prompt)
+      ├─ Step 1.1: Create test session → testSessionId
+      └─ Output: testSessionId, MODE
+
+Phase 2: Test Context Gather (test-context-gather)
+   └─ Ref: phases/02-test-context-gather.md
+      ├─ Step 1.2: Gather test context → contextPath
+      └─ Output: contextPath
+
+Phase 3: Test Concept Enhanced (test-concept-enhanced)
+   └─ Ref: phases/03-test-concept-enhanced.md
+      ├─ Step 1.3: Test analysis (Gemini) → TEST_ANALYSIS_RESULTS.md
+      └─ Output: TEST_ANALYSIS_RESULTS.md
+
+Phase 4: Test Task Generate (test-task-generate)
+   └─ Ref: phases/04-test-task-generate.md
+      ├─ Step 1.4: Generate test tasks → IMPL_PLAN.md, IMPL-*.json, TODO_LIST.md
      └─ Output: testSessionId, 4+ task JSONs
-         → Auto-continue to Phase 2

-Phase 2: Test Cycle Execution (test-cycle-execute)
-   └─ Ref: phases/02-test-cycle-execute.md
+Summary Output (inline after Phase 4):
+   └─ Display summary, auto-continue to Phase 5
+
+Phase 5: Test Cycle Execution (test-cycle-execute)
+   └─ Ref: phases/05-test-cycle-execute.md
      ├─ Step 2.1: Discovery (load session, tasks, iteration state)
      ├─ Step 2.2: Execute initial tasks (IMPL-001 → 001.3 → 001.5 → 002)
      ├─ Step 2.3: Fix loop (if pass_rate < 95%)
@@ -105,20 +121,23 @@ Phase 2: Test Cycle Execution (test-cycle-execute)

 | Phase | Document | Purpose |
 |-------|----------|---------|
-| 1 | [phases/01-test-fix-gen.md](phases/01-test-fix-gen.md) | Create test session, gather context, analyze, generate tasks |
-| 2 | [phases/02-test-cycle-execute.md](phases/02-test-cycle-execute.md) | Execute tasks, iterative fix cycles, completion |
+| 1 | [phases/01-session-start.md](phases/01-session-start.md) | Detect input mode, create test session |
+| 2 | [phases/02-test-context-gather.md](phases/02-test-context-gather.md) | Gather test context (coverage/codebase) |
+| 3 | [phases/03-test-concept-enhanced.md](phases/03-test-concept-enhanced.md) | Gemini analysis, L0-L3 test requirements |
+| 4 | [phases/04-test-task-generate.md](phases/04-test-task-generate.md) | Generate task JSONs and IMPL_PLAN.md |
+| 5 | [phases/05-test-cycle-execute.md](phases/05-test-cycle-execute.md) | Execute tasks, iterative fix cycles, completion |

 ## Core Rules

-1. **Start Immediately**: First action is TaskCreate initialization, second action is Phase 1 (or Phase 2 for execute-only entry)
+1. **Start Immediately**: First action is TaskCreate initialization, second action is Phase 1 (or Phase 5 for execute-only entry)
 2. **No Preliminary Analysis**: Do not read files or gather context before starting the phase
 3. **Parse Every Output**: Extract required data from each step output for next step
-4. **Auto-Continue**: Phase 1 → Phase 2 automatically (for full pipeline entry)
+4. **Auto-Continue**: Phase 1→2→3→4→(Summary)→5 automatically (for full pipeline entry)
 5. **Track Progress**: Update TaskCreate/TaskUpdate dynamically with task attachment/collapse pattern
 6. **Task Attachment Model**: Sub-tasks **attached** during phase, **collapsed** after completion
 7. **DO NOT STOP**: Continuous workflow until quality gate met or max iterations reached
 8. **Progressive Loading**: Read phase doc ONLY when that phase is about to execute
-9. **Entry Point Routing**: `/workflow:test-fix-gen` → Phase 1 + Phase 2; `/workflow:test-cycle-execute` → Phase 2 only
+9. **Entry Point Routing**: `/workflow:test-fix-gen` → Phase 1-5; `/workflow:test-cycle-execute` → Phase 5 only

 ## Input Processing

@@ -130,7 +149,7 @@ User input → Detect type:
  └─ Otherwise          → MODE=prompt, description=input
 ```

-### test-cycle-execute Entry (Phase 2 Only)
+### test-cycle-execute Entry (Phase 5 Only)
 ```
 Arguments → Parse flags:
  ├─ --resume-session="WFS-xxx" → sessionId=WFS-xxx
@@ -145,20 +164,60 @@ User Input (session ID | description | file path)
    ↓
 [Detect Mode: session | prompt]
    ↓
-Phase 1: Test Generation ─────────────────────────────────────────
-    ↓ 1.1: session:start → testSessionId
-    ↓ 1.2: test-context-gather/context-gather → contextPath
-    ↓ 1.3: test-concept-enhanced → TEST_ANALYSIS_RESULTS.md
-    ↓ 1.4: test-task-generate → IMPL_PLAN.md, IMPL-*.json, TODO_LIST.md
-    ↓ 1.5: Summary with next step
+Phase 1: Session Start ─────────────────────────────────────────
+    ↓ 1.0+1.1: session:start → testSessionId, MODE
    ↓
-Phase 2: Test Cycle Execution ────────────────────────────────────
+Phase 2: Test Context Gather ────────────────────────────────────
+    ↓ 1.2: test-context-gather/context-gather → contextPath
+    ↓
+Phase 3: Test Concept Enhanced ──────────────────────────────────
+    ↓ 1.3: test-concept-enhanced → TEST_ANALYSIS_RESULTS.md
+    ↓
+Phase 4: Test Task Generate ─────────────────────────────────────
+    ↓ 1.4: test-task-generate → IMPL_PLAN.md, IMPL-*.json, TODO_LIST.md
+    ↓
+Summary Output (inline) ─────────────────────────────────────────
+    ↓ Display summary with next step
+    ↓
+Phase 5: Test Cycle Execution ───────────────────────────────────
    ↓ 2.1: Load session + tasks + iteration state
    ↓ 2.2: Execute IMPL-001 → 001.3 → 001.5 → 002
    ↓ 2.3: Fix loop (analyze → fix → retest) until pass_rate >= 95%
    ↓ 2.4: Completion → summary → session archive
 ```

+## Summary Output (after Phase 4)
+
+After Phase 4 completes, display the following summary before auto-continuing to Phase 5:
+
+```
+Test-fix workflow created successfully!
+
+Input: [original input]
+Mode: [Session|Prompt]
+Test Session: [testSessionId]
+
+Tasks Created:
+- IMPL-001: Test Understanding & Generation (@code-developer)
+- IMPL-001.3: Code Validation Gate - AI Error Detection (@test-fix-agent)
+- IMPL-001.5: Test Quality Gate - Static Analysis & Coverage (@test-fix-agent)
+- IMPL-002: Test Execution & Fix Cycle (@test-fix-agent)
+
+Quality Thresholds:
+- Code Validation: Zero CRITICAL issues, zero compilation errors
+- Minimum Coverage: 80% line, 70% branch
+- Static Analysis: Zero critical anti-patterns
+- Max Fix Iterations: 5
+
+Review artifacts:
+- Test plan: .workflow/[testSessionId]/IMPL_PLAN.md
+- Task list: .workflow/[testSessionId]/TODO_LIST.md
+- Analysis: .workflow/[testSessionId]/.process/TEST_ANALYSIS_RESULTS.md
+```
+
+**CRITICAL - Next Step**: Auto-continue to Phase 5: Test Cycle Execution.
+Pass `testSessionId` to Phase 5 for test execution pipeline. Do NOT wait for user confirmation — the unified pipeline continues automatically.
+
 ## Test Strategy Overview

 Progressive Test Layers (L0-L3):
@@ -177,7 +236,7 @@ Progressive Test Layers (L0-L3):
 - Pass Rate Gate: >= 95% (criticality-aware) or 100%
 - Max Fix Iterations: 10 (default, adjustable)

-## Strategy Engine (Phase 2)
+## Strategy Engine (Phase 5)

 | Strategy | Trigger | Behavior |
 |----------|---------|----------|
@@ -185,16 +244,16 @@ Progressive Test Layers (L0-L3):
 | **Aggressive** | Pass rate >80% + similar failures | Batch fix related issues |
 | **Surgical** | Regression detected (pass rate drops >10%) | Minimal changes, rollback focus |

-Selection logic and CLI fallback chain (Gemini → Qwen → Codex) are detailed in Phase 2.
+Selection logic and CLI fallback chain (Gemini → Qwen → Codex) are detailed in Phase 5.

 ## Agent Roles

 | Agent | Used In | Responsibility |
 |-------|---------|---------------|
-| **Orchestrator** | Both phases | Route entry, track progress, pass context |
-| **@code-developer** | Phase 2 (IMPL-001) | Test generation (L1-L3) |
-| **@test-fix-agent** | Phase 2 | Test execution, code fixes, criticality assignment |
-| **@cli-planning-agent** | Phase 2 (fix loop) | CLI analysis, root cause extraction, fix task generation |
+| **Orchestrator** | All phases | Route entry, track progress, pass context |
+| **@code-developer** | Phase 5 (IMPL-001) | Test generation (L1-L3) |
+| **@test-fix-agent** | Phase 5 | Test execution, code fixes, criticality assignment |
+| **@cli-planning-agent** | Phase 5 (fix loop) | CLI analysis, root cause extraction, fix task generation |

 ## TodoWrite Pattern

@@ -206,25 +265,27 @@ Selection logic and CLI fallback chain (Gemini → Qwen → Codex) are detailed
 > - Sub-task attachment → `TaskCreate` + `TaskUpdate({ addBlockedBy })`
 > - Sub-task collapse → `TaskUpdate({ status: "completed" })` + `TaskUpdate({ status: "deleted" })` for collapsed sub-items

-### Full Pipeline (Phase 1 + Phase 2)
+### Full Pipeline (Phase 1-5)

 ```json
 [
-  {"content": "Phase 1: Test Generation", "status": "in_progress"},
-  {"content": "  → Create test session", "status": "in_progress"},
-  {"content": "  → Gather test context", "status": "pending"},
-  {"content": "  → Test analysis (Gemini)", "status": "pending"},
-  {"content": "  → Generate test tasks", "status": "pending"},
-  {"content": "Phase 2: Test Cycle Execution", "status": "pending"}
+  {"content": "Phase 1: Session Start", "status": "in_progress"},
+  {"content": "Phase 2: Test Context Gather", "status": "pending"},
+  {"content": "Phase 3: Test Analysis (Gemini)", "status": "pending"},
+  {"content": "Phase 4: Test Task Generate", "status": "pending"},
+  {"content": "Phase 5: Test Cycle Execution", "status": "pending"}
 ]
 ```

-### Phase 1 Collapsed → Phase 2 Active
+### Phase 1-4 Collapsed → Phase 5 Active

 ```json
 [
-  {"content": "Phase 1: Test Generation", "status": "completed"},
-  {"content": "Phase 2: Test Cycle Execution", "status": "in_progress"},
+  {"content": "Phase 1: Session Start", "status": "completed"},
+  {"content": "Phase 2: Test Context Gather", "status": "completed"},
+  {"content": "Phase 3: Test Analysis (Gemini)", "status": "completed"},
+  {"content": "Phase 4: Test Task Generate", "status": "completed"},
+  {"content": "Phase 5: Test Cycle Execution", "status": "in_progress"},
  {"content": "  → Execute IMPL-001 [code-developer]", "status": "in_progress"},
  {"content": "  → Execute IMPL-001.3 [test-fix-agent]", "status": "pending"},
  {"content": "  → Execute IMPL-001.5 [test-fix-agent]", "status": "pending"},
@@ -237,8 +298,8 @@ Selection logic and CLI fallback chain (Gemini → Qwen → Codex) are detailed

 ```json
 [
-  {"content": "Phase 1: Test Generation", "status": "completed"},
-  {"content": "Phase 2: Test Cycle Execution", "status": "in_progress"},
+  {"content": "Phase 1-4: Test Generation", "status": "completed"},
+  {"content": "Phase 5: Test Cycle Execution", "status": "in_progress"},
  {"content": "  → Initial tasks", "status": "completed"},
  {"content": "  → Iteration 1: Initial test (pass: 70%, conservative)", "status": "completed"},
  {"content": "  → Iteration 2: Fix validation (pass: 82%, conservative)", "status": "completed"},
@@ -258,7 +319,7 @@ Selection logic and CLI fallback chain (Gemini → Qwen → Codex) are detailed
 │   ├── IMPL-001.3-validation.json     # Code validation gate
 │   ├── IMPL-001.5-review.json         # Test quality gate
 │   ├── IMPL-002.json                  # Test execution & fix cycle
-│   └── IMPL-fix-{N}.json             # Generated fix tasks (Phase 2 fix loop)
+│   └── IMPL-fix-{N}.json             # Generated fix tasks (Phase 5 fix loop)
 ├── .process/
 │   ├── [test-]context-package.json    # Context and coverage analysis
 │   ├── TEST_ANALYSIS_RESULTS.md       # Test requirements (L0-L3)
@@ -274,17 +335,17 @@ Selection logic and CLI fallback chain (Gemini → Qwen → Codex) are detailed

 ## Error Handling

-### Phase 1 (Generation)
+### Phase 1-4 (Generation)

-| Step | Error Condition | Action |
-|------|----------------|--------|
-| Session create | Source session not found (session mode) | Return error with session ID |
-| Session create | No completed IMPL tasks (session mode) | Return error, source incomplete |
-| Context gather | Context gathering failed | Return error, check source artifacts |
-| Analysis | Gemini analysis failed | Return error, check context package |
-| Task gen | Task generation failed | Retry once, then return error |
+| Phase | Error Condition | Action |
+|-------|----------------|--------|
+| 1: Session Start | Source session not found (session mode) | Return error with session ID |
+| 1: Session Start | No completed IMPL tasks (session mode) | Return error, source incomplete |
+| 2: Context Gather | Context gathering failed | Return error, check source artifacts |
+| 3: Analysis | Gemini analysis failed | Return error, check context package |
+| 4: Task Gen | Task generation failed | Retry once, then return error |

-### Phase 2 (Execution)
+### Phase 5 (Execution)

 | Scenario | Action |
 |----------|--------|
@@ -295,7 +356,7 @@ Selection logic and CLI fallback chain (Gemini → Qwen → Codex) are detailed
 | Regression detected | Rollback last fix, switch to surgical strategy |
 | Stuck tests detected | Continue with alternative strategy, document |

-## Commit Strategy (Phase 2)
+## Commit Strategy (Phase 5)

 Automatic commits at key checkpoints:
 1. **After successful iteration** (pass rate increased): `test-cycle: iteration N - strategy (pass: old% → new%)`
@@ -315,16 +376,28 @@ After completion, ask user if they want to expand into issues (test/enhance/refa

 ## Coordinator Checklist

-### Phase 1 (test-fix-gen)
+### Phase 1 (session-start)
 - [ ] Detect input type (session ID / description / file path)
 - [ ] Initialize TaskCreate before any execution
- [ ] Read Phase 1 doc, execute all 5 internal steps
+- [ ] Read Phase 1 doc, execute Steps 1.0 + 1.1
 - [ ] Parse testSessionId from step output, store in memory
- [ ] Verify all Phase 1 outputs (4 task JSONs, IMPL_PLAN.md, TODO_LIST.md)
- [ ] Collapse Phase 1 tasks, auto-continue to Phase 2

-### Phase 2 (test-cycle-execute)
- [ ] Read Phase 2 doc
+### Phase 2 (test-context-gather)
+- [ ] Read Phase 2 doc, execute Step 1.2
+- [ ] Parse contextPath from step output, store in memory
+
+### Phase 3 (test-concept-enhanced)
+- [ ] Read Phase 3 doc, execute Step 1.3
+- [ ] Verify TEST_ANALYSIS_RESULTS.md created
+
+### Phase 4 (test-task-generate)
+- [ ] Read Phase 4 doc, execute Step 1.4
+- [ ] Verify all Phase 1-4 outputs (4 task JSONs, IMPL_PLAN.md, TODO_LIST.md)
+- [ ] Display Summary output (inline)
+- [ ] Collapse Phase 1-4 tasks, auto-continue to Phase 5
+
+### Phase 5 (test-cycle-execute)
+- [ ] Read Phase 5 doc
 - [ ] Load session, tasks, iteration state
 - [ ] Execute initial tasks sequentially
 - [ ] Calculate pass rate from test-results.json
@@ -340,14 +413,6 @@ After completion, ask user if they want to expand into issues (test/enhance/refa
 - `/workflow:plan` or `/workflow:execute` - Complete implementation (Session Mode source)
 - None for Prompt Mode

-**Called During Execution**:
- `/workflow:session:start` - Phase 1: Create test session
- `/workflow:tools:test-context-gather` - Phase 1 (Session Mode)
- `/workflow:tools:context-gather` - Phase 1 (Prompt Mode)
- `/workflow:tools:test-concept-enhanced` - Phase 1: Gemini analysis
- `/workflow:tools:test-task-generate` - Phase 1: Task generation
- `/workflow:session:complete` - Phase 2: Archive session
-
 **Follow-up Skills**:
 - `/workflow:status` - Review workflow state
 - `/workflow:review` - Post-implementation review