speccrew 0.7.3 → 0.7.5

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

@@ -145,6 +145,12 @@ This agent MUST execute tasks continuously without unnecessary interruptions.
 
 # Workflow
 
+## AgentFlow Definition
+
+<!-- @skill: speccrew-feature-designer-orchestration -->
+
+---
+
 ## Phase 0: Workflow Progress Management
 
 > **Path Variables** (provided by caller as absolute paths):

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

@@ -184,6 +184,12 @@ If WORKFLOW-PROGRESS.json does not exist (legacy iterations or new workspace):
 
 # Workflow
 
+## AgentFlow Definition
+
+<!-- @skill: speccrew-product-manager-orchestration -->
+
+---
+
 ## Phase 0.5: IDE Detection
 
 Detect current IDE environment and determine skill loading strategy:

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

@@ -614,3 +614,9 @@ You can proceed with System Test Agent (speccrew-test-manager).
 - Proceed to next skill if current skill fails
 - Proceed to testing phase without user confirmation
 - Hardcode any commands — always read from techs knowledge
+
+---
+
+## AgentFlow Definition
+
+<!-- @skill: speccrew-system-deployer-orchestration -->

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

@@ -1022,3 +1022,9 @@ After user confirms:
 - DO NOT proceed to the next batch or Phase 6 if any Phase 5 batch worker failure rate > 50% — follow the Batch Failure recovery flow in Phase 5.6
 - DO NOT skip backward compatibility checks for old format Feature Specs
 - DO NOT automatically transition to or invoke the next stage agent — user starts next stage in a new conversation
+
+---
+
+## AgentFlow Definition
+
+<!-- @skill: speccrew-system-designer-orchestration -->

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

@@ -1112,3 +1112,9 @@ Delivery Report: {path}/delivery-report.md
 - Ignore cross-platform integration issues
 - Proceed to test phase with unresolved blockers
 - Write application code directly (System Developer is a **pure orchestrator** — it reads design documents, creates task lists, dispatches workers, tracks progress, and coordinates reviews. It NEVER writes application code directly.)
+
+---
+
+## AgentFlow Definition
+
+<!-- @skill: speccrew-system-developer-orchestration -->

package/.speccrew/agents/speccrew-task-worker.md

@@ -208,3 +208,8 @@ When the task fails or is blocked, output:
 - **DO NOT** use Bash/terminal tools to create .py, .bat, .sh, .ps1, or any executable files
 - If the assigned Skill file does not exist or task execution fails, STOP immediately and report the exact error — do not improvise alternative solutions
 
+---
+
+## AgentFlow Definition
+
+<!-- @skill: speccrew-task-worker-execution -->

package/.speccrew/agents/speccrew-team-leader.md

@@ -50,6 +50,12 @@ You understand the complete AI engineering closed loop: **speccrew-pm → speccr
 
 # Skill Inventory
 
+## Routing
+
+| Skill | Trigger Scenario | Function |
+|-------|------------------|----------|
+| `speccrew-team-leader-routing` | All user inputs | Intent recognition and routing to corresponding Skill/Agent |
+
 ## Infrastructure (Project-level)
 
 | Skill | Trigger Scenario | Function |
@@ -89,7 +95,7 @@ You understand the complete AI engineering closed loop: **speccrew-pm → speccr
 
 ## AgentFlow Definition
 
-<!-- @agentflow: workflow.agentflow.xml -->
+<!-- @skill: speccrew-team-leader-routing -->
 
 ---
 

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

@@ -917,3 +917,9 @@ node {update_progress_script} update-workflow --file {workspace_path}/WORKFLOW-P
 - Assume business rules; unclear requirements must be traced to Feature Spec or PRD
 - Modify development phase source code
 - Proceed to delivery phase with unresolved critical or high-severity bugs
+
+---
+
+## AgentFlow Definition
+
+<!-- @skill: speccrew-test-manager-orchestration -->

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

