speccrew 0.6.68 → 0.7.0

package/.speccrew/skills/{speccrew-knowledge-system-summarize-xml/SKILL.md → speccrew-knowledge-system-summarize/workflow.agentflow.xml}

@@ -1,66 +1,3 @@
----
-name: speccrew-knowledge-system-summarize-xml
-description: Generate complete system-overview.md by reading all {{module_name}}-overview.md files using XML workflow blocks. Aggregates module information, builds dependency graph, and creates system-level documentation.
-tools: Read, Write, Glob, Skill
----
-
-# System Summarize - Complete System Overview (XML Workflow)
-
-Read all {{module_name}}-overview.md files, aggregate information to generate complete system-overview.md with module index, topology, and business flows.
-
-## Language Adaptation
-
-**CRITICAL**: Generate all content in the language specified by the `language` parameter.
-
-- `language: "zh"` → Generate all content in 中文
-- `language: "en"` → Generate all content in English
-- Other languages → Use the specified language
-
-**All output content (system description, module summaries, flow descriptions) must be in the target language only.**
-
-## Trigger Scenarios
-
-- "Generate system overview from modules"
-- "Complete system documentation"
-- "Summarize all modules into system view"
-
-## User
-
-Worker Agent (speccrew-task-worker)
-
-## Input
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `modules_path` | string | Yes | Path to modules directory (e.g., `speccrew-workspace/knowledges/bizs/`) containing all {{platform_type}}/{{module_name}}/{{module_name}}-overview.md files |
-| `output_path` | string | Yes | Output path for system-overview.md (e.g., `speccrew-workspace/knowledges/bizs/`) |
-| `language` | string | Yes | Target language for generated content (e.g., "zh", "en") |
-
-## Output
-
-| Output | Path | Description |
-|--------|------|-------------|
-| `system-overview.md` | `{{output_path}}/system-overview.md` | Complete system overview. Example: `speccrew-workspace/knowledges/bizs/system-overview.md` |
-
-## Workflow
-
-```mermaid
-flowchart TD
-    Start([Start]) --> Step0[Step 0: Read System Overview Template]
-    Step0 --> Step1[Step 1: Discover All Modules]
-    Step1 --> Step2[Step 2: Read All Module Overviews]
-    Step2 --> Step3[Step 3: Build Module Index]
-    Step3 --> Step4[Step 4: Build Dependency Graph]
-    Step4 --> Step5[Step 5: Identify Business Domains]
-    Step5 --> Step6[Step 6: Identify End-to-End Flows]
-    Step6 --> Step7[Step 7: Generate system-overview.md]
-    Step7 --> Step8[Step 8: Report Results]
-    Step8 --> End([End])
-```
-
-> **REQUIRED**: Before executing this workflow, read the XML workflow specification: `speccrew-workspace/docs/rules/xml-workflow-spec.md`
-
-```xml
 <?xml version="1.0" encoding="UTF-8"?>
 <workflow id="system-summarize-main" status="pending" version="1.0" desc="System summarization workflow">
   <!-- ============================================================
@@ -532,117 +469,3 @@ flowchart TD
     <field name="message" value="System summarization completed with ${module_count} modules processed"/>
   </block>
 </workflow>
-```
-
-## Constraints
-
-### Critical Constraints
-
-> 1. **FORBIDDEN: `create_file` for documents** — Document MUST be created by copying template (Step 7a) then filling with `search_replace` (Step 7b)
-> 2. **FORBIDDEN: Full-file rewrite** — Always use targeted `search_replace` on specific sections
-> 3. **MANDATORY: Template-first workflow** — Step 7a MUST execute before Step 7b
-
-### Content Language
-
-**IMPORTANT**: ALL generated content (system description, module summaries, flow descriptions, section headers, and narrative text) MUST be written in the language specified by the `language` parameter. Only code identifiers, file paths, and technical terms remain in their original language.
-
-## Return Value Format
-
-```json
-{
-  "status": "success|failed",
-  "output_file": "system-overview.md",
-  "message": "System summarization completed with N modules processed"
-}
-```
-
-## Task Completion Report
-
-Upon completion, output the following structured report:
-
-```json
-{
-  "status": "success | partial | failed",
-  "skill": "speccrew-knowledge-system-summarize-xml",
-  "output_files": [
-    "{output_path}/system-overview.md"
-  ],
-  "summary": "System overview generated from {module_count} modules across {platform_count} platforms",
-  "metrics": {
-    "platforms_covered": 0,
-    "modules_summarized": 0,
-    "system_overview_generated": true
-  },
-  "errors": [],
-  "next_steps": [
-    "Review system-overview.md for completeness",
-    "Run speccrew-pm-requirement-assess if requirement assessment is needed"
-  ]
-}
-```
-
-## Reference Guides
-
-### Mermaid Diagram Guide
-
-When generating Mermaid diagrams, follow these compatibility guidelines:
-
-**Key Requirements:**
-- Use only basic node definitions: `A[text content]`
-- No HTML tags (e.g., `<br/>`)
-- No nested subgraphs
-- No `direction` keyword
-- No `style` definitions
-- Use standard `graph TB/LR` syntax only
-
-**Diagram Types:**
-
-| Diagram Type | Use Case | Example |
-|---------|---------|------|
-| `graph TB/LR` | System structure, module dependencies | System architecture, module dependency graph |
-| `sequenceDiagram` | Cross-module interaction flow | User operation flow, service call chain |
-| `flowchart TD` | Business logic, conditional branches | State transition, exception handling |
-| `classDiagram` | Class structure, entity relationships | Data model, service interface |
-| `erDiagram` | Database table relationships | Entity relationship diagram |
-| `stateDiagram-v2` | State machine | Order status, approval status |
-
-### Source Traceability Guide
-
-Aggregate source file references from all module overview documents:
-
-> **Note**: Use relative paths from the generated document to the source file. Do NOT use `file://` protocol.
-
-1. **File Reference Block** (at document start):
-```markdown
-**Referenced Files**
-
-- Aggregated from all module overview documents
-- [OrderController.java](path/to/source/OrderController.java)
-- [PaymentController.java](path/to/source/PaymentController.java)
-```
-
-2. **Diagram Source** (after each Mermaid diagram):
-```markdown
-**Diagram Source**
-- Aggregated from: order-overview.md, payment-overview.md
-```
-
-3. **Section Source** (at end of document):
-```markdown
-**Section Source**
-- Aggregated from all module overview documents
-```
-
-## Checklist
-
-- [ ] All {{module_name}}-overview.md files discovered
-- [ ] Module information extracted
-- [ ] Source file references aggregated from module documents
-- [ ] Module index table created
-- [ ] Dependency graph built
-- [ ] Business domains identified
-- [ ] End-to-end flows mapped
-- [ ] system-overview.md generated with all sections
-- [ ] Source traceability information included
-- [ ] Mermaid diagrams follow compatibility guidelines
-- [ ] Results reported