speccrew 0.7.74 → 0.7.75

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (66) hide show
  1. package/.speccrew/skills/speccrew-agentflow-manager/SKILL.md +6 -149
  2. package/.speccrew/skills/speccrew-deploy-build/SKILL.md +2 -59
  3. package/.speccrew/skills/speccrew-deploy-migrate/SKILL.md +2 -64
  4. package/.speccrew/skills/speccrew-deploy-smoke-test/SKILL.md +2 -75
  5. package/.speccrew/skills/speccrew-deploy-startup/SKILL.md +2 -70
  6. package/.speccrew/skills/speccrew-dev-backend/SKILL.md +2 -381
  7. package/.speccrew/skills/speccrew-dev-desktop-electron/SKILL.md +2 -369
  8. package/.speccrew/skills/speccrew-dev-desktop-tauri/SKILL.md +2 -362
  9. package/.speccrew/skills/speccrew-dev-frontend/SKILL.md +2 -304
  10. package/.speccrew/skills/speccrew-dev-mobile/SKILL.md +2 -294
  11. package/.speccrew/skills/speccrew-dev-review-backend/SKILL.md +2 -204
  12. package/.speccrew/skills/speccrew-dev-review-desktop/SKILL.md +2 -173
  13. package/.speccrew/skills/speccrew-dev-review-frontend/SKILL.md +2 -169
  14. package/.speccrew/skills/speccrew-dev-review-mobile/SKILL.md +2 -173
  15. package/.speccrew/skills/speccrew-fd-api-contract/SKILL.md +2 -251
  16. package/.speccrew/skills/speccrew-fd-feature-analyze/SKILL.md +2 -254
  17. package/.speccrew/skills/speccrew-fd-feature-design/SKILL.md +2 -748
  18. package/.speccrew/skills/speccrew-feature-designer-orchestration/SKILL.md +6 -105
  19. package/.speccrew/skills/speccrew-get-timestamp/SKILL.md +6 -33
  20. package/.speccrew/skills/speccrew-knowledge-bizs-api-analyze/SKILL.md +3 -138
  21. package/.speccrew/skills/speccrew-knowledge-bizs-api-graph/SKILL.md +3 -283
  22. package/.speccrew/skills/speccrew-knowledge-bizs-dispatch/SKILL.md +3 -1014
  23. package/.speccrew/skills/speccrew-knowledge-bizs-identify-entries/SKILL.md +4 -343
  24. package/.speccrew/skills/speccrew-knowledge-bizs-init-features/SKILL.md +4 -235
  25. package/.speccrew/skills/speccrew-knowledge-bizs-module-classify/SKILL.md +6 -72
  26. package/.speccrew/skills/speccrew-knowledge-bizs-ui-analyze/SKILL.md +3 -534
  27. package/.speccrew/skills/speccrew-knowledge-bizs-ui-graph/SKILL.md +3 -432
  28. package/.speccrew/skills/speccrew-knowledge-bizs-ui-style-extract/SKILL.md +4 -391
  29. package/.speccrew/skills/speccrew-knowledge-graph-query/SKILL.md +3 -98
  30. package/.speccrew/skills/speccrew-knowledge-graph-write/SKILL.md +3 -92
  31. package/.speccrew/skills/speccrew-knowledge-module-summarize/SKILL.md +3 -181
  32. package/.speccrew/skills/speccrew-knowledge-system-summarize/SKILL.md +3 -148
  33. package/.speccrew/skills/speccrew-knowledge-techs-dispatch/SKILL.md +3 -330
  34. package/.speccrew/skills/speccrew-knowledge-techs-generate/SKILL.md +6 -159
  35. package/.speccrew/skills/speccrew-knowledge-techs-generate-conventions/SKILL.md +3 -142
  36. package/.speccrew/skills/speccrew-knowledge-techs-generate-quality/SKILL.md +3 -568
  37. package/.speccrew/skills/speccrew-knowledge-techs-generate-ui-style/SKILL.md +3 -180
  38. package/.speccrew/skills/speccrew-knowledge-techs-index/SKILL.md +3 -154
  39. package/.speccrew/skills/speccrew-knowledge-techs-init/SKILL.md +3 -176
  40. package/.speccrew/skills/speccrew-knowledge-techs-ui-analyze/SKILL.md +3 -135
  41. package/.speccrew/skills/speccrew-pm-knowledge-detector/SKILL.md +4 -88
  42. package/.speccrew/skills/speccrew-pm-module-initializer/SKILL.md +4 -178
  43. package/.speccrew/skills/speccrew-pm-module-matcher/SKILL.md +3 -102
  44. package/.speccrew/skills/speccrew-pm-phase0-init/SKILL.md +5 -78
  45. package/.speccrew/skills/speccrew-pm-phase1-knowledge-check/SKILL.md +5 -85
  46. package/.speccrew/skills/speccrew-pm-phase2-complexity-assess/SKILL.md +4 -100
  47. package/.speccrew/skills/speccrew-pm-phase5-subprd-dispatch/SKILL.md +14 -106
  48. package/.speccrew/skills/speccrew-pm-phase6-verify-confirm/SKILL.md +7 -84
  49. package/.speccrew/skills/speccrew-pm-requirement-analysis/SKILL.md +6 -66
  50. package/.speccrew/skills/speccrew-pm-requirement-assess/SKILL.md +4 -96
  51. package/.speccrew/skills/speccrew-pm-requirement-clarify/SKILL.md +4 -131
  52. package/.speccrew/skills/speccrew-pm-requirement-model/SKILL.md +6 -79
  53. package/.speccrew/skills/speccrew-pm-requirement-simple/SKILL.md +4 -76
  54. package/.speccrew/skills/speccrew-pm-sub-prd-generate/SKILL.md +3 -281
  55. package/.speccrew/skills/speccrew-product-manager-orchestration/SKILL.md +6 -165
  56. package/.speccrew/skills/speccrew-system-deployer-orchestration/SKILL.md +6 -79
  57. package/.speccrew/skills/speccrew-system-designer-orchestration/SKILL.md +2 -35
  58. package/.speccrew/skills/speccrew-system-developer-orchestration/SKILL.md +6 -98
  59. package/.speccrew/skills/speccrew-task-worker-execution/SKILL.md +6 -94
  60. package/.speccrew/skills/speccrew-team-leader-routing/SKILL.md +6 -79
  61. package/.speccrew/skills/speccrew-test-case-design/SKILL.md +2 -58
  62. package/.speccrew/skills/speccrew-test-code-gen/SKILL.md +2 -61
  63. package/.speccrew/skills/speccrew-test-manager-orchestration/SKILL.md +6 -94
  64. package/.speccrew/skills/speccrew-test-reporter/SKILL.md +2 -102
  65. package/.speccrew/skills/speccrew-test-runner/SKILL.md +3 -121
  66. package/package.json +1 -1