@@ -0,0 +1,117 @@
+---
+name: speccrew-feature-designer-orchestration
+version: 1.0.0
+description: Feature Designer 的核心编排技能，负责加载功能清单、协调功能分析、功能规格设计与 API 契约生成。处理单个功能（直接调用）和多个功能（Worker 分发）两种工作流路径。
+tools: Read, Write, Glob, Grep, Bash, Agent
+---
+
+> **⚠️ MANDATORY EXECUTION PROTOCOL — READ BEFORE EXECUTING ANY BLOCK**
+>
+> **Step 1**: Load XML workflow specification: `speccrew-workspace/docs/rules/agentflow-spec.md` — this defines all block types and action-to-tool mappings
+>
+> **Step 2**: Execute this SKILL.md's XML workflow **block by block in document order**. For EVERY block, you MUST follow this 3-step cycle:
+>
+> ```
+> 📋 Block [ID] (action=[action]) — [desc]
+> 🔧 Tool: [which IDE tool to call]
+> ✅ Result: [output or status]
+> ```
+>
+> Action-to-tool mapping:
+> - `action="run-skill"` → Invoke via **Skill tool** (pass the `<field name="skill">` value EXACTLY)
+> - `action="run-script"` → Execute via **Terminal tool** (pass the `<field name="command">` value EXACTLY)
+> - `action="dispatch-to-worker"` → Create **Task** via **Task tool** for `speccrew-task-worker`
+> - `action="read-file"` → Read via **Read tool**
+> - `action="log"` → Output message directly
+> - `action="confirm"` → Present to user and wait for response
+>
+> **Step 3**: Execute ALL blocks sequentially without pausing (only stop at explicit `<event action="confirm">` blocks)
+
+# Feature Designer Orchestration
+
+Feature Designer 的核心编排技能，负责：
+
+1. **Stage Gate Verification** - 验证 PRD 阶段已完成确认
+2. **Feature List Loading** - 从 .prd-feature-list.json 加载功能清单
+3. **Feature Analysis Orchestration** - 协调功能分析（单个直接调用，多个分发 Worker）
+4. **Feature Design Orchestration** - 协调功能规格设计
+5. **API Contract Generation** - 生成 API 契约文档
+6. **Joint Confirmation** - 汇总确认所有设计产出
+
+## Invocation Method
+
+**CRITICAL**: This skill is loaded directly by Feature Designer Agent — do NOT invoke via Worker Agent.
+
+```xml
+<block type="task" action="run-skill" desc="Feature Designer orchestration workflow">
+  <field name="skill">speccrew-feature-designer-orchestration</field>
+</block>
+```
+
+## Input Parameters
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `prd_path` | string | Yes | PRD 文档目录路径 |
+| `iteration_path` | string | Yes | 当前迭代目录路径 |
+| `workspace_root` | string | Yes | speccrew-workspace 根目录路径 |
+| `frontend_platforms` | array | No | 前端平台列表（从 techs-manifest 读取） |
+
+## Output
+
+- `status` - 执行状态 (success / partial / failed)
+- `feature_specs` - 生成的功能规格文件列表
+- `api_contracts` - 生成的 API 契约文件列表
+- `workflow_stage` - 当前工作流阶段状态
+- `next_agent` - 下一步建议的 Agent
+
+---
+
+## AgentFlow Definition
+
+<!-- @agentflow: workflow.agentflow.xml -->
+
+---
+
+## CONTINUOUS EXECUTION RULES
+
+This skill MUST execute tasks continuously without unnecessary interruptions.
+
+### FORBIDDEN Interruptions
+
+1. DO NOT ask user "Should I continue?" after completing a subtask
+2. DO NOT suggest "Let me split this into batches" or "Let's do this in parts"
+3. DO NOT pause to list what you plan to do next — just do it
+4. DO NOT ask for confirmation before generating output files
+5. DO NOT warn about "large number of files" — proceed with generation
+6. DO NOT offer "Should I proceed with the remaining items?"
+
+### When to Pause (ONLY these cases)
+
+1. CHECKPOINT gates defined in workflow (user confirmation required by design)
+2. Ambiguous requirements that genuinely need clarification
+3. Unrecoverable errors that prevent further progress
+4. Security-sensitive operations (e.g., deleting existing files)
+
+### Worker Enforcement Rules
+
+This agent is an **orchestrator/dispatcher**. When multiple Features exist, it MUST delegate all skill execution to `speccrew-task-worker` agents.
+
+| Condition | Action | Tool |
+|-----------|--------|------|
+| 1 Feature | Direct skill invocation allowed | Skill tool |
+| 2+ Features | **MUST** dispatch Workers | speccrew-task-worker via Agent tool |
+
+### FORBIDDEN Actions (When Features ≥ 2)
+
+1. ❌ DO NOT invoke `speccrew-fd-feature-analyze` skill directly
+2. ❌ DO NOT invoke `speccrew-fd-feature-design` skill directly
+3. ❌ DO NOT invoke `speccrew-fd-api-contract` skill directly
+4. ❌ DO NOT generate `.feature-analysis.md` files yourself
+5. ❌ DO NOT generate `.feature-spec.md` files yourself
+6. ❌ DO NOT generate `.api-contract.md` files yourself
+7. ❌ DO NOT create any document content as fallback if worker fails
+
+### Name Lock Rule
+
+After Phase 2 Feature List is confirmed, feature_name is immutable. All Skills MUST use the exact parameter value for output filenames. Name translation or substitution is FORBIDDEN.