speccrew 0.5.9 → 0.5.11
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 +67 -0
- package/.speccrew/agents/speccrew-product-manager.md +69 -0
- package/.speccrew/agents/speccrew-system-designer.md +77 -0
- package/.speccrew/agents/speccrew-system-developer.md +311 -8
- package/.speccrew/agents/speccrew-task-worker.md +34 -0
- package/.speccrew/agents/speccrew-team-leader.md +84 -0
- package/.speccrew/agents/speccrew-test-manager.md +27 -0
- package/.speccrew/skills/{speccrew-dev-desktop → speccrew-dev-desktop-electron}/SKILL.md +38 -50
- package/.speccrew/skills/{speccrew-dev-desktop → speccrew-dev-desktop-electron}/templates/TASK-RECORD-TEMPLATE.md +14 -28
- package/.speccrew/skills/speccrew-dev-desktop-tauri/SKILL.md +341 -0
- package/.speccrew/skills/speccrew-dev-desktop-tauri/templates/TASK-RECORD-TEMPLATE.md +145 -0
- package/.speccrew/skills/speccrew-dev-review-backend/SKILL.md +212 -0
- package/.speccrew/skills/speccrew-dev-review-backend/templates/REVIEW-REPORT-TEMPLATE.md +94 -0
- package/.speccrew/skills/speccrew-dev-review-desktop/SKILL.md +181 -0
- package/.speccrew/skills/speccrew-dev-review-desktop/templates/REVIEW-REPORT-TEMPLATE.md +90 -0
- package/.speccrew/skills/speccrew-dev-review-frontend/SKILL.md +177 -0
- package/.speccrew/skills/speccrew-dev-review-frontend/templates/REVIEW-REPORT-TEMPLATE.md +83 -0
- package/.speccrew/skills/speccrew-dev-review-mobile/SKILL.md +181 -0
- package/.speccrew/skills/speccrew-dev-review-mobile/templates/REVIEW-REPORT-TEMPLATE.md +90 -0
- package/docs/GETTING-STARTED.ar.md +249 -176
- package/docs/GETTING-STARTED.bn.md +108 -412
- package/docs/GETTING-STARTED.bs.md +103 -407
- package/docs/GETTING-STARTED.da.md +267 -190
- package/docs/GETTING-STARTED.de.md +190 -115
- package/docs/GETTING-STARTED.el.md +245 -169
- package/docs/GETTING-STARTED.en.md +97 -22
- package/docs/GETTING-STARTED.es.md +179 -104
- package/docs/GETTING-STARTED.fr.md +191 -116
- package/docs/GETTING-STARTED.it.md +233 -156
- package/docs/GETTING-STARTED.ja.md +242 -167
- package/docs/GETTING-STARTED.ko.md +211 -136
- package/docs/GETTING-STARTED.md +97 -22
- package/docs/GETTING-STARTED.no.md +86 -417
- package/docs/GETTING-STARTED.pl.md +213 -135
- package/docs/GETTING-STARTED.pt-BR.md +94 -396
- package/docs/GETTING-STARTED.ru.md +241 -162
- package/docs/GETTING-STARTED.th.md +104 -405
- package/docs/GETTING-STARTED.tr.md +223 -144
- package/docs/GETTING-STARTED.uk.md +273 -194
- package/docs/GETTING-STARTED.vi.md +98 -399
- package/docs/GETTING-STARTED.zh-TW.md +213 -138
- package/lib/commands/init.js +18 -0
- package/package.json +1 -1
- package/.speccrew/skills/speccrew-dev-review/SKILL.md +0 -451
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# SpecCrew
|
|
1
|
+
# SpecCrew Hurtig Start Guide
|
|
2
2
|
|
|
3
3
|
<p align="center">
|
|
4
4
|
<a href="./GETTING-STARTED.md">简体中文</a> |
|
|
@@ -14,11 +14,11 @@
|
|
|
14
14
|
<a href="./GETTING-STARTED.ar.md">العربية</a>
|
|
15
15
|
</p>
|
|
16
16
|
|
|
17
|
-
Dette dokument hjælper dig med hurtigt at forstå, hvordan du bruger
|
|
17
|
+
Dette dokument hjælper dig med hurtigt at forstå, hvordan du bruger SpecCrews Agent-team til at fuldføre den komplette udvikling fra krav til levering efter standard engineering-processer.
|
|
18
18
|
|
|
19
19
|
---
|
|
20
20
|
|
|
21
|
-
## 1.
|
|
21
|
+
## 1. Forudsætninger
|
|
22
22
|
|
|
23
23
|
### Installer SpecCrew
|
|
24
24
|
|
|
@@ -26,7 +26,7 @@ Dette dokument hjælper dig med hurtigt at forstå, hvordan du bruger SpecCrew's
|
|
|
26
26
|
npm install -g speccrew
|
|
27
27
|
```
|
|
28
28
|
|
|
29
|
-
### Initialiser
|
|
29
|
+
### Initialiser Projekt
|
|
30
30
|
|
|
31
31
|
```bash
|
|
32
32
|
speccrew init --ide qoder
|
|
@@ -34,47 +34,122 @@ speccrew init --ide qoder
|
|
|
34
34
|
|
|
35
35
|
Understøttede IDE'er: `qoder`, `cursor`, `claude`, `codex`
|
|
36
36
|
|
|
37
|
-
### Mappestruktur
|
|
37
|
+
### Mappestruktur Efter Initialisering
|
|
38
38
|
|
|
39
39
|
```
|
|
40
40
|
.
|
|
41
41
|
├── .qoder/
|
|
42
42
|
│ ├── agents/ # Agent definitionsfiler
|
|
43
43
|
│ └── skills/ # Skill definitionsfiler
|
|
44
|
-
├── speccrew-workspace/ #
|
|
45
|
-
│ ├── docs/ #
|
|
46
|
-
│ ├── iterations/ #
|
|
44
|
+
├── speccrew-workspace/ # Workspace
|
|
45
|
+
│ ├── docs/ # Konfigurationer, regler, skabeloner, løsninger
|
|
46
|
+
│ ├── iterations/ # Nuværende kørende iterationer
|
|
47
47
|
│ ├── iteration-archives/ # Arkiverede iterationer
|
|
48
|
-
│ └── knowledges/ #
|
|
48
|
+
│ └── knowledges/ # Vidensbase
|
|
49
49
|
│ ├── base/ # Basisinformation (diagnoserapporter, teknisk gæld)
|
|
50
|
-
│ ├── bizs/ #
|
|
51
|
-
│ └── techs/ # Teknisk
|
|
50
|
+
│ ├── bizs/ # Forretningsvidensbase
|
|
51
|
+
│ └── techs/ # Teknisk vidensbase
|
|
52
52
|
```
|
|
53
53
|
|
|
54
|
-
### CLI
|
|
54
|
+
### CLI Kommando Hurtig Reference
|
|
55
55
|
|
|
56
56
|
| Kommando | Beskrivelse |
|
|
57
57
|
|------|------|
|
|
58
|
-
| `speccrew list` | List alle tilgængelige
|
|
59
|
-
| `speccrew doctor` |
|
|
60
|
-
| `speccrew update` | Opdater projektkonfiguration til
|
|
58
|
+
| `speccrew list` | List alle tilgængelige Agenter og Skills |
|
|
59
|
+
| `speccrew doctor` | Kontroller installationsintegritet |
|
|
60
|
+
| `speccrew update` | Opdater projektkonfiguration til nyeste version |
|
|
61
61
|
| `speccrew uninstall` | Afinstaller SpecCrew |
|
|
62
62
|
|
|
63
63
|
---
|
|
64
64
|
|
|
65
|
-
## 2.
|
|
65
|
+
## 2. Hurtig Start på 5 Minutter Efter Installation
|
|
66
66
|
|
|
67
|
-
|
|
67
|
+
Efter kørsel af `speccrew init`, følg disse trin for hurtigt at komme i arbejdstilstand:
|
|
68
|
+
|
|
69
|
+
### Trin 1: Vælg Din IDE
|
|
70
|
+
|
|
71
|
+
| IDE | Initialiseringskommando | Anvendelsesscenarie |
|
|
72
|
+
|-----|-----------|----------|
|
|
73
|
+
| **Qoder** (Anbefalet) | `speccrew init --ide qoder` | Fuld agent-orkestrering, parallelle workers |
|
|
74
|
+
| **Cursor** | `speccrew init --ide cursor` | Composer-baserede workflows |
|
|
75
|
+
| **Claude Code** | `speccrew init --ide claude` | CLI-først udvikling |
|
|
76
|
+
| **Codex** | `speccrew init --ide codex` | OpenAI økosystemintegration |
|
|
77
|
+
|
|
78
|
+
### Trin 2: Initialiser Vidensbase (Anbefalet)
|
|
79
|
+
|
|
80
|
+
For projekter med eksisterende kildekode anbefales det at initialisere vidensbasen først, så agenter forstår din kodebase:
|
|
81
|
+
|
|
82
|
+
```
|
|
83
|
+
@speccrew-team-leader initialiser teknisk vidensbase
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
Derefter:
|
|
87
|
+
|
|
88
|
+
```
|
|
89
|
+
@speccrew-team-leader initialiser forretningsvidensbase
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
### Trin 3: Start Din Første Opgave
|
|
93
|
+
|
|
94
|
+
```
|
|
95
|
+
@speccrew-product-manager Jeg har et nyt krav: [beskriv dit funktionskrav]
|
|
96
|
+
```
|
|
97
|
+
|
|
98
|
+
> **Tip**: Hvis du er usikker på hvad du skal gøre, sig blot `@speccrew-team-leader hjælp mig med at komme i gang` — Team Leader vil automatisk registrere din projektstatus og vejlede dig.
|
|
99
|
+
|
|
100
|
+
---
|
|
101
|
+
|
|
102
|
+
## 3. Hurtigt Beslutningstræ
|
|
103
|
+
|
|
104
|
+
Usikker på hvad du skal gøre? Find dit scenarie nedenfor:
|
|
105
|
+
|
|
106
|
+
- **Jeg har et nyt funktionskrav**
|
|
107
|
+
→ `@speccrew-product-manager Jeg har et nyt krav: [beskriv dit funktionskrav]`
|
|
108
|
+
|
|
109
|
+
- **Jeg vil scanne eksisterende projektviden**
|
|
110
|
+
→ `@speccrew-team-leader initialiser teknisk vidensbase`
|
|
111
|
+
→ Derefter: `@speccrew-team-leader initialiser forretningsvidensbase`
|
|
112
|
+
|
|
113
|
+
- **Jeg vil fortsætte tidligere arbejde**
|
|
114
|
+
→ `@speccrew-team-leader hvad er den aktuelle fremgang?`
|
|
115
|
+
|
|
116
|
+
- **Jeg vil kontrollere systemets sundhedstilstand**
|
|
117
|
+
→ Kør i terminal: `speccrew doctor`
|
|
118
|
+
|
|
119
|
+
- **Jeg er usikker på hvad jeg skal gøre**
|
|
120
|
+
→ `@speccrew-team-leader hjælp mig med at komme i gang`
|
|
121
|
+
→ Team Leader vil automatisk registrere din projektstatus og vejlede dig
|
|
122
|
+
|
|
123
|
+
---
|
|
124
|
+
|
|
125
|
+
## 4. Agent Hurtig Reference
|
|
126
|
+
|
|
127
|
+
| Rolle | Agent | Ansvarsområder | Kommandoeksempel |
|
|
128
|
+
|------|-------|-----------------|-----------------|
|
|
129
|
+
| Teamleder | `@speccrew-team-leader` | Projektnavigation, vidensbaseinitialisering, statuskontrol | "Hjælp mig med at komme i gang" |
|
|
130
|
+
| Produktchef | `@speccrew-product-manager` | Kravanalyse, PRD-generering | "Jeg har et nyt krav: ..." |
|
|
131
|
+
| Funktionsdesigner | `@speccrew-feature-designer` | Funktionsanalyse, specifikationsdesign, API-kontrakter | "Start funktionsdesign for iteration X" |
|
|
132
|
+
| Systemdesigner | `@speccrew-system-designer` | Arkitekturdesign, platformsdetaljeret design | "Start systemdesign for iteration X" |
|
|
133
|
+
| Systemudvikler | `@speccrew-system-developer` | Udviklingskoordinering, kodegenerering | "Start udvikling for iteration X" |
|
|
134
|
+
| Testchef | `@speccrew-test-manager` | Testplanlægning, casestudier, udførelse | "Start test for iteration X" |
|
|
135
|
+
|
|
136
|
+
> **Bemærk**: Du behøver ikke huske alle agenter. Bare tal med `@speccrew-team-leader`, og den vil rute din anmodning til den rigtige agent.
|
|
137
|
+
|
|
138
|
+
---
|
|
139
|
+
|
|
140
|
+
## 5. Workflow Oversigt
|
|
141
|
+
|
|
142
|
+
### Komplet Flowdiagram
|
|
68
143
|
|
|
69
144
|
```mermaid
|
|
70
145
|
flowchart LR
|
|
71
|
-
PRD[
|
|
72
|
-
FD --> SD[
|
|
73
|
-
SD --> DEV[
|
|
74
|
-
DEV --> TEST[
|
|
75
|
-
TEST --> ARCHIVE[
|
|
146
|
+
PRD[Trin 1<br/>Kravanalyse<br/>Product Manager] --> FD[Trin 2<br/>Funktionsdesign<br/>Feature Designer]
|
|
147
|
+
FD --> SD[Trin 3<br/>Systemdesign<br/>System Designer]
|
|
148
|
+
SD --> DEV[Trin 4<br/>Udvikling<br/>System Developer]
|
|
149
|
+
DEV --> TEST[Trin 5<br/>Systemtest<br/>Test Manager]
|
|
150
|
+
TEST --> ARCHIVE[Trin 6<br/>Arkivering]
|
|
76
151
|
|
|
77
|
-
KB[(
|
|
152
|
+
KB[(Vidensbase<br/>Gennem Hele Processen)] -.-> PRD
|
|
78
153
|
KB -.-> FD
|
|
79
154
|
KB -.-> SD
|
|
80
155
|
KB -.-> DEV
|
|
@@ -83,52 +158,52 @@ flowchart LR
|
|
|
83
158
|
|
|
84
159
|
### Kerneprincipper
|
|
85
160
|
|
|
86
|
-
1. **
|
|
87
|
-
2. **Checkpoint-bekræftelse**:
|
|
88
|
-
3. **
|
|
161
|
+
1. **Trinafhængigheder**: Hvert trins resultat er input til næste trin
|
|
162
|
+
2. **Checkpoint-bekræftelse**: Hvert trin har et bekræftelsespunkt, der kræver brugergodkendelse før fortsættelse til næste trin
|
|
163
|
+
3. **Vidensbase-drevet**: Vidensbasen kører gennem hele processen og giver kontekst til alle trin
|
|
89
164
|
|
|
90
165
|
---
|
|
91
166
|
|
|
92
|
-
##
|
|
167
|
+
## 6. Trin Nul: Vidensbaseinitialisering
|
|
93
168
|
|
|
94
|
-
Før du starter den formelle
|
|
169
|
+
Før du starter den formelle engineering-proces, skal du initialisere projektets vidensbase.
|
|
95
170
|
|
|
96
|
-
###
|
|
171
|
+
### 6.1 Teknisk Vidensbaseinitialisering
|
|
97
172
|
|
|
98
|
-
**
|
|
173
|
+
**Samtaleeksempel**:
|
|
99
174
|
```
|
|
100
|
-
@speccrew-team-leader initialiser teknisk
|
|
175
|
+
@speccrew-team-leader initialiser teknisk vidensbase
|
|
101
176
|
```
|
|
102
177
|
|
|
103
|
-
**
|
|
104
|
-
1.
|
|
178
|
+
**Tre-faset proces**:
|
|
179
|
+
1. Platformdetektering — Identificer tekniske platforme i projektet
|
|
105
180
|
2. Teknisk dokumentgeneration — Generer tekniske specifikationsdokumenter for hver platform
|
|
106
|
-
3.
|
|
181
|
+
3. Indexgeneration — Etabler vidensbaseindex
|
|
107
182
|
|
|
108
|
-
**
|
|
183
|
+
**Resultat**:
|
|
109
184
|
```
|
|
110
185
|
speccrew-workspace/knowledges/techs/{platform-id}/
|
|
111
|
-
├── tech-stack.md #
|
|
112
|
-
├── architecture.md #
|
|
113
|
-
├── dev-spec.md #
|
|
114
|
-
├── test-spec.md # Tests
|
|
115
|
-
└── INDEX.md #
|
|
186
|
+
├── tech-stack.md # Teknologi-stack-definition
|
|
187
|
+
├── architecture.md # Arkitekturkonventioner
|
|
188
|
+
├── dev-spec.md # Udviklingsspecifikationer
|
|
189
|
+
├── test-spec.md # Tests specifikationer
|
|
190
|
+
└── INDEX.md # Indexfil
|
|
116
191
|
```
|
|
117
192
|
|
|
118
|
-
###
|
|
193
|
+
### 6.2 Forretningsvidensbaseinitialisering
|
|
119
194
|
|
|
120
|
-
**
|
|
195
|
+
**Samtaleeksempel**:
|
|
121
196
|
```
|
|
122
|
-
@speccrew-team-leader initialiser
|
|
197
|
+
@speccrew-team-leader initialiser forretningsvidensbase
|
|
123
198
|
```
|
|
124
199
|
|
|
125
|
-
**
|
|
126
|
-
1.
|
|
200
|
+
**Fire-faset proces**:
|
|
201
|
+
1. Funktionsliste — Scan kode for at identificere alle funktioner
|
|
127
202
|
2. Funktionsanalyse — Analyser forretningslogik for hver funktion
|
|
128
203
|
3. Modulopsummering — Opsummer funktioner efter modul
|
|
129
204
|
4. Systemopsummering — Generer systemniveau forretningsoverblik
|
|
130
205
|
|
|
131
|
-
**
|
|
206
|
+
**Resultat**:
|
|
132
207
|
```
|
|
133
208
|
speccrew-workspace/knowledges/bizs/
|
|
134
209
|
├── {platform-type}/
|
|
@@ -139,140 +214,140 @@ speccrew-workspace/knowledges/bizs/
|
|
|
139
214
|
|
|
140
215
|
---
|
|
141
216
|
|
|
142
|
-
##
|
|
217
|
+
## 7. Trin-for-Trin Samtaleguide
|
|
143
218
|
|
|
144
|
-
###
|
|
219
|
+
### 7.1 Trin 1: Kravanalyse (Product Manager)
|
|
145
220
|
|
|
146
221
|
**Sådan startes**:
|
|
147
222
|
```
|
|
148
223
|
@speccrew-product-manager Jeg har et nyt krav: [beskriv dit krav]
|
|
149
224
|
```
|
|
150
225
|
|
|
151
|
-
**Agent
|
|
226
|
+
**Agent Workflow**:
|
|
152
227
|
1. Læs systemoversigt for at forstå eksisterende moduler
|
|
153
|
-
2. Analyser
|
|
228
|
+
2. Analyser brugers krav
|
|
154
229
|
3. Generer struktureret PRD-dokument
|
|
155
230
|
|
|
156
|
-
**
|
|
231
|
+
**Resultat**:
|
|
157
232
|
```
|
|
158
|
-
iterations/{
|
|
233
|
+
iterations/{nummer}-{type}-{navn}/01.product-requirement/
|
|
159
234
|
├── [feature-name]-prd.md # Produktkravdokument
|
|
160
235
|
└── [feature-name]-bizs-modeling.md # Forretningsmodellering (for komplekse krav)
|
|
161
236
|
```
|
|
162
237
|
|
|
163
238
|
**Bekræftelsespunkter**:
|
|
164
|
-
- [ ] Beskriver
|
|
165
|
-
- [ ] Er forretningsregler komplette
|
|
166
|
-
- [ ] Er integrationspunkter med eksisterende
|
|
167
|
-
- [ ] Er acceptkriterier målbare
|
|
239
|
+
- [ ] Beskriver kravet nøjagtigt brugerens hensigt?
|
|
240
|
+
- [ ] Er forretningsregler komplette?
|
|
241
|
+
- [ ] Er integrationspunkter med eksisterende systemer klare?
|
|
242
|
+
- [ ] Er acceptkriterier målbare?
|
|
168
243
|
|
|
169
244
|
---
|
|
170
245
|
|
|
171
|
-
###
|
|
246
|
+
### 7.2 Trin 2: Funktionsdesign (Feature Designer)
|
|
172
247
|
|
|
173
248
|
**Sådan startes**:
|
|
174
249
|
```
|
|
175
250
|
@speccrew-feature-designer start funktionsdesign
|
|
176
251
|
```
|
|
177
252
|
|
|
178
|
-
**Agent
|
|
179
|
-
1.
|
|
180
|
-
2. Indlæs
|
|
181
|
-
3. Generer funktionsdesign (
|
|
182
|
-
4.
|
|
253
|
+
**Agent Workflow**:
|
|
254
|
+
1. Automatisk lokalisering af bekræftet PRD-dokument
|
|
255
|
+
2. Indlæs forretningsvidensbase
|
|
256
|
+
3. Generer funktionsdesign (inklusive UI-wireframes, interaktionsflows, datadefinitioner, API-kontrakter)
|
|
257
|
+
4. For flere PRD'er, brug Task Worker til parallelt design
|
|
183
258
|
|
|
184
|
-
**
|
|
259
|
+
**Resultat**:
|
|
185
260
|
```
|
|
186
261
|
iterations/{iter}/02.feature-design/
|
|
187
|
-
└── [feature-name]-feature-spec.md #
|
|
262
|
+
└── [feature-name]-feature-spec.md # Funktionsdesign-dokument
|
|
188
263
|
```
|
|
189
264
|
|
|
190
265
|
**Bekræftelsespunkter**:
|
|
191
|
-
- [ ] Er alle brugerscenarier dækket
|
|
192
|
-
- [ ] Er
|
|
193
|
-
- [ ] Er datafeltdefinitioner komplette
|
|
194
|
-
- [ ] Er undtagelseshåndtering
|
|
266
|
+
- [ ] Er alle brugerscenarier dækket?
|
|
267
|
+
- [ ] Er interaktionsflows klare?
|
|
268
|
+
- [ ] Er datafeltdefinitioner komplette?
|
|
269
|
+
- [ ] Er undtagelseshåndtering omfattende?
|
|
195
270
|
|
|
196
271
|
---
|
|
197
272
|
|
|
198
|
-
###
|
|
273
|
+
### 7.3 Trin 3: Systemdesign (System Designer)
|
|
199
274
|
|
|
200
275
|
**Sådan startes**:
|
|
201
276
|
```
|
|
202
277
|
@speccrew-system-designer start systemdesign
|
|
203
278
|
```
|
|
204
279
|
|
|
205
|
-
**Agent
|
|
206
|
-
1.
|
|
207
|
-
2. Indlæs teknisk
|
|
208
|
-
3. **Checkpoint A**: Framework-evaluering — Analyser
|
|
280
|
+
**Agent Workflow**:
|
|
281
|
+
1. Lokaliser Feature Spec og API Contract
|
|
282
|
+
2. Indlæs teknisk vidensbase (teknologi-stack, arkitektur, specifikationer for hver platform)
|
|
283
|
+
3. **Checkpoint A**: Framework-evaluering — Analyser tekniske kløfter, anbefal nye frameworks (hvis nødvendigt), vent på brugerbekræftelse
|
|
209
284
|
4. Generer DESIGN-OVERVIEW.md
|
|
210
|
-
5.
|
|
211
|
-
6. **Checkpoint B**: Fælles bekræftelse — Vis
|
|
285
|
+
5. Brug Task Worker til parallelt at distribuere design for hver platform (frontend/backend/mobil/desktop)
|
|
286
|
+
6. **Checkpoint B**: Fælles bekræftelse — Vis resume af alle platformdesign, vent på brugerbekræftelse
|
|
212
287
|
|
|
213
|
-
**
|
|
288
|
+
**Resultat**:
|
|
214
289
|
```
|
|
215
290
|
iterations/{iter}/03.system-design/
|
|
216
291
|
├── DESIGN-OVERVIEW.md # Designoversigt
|
|
217
292
|
├── {platform-id}/
|
|
218
|
-
│ ├── INDEX.md #
|
|
219
|
-
│ └── {module}-design.md #
|
|
293
|
+
│ ├── INDEX.md # Platformdesignindex
|
|
294
|
+
│ └── {module}-design.md # Pseudokode-niveau moduldesign
|
|
220
295
|
```
|
|
221
296
|
|
|
222
297
|
**Bekræftelsespunkter**:
|
|
223
|
-
- [ ] Bruger pseudokoden faktisk
|
|
224
|
-
- [ ] Er API-kontrakter
|
|
225
|
-
- [ ] Er
|
|
298
|
+
- [ ] Bruger pseudokoden faktisk frameworks syntaks?
|
|
299
|
+
- [ ] Er cross-platform API-kontrakter konsistente?
|
|
300
|
+
- [ ] Er fejlhåndteringsstrategi ensartet?
|
|
226
301
|
|
|
227
302
|
---
|
|
228
303
|
|
|
229
|
-
###
|
|
304
|
+
### 7.4 Trin 4: Udvikling (System Developer)
|
|
230
305
|
|
|
231
306
|
**Sådan startes**:
|
|
232
307
|
```
|
|
233
308
|
@speccrew-system-developer start udvikling
|
|
234
309
|
```
|
|
235
310
|
|
|
236
|
-
**Agent
|
|
311
|
+
**Agent Workflow**:
|
|
237
312
|
1. Læs systemdesigndokumenter
|
|
238
|
-
2. Indlæs teknisk viden for hver
|
|
239
|
-
3. **Checkpoint A**:
|
|
240
|
-
4.
|
|
241
|
-
5.
|
|
242
|
-
6. Output
|
|
313
|
+
2. Indlæs teknisk viden for hver platform
|
|
314
|
+
3. **Checkpoint A**: Miljøforhåndskontrol — Kontroller runtime-versioner, afhængigheder, servicetilgængelighed; vent på brugerløsning hvis det fejler
|
|
315
|
+
4. Brug Task Worker til parallelt at distribuere udvikling for hver platform
|
|
316
|
+
5. Integrationskontrol: API-kontraktjustering, datakonsistens
|
|
317
|
+
6. Output leveringsrapport
|
|
243
318
|
|
|
244
|
-
**
|
|
319
|
+
**Resultat**:
|
|
245
320
|
```
|
|
246
|
-
# Kildekode skrives til projektets faktiske
|
|
321
|
+
# Kildekode skrives til projektets faktiske kildemappe
|
|
247
322
|
iterations/{iter}/04.development/
|
|
248
323
|
├── {platform-id}/
|
|
249
|
-
│ └── tasks/ #
|
|
324
|
+
│ └── tasks/ # Udviklingsopgaveregistre
|
|
250
325
|
└── delivery-report.md
|
|
251
326
|
```
|
|
252
327
|
|
|
253
328
|
**Bekræftelsespunkter**:
|
|
254
|
-
- [ ] Er miljøet klar
|
|
255
|
-
- [ ] Er integrationsproblemer inden for acceptabelt område
|
|
256
|
-
- [ ] Overholder
|
|
329
|
+
- [ ] Er miljøet klar?
|
|
330
|
+
- [ ] Er integrationsproblemer inden for acceptabelt område?
|
|
331
|
+
- [ ] Overholder koden udviklingsspecifikationerne?
|
|
257
332
|
|
|
258
333
|
---
|
|
259
334
|
|
|
260
|
-
###
|
|
335
|
+
### 7.5 Trin 5: Systemtest (Test Manager)
|
|
261
336
|
|
|
262
337
|
**Sådan startes**:
|
|
263
338
|
```
|
|
264
339
|
@speccrew-test-manager start test
|
|
265
340
|
```
|
|
266
341
|
|
|
267
|
-
**
|
|
342
|
+
**Tre-faset testproces**:
|
|
268
343
|
|
|
269
344
|
| Fase | Beskrivelse | Checkpoint |
|
|
270
|
-
|
|
271
|
-
|
|
|
272
|
-
|
|
|
273
|
-
| Testudførelse og
|
|
345
|
+
|-------|-------------|------------|
|
|
346
|
+
| Testcasedesign | Generer testcases baseret på PRD og Feature Spec | A: Vis testcase-dækningsstatistik og sporbarhedsmatrix, vent på brugerbekræftelse af tilstrækkelig dækning |
|
|
347
|
+
| Testkodegenerering | Generer eksekverbar testkode | B: Vis genererede testfiler og casemapping, vent på brugerbekræftelse |
|
|
348
|
+
| Testudførelse og Bug-rapportering | Kør automatisk tests og generer rapporter | Ingen (automatisk udførelse) |
|
|
274
349
|
|
|
275
|
-
**
|
|
350
|
+
**Resultat**:
|
|
276
351
|
```
|
|
277
352
|
iterations/{iter}/05.system-test/
|
|
278
353
|
├── cases/
|
|
@@ -282,23 +357,23 @@ iterations/{iter}/05.system-test/
|
|
|
282
357
|
├── reports/
|
|
283
358
|
│ └── test-report-{date}.md # Testrapport
|
|
284
359
|
└── bugs/
|
|
285
|
-
└── BUG-{id}-{title}.md # Bug-
|
|
360
|
+
└── BUG-{id}-{title}.md # Bug-rapporter (én fil pr. bug)
|
|
286
361
|
```
|
|
287
362
|
|
|
288
363
|
**Bekræftelsespunkter**:
|
|
289
|
-
- [ ] Er
|
|
290
|
-
- [ ] Er
|
|
291
|
-
- [ ] Er bug-
|
|
364
|
+
- [ ] Er casedækning komplet?
|
|
365
|
+
- [ ] Er testkode kørbar?
|
|
366
|
+
- [ ] Er bug-alvorlighedsvurdering præcis?
|
|
292
367
|
|
|
293
368
|
---
|
|
294
369
|
|
|
295
|
-
###
|
|
370
|
+
### 7.6 Trin 6: Arkivering
|
|
296
371
|
|
|
297
|
-
|
|
372
|
+
Iterationer arkiveres automatisk efter fuldførelse:
|
|
298
373
|
|
|
299
374
|
```
|
|
300
375
|
speccrew-workspace/iteration-archives/
|
|
301
|
-
└── {
|
|
376
|
+
└── {nummer}-{type}-{navn}-{dato}/
|
|
302
377
|
├── 01.product-requirement/
|
|
303
378
|
├── 02.feature-design/
|
|
304
379
|
├── 03.system-design/
|
|
@@ -308,11 +383,11 @@ speccrew-workspace/iteration-archives/
|
|
|
308
383
|
|
|
309
384
|
---
|
|
310
385
|
|
|
311
|
-
##
|
|
386
|
+
## 8. Vidensbase Oversigt
|
|
312
387
|
|
|
313
|
-
###
|
|
388
|
+
### 8.1 Forretningsvidensbase (bizs)
|
|
314
389
|
|
|
315
|
-
**Formål**: Gem projektets forretningsfunktionsbeskrivelser,
|
|
390
|
+
**Formål**: Gem projektets forretningsfunktionsbeskrivelser, modulopdelinger, API-karakteristika
|
|
316
391
|
|
|
317
392
|
**Mappestruktur**:
|
|
318
393
|
```
|
|
@@ -323,11 +398,11 @@ knowledges/bizs/
|
|
|
323
398
|
└── system-overview.md
|
|
324
399
|
```
|
|
325
400
|
|
|
326
|
-
**
|
|
401
|
+
**Anvendelsesscenarier**: Product Manager, Feature Designer
|
|
327
402
|
|
|
328
|
-
###
|
|
403
|
+
### 8.2 Teknisk Vidensbase (techs)
|
|
329
404
|
|
|
330
|
-
**Formål**: Gem projektets
|
|
405
|
+
**Formål**: Gem projektets teknologi-stack, arkitekturkonventioner, udviklingsspecifikationer, tests specifikationer
|
|
331
406
|
|
|
332
407
|
**Mappestruktur**:
|
|
333
408
|
```
|
|
@@ -339,87 +414,87 @@ knowledges/techs/{platform-id}/
|
|
|
339
414
|
└── INDEX.md
|
|
340
415
|
```
|
|
341
416
|
|
|
342
|
-
**
|
|
417
|
+
**Anvendelsesscenarier**: System Designer, System Developer, Test Manager
|
|
343
418
|
|
|
344
419
|
---
|
|
345
420
|
|
|
346
|
-
##
|
|
421
|
+
## 9. Workflow Fremskridtshåndtering
|
|
347
422
|
|
|
348
|
-
|
|
423
|
+
SpecCrew virtuelle team følger en streng fase-gating-mekanisme, hvor hver fase skal bekræftes af brugeren, før den går videre til næste. Den understøtter også genoptagelig udførelse — når den genstartes efter afbrydelse, fortsætter den automatisk fra hvor den slap.
|
|
349
424
|
|
|
350
|
-
###
|
|
425
|
+
### 9.1 Tre-lags Fremskridtsfiler
|
|
351
426
|
|
|
352
|
-
|
|
427
|
+
Workflowet vedligeholder automatisk tre typer JSON-fremskridtsfiler, placeret i iterationsmappen:
|
|
353
428
|
|
|
354
429
|
| Fil | Placering | Formål |
|
|
355
430
|
|------|----------|---------|
|
|
356
431
|
| `WORKFLOW-PROGRESS.json` | `iterations/{iter}/` | Registrerer status for hver pipeline-fase |
|
|
357
|
-
| `.checkpoints.json` | Under hver fasemappe | Registrerer
|
|
358
|
-
| `DISPATCH-PROGRESS.json` | Under hver fasemappe | Registrerer
|
|
432
|
+
| `.checkpoints.json` | Under hver fasemappe | Registrerer brugercheckpoint-bekræftelsesstatus |
|
|
433
|
+
| `DISPATCH-PROGRESS.json` | Under hver fasemappe | Registrerer element-for-element fremskridt for parallelle opgaver (multi-platform/multi-modul) |
|
|
359
434
|
|
|
360
|
-
###
|
|
435
|
+
### 9.2 Fasestatus Flow
|
|
361
436
|
|
|
362
|
-
Hver fase følger
|
|
437
|
+
Hver fase følger denne status flow:
|
|
363
438
|
|
|
364
439
|
```
|
|
365
440
|
pending → in_progress → completed → confirmed
|
|
366
441
|
```
|
|
367
442
|
|
|
368
|
-
- **pending**:
|
|
369
|
-
- **in_progress**:
|
|
370
|
-
- **completed**: Agent-udførelse
|
|
371
|
-
- **confirmed**: Bruger bekræftet
|
|
443
|
+
- **pending**: Endnu ikke startet
|
|
444
|
+
- **in_progress**: Under udførelse
|
|
445
|
+
- **completed**: Agent-udførelse fuldført, venter på brugerbekræftelse
|
|
446
|
+
- **confirmed**: Bruger bekræftet via endeligt checkpoint, næste fase kan starte
|
|
372
447
|
|
|
373
|
-
###
|
|
448
|
+
### 9.3 Genoptagelig Udførelse
|
|
374
449
|
|
|
375
|
-
Når en Agent
|
|
450
|
+
Når du genstarter en Agent for en fase:
|
|
376
451
|
|
|
377
|
-
1. **Automatisk
|
|
378
|
-
2. **Checkpoint-
|
|
379
|
-
3. **
|
|
452
|
+
1. **Automatisk upstream-kontrol**: Verificerer om forrige fase er bekræftet, blokerer og prompter hvis ikke
|
|
453
|
+
2. **Checkpoint-genopretning**: Læser `.checkpoints.json`, springer beståede checkpoints over, fortsætter fra sidste afbrydelsespunkt
|
|
454
|
+
3. **Parallelle opgave-genopretning**: Læser `DISPATCH-PROGRESS.json`, genudfører kun opgaver med `pending` eller `failed` status, springer `completed` opgaver over
|
|
380
455
|
|
|
381
|
-
###
|
|
456
|
+
### 9.4 Se Nuværende Fremskridt
|
|
382
457
|
|
|
383
|
-
|
|
458
|
+
Se pipeline-panoramastatus via Team Leader Agent:
|
|
384
459
|
|
|
385
460
|
```
|
|
386
|
-
@speccrew-team-leader
|
|
461
|
+
@speccrew-team-leader se nuværende iterationsfremskridt
|
|
387
462
|
```
|
|
388
463
|
|
|
389
|
-
Team Leader vil læse
|
|
464
|
+
Team Leader vil læse fremskridtsfilerne og vise en statusoversigt svarende til:
|
|
390
465
|
|
|
391
466
|
```
|
|
392
467
|
Pipeline Status: i001-user-management
|
|
393
|
-
01 PRD: ✅
|
|
394
|
-
02 Feature Design: 🔄
|
|
395
|
-
03 System Design: ⏳
|
|
396
|
-
04 Development: ⏳
|
|
397
|
-
05 System Test: ⏳
|
|
468
|
+
01 PRD: ✅ Confirmed
|
|
469
|
+
02 Feature Design: 🔄 In Progress (Checkpoint A passed)
|
|
470
|
+
03 System Design: ⏳ Pending
|
|
471
|
+
04 Development: ⏳ Pending
|
|
472
|
+
05 System Test: ⏳ Pending
|
|
398
473
|
```
|
|
399
474
|
|
|
400
|
-
###
|
|
475
|
+
### 9.5 Bagudkompatibilitet
|
|
401
476
|
|
|
402
|
-
|
|
477
|
+
Fremskridtsfil-mekanismen er fuldt bagudkompatibel — hvis fremskridtsfiler ikke eksisterer (f.eks. i ældre projekter eller nye iterationer), vil alle Agenter køre normalt ifølge den oprindelige logik.
|
|
403
478
|
|
|
404
479
|
---
|
|
405
480
|
|
|
406
|
-
##
|
|
481
|
+
## 10. Ofte Stillede Spørgsmål (FAQ)
|
|
407
482
|
|
|
408
|
-
###
|
|
483
|
+
### S1: Hvad gør jeg hvis Agenten ikke fungerer som forventet?
|
|
409
484
|
|
|
410
|
-
1. Kør `speccrew doctor` for at
|
|
411
|
-
2. Bekræft at
|
|
412
|
-
3. Bekræft at
|
|
485
|
+
1. Kør `speccrew doctor` for at kontrollere installationsintegritet
|
|
486
|
+
2. Bekræft at vidensbasen er blevet initialiseret
|
|
487
|
+
3. Bekræft at resultatet fra forrige fase findes i den aktuelle iterationsmappe
|
|
413
488
|
|
|
414
|
-
###
|
|
489
|
+
### S2: Hvordan springer jeg en fase over?
|
|
415
490
|
|
|
416
|
-
**Anbefales ikke
|
|
491
|
+
**Anbefales ikke** — Hver fases output er input til næste fase.
|
|
417
492
|
|
|
418
|
-
Hvis
|
|
493
|
+
Hvis du skal springe over, skal du manuelt forberede inputdokumentet for den tilsvarende fase og sikre, at det overholder formatspecifikationerne.
|
|
419
494
|
|
|
420
|
-
###
|
|
495
|
+
### S3: Hvordan håndterer jeg flere parallelle krav?
|
|
421
496
|
|
|
422
|
-
Opret
|
|
497
|
+
Opret uafhængige iterationsmapper for hvert krav:
|
|
423
498
|
```
|
|
424
499
|
iterations/
|
|
425
500
|
├── 001-feature-xxx/
|
|
@@ -427,63 +502,65 @@ iterations/
|
|
|
427
502
|
└── 003-feature-zzz/
|
|
428
503
|
```
|
|
429
504
|
|
|
430
|
-
Hver iteration er
|
|
505
|
+
Hver iteration er fuldstændigt isoleret og påvirker ikke andre.
|
|
431
506
|
|
|
432
|
-
###
|
|
507
|
+
### S4: Hvordan opdaterer jeg SpecCrew-versionen?
|
|
433
508
|
|
|
434
|
-
Opdatering
|
|
509
|
+
Opdatering kræver to trin:
|
|
435
510
|
|
|
436
511
|
```bash
|
|
437
512
|
# Trin 1: Opdater det globale CLI-værktøj
|
|
438
513
|
npm install -g speccrew@latest
|
|
439
514
|
|
|
440
|
-
# Trin 2: Synkroniser Agenter og Skills i
|
|
515
|
+
# Trin 2: Synkroniser Agenter og Skills i din projektmappe
|
|
441
516
|
cd /path/to/your-project
|
|
442
517
|
speccrew update
|
|
443
518
|
```
|
|
444
519
|
|
|
445
|
-
- `npm install -g speccrew@latest`: Opdaterer
|
|
446
|
-
- `speccrew update`: Synkroniserer
|
|
447
|
-
- `speccrew update --ide cursor`: Opdaterer kun
|
|
520
|
+
- `npm install -g speccrew@latest`: Opdaterer CLI-værktøjet selv (nye versioner kan indeholde nye Agent/Skill-definitioner, fejlrettelser osv.)
|
|
521
|
+
- `speccrew update`: Synkroniserer Agent- og Skill-definitions filer i dit projekt til nyeste version
|
|
522
|
+
- `speccrew update --ide cursor`: Opdaterer kun konfiguration for specifik IDE
|
|
448
523
|
|
|
449
|
-
> **Bemærk**: Begge trin
|
|
524
|
+
> **Bemærk**: Begge trin er påkrævet. Kun at køre `speccrew update` vil ikke opdatere CLI-værktøjet selv; kun at køre `npm install` vil ikke opdatere projektfiler.
|
|
450
525
|
|
|
451
|
-
###
|
|
526
|
+
### S5: `speccrew update` viser ny version tilgængelig men `npm install -g speccrew@latest` installerer stadig den gamle version?
|
|
452
527
|
|
|
453
|
-
|
|
528
|
+
Dette skyldes normalt npm-cache. Løsning:
|
|
454
529
|
|
|
455
530
|
```bash
|
|
531
|
+
# Ryd npm-cache og geninstaller
|
|
456
532
|
npm cache clean --force
|
|
457
533
|
npm install -g speccrew@latest
|
|
534
|
+
|
|
535
|
+
# Verificer version
|
|
458
536
|
npm list -g speccrew
|
|
459
537
|
```
|
|
460
538
|
|
|
461
|
-
Hvis det stadig ikke virker,
|
|
539
|
+
Hvis det stadig ikke virker, prøv at installere med specifikt versionsnummer:
|
|
462
540
|
```bash
|
|
463
541
|
npm install -g speccrew@0.5.6
|
|
464
542
|
```
|
|
465
543
|
|
|
466
|
-
###
|
|
544
|
+
### S6: Hvordan ser jeg historiske iterationer?
|
|
467
545
|
|
|
468
|
-
Efter arkivering, se i `speccrew-workspace/iteration-archives/`, organiseret efter `{
|
|
546
|
+
Efter arkivering, se i `speccrew-workspace/iteration-archives/`, organiseret efter `{nummer}-{type}-{navn}-{dato}/` format.
|
|
469
547
|
|
|
470
|
-
###
|
|
548
|
+
### S7: Skal vidensbasen opdateres regelmæssigt?
|
|
471
549
|
|
|
472
|
-
|
|
473
|
-
-
|
|
474
|
-
-
|
|
475
|
-
-
|
|
550
|
+
Geninitialisering er påkrævet i følgende situationer:
|
|
551
|
+
- Større ændringer i projektstruktur
|
|
552
|
+
- Teknologi-stack-opgradering eller udskiftning
|
|
553
|
+
- Tilføjelse/fjernelse af forretningsmoduler
|
|
476
554
|
|
|
477
555
|
---
|
|
478
556
|
|
|
479
|
-
##
|
|
480
|
-
|
|
481
|
-
### Agent Start Hurtigreferencetabel
|
|
557
|
+
## 11. Hurtig Reference
|
|
482
558
|
|
|
483
|
-
|
|
484
|
-
|------|-------|----------|
|
|
559
|
+
### Agent Start Hurtig Reference
|
|
485
560
|
|
|
486
|
-
|
|
|
561
|
+
| Fase | Agent | Start Samtale |
|
|
562
|
+
|-------|-------|-------------------|
|
|
563
|
+
| Initialisering | Team Leader | `@speccrew-team-leader initialiser teknisk vidensbase` |
|
|
487
564
|
| Kravanalyse | Product Manager | `@speccrew-product-manager Jeg har et nyt krav: [beskrivelse]` |
|
|
488
565
|
| Funktionsdesign | Feature Designer | `@speccrew-feature-designer start funktionsdesign` |
|
|
489
566
|
| Systemdesign | System Designer | `@speccrew-system-designer start systemdesign` |
|
|
@@ -492,18 +569,18 @@ Følgende situationer kræver re-initialisering:
|
|
|
492
569
|
|
|
493
570
|
### Checkpoint Tjekliste
|
|
494
571
|
|
|
495
|
-
| Fase | Antal Checkpoints |
|
|
496
|
-
|
|
497
|
-
| Kravanalyse | 1 | Kravnøjagtighed,
|
|
498
|
-
| Funktionsdesign | 1 | Scenariedækning, interaktionsklarhed,
|
|
499
|
-
| Systemdesign | 2 | A: Framework-evaluering; B: Pseudokode syntaks, cross-
|
|
500
|
-
| Udvikling | 1 | A:
|
|
501
|
-
| Systemtest | 2 | A: Casedækning; B: Testkode
|
|
572
|
+
| Fase | Antal Checkpoints | Vigtige Kontrolpunkter |
|
|
573
|
+
|-------|----------------------|-----------------|
|
|
574
|
+
| Kravanalyse | 1 | Kravnøjagtighed, forretningsregelkomplethed, acceptkriteriemålbarhed |
|
|
575
|
+
| Funktionsdesign | 1 | Scenariedækning, interaktionsklarhed, datakomplethed, undtagelseshåndtering |
|
|
576
|
+
| Systemdesign | 2 | A: Framework-evaluering; B: Pseudokode syntaks, cross-platform konsistens, fejlhåndtering |
|
|
577
|
+
| Udvikling | 1 | A: Miljøklarhed, integrationsproblemer, kodespecifikationer |
|
|
578
|
+
| Systemtest | 2 | A: Casedækning; B: Testkode-kørbarhed |
|
|
502
579
|
|
|
503
|
-
###
|
|
580
|
+
### Resultatsti Hurtig Reference
|
|
504
581
|
|
|
505
|
-
| Fase | Output
|
|
506
|
-
|
|
582
|
+
| Fase | Output-mappe | Filformat |
|
|
583
|
+
|-------|-----------------|-------------|
|
|
507
584
|
| Kravanalyse | `iterations/{iter}/01.product-requirement/` | `[name]-prd.md`, `[name]-bizs-modeling.md` |
|
|
508
585
|
| Funktionsdesign | `iterations/{iter}/02.feature-design/` | `[name]-feature-spec.md` |
|
|
509
586
|
| Systemdesign | `iterations/{iter}/03.system-design/` | `DESIGN-OVERVIEW.md`, `{platform}/INDEX.md`, `{platform}/{module}-design.md` |
|
|
@@ -513,8 +590,8 @@ Følgende situationer kræver re-initialisering:
|
|
|
513
590
|
|
|
514
591
|
---
|
|
515
592
|
|
|
516
|
-
## Næste
|
|
593
|
+
## Næste Trin
|
|
517
594
|
|
|
518
595
|
1. Kør `speccrew init --ide qoder` for at initialisere dit projekt
|
|
519
|
-
2. Udfør
|
|
520
|
-
3.
|
|
596
|
+
2. Udfør Trin Nul: Vidensbaseinitialisering
|
|
597
|
+
3. Gå frem fase for fase ifølge workflowet, nyd den specifikationsdrevne udviklingsoplevelse!
|