@@ -4,189 +4,12 @@ description: Generate UI style analysis documents for a specific frontend platfo
4
4
  tools: Read, Write, Glob, Grep, Skill
5
5
  ---
6
6
 
7
- # Stage 2: Generate Platform UI Style Documents (XML Workflow)
8
-
9
- Generate comprehensive UI style documentation for a specific frontend platform by analyzing its source code structure, components, and styling patterns using XML workflow blocks.
10
-
11
- ## Language Adaptation
12
-
13
- **CRITICAL**: All generated documents must match the user's language. Detect the language from the user's input and generate content accordingly.
14
-
15
- - User writes in 中文 → Generate Chinese documents, use `language: "zh"`
16
- - User writes in English → Generate English documents, use `language: "en"`
17
- - Other languages → Use the specified language code
18
-
19
- ## Prerequisite
20
-
21
- This skill ONLY applies to frontend platforms. The dispatcher MUST check platform_type before invoking:
22
-
23
- - `web` → Execute this skill
24
- - `mobile` → Execute this skill
25
- - `desktop` → Execute this skill
26
- - `backend` → DO NOT invoke this skill
27
- - `api` → DO NOT invoke this skill
28
-
29
- ## Trigger Scenarios
30
-
7
+ # Trigger Scenarios
31
8
  - "Generate UI style documents for {platform}"
32
9
  - "Analyze UI components and layouts"
33
10
  - "Extract design system from {platform}"
34
11
 
35
- ## User
36
-
37
- Worker Agent (speccrew-task-worker)
38
-
39
- ---
40
-
41
12
  ## AgentFlow Definition
42
-
43
13
  <!-- @agentflow: SKILL.xml -->
