speccrew 0.7.54 → 0.7.56

package/.speccrew/agents/speccrew-system-designer.md

@@ -31,8 +31,8 @@ Phase 2: Resource Verification
 Phase 3: Framework Evaluation (HARD STOP)
   └── Dispatch speccrew-sd-framework-evaluate skill → User confirms
         ↓
-Phase 4: Generate DESIGN-OVERVIEW.md
-  └── Create L1 overview with Feature×Platform matrix → Validate completeness
+Phase 4: Generate DESIGN-OVERVIEW.md (WORKER-DISPATCH)
+  └── Dispatch speccrew-sd-design-overview-generate skill → Wait for worker → Validate output
         ↓
 Phase 5: Dispatch Per-Platform Skills
   ├── Single Feature + Single Platform → Direct skill invocation
@@ -57,7 +57,6 @@ This agent is an **orchestrator/dispatcher**. For system design execution (Phase
 ### Agent-Allowed Deliverables
 
 This agent MAY directly create/modify ONLY the following files:
-- ✅ `DESIGN-OVERVIEW.md`
 - ✅ `DISPATCH-PROGRESS.json` (via update-progress.js script only)
 - ✅ `.checkpoints.json` (via update-progress.js script only)
 - ✅ Progress summary messages to user
@@ -65,6 +64,9 @@ This agent MAY directly create/modify ONLY the following files:
 > Note: `framework-evaluation.md` is generated **ONLY** by the `speccrew-sd-framework-evaluate` skill.
 > The Agent MUST NOT create or modify this file manually.
 
+> Note: `DESIGN-OVERVIEW.md` is generated **ONLY** by the `speccrew-sd-design-overview-generate` skill dispatched to a worker agent.
+> The Agent MUST NOT create or modify this file manually.
+
 ### FORBIDDEN Actions (When Features ≥ 2 OR Platforms ≥ 2)
 
 1. ❌ DO NOT invoke `speccrew-sd-backend` skill directly
@@ -124,7 +126,7 @@ This agent MUST execute tasks continuously without unnecessary interruptions.
 | Phase 2 | KNOWLEDGE-FIRST | MUST load ALL techs knowledge before Phase 3. DO NOT assume technology stack |
 | Phase 3 | WORKER-DISPATCH | Framework evaluation MUST be dispatched to speccrew-task-worker via **Agent tool**. Agent MUST NOT invoke speccrew-sd-framework-evaluate via Skill tool. |
 | Phase 3 | HARD STOP | User must confirm framework decisions before proceeding to Phase 4 |
-| Phase 4 | AGENT-OWNED | DESIGN-OVERVIEW.md generation is Agent responsibility (not skill-dispatched) |
+| Phase 4 | WORKER-DISPATCH | DESIGN-OVERVIEW.md generation MUST be dispatched to speccrew-task-worker via **Agent tool**. Agent MUST NOT generate this file inline. |
 | Phase 5 | SKILL-ONLY | Platform design workers MUST use platform-specific design skills. Agent MUST NOT write design documents itself |
 | Phase 6 | HARD STOP | User must confirm all designs before finalizing |
 | ALL | ABORT ON FAILURE | If any skill invocation fails → STOP and report. Do NOT generate content manually as fallback |
@@ -529,6 +531,19 @@ Proceed to Phase 4? (Confirm/Cancel)
 
 ## Phase 4: Generate DESIGN-OVERVIEW.md (L1)
 
+> 🛑 **CRITICAL: Phase 4 dispatch-to-worker Protocol**
+>
+> When executing Phase 4 (Design Overview Generation):
+> 1. Use **Agent tool** to create a new sub-Agent
+> 2. Specify sub-Agent role as **speccrew-task-worker**
+> 3. Pass `skill_path`: `${workspace_path}/.speccrew/skills/speccrew-sd-design-overview-generate/SKILL.md`
+> 4. Pass context parameters: workspace_path, iteration_path, feature_registry_path, techs_manifest_path, framework_evaluation_path, output_path
+> 5. **Wait for Worker completion** before proceeding to validation
+>
+> **FORBIDDEN**:
+> - ❌ DO NOT generate DESIGN-OVERVIEW.md yourself
+> - ❌ DO NOT use Skill tool to invoke speccrew-sd-design-overview-generate
+
 Create the top-level overview at:
 `{iterations_dir}/{current}/03.system-design/DESIGN-OVERVIEW.md`
 
@@ -1025,7 +1040,7 @@ Otherwise
 - Phase 2: MUST verify ALL techs knowledge files exist (manifest + platform-specific stacks) before Phase 3
 - Phase 3: MUST dispatch speccrew-sd-framework-evaluate via speccrew-task-worker (Agent tool) — DO NOT evaluate yourself and DO NOT invoke via Skill tool
 - Phase 3: User MUST confirm framework decisions (🛑 HARD STOP) before proceeding to Phase 4
-- Phase 4: MUST generate DESIGN-OVERVIEW.md with complete Feature×Platform index BEFORE dispatching platform workers
+- Phase 4: MUST dispatch speccrew-task-worker with speccrew-sd-design-overview-generate skill to generate DESIGN-OVERVIEW.md BEFORE dispatching platform workers
 - Phase 5: MUST use speccrew-task-worker to dispatch platform-specific design skills for parallel execution (never direct skill invocation for batch)
 - Phase 5: MUST use update-progress.js script for ALL progress tracking (DISPATCH-PROGRESS.json, .checkpoints.json, WORKFLOW-PROGRESS.json)
 - Phase 6: MUST collect ALL worker results and present joint summary before requesting user confirmation (🛑 HARD STOP)
@@ -1040,7 +1055,7 @@ Otherwise
 - DO NOT skip framework evaluation checkpoint — user confirmation is mandatory
 - DO NOT assume technology stack without verifying techs knowledge exists
 - DO NOT generate designs for platforms not in techs-manifest
-- DO NOT generate per-platform or per-feature design documents yourself (INDEX.md, {feature-id}-{feature-name}-design.md, etc.) — always dispatch platform design skills via workers. DESIGN-OVERVIEW.md is the ONLY system design document this Agent generates directly
+- DO NOT generate DESIGN-OVERVIEW.md yourself — dispatch speccrew-task-worker with speccrew-sd-design-overview-generate skill. Agent does NOT directly generate ANY system design documents.
 - DO NOT invoke platform design skills directly when 2+ features or 2+ platforms exist — use speccrew-task-worker
 - DO NOT create or manually edit DISPATCH-PROGRESS.json, .checkpoints.json, or WORKFLOW-PROGRESS.json — use update-progress.js script only
 - DO NOT update WORKFLOW-PROGRESS.json status to "confirmed" before joint user confirmation in Phase 6

package/.speccrew/skills/speccrew-sd-design-overview-generate/SKILL.md

@@ -0,0 +1,240 @@
+---
+name: speccrew-sd-design-overview-generate
+version: 1.0.0
+description: Design Overview Generation Skill for System Designer. Reads Feature Registry, techs-manifest platforms, and framework evaluation results to generate a comprehensive DESIGN-OVERVIEW.md with Feature×Platform matrix index. Invoked by System Designer Agent during Phase 4 via worker dispatch.
+tools: Read, Write, Glob, Grep
+---
+
+# Trigger Scenarios
+
+- System Designer Agent dispatches this skill during Phase 4 to generate DESIGN-OVERVIEW.md
+- User requests a design overview document for the current iteration
+- Need to establish a Feature×Platform matrix index before per-platform system design begins
+
+## AgentFlow Definition
+
+<!-- @agentflow: workflow.agentflow.xml -->
+
+> **REQUIRED**: Before executing this workflow, read the XML workflow specification: `speccrew-workspace/docs/rules/agentflow-spec.md`
+
+## Workflow
+
+## Absolute Constraints
+
+> **These rules apply to ALL steps. Violation = task failure.**
+
+1. **READ-ONLY on Feature Spec and API Contract** — NEVER modify Feature Spec or API Contract documents. Only read for reference.
+2. **READ-ONLY on techs-manifest.json** — NEVER modify the techs manifest. Only read for platform information.
+3. **READ-ONLY on framework-evaluation.md** — NEVER modify the framework evaluation report. Only read for technology decisions.
+4. **Single Output Only** — Only create DESIGN-OVERVIEW.md at the specified output_path. No other files.
+5. **Direct-to-File Output** — Write all content directly to DESIGN-OVERVIEW.md. DO NOT display document content in conversation.
+
+## Step 1: Read Inputs
+
+**Input Parameters** (from agent context):
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `workspace_path` | string | Yes | speccrew-workspace root directory path |
+| `iteration_path` | string | Yes | Current iteration directory path |
+| `feature_registry_path` | string | Yes | Path to .prd-feature-list.json |
+| `techs_manifest_path` | string | Yes | Path to techs-manifest.json |
+| `framework_evaluation_path` | string | Yes | Path to framework-evaluation.md |
+| `output_path` | string | No | Output file path (default: iteration_path/03.system-design/DESIGN-OVERVIEW.md) |
+
+Read in order:
+
+1. **Read .prd-feature-list.json** — Extract features array:
+   - `feature_id` (e.g., F-CRM-01) or `module_name` for legacy format
+   - `feature_name` or `module_name`
+   - `feature_spec` path
+   - `api_contract` path
+   - `module`
+   - `type`
+
+2. **Read techs-manifest.json** — Extract platforms array:
+   - `platform_id` (e.g., web-react, backend-nodejs)
+   - `friendly_name`
+   - `tech_stack`
+
+3. **Read framework-evaluation.md** — Extract Technology Decisions:
+   - Framework evaluation results
+   - New dependencies introduced (if any)
+   - Version constraints
+
+## Step 2: Build Feature×Platform Matrix
+
+For each feature × platform combination, generate one matrix row:
+
+| Field | Source |
+|-------|--------|
+| `feature_id` | feature.feature_id (or "-" for legacy format) |
+| `feature_name` | feature.feature_name (or feature.module_name for legacy) |
+| `platform` | platform.friendly_name |
+| `platform_id` | platform.platform_id |
+| `skill` | Map platform_id prefix → speccrew-sd-{type} (see below) |
+| `design_directory` | {platform_id}/{feature_id}-{feature_name}-design.md (new) or {platform_id}/{module}-design.md (legacy) |
+| `status` | Always "pending" |
+
+### Platform ID Prefix → Skill Mapping
+
+| Platform ID Prefix | Target Skill |
+|-------------------|--------------|
+| web-* | speccrew-sd-frontend |
+| backend-* | speccrew-sd-backend |
+| mobile-* | speccrew-sd-mobile |
+| desktop-* | speccrew-sd-desktop |
+
+### Legacy Format Compatibility
+
+If a feature does NOT have a Feature ID (no "F-" prefix):
+- Feature ID column displays `-`
+- Use `module_name` as Feature Name
+- Design Directory uses `{platform_id}/{module_name}-design.md` (legacy format)
+
+## Step 3: Generate DESIGN-OVERVIEW.md
+
+Write the design overview document to `output_path`.
+
+### Document Structure
+
+```markdown
+# System Design Overview - {Iteration Name}
+
+## 1. Design Scope
+
+- **Iteration**: {iteration_identifier}
+- **Platforms**: {platform_list}
+- **Features**: {count} features discovered
+
+### 1.1 Feature List
+
+| Feature ID | Feature Name | Feature Spec | API Contract |
+|------------|--------------|--------------|--------------|
+| (from feature registry, one row per feature) |
+
+> **Legacy Format Compatibility**: If file uses legacy format (no Feature ID), Feature ID column shows `-`, using module name as Feature Name
+
+## 2. Technology Decisions
+
+(from framework-evaluation.md - Phase 3 results)
+
+- Framework evaluation results
+- New dependencies introduced (if any)
+- Version constraints
+
+## 3. Platform Design Index
+
+| Feature ID | Feature Name | Platform | Platform ID | Skill | Design Directory | Status |
+|------------|--------------|----------|-------------|-------|------------------|--------|
+| (Feature × Platform matrix from Step 2) |
+
+> **Notes**:
+> - New Format: Design Directory contains `{feature-id}-{feature-name}` (e.g., `F-CRM-01-customer-list-design.md`)
+> - Legacy Format: Design Directory uses `{module}-design.md`
+
+## 4. Feature Summary (Optional - when Feature count > 5)
+
+### 4.1 Feature by Module
+
+| Module | Feature Count | Feature IDs |
+|--------|---------------|-------------|
+| (group features by module) |
+
+### 4.2 Feature Type Distribution
+
+| Type | Count | Features |
+|------|-------|----------|
+| (group features by type) |
+
+## 5. Cross-Platform Concerns
+
+- Shared data structures
+- Cross-platform API contracts
+- Authentication/authorization strategy
+- Error handling conventions
+
+## 6. Design Constraints
+
+- API Contract is READ-ONLY — do not modify
+- All pseudo-code must use actual framework syntax from techs knowledge
+- Each module design document maps 1:1 to a Feature Spec function
+```
+
+## Step 4: Validate Output
+
+After writing DESIGN-OVERVIEW.md, verify:
+
+- [ ] File exists at output_path
+- [ ] Contains "## 1. Design Scope" section
+- [ ] Contains "## 2. Technology Decisions" section
+- [ ] Contains "## 3. Platform Design Index" table
+- [ ] Platform Design Index covers all Feature × Platform combinations
+- [ ] Feature count matches feature registry
+- [ ] Platform count matches techs-manifest
+- [ ] All index entries have status "pending"
+
+## Step 5: Output Task Completion Report
+
+After validation, output:
+
+```
+--- TASK COMPLETION REPORT ---
+Task: Design Overview Generation
+Status: SUCCESS
+Output: {output_path}
+Features: {feature_count}
+Platforms: {platform_count}
+Matrix Entries: {feature_count × platform_count}
+--- END REPORT ---
+```
+
+If any step fails:
+
+```
+--- TASK COMPLETION REPORT ---
+Task: Design Overview Generation
+Status: FAILED
+Error: {specific error description}
+Failed At: Step {N}
+--- END REPORT ---
+```
+
+## OUTPUT EFFICIENCY RULES
+
+When executing this skill:
+
+1. **Direct-to-File Output**: All design overview content MUST be written directly to DESIGN-OVERVIEW.md
+2. **Minimal Conversation Output**: Only output:
+   - Block execution announcements (1 line each): `[Block XX] Building matrix...`
+   - Error messages requiring attention
+   - Task Completion Report (final summary)
+3. **FORBIDDEN in conversation**:
+   - Full document sections or drafts
+   - Feature × Platform matrix tables
+   - Feature list tables
+   - Technology decision excerpts longer than 2 lines
+4. **Rationale**: Workers run in batch mode. Displaying design content in conversation wastes context window and provides no value since content goes to file anyway.
+
+# Key Rules
+
+| Rule | Description |
+|------|-------------|
+| **FORBIDDEN: Input Modification** | Do NOT modify feature specs, API contracts, techs-manifest, or framework-evaluation |
+| **FORBIDDEN: Extra Files** | Do NOT create any files other than DESIGN-OVERVIEW.md |
+| **FORBIDDEN: Conversation Output** | Do NOT display DESIGN-OVERVIEW content in conversation — write directly to file |
+| **MANDATORY: Complete Matrix** | Platform Design Index MUST cover ALL Feature × Platform combinations |
+| **MANDATORY: Pending Status** | ALL Platform Design Index entries MUST have status "pending" |
+
+# Checklist
+
+- [ ] .prd-feature-list.json read and features array extracted
+- [ ] techs-manifest.json read and platforms array extracted
+- [ ] framework-evaluation.md read and technology decisions extracted
+- [ ] Feature format detected (new or legacy)
+- [ ] Feature × Platform matrix built with all combinations
+- [ ] Platform ID prefix correctly mapped to target skills
+- [ ] DESIGN-OVERVIEW.md generated with all required sections
+- [ ] Feature Summary section included only when feature count > 5
+- [ ] Output validated against checklist
+- [ ] Task Completion Report output

package/.speccrew/skills/speccrew-sd-design-overview-generate/workflow.agentflow.xml

@@ -0,0 +1,161 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<workflow id="sd-design-overview-generate-main" status="pending" version="1.0.0" desc="Design Overview Generation workflow">
+
+  <!-- ============================================================
+       Input Parameters Definition
+       ============================================================ -->
+  <block type="input" id="I1" desc="Workflow input parameters">
+    <field name="workspace_path" required="true" type="string" desc="speccrew-workspace root directory path"/>
+    <field name="iteration_path" required="true" type="string" desc="Current iteration directory path"/>
+    <field name="feature_registry_path" required="true" type="string" desc="Path to .prd-feature-list.json"/>
+    <field name="techs_manifest_path" required="true" type="string" desc="Path to techs-manifest.json"/>
+    <field name="framework_evaluation_path" required="true" type="string" desc="Path to framework-evaluation.md"/>
+    <field name="output_path" required="false" type="string" desc="Output file path (default: iteration_path/03.system-design/DESIGN-OVERVIEW.md)"/>
+  </block>
+
+  <!-- ============================================================
+       Global Rules
+       ============================================================ -->
+  <block type="rule" id="R1" level="forbidden" desc="Input File Protection">
+    <field name="text">DO NOT modify any input files (feature specs, API contracts, techs-manifest.json, framework-evaluation.md)</field>
+  </block>
+
+  <block type="rule" id="R2" level="forbidden" desc="Single Output Only">
+    <field name="text">DO NOT create any files other than DESIGN-OVERVIEW.md at the specified output_path</field>
+  </block>
+
+  <block type="rule" id="R3" level="mandatory" desc="Direct-to-File Output">
+    <field name="text">Write all design content directly to DESIGN-OVERVIEW.md. DO NOT display document content in conversation.</field>
+  </block>
+
+  <block type="rule" id="R4" level="mandatory" desc="Complete Matrix Coverage">
+    <field name="text">Platform Design Index MUST cover ALL Feature × Platform combinations. No feature or platform may be omitted.</field>
+  </block>
+
+  <!-- ============================================================
+       Main Processing Sequence
+       ============================================================ -->
+  <sequence id="S1" name="Design Overview Generation" status="pending" desc="Generate DESIGN-OVERVIEW.md with Feature×Platform matrix">
+
+    <!-- Step 1: Read Feature Registry -->
+    <block type="task" id="B1" action="read-file" status="pending" desc="Read Feature Registry (.prd-feature-list.json)">
+      <field name="path" value="${feature_registry_path}"/>
+      <field name="output" var="feature_registry"/>
+    </block>
+
+    <!-- Step 2: Read Techs Manifest -->
+    <block type="task" id="B2" action="read-file" status="pending" desc="Read Techs Manifest (techs-manifest.json)">
+      <field name="path" value="${techs_manifest_path}"/>
+      <field name="output" var="techs_manifest"/>
+    </block>
+
+    <!-- Step 3: Read Framework Evaluation -->
+    <block type="task" id="B3" action="read-file" status="pending" desc="Read Framework Evaluation Report">
+      <field name="path" value="${framework_evaluation_path}"/>
+      <field name="output" var="framework_evaluation"/>
+    </block>
+
+    <!-- Step 4: Determine Feature Format -->
+    <block type="gateway" id="G1" mode="exclusive" desc="Check Feature ID format">
+      <branch test="${feature_registry.features[0].feature_id} exists and starts with 'F-'" name="New Format">
+        <block type="event" id="E1" action="log" level="info" desc="New format detected">
+          <field name="message">Feature registry uses new format with F- prefixed Feature IDs</field>
+        </block>
+        <field name="format" var="feature_format" value="new"/>
+      </branch>
+      <branch default="true" name="Legacy Format">
+        <block type="event" id="E2" action="log" level="info" desc="Legacy format detected">
+          <field name="message">Feature registry uses legacy format (no Feature IDs)</field>
+        </block>
+        <field name="format" var="feature_format" value="legacy"/>
+      </branch>
+    </block>
+
+    <!-- Step 5: Build Feature × Platform Matrix -->
+    <block type="task" id="B4" action="compute" status="pending" desc="Build Feature×Platform matrix index">
+      <field name="input" value="${feature_registry.features}">${techs_manifest.platforms}</field>
+      <field name="logic">
+        For each feature in feature_registry.features:
+          For each platform in techs_manifest.platforms:
+            - feature_id: feature.feature_id (or "-" for legacy)
+            - feature_name: feature.feature_name (or feature.module_name for legacy)
+            - platform: platform.friendly_name
+            - platform_id: platform.platform_id
+            - skill: map platform_id prefix → speccrew-sd-{type}
+              (web-* → frontend, backend-* → backend, mobile-* → mobile, desktop-* → desktop)
+            - design_directory: {platform_id}/{feature_id}-{feature_name}-design.md (new)
+              or {platform_id}/{module_name}-design.md (legacy)
+            - status: "pending"
+      </field>
+      <field name="output" var="platform_design_index"/>
+    </block>
+
+    <!-- Step 6: Check if Feature Summary needed -->
+    <block type="gateway" id="G2" mode="exclusive" desc="Feature count check for optional summary">
+      <branch test="${feature_registry.features.length} > 5" name="Large Feature Set">
+        <block type="event" id="E3" action="log" level="info" desc="Large feature set">
+          <field name="message">Feature count > 5, including Feature Summary section</field>
+        </block>
+        <field name="include_summary" var="include_feature_summary" value="true"/>
+      </branch>
+      <branch default="true" name="Small Feature Set">
+        <block type="event" id="E4" action="log" level="info" desc="Small feature set">
+          <field name="message">Feature count <= 5, skipping Feature Summary section</field>
+        </block>
+        <field name="include_summary" var="include_feature_summary" value="false"/>
+      </branch>
+    </block>
+
+    <!-- Step 7: Generate DESIGN-OVERVIEW.md -->
+    <block type="task" id="B5" action="write-file" status="pending" desc="Generate DESIGN-OVERVIEW.md with all sections">
+      <field name="path">${output_path}</field>
+      <field name="encoding">utf8</field>
+      <field name="content">
+        Section 1: Design Scope (iteration, platforms, features count, Feature List table)
+        Section 2: Technology Decisions (from framework_evaluation)
+        Section 3: Platform Design Index (from platform_design_index matrix)
+        Section 4: Feature Summary (ONLY if include_feature_summary == true)
+          - 4.1 Feature by Module
+          - 4.2 Feature Type Distribution
+        Section 5: Cross-Platform Concerns
+        Section 6: Design Constraints
+      </field>
+    </block>
+
+    <!-- Step 8: Validate Output -->
+    <block type="checkpoint" id="CP1" name="design_overview_validation" desc="Validate DESIGN-OVERVIEW.md completeness">
+      <field name="conditions">
+        file_exists: ${output_path} exists,
+        has_design_scope: contains "## 1. Design Scope",
+        has_tech_decisions: contains "## 2. Technology Decisions",
+        has_platform_index: contains "## 3. Platform Design Index",
+        matrix_complete: index row count == feature_count × platform_count,
+        all_pending: all status entries are "pending"
+      </field>
+    </block>
+
+    <!-- Step 9: Output Task Completion Report -->
+    <block type="event" id="E5" action="log" level="info" desc="Output completion report">
+      <field name="message">--- TASK COMPLETION REPORT ---
+Task: Design Overview Generation
+Status: SUCCESS
+Output: ${output_path}
+Features: ${feature_registry.features.length}
+Platforms: ${techs_manifest.platforms.length}
+Matrix Entries: ${feature_registry.features.length * techs_manifest.platforms.length}
+--- END REPORT ---</field>
+    </block>
+
+  </sequence>
+
+  <!-- ============================================================
+       Output Results
+       ============================================================ -->
+  <block type="output" id="O1" desc="Workflow output results">
+    <field name="design_overview_path" value="${output_path}" type="string" desc="Path to generated DESIGN-OVERVIEW.md"/>
+    <field name="feature_count" from="${feature_registry.features.length}" type="number" desc="Number of features in the matrix"/>
+    <field name="platform_count" from="${techs_manifest.platforms.length}" type="number" desc="Number of platforms in the matrix"/>
+    <field name="matrix_entries" from="${feature_registry.features.length * techs_manifest.platforms.length}" type="number" desc="Total Feature×Platform combinations"/>
+  </block>
+
+</workflow>

package/.speccrew/skills/speccrew-system-designer-orchestration/SKILL.md

@@ -35,7 +35,7 @@ System Designer 的核心编排技能，负责：
 2. **Preparation** - 加载 Feature Registry，验证文件存在性
 3. **Resource Verification** - 验证技术知识库可用性
 4. **Framework Evaluation** - 派发单个 worker agent 执行框架评估技能，等待 worker 完成并验证 framework-evaluation.md 生成后进入下一阶段（HARD STOP 等待用户确认）
-5. **Design Overview** - 生成 DESIGN-OVERVIEW.md
+5. **Design Overview** - 派发 worker agent 执行 speccrew-sd-design-overview-generate 技能生成 DESIGN-OVERVIEW.md，等待 worker 完成并验证输出
 6. **Platform Dispatch** - 分发各平台设计任务给 Worker
 7. **Joint Confirmation** - 联合确认所有设计文档
 
@@ -105,6 +105,18 @@ This skill MUST execute tasks continuously without unnecessary interruptions.
 
 **CRITICAL**: The `Agent tool` creates a NEW agent session — this is completely different from the `Skill tool` which executes inline.
 
+### Phase 4 Execution Method — Worker Agent Dispatch
+
+**HOW TO DISPATCH**: When executing Phase 4 block P4-B1 (action="dispatch-to-worker"):
+1. Use the **Agent tool** to create a new `speccrew-task-worker` agent
+2. Pass `skill_path` to the worker: `${workspace_path}/.speccrew/skills/speccrew-sd-design-overview-generate/SKILL.md`
+3. Pass context parameters: workspace_path, iteration_path, feature_registry_path (.prd-feature-list.json path), techs_manifest_path (techs-manifest.json path), framework_evaluation_path (framework-evaluation.md path), output_path
+4. **Wait** for the worker agent to complete and return results
+5. After worker completes, verify DESIGN-OVERVIEW.md exists at output_path
+6. Then proceed to Phase 4 checkpoint validation (P4-CP1)
+
+**CRITICAL**: The `Agent tool` creates a NEW agent session — this is completely different from the `Skill tool` which executes inline.
+
 ### HARD STOP Checkpoints
 
 This workflow has **mandatory HARD STOP** checkpoints at:
@@ -130,3 +142,5 @@ DO NOT proceed past these checkpoints without explicit user confirmation.
 - **DO NOT create scripts for batch analysis** — Workers handle this via their own skill
 - **DO NOT fallback to inline execution if worker fails** — ABORT instead
 - **DO NOT skip reading workflow.agentflow.xml** — XML is the execution authority
+- **DO NOT generate DESIGN-OVERVIEW.md yourself** — Dispatch speccrew-task-worker with speccrew-sd-design-overview-generate skill
+- **DO NOT use Skill tool for Phase 4 design overview generation** — Skill tool executes inline, Agent tool creates a worker

package/.speccrew/skills/speccrew-system-designer-orchestration/workflow.agentflow.xml

@@ -245,25 +245,43 @@
     </block>
   </sequence>
 
-  <!-- ========== Phase 4: Generate DESIGN-OVERVIEW.md ========== -->
-  <sequence name="Phase 4: Generate DESIGN-OVERVIEW.md">
-    <block type="rule" id="P4-R1" level="mandatory" desc="Agent-Owned Rule">
-      <field name="text">DESIGN-OVERVIEW.md generation is Agent responsibility (not skill-dispatched)</field>
+  <!-- ========== Phase 4: Generate DESIGN-OVERVIEW.md (WORKER-DISPATCH) ========== -->
+  <sequence name="Phase 4: Generate DESIGN-OVERVIEW.md (WORKER-DISPATCH)">
+    <block type="rule" id="P4-R0" level="forbidden" desc="Phase 4 Worker Dispatch Enforcement">
+      <field name="text">FORBIDDEN: Do NOT inline-generate DESIGN-OVERVIEW.md yourself</field>
+      <field name="text">MANDATORY: DESIGN-OVERVIEW.md generation MUST be delegated to worker agent via block P4-B1</field>
+      <field name="text">TOOL MAPPING: action="dispatch-to-worker" → Use Agent tool (NOT Skill tool) to create speccrew-task-worker agent</field>
+      <field name="text">If worker dispatch fails, ABORT — do NOT fallback to inline generation</field>
     </block>
 
-    <block type="task" id="P4-B1" action="write-file" status="pending"
-           desc="Generate DESIGN-OVERVIEW.md">
-      <field name="path">${iterations_dir}/${current_iteration}/03.system-design/DESIGN-OVERVIEW.md</field>
-      <field name="template">design-overview-template</field>
-      <field name="data">
-        iteration: ${current_iteration},
-        platforms: ${techs_manifest.platforms},
-        features: ${feature_registry.features},
-        framework_decisions: ${framework_result.decisions}
+    <block type="task" id="P4-B1" action="dispatch-to-worker" status="pending"
+           desc="Dispatch single worker agent for design overview generation. Use Agent tool, NOT Skill tool.">
+      <field name="agent">speccrew-task-worker</field>
+      <field name="skill">speccrew-sd-design-overview-generate</field>
+      <field name="skill_path">${workspace_path}/.speccrew/skills/speccrew-sd-design-overview-generate/SKILL.md</field>
+      <field name="context">
+        workspace_path: ${workspace_path},
+        iteration_path: ${iterations_dir}/${current_iteration},
+        feature_registry_path: ${iterations_dir}/${current_iteration}/01.product-requirement/.prd-feature-list.json,
+        techs_manifest_path: ${workspace_path}/knowledges/techs/techs-manifest.json,
+        framework_evaluation_path: ${iterations_dir}/${current_iteration}/03.system-design/framework-evaluation.md,
+        output_path: ${iterations_dir}/${current_iteration}/03.system-design/DESIGN-OVERVIEW.md
       </field>
+      <field name="note">Worker receives ALL context above and generates DESIGN-OVERVIEW.md. Orchestrator MUST NOT read feature files or generate this document itself.</field>
+    </block>
+
+    <block type="gateway" id="P4-GW1" mode="wait" desc="Wait for design overview worker to complete">
+      <field name="wait_for">P4-B1</field>
+      <field name="timeout">300</field>
+    </block>
+
+    <block type="task" id="P4-B2" action="read-file" status="pending"
+           desc="Verify DESIGN-OVERVIEW.md was generated by worker">
+      <field name="path">${iterations_dir}/${current_iteration}/03.system-design/DESIGN-OVERVIEW.md</field>
+      <field name="output" var="design_overview_content"/>
     </block>
 
-    <!-- Step 4.1: Validation -->
+    <!-- Validation Checkpoint -->
     <block type="checkpoint" id="P4-CP1" name="design_overview" desc="DESIGN-OVERVIEW validation">
       <field name="conditions">file_exists, has_design_scope_section, has_tech_decisions_section, has_platform_design_index, index_covers_all_feature_platform_combinations</field>
     </block>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "speccrew",
-  "version": "0.7.54",
+  "version": "0.7.56",
   "description": "Spec-Driven Development toolkit for AI-powered IDEs",
   "author": "charlesmu99",
   "repository": {