speccrew 0.7.61 → 0.7.63

package/.speccrew/skills/speccrew-team-leader-routing/SKILL.md

@@ -1,4 +1,4 @@
----
+---
 name: speccrew-team-leader-routing
 version: 1.0.0
 description: Team Leader 的意图识别与路由调度技能，负责识别用户意图并路由到对应 Skill/Agent。处理项目初始化、知识库同步、工作流诊断等基础设施请求。
@@ -66,7 +66,7 @@ Team Leader 的核心路由调度技能，负责：
 
 ## AgentFlow Definition
 
-<!-- @agentflow: workflow.agentflow.xml -->
+<!-- @agentflow: SKILL.xml -->
 
 ---
 

package/.speccrew/skills/speccrew-test-case-design/SKILL.md

@@ -1,4 +1,4 @@
----
+---
 name: speccrew-test-case-design
 description: Designs structured test cases from Feature Spec and API Contract documents. Focuses on comprehensive test scenario analysis, test case matrix generation, and coverage traceability without involving any code implementation.
 tools: Read, Write, Glob, Grep
@@ -12,7 +12,7 @@ tools: Read, Write, Glob, Grep
 
 ## AgentFlow Definition
 
-<!-- @agentflow: workflow.agentflow.xml -->
+<!-- @agentflow: SKILL.xml -->
 
 > **REQUIRED**: Before executing this workflow, read the XML workflow specification: `speccrew-workspace/docs/rules/agentflow-spec.md`
 

package/.speccrew/skills/speccrew-test-code-gen/SKILL.md

@@ -1,4 +1,4 @@
----
+---
 name: speccrew-test-code-gen
 description: Generates executable test code from confirmed test case documents. Reads test case matrix, platform technical conventions, and system design to produce well-structured test files with full traceability to test case IDs.
 tools: Read, Write, Glob, Grep
@@ -12,7 +12,7 @@ tools: Read, Write, Glob, Grep
 
 ## AgentFlow Definition
 
-<!-- @agentflow: workflow.agentflow.xml -->
+<!-- @agentflow: SKILL.xml -->
 
 > **REQUIRED**: Before executing this workflow, read the XML workflow specification: `speccrew-workspace/docs/rules/agentflow-spec.md`
 

package/.speccrew/skills/speccrew-test-manager-orchestration/SKILL.md

@@ -1,4 +1,4 @@
----
+---
 name: speccrew-test-manager-orchestration
 version: 1.0.0
 description: Test Manager 的编排调度技能，负责执行三阶段测试工作流：测试用例设计 → 测试代码生成 → 测试执行与报告。支持单平台直接调用和多平台 Worker 并行调度。
@@ -74,7 +74,7 @@ Test Manager 的核心编排技能，负责：
 
 ## AgentFlow Definition
 
-<!-- @agentflow: workflow.agentflow.xml -->
+<!-- @agentflow: SKILL.xml -->
 
 ---
 

package/.speccrew/skills/speccrew-test-reporter/SKILL.md

@@ -1,4 +1,4 @@
----
+---
 name: speccrew-test-reporter
 description: "SpecCrew Test Reporter. Generates comprehensive test reports and individual bug reports from test execution results. Performs root cause analysis and severity classification."
 tools: Read, Write, Glob, Grep
@@ -27,7 +27,7 @@ tools: Read, Write, Glob, Grep
 
 ## AgentFlow Definition
 
-<!-- @agentflow: workflow.agentflow.xml -->
+<!-- @agentflow: SKILL.xml -->
 
 > **REQUIRED**: Before executing this workflow, read the XML workflow specification: `speccrew-workspace/docs/rules/agentflow-spec.md`
 

package/.speccrew/skills/speccrew-test-runner/SKILL.md

@@ -1,4 +1,4 @@
----
+---
 name: speccrew-test-runner
 description: "SpecCrew Test Runner. Executes test code, parses results, and detects deviations between expected and actual outcomes. Reads test code files and system design to run platform-specific test suites."
 tools: Read, Write, Bash, Glob, Grep
@@ -27,7 +27,7 @@ tools: Read, Write, Bash, Glob, Grep
 
 ## AgentFlow Definition
 
-<!-- @agentflow: workflow.agentflow.xml -->
+<!-- @agentflow: SKILL.xml -->
 
 > **REQUIRED**: Before executing this workflow, read the XML workflow specification: `speccrew-workspace/docs/rules/agentflow-spec.md`
 