44
-
45
- > **REQUIRED**: Before executing this workflow, read the XML workflow specification: `speccrew-workspace/docs/rules/agentflow-spec.md`
46
-
47
- ---
48
-
49
- ## Output Directory Structure
50
-
51
- ```
52
- {output_path}/
53
- └── ui-style/
54
- ├── ui-style-guide.md # Main UI style guide (Required)
55
- ├── page-types/
56
- │ ├── page-type-summary.md # Page type overview (Required)
57
- │ └── [type]-pages.md # Per-type detail (Dynamic)
58
- ├── components/
59
- │ ├── component-library.md # Component catalog (Required)
60
- │ ├── common-components.md # Common components (Required)
61
- │ ├── business-components.md # Business components (Required)
62
- │ └── {component-name}.md # Per-component detail (Dynamic)
63
- ├── layouts/
64
- │ ├── page-layouts.md # Layout patterns (Required)
65
- │ ├── navigation-patterns.md # Navigation patterns (Required)
66
- │ └── {layout-name}-layout.md # Per-layout detail (Dynamic)
67
- └── styles/
68
- ├── color-system.md # Color system (Required)
69
- ├── typography.md # Typography (Required)
70
- └── spacing-system.md # Spacing system (Required)
71
- ```
72
-
73
- ## Directory Ownership
74
-
75
- - `ui-style/` — Fully managed by this skill (techs pipeline)
76
- - Contains: ui-style-guide.md, styles/, page-types/, components/, layouts/
77
- - Source: Framework-level design system analysis from source code
78
- - `ui-style-patterns/` — Managed by bizs pipeline (Stage 3.5: bizs-ui-style-extract)
79
- - Contains: Business pattern aggregation from feature documents
80
- - NOT created or written by this skill
81
- - May not exist if bizs pipeline has not been executed
82
-
83
- ---
84
-
85
- ## Quality Requirements
86
-
87
- - ui-style-guide.md MUST have substantial content (not just template placeholders)
88
- - At least 5 mandatory files MUST exist (see Self-Verification Checklist)
89
- - Analysis report MUST honestly reflect coverage level
90
- - All paths in documents MUST be relative (never absolute or file:// protocol)
91
-
92
- ---
93
-
94
- ## Error Handling
95
-
96
- | Error Type | Action |
97
- |------------|--------|
98
- | Platform type is backend/api | Skip execution, return skipped status |
99
- | UI analyzer skill invocation fails | Execute Secondary Path (template fill) |
100
- | Source code structure is non-standard | Execute Tertiary Path (reference only) |
101
- | Template not found | Use default structure, log warning |
102
- | Any path MUST output the done file and analysis file | Never report "completed" with missing mandatory files |
103
-
104
- ---
105
-
106
- ## Task Completion Report
107
-
108
- Upon completion, return the following structured report:
109
-
110
- ```json
111
- {
112
- "status": "success | partial | failed",
113
- "skill": "speccrew-knowledge-techs-generate-ui-style",
114
- "output_files": [
115
- "{output_path}/ui-style/ui-style-guide.md",
116
- "{output_path}/ui-style/page-types/page-type-summary.md",
117
- "{output_path}/ui-style/components/component-library.md",
118
- "{output_path}/ui-style/layouts/page-layouts.md",
119
- "{output_path}/ui-style/styles/color-system.md",
120
- "{completed_dir}/{platform_id}.analysis-ui-style.json",
121
- "{completed_dir}/{platform_id}.done-ui-style.json"
122
- ],
123
- "summary": "UI style documents generated for {platform_id} at {ui_analysis_level} analysis level",
124
- "metrics": {
125
- "components_documented": 0,
126
- "style_patterns_captured": 0,
127
- "design_tokens_extracted": 0
128
- },
129
- "errors": [],
130
- "next_steps": [
131
- "Review ui-style-guide.md for design system completeness",
132
- "Coordinate with bizs-ui-style-extract for business pattern integration"
133
- ]
134
- }
135
- ```
136
-
137
- ---
138
-
139
- ## Checklist
140
-
141
- ### Pre-Generation
142
- - [ ] Platform type verified (web/mobile/desktop only)
143
- - [ ] Template files read and understood
144
- - [ ] Source directory structure scanned
145
-
146
- ### UI Style Analysis
147
- - [ ] `speccrew-knowledge-techs-ui-analyze` skill invoked (Primary Path)
148
- - [ ] If Primary Path failed → Secondary Path executed
149
- - [ ] If Secondary Path failed → Tertiary Path executed
150
- - [ ] All mandatory files created per Self-Verification Checklist
151
-
152
- ### Output Verification
153
- - [ ] ui-style/ui-style-guide.md exists and has content
154
- - [ ] ui-style/page-types/page-type-summary.md exists and has content
155
- - [ ] ui-style/components/component-library.md exists and has content
156
- - [ ] ui-style/layouts/page-layouts.md exists and has content
157
- - [ ] ui-style/styles/color-system.md exists and has content
158
-
159
- ### Reporting
160
- - [ ] Analysis report generated: `{platform_id}.analysis-ui-style.json`
161
- - [ ] Completion marker generated: `{platform_id}.done-ui-style.json`
162
- - [ ] Console output reported with correct status
163
-
164
- ---
165
-
166
- ## CONTINUOUS EXECUTION RULES
167
-
168
- This skill MUST execute all steps continuously without unnecessary interruptions.
169
-
170
- ### FORBIDDEN Interruptions
171
-
172
- 1. DO NOT ask user "Should I continue?" after completing a step
173
- 2. DO NOT suggest "Let me split this into batches" or "Let's do this in parts"
174
- 3. DO NOT pause to list what you plan to do next — just do it
175
- 4. DO NOT ask for confirmation before generating output files
176
- 5. DO NOT warn about "large number of files" — proceed with generation
177
- 6. DO NOT offer "Should I proceed with the remaining items?"
178
- 7. DO NOT present options like "Full execution / Sample execution / Pause"
179
-
180
- ### When to Pause (ONLY these cases)
181
-
182
- 1. Explicit `<event action="confirm">` blocks in the workflow
183
- 2. Ambiguous requirements that genuinely need clarification
184
- 3. Unrecoverable errors that prevent further progress
185
- 4. Security-sensitive operations (e.g., deleting existing files)
186
-
187
- ### Execution Behavior
188
-
189
- - When multiple templates need filling, process ALL of them sequentially without asking
190
- - Use checkpoint files to track progress, enabling resumption if interrupted
191
- - If context window is approaching limit, save progress and inform user how to resume
192
- - NEVER voluntarily stop mid-process to ask if user wants to continue
14
+ > **REQUIRED**: Before executing this workflow, read the XML workflow specification: speccrew-workspace/docs/rules/agentflow-spec.md
15
+ > Then read and execute the XML workflow in SKILL.xml block-by-block as the authoritative execution plan.
@@ -4,163 +4,12 @@ description: Stage 3 of technology knowledge initialization - Generate root INDE
4
4
  tools: Read, Write, Skill
5
5
  ---
6
6
 
7
- # Stage 3: Generate Root Technology Index (XML Workflow)
8
-
9
- Aggregate all platform technology documentation into a single root INDEX.md that serves as the master navigation hub for technology knowledge.
10
-
11
- ## Language Adaptation
12
-
13
- **CRITICAL**: Generate all content in the language specified by the `language` parameter.
14
-
15
- - `language: "zh"` → Generate all content in 中文
16
- - `language: "en"` → Generate all content in English
17
- - Other languages → Use the specified language
18
-
19
- ## Trigger Scenarios
20
-
7
+ # Trigger Scenarios
21
8
  - "Generate techs root index"
22
9
  - "Create technology knowledge index"
23
10
  - "Aggregate platform tech docs"
24
- - "Generate master tech index"
25
-
26
- ## User
27
-
28
- Worker Agent (speccrew-task-worker)
29
-
30
- ## Input
31
-
32
- - `manifest_path`: Path to techs-manifest.json
33
- - `techs_base_path`: Base path for techs documentation (default: `speccrew-workspace/knowledges/techs/`)
34
- - `output_path`: Output path for root INDEX.md (default: `speccrew-workspace/knowledges/techs/`)
35
- - `language`: Target language (e.g., "zh", "en") - **REQUIRED**
36
-
37
- ## Output
38
-
39
- - `{{output_path}}/INDEX.md` - Root technology knowledge index
40
-
41
- **INDEX.md Content Structure**:
42
- - Introduction (generation info, platform count)
43
- - Platform Overview (table with links to all platform docs)
44
- - Quick Reference (links organized by document type)
45
- - Agent-to-Platform Mapping (maps agents to their platform docs)
46
- - Document Guide (explains each document type)
47
- - Usage Guide (how to use the knowledge)
48
11
 
49
12
  ## AgentFlow Definition
50
-
51
13
  <!-- @agentflow: SKILL.xml -->
52
-
53
- > **REQUIRED**: Before executing this workflow, read the XML workflow specification: `speccrew-workspace/docs/rules/agentflow-spec.md`
54
-
55
- ---
56
-
57
- ## Template Usage
58
-
59
- Templates are located at `./templates/`:
60
-
61
- **Template Variables:**
62
- - `{{generated_at}}`: ISO timestamp
63
- - `{{source_path}}`: Source path
64
- - `{{platform_count}}`: Number of platforms
65
- - `{{#each platforms}}`: Loop through platforms
66
- - `{{platform_id}}`: Platform identifier
67
- - `{{platform_type}}`: Platform type
68
- - `{{framework}}`: Framework name
69
- - `{{language}}`: Programming language
70
-
71
- ---
72
-
73
- ## Document Structure Details
74
-
75
- ### Section 1: Header
76
-
77
- ```markdown
78
- # Technology Knowledge Index
79
-
80
- **Files Referenced in This Document**
81
-
82
- - [techs-manifest.json](../../../speccrew-workspace/knowledges/techs/techs-manifest.json)
83
-
84
- > **Target Audience**: devcrew-designer-*, devcrew-dev-*, devcrew-test-*
85
- ```
86
-
87
- ### Section 2: Platform Overview
88
-
89
- Summary table of all platforms with **dynamically generated document links**:
90
-
91
- ```markdown
92
- ## Platform Overview
93
-
94
- | Platform | Type | Framework | Stack | Arch | Design | Dev | Test | Build | Data |
95
- |----------|------|-----------|-------|------|--------|-----|------|-------|------|
96
- | [web-react](web-react/INDEX.md) | web | React | [Stack](web-react/tech-stack.md) | ... | ... | ... | ... | ... | - |
97
- ```
98
-
99
- **Dynamic Link Generation Rules:**
100
-
101
- 1. **Always include links to required documents** (if they exist)
102
- 2. **Conditionally include conventions-data.md**: Show `-` if not exists
103
- 3. **Link Format**: Use short abbreviations to save space
104
-
105
- ### Section 3: Quick Reference
106
-
107
- Quick links organized by document type (Technology Stacks, Architecture Guidelines, Design Conventions, etc.)
108
-
109
- ### Section 4: Agent-to-Platform Mapping
110
-
111
- Critical section that defines how Agents map to platform documentation. **Must dynamically adjust based on actual document availability.**
112
-
113
- **Dynamic Adjustment Rules:**
114
-
115
- 1. **Designer Agent Documents**: Primary + Optional (conventions-data.md, ui-style-patterns/)
116
- 2. **Developer Agent Documents**: Primary (conventions-dev.md, conventions-build.md) + Optional
117
- 3. **Tester Agent Documents**: Primary (conventions-test.md, conventions-build.md) + Optional
118
-
119
- ### Section 5: Document Guide
120
-
121
- Explain what each document type contains.
122
-
123
- ### Section 6: Usage Guide
124
-
125
- How to use the technology knowledge for Designer, Developer, and Tester Agents.
126
-
127
- ---
128
-
129
- ## Checklist
130
-
131
- ### Pre-Generation
132
- - [ ] techs-manifest.json read successfully
133
- - [ ] Platform list extracted from manifest
134
-
135
- ### Dynamic Document Detection
136
- - [ ] Each platform directory scanned for actual document existence
137
- - [ ] Document availability map created for each platform
138
- - [ ] Required documents verified
139
- - [ ] Optional conventions-data.md existence checked per platform
140
-
141
- ### Content Generation
142
- - [ ] Platform summaries extracted from existing INDEX.md files
143
- - [ ] Root INDEX.md generated with all sections
144
- - [ ] **Platform Overview table**: Links dynamically generated based on actual document existence
145
- - [ ] **Agent-to-Platform mapping**: Document recommendations adjusted per platform
146
- - [ ] Document guide included
147
- - [ ] Usage guide included
148
-
149
- ### Quality & Validation
150
- - [ ] No broken links to non-existent documents
151
- - [ ] conventions-data.md links only included for platforms where it exists
152
- - [ ] **Source traceability**: File reference block added to root INDEX.md
153
- - [ ] Output file written successfully
154
- - [ ] Results reported with document availability summary
155
-
156
- ---
157
-
158
- ## CONTINUOUS EXECUTION RULES
159
-
160
- This skill follows the continuous execution pattern defined in `GLOBAL-R1`:
161
-
162
- 1. **Sequential Execution**: All workflow steps must execute in the defined order without interruption.
163
- 2. **No User Prompts**: Worker must not pause for user confirmation between steps.
164
- 3. **Complete All Steps**: Worker must complete all steps before reporting results.
165
- 4. **Error Handling**: If any step fails, continue with remaining steps if possible, then report all errors together.
166
- 5. **Technology Stack Constraint**: Per `GLOBAL-R-TECHSTACK`, all generated index documents must accurately reflect detected platform technology stacks.
14
+ > **REQUIRED**: Before executing this workflow, read the XML workflow specification: speccrew-workspace/docs/rules/agentflow-spec.md
15
+ > Then read and execute the XML workflow in SKILL.xml block-by-block as the authoritative execution plan.
@@ -4,185 +4,12 @@ description: Stage 1 of technology knowledge initialization - Scan source code t
4
4
  tools: Read, Write, Glob, Grep, SearchCodebase, Skill
5
5
  ---
6
6
 
7
- # Stage 1: Detect Technology Platforms (XML Workflow)
8
-
9
- Scan project source code to identify all technology platforms, extract configuration metadata, and generate techs-manifest.json for downstream document generation.
10
-
11
- ## Language Adaptation
12
-
13
- **CRITICAL**: Generate all content in the language specified by the `language` parameter.
14
-
15
- - `language: "zh"` → Generate all content in 中文
16
- - `language: "en"` → Generate all content in English
17
- - Other languages → Use the specified language
18
-
19
- **All output content must be in the target language only.**
20
-
21
- ## Trigger Scenarios
22
-
7
+ # Trigger Scenarios
23
8
  - "Initialize technology knowledge base"
24
9
  - "Scan source code for technology platforms"
25
10
  - "Detect tech stacks in project"
26
- - "Generate techs manifest"
27
-
28
- ## User
29
-
30
- Worker Agent (speccrew-task-worker)
31
-
32
- ## Input
33
-
34
- - `source_path`: Source code root directory (default: project root)
35
- - `output_path`: Output directory for techs-manifest.json (default: `speccrew-workspace/knowledges/base/sync-state/knowledge-techs/`)
36
- - `language`: Target language for generated content (e.g., "zh", "en") - **REQUIRED**
37
-
38
- ## Output
39
-
40
- - `{{output_path}}/techs-manifest.json` - Technology platform manifest for pipeline orchestration
41
11
 
42
12
  ## AgentFlow Definition
43
-
44
13
  <!-- @agentflow: SKILL.xml -->
45
-
46
- > **REQUIRED**: Before executing this workflow, read the XML workflow specification: `speccrew-workspace/docs/rules/agentflow-spec.md`
47
-
48
- ---
49
-
50
- ## Platform Detection Reference
51
-
52
- ### Web Platform Detection
53
-
54
- **Indicators:**
55
-
56
- | Signal | Platform ID | Framework |
57
- |--------|-------------|-----------|
58
- | package.json + react dependency | web-react | React |
59
- | package.json + vue dependency | web-vue | Vue |
60
- | package.json + @angular/core | web-angular | Angular |
61
- | package.json + next | web-nextjs | Next.js |
62
- | package.json + nuxt | web-nuxt | Nuxt |
63
- | package.json + svelte | web-svelte | Svelte |
64
-
65
- **Configuration Files to Capture:**
66
- - package.json
67
- - tsconfig.json
68
- - vite.config.* / webpack.config.* / next.config.* / nuxt.config.*
69
- - tailwind.config.* / postcss.config.*
70
- - .eslintrc.* / .prettierrc.*
71
-
72
- ### Mobile Platform Detection
73
-
74
- **Indicators:**
75
-
76
- | Signal | Platform ID | Framework |
77
- |--------|-------------|-----------|
78
- | pubspec.yaml | mobile-flutter | Flutter |
79
- | package.json + react-native | mobile-react-native | React Native |
80
- | .xcodeproj / Package.swift | mobile-ios | iOS (Swift) |
81
- | build.gradle + AndroidManifest.xml | mobile-android | Android (Kotlin/Java) |
82
- | manifest.json + pages.json (uni-app) | mobile-uniapp | UniApp |
83
- | project.config.json + app.json | mobile-miniprogram | Mini Program |
84
-
85
- **Configuration Files to Capture:**
86
- - Flutter: pubspec.yaml, analysis_options.yaml
87
- - React Native: package.json, metro.config.js
88
- - iOS: Package.swift, Podfile, Info.plist
89
- - Android: build.gradle, AndroidManifest.xml
90
-
91
- ### Backend Platform Detection
92
-
93
- **Indicators:**
94
-
95
- | Signal | Platform ID | Framework |
96
- |--------|-------------|-----------|
97
- | package.json + @nestjs/core | backend-nestjs | NestJS |
98
- | package.json + express | backend-express | Express |
99
- | package.json + fastify | backend-fastify | Fastify |
100
- | pom.xml + spring-boot | backend-spring | Spring Boot |
101
- | build.gradle + spring-boot | backend-spring | Spring Boot |
102
- | requirements.txt + django | backend-django | Django |
103
- | requirements.txt + fastapi | backend-fastapi | FastAPI |
104
- | go.mod | backend-go | Go |
105
- | Cargo.toml | backend-rust | Rust (Actix/Rocket) |
106
-
107
- **Configuration Files to Capture:**
108
- - Node.js: package.json, tsconfig.json, nest-cli.json
109
- - Java: pom.xml, build.gradle, application.yml/properties
110
- - Python: requirements.txt, pyproject.toml
111
- - Go: go.mod, go.sum
112
- - Rust: Cargo.toml
113
-
114
- ### Desktop Platform Detection
115
-
116
- **Indicators:**
117
-
118
- | Signal | Platform ID | Framework |
119
- |--------|-------------|-----------|
120
- | package.json + electron | desktop-electron | Electron |
121
- | tauri.conf.json | desktop-tauri | Tauri |
122
- | .csproj + WPF references | desktop-wpf | WPF |
123
- | .csproj + WinForms | desktop-winforms | WinForms |
124
- | .pro file + Qt | desktop-qt | Qt |
125
-
126
- **Configuration Files to Capture:**
127
- - Electron: package.json, electron-builder.yml
128
- - Tauri: tauri.conf.json, Cargo.toml
129
- - WPF/WinForms: .csproj, App.xaml
130
- - Qt: .pro, CMakeLists.txt
131
-
132
- ---
133
-
134
- ## Metadata Extraction Fields
135
-
136
- | Field | Source | Example |
137
- |-------|--------|---------|
138
- | platform_id | `{{platform_type}}-{{framework}}` | web-react, backend-nestjs |
139
- | platform_type | Platform category | web, mobile, backend, desktop |
140
- | framework | Primary framework | react, nestjs, flutter |
141
- | language | Primary language | typescript, kotlin, dart |
142
- | source_path | Relative source directory | src/web, src/server |
143
- | config_files | List of config file paths | ["package.json", "tsconfig.json"] |
144
- | convention_files | Lint/format config files | [".eslintrc.js", ".prettierrc"] |
145
-
146
- ---
147
-
148
- ## Platform Mapping Consistency
149
-
150
- Ensure consistency with modules.json by using standardized platform identifiers from `platform-mapping.json`:
151
-
152
- **Key Rules:**
153
- - `platform_id` format: `{{platform_type}}-{{framework}}` (e.g., `mobile-uniapp`, `web-vue`)
154
- - `platform_type` must match between techs-manifest.json and modules.json
155
- - `framework` maps to `platform_subtype` in modules.json
156
-
157
- **Example Mapping:**
158
-
159
- | platform_id | platform_type | framework | platform_subtype (for bizs-init) |
160
- |-------------|---------------|-----------|----------------------------------|
161
- | web-vue | web | vue | vue |
162
- | mobile-uniapp | mobile | uniapp | uniapp |
163
- | backend-spring | backend | spring | spring |
164
-
165
- ---
166
-
167
- ## Checklist
168
-
169
- - [ ] All platform indicators checked
170
- - [ ] Platform metadata extracted (platform_id, type, framework, language)
171
- - [ ] Configuration files identified and paths recorded
172
- - [ ] Convention files (eslint, prettier) identified
173
- - [ ] techs-manifest.json generated with valid JSON structure
174
- - [ ] **Source traceability**: All config_file paths recorded for downstream use
175
- - [ ] Output path verified
176
- - [ ] Results reported with platform summary
177
-
178
- ---
179
-
180
- ## CONTINUOUS EXECUTION RULES
181
-
182
- This skill follows the continuous execution pattern defined in `GLOBAL-R1`:
183
-
184
- 1. **Sequential Execution**: All workflow steps must execute in the defined order without interruption.
185
- 2. **No User Prompts**: Worker must not pause for user confirmation between steps.
186
- 3. **Complete All Steps**: Worker must complete all steps before reporting results.
187
- 4. **Error Handling**: If any step fails, continue with remaining steps if possible, then report all errors together.
188
- 5. **Technology Stack Constraint**: Per `GLOBAL-R-TECHSTACK`, detected platforms must align with standardized platform identifiers from platform-mapping.json.
14
+ > **REQUIRED**: Before executing this workflow, read the XML workflow specification: speccrew-workspace/docs/rules/agentflow-spec.md
15
+ > Then read and execute the XML workflow in SKILL.xml block-by-block as the authoritative execution plan.
@@ -4,144 +4,12 @@ description: Analyze existing frontend UI codebase to extract and summarize page
4
4
  tools: Read, Write, Glob, Grep
5
5
  ---
6
6
 
7
- # UI Style Analyzer
8
-
9
- Analyze existing frontend UI codebase to extract and summarize page styles, layout patterns, and component usage for each platform.
10
-
11
- ## Language Adaptation
12
-
13
- **CRITICAL**: Generate all content in the language specified by the `language` parameter.
14
-
15
- - `language: "zh"` → Generate all content in 中文
16
- - `language: "en"` → Generate all content in English
17
-
18
- ## Trigger Scenarios
19
-
7
+ # Trigger Scenarios
20
8
  - "Analyze UI styles from existing codebase"
21
9
  - "Extract page layout patterns from {platform}"
22
10
  - "Summarize component usage in {project}"
23
- - "Generate UI style guide from source code"
24
- - "梳理现有系统页面风格"
25
- - "分析项目UI组件使用规范"
26
-
27
- ## User
28
-
29
- Worker Agent (speccrew-task-worker)
30
-
31
- ## Input
32
-
33
- - `source_path`: Path to UI source code directory (e.g., `yudao-ui/yudao-ui-admin-vue3/`)
34
- - `platform_id`: Platform identifier (e.g., "admin-pc", "admin-mobile")
35
- - `platform_type`: Platform type (`web`, `mobile`, `desktop`)
36
- - `framework`: Frontend framework (vue3, react, uniapp, etc.)
37
- - `output_path`: Output directory for generated style guide
38
- - `language`: Target language (e.g., "zh", "en") - **REQUIRED**
39
-
40
- ## Output
41
-
42
- Generate the following documents in `{output_path}/`:
43
-
44
- **Note**: The `output_path` parameter should already include the `ui-style/` suffix when passed from the caller (e.g., `speccrew-knowledge-techs-generate`).
45
-
46
- ```
47
- {output_path}/ # e.g., .../techs/mobile-uniapp/ui-style/
48
- ├── ui-style-guide.md # Main UI style guide (Required)
49
- ├── page-types/ # Page type analysis
50
- │ ├── page-type-summary.md # Page type overview (dynamically generated type list)
51
- │ ├── [type-1]-pages.md # Specific page type analysis (dynamically named)
52
- │ ├── [type-2]-pages.md # Specific page type analysis
53
- │ └── ... # Other discovered page types
54
- ├── components/ # Component analysis
55
- │ ├── component-library.md # Component inventory (summary)
56
- │ ├── common-components.md # Common component usage conventions
57
- │ ├── business-components.md # Business component usage conventions
58
- │ └── {component-name}.md # Individual component detail (one per discovered component)
59
- ├── layouts/ # Layout patterns
60
- │ ├── page-layouts.md # Layout patterns summary
61
- │ ├── navigation-patterns.md # Navigation patterns
62
- │ └── {layout-name}-layout.md # Individual layout detail (one per discovered layout)
63
- └── styles/ # Styling conventions
64
- ├── color-system.md # Color system
65
- ├── typography.md # Typography conventions
66
- └── spacing-system.md # Spacing system
67
- ```
68
-
69
- **Note**: Page type documents are dynamically named based on discovered types, e.g.
70
- - If system has `*List.vue` files → `list-pages.md`
71
- - If system has `*Form.vue` files → `form-pages.md`
72
- - If system has `*Dashboard.vue` files → `dashboard-pages.md`
73
- - If system has custom patterns like `*Workflow.vue` → `workflow-pages.md`
74
11
 
75
12
  ## AgentFlow Definition
76
-
77
13
  <!-- @agentflow: SKILL.xml -->
78
-
79
- > **REQUIRED**: Before executing this workflow, read the XML workflow specification: `speccrew-workspace/docs/rules/agentflow-spec.md`
80
-
81
- ## Checklist
82
-
83
- ### Pre-Analysis (Step 0)
84
- - [ ] All 13 templates read and understood
85
- - [ ] Template section requirements mapped to extraction tasks
86
- - [ ] Source path exists and accessible
87
- - [ ] Framework identified (Vue3, React, etc.)
88
- - [ ] Platform type determined
89
-
90
- ### Analysis Phase
91
- **Step 1: Source Structure**
92
- - [ ] Project structure explored
93
- - [ ] Technology stack extracted for ui-style-guide.md
94
- - [ ] Directory structure documented
95
-
96
- **Step 2: Page Types**
97
- - [ ] PAGE-TYPE-SUMMARY-TEMPLATE.md read
98
- - [ ] PAGE-TYPE-INDIVIDUAL-TEMPLATE.md read
99
- - [ ] Page files discovered and categorized
100
- - [ ] page-type-summary.md generated
101
- - [ ] Individual [type]-pages.md generated (one per discovered type)
102
-
103
- **Step 3: Component Usage**
104
- - [ ] COMPONENT-LIBRARY-TEMPLATE.md read
105
- - [ ] COMMON-COMPONENTS-TEMPLATE.md read
106
- - [ ] BUSINESS-COMPONENTS-TEMPLATE.md read
107
- - [ ] COMPONENT-INDIVIDUAL-TEMPLATE.md read
108
- - [ ] Components extracted and classified
109
- - [ ] component-library.md generated
110
- - [ ] common-components.md generated
111
- - [ ] business-components.md generated
112
- - [ ] Individual {component-name}.md files generated (one per discovered component)
113
-
114
- **Step 4: Layout Patterns**
115
- - [ ] LAYOUT-PATTERNS-TEMPLATE.md read
116
- - [ ] NAVIGATION-PATTERNS-TEMPLATE.md read
117
- - [ ] LAYOUT-INDIVIDUAL-TEMPLATE.md read
118
- - [ ] Layout patterns identified
119
- - [ ] page-layouts.md generated
120
- - [ ] navigation-patterns.md generated
121
- - [ ] Individual {layout-name}-layout.md files generated (one per discovered layout)
122
-
123
- **Step 5: Style Conventions**
124
- - [ ] STYLE-SYSTEM-TEMPLATE.md read
125
- - [ ] TYPOGRAPHY-TEMPLATE.md read
126
- - [ ] SPACING-TEMPLATE.md read
127
- - [ ] Style conventions extracted
128
- - [ ] color-system.md generated
129
- - [ ] typography.md generated
130
- - [ ] spacing-system.md generated
131
-
132
- ### Documentation Phase (Step 6)
133
- - [ ] UI-STYLE-GUIDE-TEMPLATE.md read
134
- - [ ] ui-style-guide.md generated with links to all other documents
135
- - [ ] All 13 required documents exist (11 base + individual component/layout files)
136
- - [ ] Each component in component-library.md links to its individual file
137
- - [ ] Each layout in page-layouts.md links to its individual file
138
- - [ ] Document cross-references are valid
139
-
140
- ### Quality Checks
141
- - [ ] All content in specified language
142
- - [ ] File paths are correct and accessible
143
- - [ ] Code examples are syntactically correct
144
- - [ ] ASCII diagrams are clear and accurate
145
- - [ ] Individual component files follow template structure (Props table, Usage examples, etc.)
146
- - [ ] Individual layout files follow template structure (Regions table, Navigation, etc.)
147
- - [ ] Results reported with file counts
14
+ > **REQUIRED**: Before executing this workflow, read the XML workflow specification: speccrew-workspace/docs/rules/agentflow-spec.md
15
+ > Then read and execute the XML workflow in SKILL.xml block-by-block as the authoritative execution plan.