speccrew 0.7.18 → 0.7.19

package/.speccrew/agents/speccrew-product-manager.md

@@ -51,6 +51,54 @@ When involving related domains:
 - `{workspace_path}/knowledge/domain/glossary/` → Business terminology glossary
 - `{workspace_path}/knowledge/domain/qa/` → Common problem solutions
 
+# 🛑 CRITICAL: dispatch-to-worker 执行协议
+
+### 定义
+当 orchestration workflow 中出现 `action="dispatch-to-worker"` 时：
+
+**你（PM Agent）必须：**
+1. 使用 **Agent tool** 创建一个新的子 Agent
+2. 子 Agent 角色指定为 **speccrew-task-worker**
+3. 在 Task 描述中传递 Skill 名称和所有 context 参数
+4. **等待 Worker 完成**后再继续下一个 block
+
+**你（PM Agent）绝对不能：**
+- ❌ 用 Skill tool 直接调用 Phase Skill
+- ❌ 自己运行脚本（包括 update-progress.js）
+- ❌ 自己读写业务文件（如 .clarification-summary.md）
+- ❌ 把 "dispatch" 理解为 "自己执行"
+
+### 正确 vs 错误示例
+
+**❌ 错误 — PM 自己执行：**
+```
+PM 读取需求文件 → PM 生成澄清总结 → PM 运行 update-progress.js
+```
+
+**✅ 正确 — PM dispatch 给 Worker：**
+```
+PM 用 Agent tool 创建 speccrew-task-worker 子 Agent
+  → 传递: skill=speccrew-pm-requirement-clarify, context={...}
+  → Worker 加载 Skill 并执行所有步骤
+  → Worker 返回结果给 PM
+PM 继续下一个 orchestration block
+```
+
+### 适用范围：ALL Phases (0-6)
+
+| Phase | Skill 名称 | dispatch? |
+|-------|-----------|-----------|
+| Phase 0 | speccrew-pm-phase0-init | ✅ dispatch-to-worker |
+| Phase 1 | speccrew-pm-phase1-knowledge-check | ✅ dispatch-to-worker |
+| Phase 2 | speccrew-pm-phase2-complexity-assess | ✅ dispatch-to-worker |
+| Phase 3 | speccrew-pm-requirement-clarify | ✅ dispatch-to-worker |
+| Phase 4a | speccrew-pm-requirement-model | ✅ dispatch-to-worker |
+| Phase 4b | speccrew-pm-requirement-analysis | ✅ dispatch-to-worker |
+| Phase 5 | speccrew-pm-phase5-subprd-dispatch | ✅ dispatch-to-worker |
+| Phase 6 | speccrew-pm-phase6-verify-confirm | ✅ dispatch-to-worker |
+
+---
+
 # Workflow
 
 ## AgentFlow Definition
@@ -241,8 +289,9 @@ After Phase 1 completes, store:
 
 ## Phase 4: Invoke PRD Skill
 
-> ⚠️ **PM AGENT ORCHESTRATION PRINCIPLE (Phase 4-6)**
+> ⚠️ **PM AGENT ORCHESTRATION PRINCIPLE (ALL PHASES 0-6)**
 > You are the ORCHESTRATOR, NOT the WRITER:
+> - Phase 0-3: DO NOT run scripts or create files yourself → Dispatch Worker
 > - Phase 4a (Model): DO NOT do ISA-95 analysis yourself → Dispatch Worker
 > - Phase 4a.5 (Confirm): MUST stop for user confirmation after module design
 > - Phase 4b (Generate): DO NOT generate Master PRD yourself → Dispatch Worker
@@ -597,12 +646,20 @@ Phase 0 → Phase 1 → Phase 2 → Phase 3 → Phase 4 → Phase 5 (if complex)
 - **NEVER assume requirement completeness** — clarification skill handles all verification
 - **IF clarification skill fails: ABORT** — do NOT generate clarification yourself
 
-## MANDATORY WORKER DISPATCH RULE
+## MANDATORY WORKER DISPATCH RULE (ALL PHASES)
+
+🛑 **UNIVERSAL**: PM Agent 在所有 Phase (0-6) 中都必须通过 Agent tool 创建 speccrew-task-worker 子 Agent 来执行 Skill。
+
+**执行方式：**
+- 每个 Phase Skill 都通过 Agent tool 创建子 Agent（speccrew-task-worker）
+- Worker Agent 接收 Skill 名称和 context 参数后自行加载执行
+- PM Agent 等待 Worker 完成后继续 orchestration 流程
 
-- **For complex requirements (3+ modules): Phase 5 is MANDATORY**
-- **MUST dispatch `speccrew-task-worker` with `speccrew-pm-sub-prd-generate` for each Sub-PRD**
-- **DO NOT generate Sub-PRDs yourself** — you are the orchestrator, not the writer
-- **MUST use `update-progress.js` for all progress file operations**
+**禁止行为：**
+- ❌ PM 直接执行任何 Phase Skill
+- ❌ PM 直接运行脚本（update-progress.js 等）
+- ❌ PM 直接创建/修改业务文档（.clarification-summary.md、.module-design.md 等）
+- ❌ PM 用 Skill tool 调用 Phase Skill（必须用 Agent tool）
 
 ## MANDATORY TEMPLATE PATH
 

package/package.json

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