package/package.json

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

package/.speccrew/skills/speccrew-sd-backend/workflow.agentflow.xml

@@ -1,264 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<workflow id="sd-backend-main" status="pending" version="1.0" desc="Backend System Design workflow">
-
-  <!-- ============================================================
-       Input Parameters Definition
-       ============================================================ -->
-  <block type="input" id="I1" desc="Workflow input parameters">
-    <field name="feature_id" required="false" type="string" desc="Feature identifier, e.g., F-CRM-01"/>
-    <field name="feature_name" required="true" type="string" desc="Feature name, e.g., customer-list"/>
-    <field name="platform_id" required="true" type="string" desc="Target platform, e.g., backend-spring, backend-nestjs"/>
-    <field name="iteration_path" required="true" type="string" desc="Absolute path to iteration directory"/>
-    <field name="workspace_path" required="true" type="string" desc="Absolute path to speccrew-workspace"/>
-    <field name="task_id" required="false" type="string" desc="Task ID from dispatch context"/>
-  </block>
-
-  <!-- ============================================================
-       Global Constraints
-       ============================================================ -->
-  <block type="rule" id="R1" level="forbidden" desc="Document creation constraints">
-    <field name="text">NEVER use create_file to write design documents or INDEX directly</field>
-    <field name="text">MUST create by copying template then filling with search_replace</field>
-  </block>
-
-  <block type="rule" id="R2" level="forbidden" desc="Full-file rewrite prohibition">
-    <field name="text">NEVER replace entire document content in single operation</field>
-    <field name="text">ALWAYS use targeted search_replace on specific sections</field>
-  </block>
-
-  <block type="rule" id="R3" level="mandatory" desc="Template-first workflow">
-    <field name="text">Copy template MUST execute before fill sections</field>
-    <field name="text">Skipping copy and writing content directly is FORBIDDEN</field>
-  </block>
-
-  <block type="rule" id="R4" level="mandatory" desc="Actual framework syntax">
-    <field name="text">All pseudo-code MUST use actual framework/library syntax from techs knowledge</field>
-    <field name="text">NOT generic pseudo-code</field>
-  </block>
-
-  <!-- ============================================================
-       Main Processing Sequence
-       ============================================================ -->
-  <sequence id="S1" name="Backend System Design" status="pending" desc="Generate backend detailed design documents">
-
-    <!-- Step 1: Read Inputs -->
-    <block type="task" id="B1" action="read-file" desc="Read Feature Spec document">
-      <field name="path">${iteration_path}/02.feature-design/${feature_id}-${feature_name}-feature-spec.md</field>
-      <field name="fallback_path">${iteration_path}/02.feature-design/${feature_name}-feature-spec.md</field>
-      <field name="output" var="feature_spec"/>
-    </block>
-
-    <block type="task" id="B2" action="read-file" desc="Read API Contract">
-      <field name="path">${iteration_path}/03.api-contract/${feature_id}-${feature_name}-api-contract.md</field>
-      <field name="fallback_path">${iteration_path}/03.api-contract/${feature_name}-api-contract.md</field>
-      <field name="output" var="api_contract"/>
-    </block>
-
-    <!-- Read Techs Knowledge -->
-    <block type="task" id="B3" action="read-file" desc="Read tech-stack.md">
-      <field name="path">${workspace_path}/knowledges/techs/${platform_id}/tech-stack.md</field>
-      <field name="output" var="tech_stack"/>
-    </block>
-
-    <block type="task" id="B4" action="read-file" desc="Read architecture.md">
-      <field name="path">${workspace_path}/knowledges/techs/${platform_id}/architecture.md</field>
-      <field name="output" var="architecture"/>
-    </block>
-
-    <block type="task" id="B5" action="read-file" desc="Read conventions-design.md">
-      <field name="path">${workspace_path}/knowledges/techs/${platform_id}/conventions-design.md</field>
-      <field name="output" var="conventions_design"/>
-    </block>
-
-    <block type="task" id="B6" action="read-file" desc="Read conventions-dev.md">
-      <field name="path">${workspace_path}/knowledges/techs/${platform_id}/conventions-dev.md</field>
-      <field name="output" var="conventions_dev"/>
-    </block>
-
-    <block type="task" id="B7" action="read-file" desc="Read conventions-data.md">
-      <field name="path">${workspace_path}/knowledges/techs/${platform_id}/conventions-data.md</field>
-      <field name="output" var="conventions_data"/>
-    </block>
-
-    <!-- Step 2: Analyze Existing Code Structure -->
-    <block type="task" id="B8" action="analyze" desc="Analyze codebase structure">
-      <field name="analysis_targets">
-        - Controller/Router layer structure
-        - Service layer organization
-        - Repository/DAO layer patterns
-        - Entity/Model definitions
-        - Middleware stack
-        - Exception handling patterns
-        - Database migration structure
-        - Naming conventions
-      </field>
-      <field name="output" var="codebase_analysis"/>
-    </block>
-
-    <!-- Step 3: Extract Functions from Feature Spec -->
-    <block type="task" id="B9" action="analyze" desc="Extract backend functions">
-      <field name="input" value="${feature_spec}">${api_contract}</field>
-      <field name="extraction_rules">
-        - Parse Feature Spec Section 2.N pattern
-        - Extract API interfaces from backend part
-        - Extract data access requirements
-        - Extract business logic flow
-        - Extract cross-module dependencies
-        - Mark each function as [EXISTING], [MODIFIED], or [NEW]
-      </field>
-      <field name="output" var="extracted_functions"/>
-    </block>
-
-    <!-- Checkpoint A: Present function list for confirmation -->
-    <block type="event" id="E1" action="confirm" title="Function List Confirmation" type="yesno" desc="Present function extraction summary">
-      <field name="preview">Backend Functions Extracted for: ${feature_name}
-Platform: ${platform_id}
-
-Function List:
-${extracted_functions.summary}
-
-Markers:
-- [NEW]: ${extracted_functions.new_count} modules
-- [MODIFIED]: ${extracted_functions.modified_count} modules
-- [EXISTING]: ${extracted_functions.existing_count} modules (no design needed)
-
-Confirm function list before proceeding?</field>
-    </block>
-
-    <!-- Step 4: Generate Module Design Documents -->
-    <block type="task" id="B10" action="read-file" desc="Read design template">
-      <field name="path">speccrew-sd-backend/templates/SD-BACKEND-TEMPLATE.md</field>
-      <field name="output" var="design_template"/>
-    </block>
-
-    <!-- Loop: Generate design for each function -->
-    <block type="loop" id="L1" over="${extracted_functions.functions}" as="function" desc="Generate module design documents">
-      <block type="task" id="B11" action="generate" desc="Copy template and create document">
-        <field name="template" value="${design_template}"/>
-        <field name="placeholders">
-          - {Module Name} → ${function.module_name}
-          - {Feature Name} → ${feature_name}
-          - {Platform ID} → ${platform_id}
-        </field>
-        <field name="output_path">${iteration_path}/03.system-design/${platform_id}/${function.module_name}-design.md</field>
-        <field name="output" var="module_doc_created"/>
-      </block>
-
-      <block type="task" id="B12" action="edit-file" desc="Fill Module Structure section">
-        <field name="path">${iteration_path}/03.system-design/${platform_id}/${function.module_name}-design.md</field>
-        <field name="operation">search_replace</field>
-        <field name="content_source">${tech_stack}${conventions_design}</field>
-        <field name="section">Module Structure</field>
-      </block>
-
-      <block type="task" id="B13" action="edit-file" desc="Fill Interface Pseudo-code section">
-        <field name="path">${iteration_path}/03.system-design/${platform_id}/${function.module_name}-design.md</field>
-        <field name="operation">search_replace</field>
-        <field name="content_source">${api_contract}${conventions_dev}</field>
-        <field name="section">Interface Pseudo-code</field>
-      </block>
-
-      <block type="task" id="B14" action="edit-file" desc="Fill Database Design section">
-        <field name="path">${iteration_path}/03.system-design/${platform_id}/${function.module_name}-design.md</field>
-        <field name="operation">search_replace</field>
-        <field name="content_source">${feature_spec}${conventions_data}</field>
-        <field name="section">Database Design</field>
-      </block>
-
-      <block type="task" id="B15" action="edit-file" desc="Fill Transaction Boundaries section">
-        <field name="path">${iteration_path}/03.system-design/${platform_id}/${function.module_name}-design.md</field>
-        <field name="operation">search_replace</field>
-        <field name="content_source">${conventions_data}</field>
-        <field name="section">Transaction Boundaries</field>
-      </block>
-
-      <block type="task" id="B16" action="edit-file" desc="Fill Exception Handling section">
-        <field name="path">${iteration_path}/03.system-design/${platform_id}/${function.module_name}-design.md</field>
-        <field name="operation">search_replace</field>
-        <field name="content_source">${api_contract}${conventions_dev}</field>
-        <field name="section">Exception Handling</field>
-      </block>
-    </block>
-
-    <!-- Step 5: Generate Platform INDEX.md -->
-    <block type="task" id="B17" action="read-file" desc="Read index template">
-      <field name="path">speccrew-sd-backend/templates/INDEX-TEMPLATE.md</field>
-      <field name="output" var="index_template"/>
-    </block>
-
-    <block type="task" id="B18" action="generate" desc="Create INDEX.md from template">
-      <field name="template" value="${index_template}"/>
-      <field name="placeholders">
-        - {Platform Name} → ${platform_id}
-        - {Feature Name} → ${feature_name}
-      </field>
-      <field name="output_path">${iteration_path}/03.system-design/${platform_id}/INDEX.md</field>
-    </block>
-
-    <block type="task" id="B19" action="edit-file" desc="Fill Tech Stack Summary">
-      <field name="path">${iteration_path}/03.system-design/${platform_id}/INDEX.md</field>
-      <field name="operation">search_replace</field>
-      <field name="content_source">${tech_stack}</field>
-      <field name="section">Tech Stack Summary</field>
-    </block>
-
-    <block type="task" id="B20" action="edit-file" desc="Fill Shared Design Decisions">
-      <field name="path">${iteration_path}/03.system-design/${platform_id}/INDEX.md</field>
-      <field name="operation">search_replace</field>
-      <field name="content_source">${architecture}${conventions_design}</field>
-      <field name="section">Shared Design Decisions</field>
-    </block>
-
-    <block type="task" id="B21" action="edit-file" desc="Fill Module List Table">
-      <field name="path">${iteration_path}/03.system-design/${platform_id}/INDEX.md</field>
-      <field name="operation">search_replace</field>
-      <field name="content_source">${extracted_functions}</field>
-      <field name="section">Module List Table</field>
-    </block>
-
-    <block type="task" id="B22" action="edit-file" desc="Fill Database Schema Overview">
-      <field name="path">${iteration_path}/03.system-design/${platform_id}/INDEX.md</field>
-      <field name="operation">search_replace</field>
-      <field name="content_source">${extracted_functions}</field>
-      <field name="section">Database Schema Overview</field>
-    </block>
-
-    <!-- Step 6: Present Summary -->
-    <block type="event" id="E2" action="log" level="info" desc="Present design summary">
-      <field name="message">Backend System Design Summary for: ${feature_name}
-Platform: ${platform_id}
-
-Module Designs: ${extracted_functions.design_count}
-├── [NEW] ${extracted_functions.new_count} modules
-├── [MODIFIED] ${extracted_functions.modified_count} modules
-└── [EXISTING] ${extracted_functions.existing_count} modules (no design needed)
-
-Database Changes:
-├── New Tables: ${extracted_functions.new_tables_count}
-├── Modified Tables: ${extracted_functions.modified_tables_count}
-└── Migration Files: ${extracted_functions.migration_count}
-
-Files Generated:
-- ${iteration_path}/03.system-design/${platform_id}/INDEX.md
-${extracted_functions.file_list}</field>
-    </block>
-
-  </sequence>
-
-  <!-- ============================================================
-       Output Results
-       ============================================================ -->
-  <block type="output" id="O1" desc="Workflow output results">
-    <field name="status" value="SUCCESS" type="string" desc="Task completion status"/>
-    <field name="task_id" from="${task_id}" type="string" desc="Task ID"/>
-    <field name="platform" value="${platform_id}" type="string" desc="Target platform"/>
-    <field name="feature_id" from="${feature_id}" type="string" desc="Feature ID"/>
-    <field name="feature" value="${feature_name}" type="string" desc="Feature name"/>
-    <field name="output_files" type="array" desc="List of generated files">
-      <field name="file">${iteration_path}/03.system-design/${platform_id}/INDEX.md</field>
-      <field name="files" from="${extracted_functions.output_files}"/>
-    </field>
-    <field name="summary" value="Backend system design completed for ${feature_name} on ${platform_id}" type="string" desc="Completion summary"/>
-  </block>
-
-</workflow>