speccrew 0.7.74 → 0.7.76
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.
- package/.speccrew/agents/speccrew-feature-designer.md +4 -647
- package/.speccrew/agents/speccrew-product-manager.md +5 -480
- package/.speccrew/agents/speccrew-system-deployer.md +6 -457
- package/.speccrew/agents/speccrew-system-developer.md +9 -913
- package/.speccrew/agents/speccrew-test-manager.md +403 -1112
- package/.speccrew/skills/speccrew-agentflow-manager/SKILL.md +6 -149
- package/.speccrew/skills/speccrew-deploy-build/SKILL.md +2 -59
- package/.speccrew/skills/speccrew-deploy-migrate/SKILL.md +2 -64
- package/.speccrew/skills/speccrew-deploy-smoke-test/SKILL.md +2 -75
- package/.speccrew/skills/speccrew-deploy-startup/SKILL.md +2 -70
- package/.speccrew/skills/speccrew-dev-backend/SKILL.md +2 -381
- package/.speccrew/skills/speccrew-dev-desktop-electron/SKILL.md +2 -369
- package/.speccrew/skills/speccrew-dev-desktop-tauri/SKILL.md +2 -362
- package/.speccrew/skills/speccrew-dev-frontend/SKILL.md +2 -304
- package/.speccrew/skills/speccrew-dev-mobile/SKILL.md +2 -294
- package/.speccrew/skills/speccrew-dev-review-backend/SKILL.md +2 -204
- package/.speccrew/skills/speccrew-dev-review-desktop/SKILL.md +2 -173
- package/.speccrew/skills/speccrew-dev-review-frontend/SKILL.md +2 -169
- package/.speccrew/skills/speccrew-dev-review-mobile/SKILL.md +2 -173
- package/.speccrew/skills/speccrew-fd-api-contract/SKILL.md +2 -251
- package/.speccrew/skills/speccrew-fd-feature-analyze/SKILL.md +2 -254
- package/.speccrew/skills/speccrew-fd-feature-design/SKILL.md +2 -748
- package/.speccrew/skills/speccrew-feature-designer-orchestration/SKILL.md +6 -105
- package/.speccrew/skills/speccrew-get-timestamp/SKILL.md +6 -33
- package/.speccrew/skills/speccrew-knowledge-bizs-api-analyze/SKILL.md +3 -138
- package/.speccrew/skills/speccrew-knowledge-bizs-api-graph/SKILL.md +3 -283
- package/.speccrew/skills/speccrew-knowledge-bizs-dispatch/SKILL.md +3 -1014
- package/.speccrew/skills/speccrew-knowledge-bizs-identify-entries/SKILL.md +4 -343
- package/.speccrew/skills/speccrew-knowledge-bizs-init-features/SKILL.md +4 -235
- package/.speccrew/skills/speccrew-knowledge-bizs-module-classify/SKILL.md +6 -72
- package/.speccrew/skills/speccrew-knowledge-bizs-ui-analyze/SKILL.md +3 -534
- package/.speccrew/skills/speccrew-knowledge-bizs-ui-graph/SKILL.md +3 -432
- package/.speccrew/skills/speccrew-knowledge-bizs-ui-style-extract/SKILL.md +4 -391
- package/.speccrew/skills/speccrew-knowledge-graph-query/SKILL.md +3 -98
- package/.speccrew/skills/speccrew-knowledge-graph-write/SKILL.md +3 -92
- package/.speccrew/skills/speccrew-knowledge-module-summarize/SKILL.md +3 -181
- package/.speccrew/skills/speccrew-knowledge-system-summarize/SKILL.md +3 -148
- package/.speccrew/skills/speccrew-knowledge-techs-dispatch/SKILL.md +3 -330
- package/.speccrew/skills/speccrew-knowledge-techs-generate/SKILL.md +6 -159
- package/.speccrew/skills/speccrew-knowledge-techs-generate-conventions/SKILL.md +3 -142
- package/.speccrew/skills/speccrew-knowledge-techs-generate-quality/SKILL.md +3 -568
- package/.speccrew/skills/speccrew-knowledge-techs-generate-ui-style/SKILL.md +3 -180
- package/.speccrew/skills/speccrew-knowledge-techs-index/SKILL.md +3 -154
- package/.speccrew/skills/speccrew-knowledge-techs-init/SKILL.md +3 -176
- package/.speccrew/skills/speccrew-knowledge-techs-ui-analyze/SKILL.md +3 -135
- package/.speccrew/skills/speccrew-pm-knowledge-detector/SKILL.md +4 -88
- package/.speccrew/skills/speccrew-pm-module-initializer/SKILL.md +4 -178
- package/.speccrew/skills/speccrew-pm-module-matcher/SKILL.md +3 -102
- package/.speccrew/skills/speccrew-pm-phase0-init/SKILL.md +5 -78
- package/.speccrew/skills/speccrew-pm-phase1-knowledge-check/SKILL.md +5 -85
- package/.speccrew/skills/speccrew-pm-phase2-complexity-assess/SKILL.md +4 -100
- package/.speccrew/skills/speccrew-pm-phase5-subprd-dispatch/SKILL.md +14 -106
- package/.speccrew/skills/speccrew-pm-phase6-verify-confirm/SKILL.md +7 -84
- package/.speccrew/skills/speccrew-pm-requirement-analysis/SKILL.md +6 -66
- package/.speccrew/skills/speccrew-pm-requirement-assess/SKILL.md +4 -96
- package/.speccrew/skills/speccrew-pm-requirement-clarify/SKILL.md +4 -131
- package/.speccrew/skills/speccrew-pm-requirement-model/SKILL.md +6 -79
- package/.speccrew/skills/speccrew-pm-requirement-simple/SKILL.md +4 -76
- package/.speccrew/skills/speccrew-pm-sub-prd-generate/SKILL.md +3 -281
- package/.speccrew/skills/speccrew-product-manager-orchestration/SKILL.md +6 -165
- package/.speccrew/skills/speccrew-system-deployer-orchestration/SKILL.md +6 -79
- package/.speccrew/skills/speccrew-system-designer-orchestration/SKILL.md +2 -35
- package/.speccrew/skills/speccrew-system-developer-orchestration/SKILL.md +6 -98
- package/.speccrew/skills/speccrew-task-worker-execution/SKILL.md +6 -94
- package/.speccrew/skills/speccrew-team-leader-routing/SKILL.md +6 -79
- package/.speccrew/skills/speccrew-test-case-design/SKILL.md +2 -58
- package/.speccrew/skills/speccrew-test-code-gen/SKILL.md +2 -61
- package/.speccrew/skills/speccrew-test-manager-orchestration/SKILL.md +6 -94
- package/.speccrew/skills/speccrew-test-reporter/SKILL.md +2 -102
- package/.speccrew/skills/speccrew-test-runner/SKILL.md +3 -121
- 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
|
-
#
|
|
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
|
-
>
|
|
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
|
-
#
|
|
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
|
-
>
|
|
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
|
-
#
|
|
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
|
-
>
|
|
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
|
-
#
|
|
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
|
-
>
|
|
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.
|