speccrew 0.7.44 → 0.7.46
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-team-leader.md +6 -6
- package/README.ar.md +5 -17
- package/README.de.md +5 -17
- package/README.en.md +5 -17
- package/README.es.md +5 -17
- package/README.fr.md +5 -17
- package/README.hi.md +384 -0
- package/README.ja.md +5 -17
- package/README.md +5 -17
- package/README.pt-BR.md +5 -17
- package/README.ru.md +5 -17
- package/docs/GETTING-STARTED.ar.md +39 -40
- package/docs/GETTING-STARTED.de.md +39 -40
- package/docs/GETTING-STARTED.en.md +39 -40
- package/docs/GETTING-STARTED.es.md +39 -40
- package/docs/GETTING-STARTED.fr.md +39 -40
- package/docs/GETTING-STARTED.hi.md +636 -0
- package/docs/GETTING-STARTED.ja.md +39 -40
- package/docs/GETTING-STARTED.md +39 -40
- package/docs/GETTING-STARTED.pt-BR.md +25 -26
- package/docs/GETTING-STARTED.ru.md +37 -38
- package/lib/commands/init.js +3 -3
- package/package.json +1 -1
- package/workspace-template/scripts/update-progress.js +5 -1
- package/README.bn.md +0 -174
- package/README.bs.md +0 -394
- package/README.da.md +0 -394
- package/README.el.md +0 -174
- package/README.it.md +0 -394
- package/README.ko.md +0 -394
- package/README.no.md +0 -394
- package/README.pl.md +0 -394
- package/README.th.md +0 -311
- package/README.tr.md +0 -306
- package/README.uk.md +0 -306
- package/README.vi.md +0 -174
- package/README.zh-TW.md +0 -394
- package/docs/GETTING-STARTED.bn.md +0 -219
- package/docs/GETTING-STARTED.bs.md +0 -219
- package/docs/GETTING-STARTED.da.md +0 -637
- package/docs/GETTING-STARTED.el.md +0 -633
- package/docs/GETTING-STARTED.it.md +0 -639
- package/docs/GETTING-STARTED.ko.md +0 -639
- package/docs/GETTING-STARTED.no.md +0 -563
- package/docs/GETTING-STARTED.pl.md +0 -597
- package/docs/GETTING-STARTED.th.md +0 -219
- package/docs/GETTING-STARTED.tr.md +0 -597
- package/docs/GETTING-STARTED.uk.md +0 -597
- package/docs/GETTING-STARTED.vi.md +0 -217
- package/docs/GETTING-STARTED.zh-TW.md +0 -639
|
@@ -1,637 +0,0 @@
|
|
|
1
|
-
# SpecCrew Hurtig Start Guide
|
|
2
|
-
|
|
3
|
-
<p align="center">
|
|
4
|
-
<a href="./GETTING-STARTED.md">简体中文</a> |
|
|
5
|
-
<a href="./GETTING-STARTED.zh-TW.md">繁體中文</a> |
|
|
6
|
-
<a href="./GETTING-STARTED.en.md">English</a> |
|
|
7
|
-
<a href="./GETTING-STARTED.ko.md">한국어</a> |
|
|
8
|
-
<a href="./GETTING-STARTED.de.md">Deutsch</a> |
|
|
9
|
-
<a href="./GETTING-STARTED.es.md">Español</a> |
|
|
10
|
-
<a href="./GETTING-STARTED.fr.md">Français</a> |
|
|
11
|
-
<a href="./GETTING-STARTED.it.md">Italiano</a> |
|
|
12
|
-
<a href="./GETTING-STARTED.da.md">Dansk</a> |
|
|
13
|
-
<a href="./GETTING-STARTED.ja.md">日本語</a> |
|
|
14
|
-
<a href="./GETTING-STARTED.ar.md">العربية</a>
|
|
15
|
-
</p>
|
|
16
|
-
|
|
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
|
-
|
|
19
|
-
---
|
|
20
|
-
|
|
21
|
-
## 1. Forudsætninger
|
|
22
|
-
|
|
23
|
-
### Installer SpecCrew
|
|
24
|
-
|
|
25
|
-
```bash
|
|
26
|
-
npm install -g speccrew
|
|
27
|
-
```
|
|
28
|
-
|
|
29
|
-
### Initialiser Projekt
|
|
30
|
-
|
|
31
|
-
```bash
|
|
32
|
-
speccrew init --ide qoder
|
|
33
|
-
```
|
|
34
|
-
|
|
35
|
-
Understøttede IDE'er: `qoder`, `cursor`, `claude`, `codex`
|
|
36
|
-
|
|
37
|
-
### Mappestruktur Efter Initialisering
|
|
38
|
-
|
|
39
|
-
```
|
|
40
|
-
.
|
|
41
|
-
├── .qoder/
|
|
42
|
-
│ ├── agents/ # Agent definitionsfiler
|
|
43
|
-
│ └── skills/ # Skill definitionsfiler
|
|
44
|
-
├── speccrew-workspace/ # Workspace
|
|
45
|
-
│ ├── docs/ # Konfigurationer, regler, skabeloner, løsninger
|
|
46
|
-
│ ├── iterations/ # Nuværende kørende iterationer
|
|
47
|
-
│ ├── iteration-archives/ # Arkiverede iterationer
|
|
48
|
-
│ └── knowledges/ # Vidensbase
|
|
49
|
-
│ ├── base/ # Basisinformation (diagnoserapporter, teknisk gæld)
|
|
50
|
-
│ ├── bizs/ # Forretningsvidensbase
|
|
51
|
-
│ └── techs/ # Teknisk vidensbase
|
|
52
|
-
```
|
|
53
|
-
|
|
54
|
-
### CLI Kommando Hurtig Reference
|
|
55
|
-
|
|
56
|
-
| Kommando | Beskrivelse |
|
|
57
|
-
|------|------|
|
|
58
|
-
| `speccrew list` | List alle tilgængelige Agenter og Skills |
|
|
59
|
-
| `speccrew doctor` | Kontroller installationsintegritet |
|
|
60
|
-
| `speccrew update` | Opdater projektkonfiguration til nyeste version |
|
|
61
|
-
| `speccrew uninstall` | Afinstaller SpecCrew |
|
|
62
|
-
|
|
63
|
-
---
|
|
64
|
-
|
|
65
|
-
## 2. Hurtig Start på 5 Minutter Efter Installation
|
|
66
|
-
|
|
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
|
|
143
|
-
|
|
144
|
-
```mermaid
|
|
145
|
-
flowchart LR
|
|
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 --> DEPLOY[Trin 5<br/>Udrulning<br/>System Deployer]
|
|
150
|
-
DEPLOY --> TEST[Trin 6<br/>Systemtest<br/>Test Manager]
|
|
151
|
-
TEST --> ARCHIVE[Trin 7<br/>Arkivering]
|
|
152
|
-
|
|
153
|
-
KB[(Vidensbase<br/>Gennem Hele Processen)] -.-> PRD
|
|
154
|
-
KB -.-> FD
|
|
155
|
-
KB -.-> SD
|
|
156
|
-
KB -.-> DEV
|
|
157
|
-
KB -.-> DEPLOY
|
|
158
|
-
KB -.-> TEST
|
|
159
|
-
```
|
|
160
|
-
|
|
161
|
-
### Kerneprincipper
|
|
162
|
-
|
|
163
|
-
1. **Trinafhængigheder**: Hvert trins resultat er input til næste trin
|
|
164
|
-
2. **Checkpoint-bekræftelse**: Hvert trin har et bekræftelsespunkt, der kræver brugergodkendelse før fortsættelse til næste trin
|
|
165
|
-
3. **Vidensbase-drevet**: Vidensbasen kører gennem hele processen og giver kontekst til alle trin
|
|
166
|
-
|
|
167
|
-
---
|
|
168
|
-
|
|
169
|
-
## 6. Trin Nul: Vidensbaseinitialisering
|
|
170
|
-
|
|
171
|
-
Før du starter den formelle engineering-proces, skal du initialisere projektets vidensbase.
|
|
172
|
-
|
|
173
|
-
### 6.1 Teknisk Vidensbaseinitialisering
|
|
174
|
-
|
|
175
|
-
**Samtaleeksempel**:
|
|
176
|
-
```
|
|
177
|
-
@speccrew-team-leader initialiser teknisk vidensbase
|
|
178
|
-
```
|
|
179
|
-
|
|
180
|
-
**Tre-faset proces**:
|
|
181
|
-
1. Platformdetektering — Identificer tekniske platforme i projektet
|
|
182
|
-
2. Teknisk dokumentgeneration — Generer tekniske specifikationsdokumenter for hver platform
|
|
183
|
-
3. Indexgeneration — Etabler vidensbaseindex
|
|
184
|
-
|
|
185
|
-
**Resultat**:
|
|
186
|
-
```
|
|
187
|
-
speccrew-workspace/knowledges/techs/{platform-id}/
|
|
188
|
-
├── tech-stack.md # Teknologi-stack-definition
|
|
189
|
-
├── architecture.md # Arkitekturkonventioner
|
|
190
|
-
├── dev-spec.md # Udviklingsspecifikationer
|
|
191
|
-
├── test-spec.md # Tests specifikationer
|
|
192
|
-
└── INDEX.md # Indexfil
|
|
193
|
-
```
|
|
194
|
-
|
|
195
|
-
### 6.2 Forretningsvidensbaseinitialisering
|
|
196
|
-
|
|
197
|
-
**Samtaleeksempel**:
|
|
198
|
-
```
|
|
199
|
-
@speccrew-team-leader initialiser forretningsvidensbase
|
|
200
|
-
```
|
|
201
|
-
|
|
202
|
-
**Fire-faset proces**:
|
|
203
|
-
1. Funktionsliste — Scan kode for at identificere alle funktioner
|
|
204
|
-
2. Funktionsanalyse — Analyser forretningslogik for hver funktion
|
|
205
|
-
3. Modulopsummering — Opsummer funktioner efter modul
|
|
206
|
-
4. Systemopsummering — Generer systemniveau forretningsoverblik
|
|
207
|
-
|
|
208
|
-
**Resultat**:
|
|
209
|
-
```
|
|
210
|
-
speccrew-workspace/knowledges/bizs/
|
|
211
|
-
├── {platform-type}/
|
|
212
|
-
│ └── {module-name}/
|
|
213
|
-
│ └── feature-spec.md
|
|
214
|
-
└── system-overview.md
|
|
215
|
-
```
|
|
216
|
-
|
|
217
|
-
---
|
|
218
|
-
|
|
219
|
-
## 7. Trin-for-Trin Samtaleguide
|
|
220
|
-
|
|
221
|
-
### 7.1 Trin 1: Kravanalyse (Product Manager)
|
|
222
|
-
|
|
223
|
-
**Sådan startes**:
|
|
224
|
-
```
|
|
225
|
-
@speccrew-product-manager Jeg har et nyt krav: [beskriv dit krav]
|
|
226
|
-
```
|
|
227
|
-
|
|
228
|
-
**Agent Workflow**:
|
|
229
|
-
1. Læs systemoversigt for at forstå eksisterende moduler
|
|
230
|
-
2. Analyser brugers krav
|
|
231
|
-
3. Generer struktureret PRD-dokument
|
|
232
|
-
|
|
233
|
-
**Resultat**:
|
|
234
|
-
```
|
|
235
|
-
iterations/{nummer}-{type}-{navn}/01.product-requirement/
|
|
236
|
-
├── [feature-name]-prd.md # Produktkravdokument
|
|
237
|
-
└── [feature-name]-bizs-modeling.md # Forretningsmodellering (for komplekse krav)
|
|
238
|
-
```
|
|
239
|
-
|
|
240
|
-
**Bekræftelsespunkter**:
|
|
241
|
-
- [ ] Beskriver kravet nøjagtigt brugerens hensigt?
|
|
242
|
-
- [ ] Er forretningsregler komplette?
|
|
243
|
-
- [ ] Er integrationspunkter med eksisterende systemer klare?
|
|
244
|
-
- [ ] Er acceptkriterier målbare?
|
|
245
|
-
|
|
246
|
-
---
|
|
247
|
-
|
|
248
|
-
### 7.2 Trin 2: Funktionsdesign (Feature Designer)
|
|
249
|
-
|
|
250
|
-
**Sådan startes**:
|
|
251
|
-
```
|
|
252
|
-
@speccrew-feature-designer start funktionsdesign
|
|
253
|
-
```
|
|
254
|
-
|
|
255
|
-
**Agent Workflow**:
|
|
256
|
-
1. Automatisk lokalisering af bekræftet PRD-dokument
|
|
257
|
-
2. Indlæs forretningsvidensbase
|
|
258
|
-
3. Generer funktionsdesign (inklusive UI-wireframes, interaktionsflows, datadefinitioner, API-kontrakter)
|
|
259
|
-
4. For flere PRD'er, brug Task Worker til parallelt design
|
|
260
|
-
|
|
261
|
-
**Resultat**:
|
|
262
|
-
```
|
|
263
|
-
iterations/{iter}/02.feature-design/
|
|
264
|
-
└── [feature-name]-feature-spec.md # Funktionsdesign-dokument
|
|
265
|
-
```
|
|
266
|
-
|
|
267
|
-
**Bekræftelsespunkter**:
|
|
268
|
-
- [ ] Er alle brugerscenarier dækket?
|
|
269
|
-
- [ ] Er interaktionsflows klare?
|
|
270
|
-
- [ ] Er datafeltdefinitioner komplette?
|
|
271
|
-
- [ ] Er undtagelseshåndtering omfattende?
|
|
272
|
-
|
|
273
|
-
---
|
|
274
|
-
|
|
275
|
-
### 7.3 Trin 3: Systemdesign (System Designer)
|
|
276
|
-
|
|
277
|
-
**Sådan startes**:
|
|
278
|
-
```
|
|
279
|
-
@speccrew-system-designer start systemdesign
|
|
280
|
-
```
|
|
281
|
-
|
|
282
|
-
**Agent Workflow**:
|
|
283
|
-
1. Lokaliser Feature Spec og API Contract
|
|
284
|
-
2. Indlæs teknisk vidensbase (teknologi-stack, arkitektur, specifikationer for hver platform)
|
|
285
|
-
3. **Checkpoint A**: Framework-evaluering — Analyser tekniske kløfter, anbefal nye frameworks (hvis nødvendigt), vent på brugerbekræftelse
|
|
286
|
-
4. Generer DESIGN-OVERVIEW.md
|
|
287
|
-
5. Brug Task Worker til parallelt at distribuere design for hver platform (frontend/backend/mobil/desktop)
|
|
288
|
-
6. **Checkpoint B**: Fælles bekræftelse — Vis resume af alle platformdesign, vent på brugerbekræftelse
|
|
289
|
-
|
|
290
|
-
**Resultat**:
|
|
291
|
-
```
|
|
292
|
-
iterations/{iter}/03.system-design/
|
|
293
|
-
├── DESIGN-OVERVIEW.md # Designoversigt
|
|
294
|
-
├── {platform-id}/
|
|
295
|
-
│ ├── INDEX.md # Platformdesignindex
|
|
296
|
-
│ └── {module}-design.md # Pseudokode-niveau moduldesign
|
|
297
|
-
```
|
|
298
|
-
|
|
299
|
-
**Bekræftelsespunkter**:
|
|
300
|
-
- [ ] Bruger pseudokoden faktisk frameworks syntaks?
|
|
301
|
-
- [ ] Er cross-platform API-kontrakter konsistente?
|
|
302
|
-
- [ ] Er fejlhåndteringsstrategi ensartet?
|
|
303
|
-
|
|
304
|
-
---
|
|
305
|
-
|
|
306
|
-
### 7.4 Trin 4: Udvikling (System Developer)
|
|
307
|
-
|
|
308
|
-
**Sådan startes**:
|
|
309
|
-
```
|
|
310
|
-
@speccrew-system-developer start udvikling
|
|
311
|
-
```
|
|
312
|
-
|
|
313
|
-
**Agent Workflow**:
|
|
314
|
-
1. Læs systemdesigndokumenter
|
|
315
|
-
2. Indlæs teknisk viden for hver platform
|
|
316
|
-
3. **Checkpoint A**: Miljøforhåndskontrol — Kontroller runtime-versioner, afhængigheder, servicetilgængelighed; vent på brugerløsning hvis det fejler
|
|
317
|
-
4. Brug Task Worker til parallelt at distribuere udvikling for hver platform
|
|
318
|
-
5. Integrationskontrol: API-kontraktjustering, datakonsistens
|
|
319
|
-
6. Output leveringsrapport
|
|
320
|
-
|
|
321
|
-
**Resultat**:
|
|
322
|
-
```
|
|
323
|
-
# Kildekode skrives til projektets faktiske kildemappe
|
|
324
|
-
iterations/{iter}/04.development/
|
|
325
|
-
├── {platform-id}/
|
|
326
|
-
│ └── tasks/ # Udviklingsopgaveregistre
|
|
327
|
-
└── delivery-report.md
|
|
328
|
-
```
|
|
329
|
-
|
|
330
|
-
**Bekræftelsespunkter**:
|
|
331
|
-
- [ ] Er miljøet klar?
|
|
332
|
-
- [ ] Er integrationsproblemer inden for acceptabelt område?
|
|
333
|
-
- [ ] Overholder koden udviklingsspecifikationerne?
|
|
334
|
-
|
|
335
|
-
---
|
|
336
|
-
|
|
337
|
-
### 7.5 Trin 5: Udrulning (System Deployer)
|
|
338
|
-
|
|
339
|
-
**Sådan startes**:
|
|
340
|
-
```
|
|
341
|
-
@speccrew-system-deployer start udrulning
|
|
342
|
-
```
|
|
343
|
-
|
|
344
|
-
**Agent Workflow**:
|
|
345
|
-
1. Verificer at udviklingsfasen er fuldført (Stage Gate)
|
|
346
|
-
2. Indlæs teknisk vidensbase (build-konfiguration, database-migreringskonfiguration, servicestart-kommandoer)
|
|
347
|
-
3. **Checkpoint**: Miljøforhåndskontrol — Verificer build-værktøjer, runtime-versioner, afhængighedstilgængelighed
|
|
348
|
-
4. Udfør udrulningsskills i rækkefølge: Build → Database-migrering → Servicestart → Smoke Test
|
|
349
|
-
5. Output udrulningsrapport
|
|
350
|
-
|
|
351
|
-
> 💡 **Tip**: For projekter uden database springes migreringstrinnet automatisk over; for klient-applikationer (desktop/mobil) bruges proces-verifikationsmode i stedet for HTTP-sundhedstjek.
|
|
352
|
-
|
|
353
|
-
**Resultat**:
|
|
354
|
-
```
|
|
355
|
-
iterations/{iter}/05.deployment/
|
|
356
|
-
├── {platform-id}/
|
|
357
|
-
│ ├── deployment-plan.md # Udrulningsplan
|
|
358
|
-
│ └── deployment-log.md # Udrulnings-eksekveringslog
|
|
359
|
-
└── deployment-report.md # Udrulnings-fuldførelsesrapport
|
|
360
|
-
```
|
|
361
|
-
|
|
362
|
-
**Bekræftelsespunkter**:
|
|
363
|
-
- [ ] Er bygningen fuldført succesfuldt?
|
|
364
|
-
- [ ] Er alle database-migreringsskripter udført succesfuldt (hvis relevant)?
|
|
365
|
-
- [ ] Er applikationen startet og bestået sundhedstjek?
|
|
366
|
-
- [ ] Er alle smoke tests bestået?
|
|
367
|
-
|
|
368
|
-
---
|
|
369
|
-
|
|
370
|
-
### 7.6 Trin 6: Systemtest (Test Manager)
|
|
371
|
-
|
|
372
|
-
**Sådan startes**:
|
|
373
|
-
```
|
|
374
|
-
@speccrew-test-manager start test
|
|
375
|
-
```
|
|
376
|
-
|
|
377
|
-
**Tre-faset testproces**:
|
|
378
|
-
|
|
379
|
-
| Fase | Beskrivelse | Checkpoint |
|
|
380
|
-
|-------|-------------|------------|
|
|
381
|
-
| 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 |
|
|
382
|
-
| Testkodegenerering | Generer eksekverbar testkode | B: Vis genererede testfiler og casemapping, vent på brugerbekræftelse |
|
|
383
|
-
| Testudførelse og Bug-rapportering | Kør automatisk tests og generer rapporter | Ingen (automatisk udførelse) |
|
|
384
|
-
|
|
385
|
-
**Resultat**:
|
|
386
|
-
```
|
|
387
|
-
iterations/{iter}/06.system-test/
|
|
388
|
-
├── cases/
|
|
389
|
-
│ └── {platform-id}/ # Testcasedokumenter
|
|
390
|
-
├── code/
|
|
391
|
-
│ └── {platform-id}/ # Testkodeplan
|
|
392
|
-
├── reports/
|
|
393
|
-
│ └── test-report-{date}.md # Testrapport
|
|
394
|
-
└── bugs/
|
|
395
|
-
└── BUG-{id}-{title}.md # Bug-rapporter (én fil pr. bug)
|
|
396
|
-
```
|
|
397
|
-
|
|
398
|
-
**Bekræftelsespunkter**:
|
|
399
|
-
- [ ] Er casedækning komplet?
|
|
400
|
-
- [ ] Er testkode kørbar?
|
|
401
|
-
- [ ] Er bug-alvorlighedsvurdering præcis?
|
|
402
|
-
|
|
403
|
-
---
|
|
404
|
-
|
|
405
|
-
### 7.7 Trin 7: Arkivering
|
|
406
|
-
|
|
407
|
-
Iterationer arkiveres automatisk efter fuldførelse:
|
|
408
|
-
|
|
409
|
-
```
|
|
410
|
-
speccrew-workspace/iteration-archives/
|
|
411
|
-
└── {nummer}-{type}-{navn}-{dato}/
|
|
412
|
-
├── 01.product-requirement/
|
|
413
|
-
├── 02.feature-design/
|
|
414
|
-
├── 03.system-design/
|
|
415
|
-
├── 04.development/
|
|
416
|
-
├── 05.deployment/
|
|
417
|
-
└── 06.system-test/
|
|
418
|
-
```
|
|
419
|
-
|
|
420
|
-
---
|
|
421
|
-
|
|
422
|
-
## 8. Vidensbase Oversigt
|
|
423
|
-
|
|
424
|
-
### 8.1 Forretningsvidensbase (bizs)
|
|
425
|
-
|
|
426
|
-
**Formål**: Gem projektets forretningsfunktionsbeskrivelser, modulopdelinger, API-karakteristika
|
|
427
|
-
|
|
428
|
-
**Mappestruktur**:
|
|
429
|
-
```
|
|
430
|
-
knowledges/bizs/
|
|
431
|
-
├── {platform-type}/
|
|
432
|
-
│ └── {module-name}/
|
|
433
|
-
│ └── feature-spec.md
|
|
434
|
-
└── system-overview.md
|
|
435
|
-
```
|
|
436
|
-
|
|
437
|
-
**Anvendelsesscenarier**: Product Manager, Feature Designer
|
|
438
|
-
|
|
439
|
-
### 8.2 Teknisk Vidensbase (techs)
|
|
440
|
-
|
|
441
|
-
**Formål**: Gem projektets teknologi-stack, arkitekturkonventioner, udviklingsspecifikationer, tests specifikationer
|
|
442
|
-
|
|
443
|
-
**Mappestruktur**:
|
|
444
|
-
```
|
|
445
|
-
knowledges/techs/{platform-id}/
|
|
446
|
-
├── tech-stack.md
|
|
447
|
-
├── architecture.md
|
|
448
|
-
├── dev-spec.md
|
|
449
|
-
├── test-spec.md
|
|
450
|
-
└── INDEX.md
|
|
451
|
-
```
|
|
452
|
-
|
|
453
|
-
**Anvendelsesscenarier**: System Designer, System Developer, Test Manager
|
|
454
|
-
|
|
455
|
-
---
|
|
456
|
-
|
|
457
|
-
## 9. Workflow Fremskridtshåndtering
|
|
458
|
-
|
|
459
|
-
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.
|
|
460
|
-
|
|
461
|
-
### 9.1 Tre-lags Fremskridtsfiler
|
|
462
|
-
|
|
463
|
-
Workflowet vedligeholder automatisk tre typer JSON-fremskridtsfiler, placeret i iterationsmappen:
|
|
464
|
-
|
|
465
|
-
| Fil | Placering | Formål |
|
|
466
|
-
|------|----------|---------|
|
|
467
|
-
| `WORKFLOW-PROGRESS.json` | `iterations/{iter}/` | Registrerer status for hver pipeline-fase |
|
|
468
|
-
| `.checkpoints.json` | Under hver fasemappe | Registrerer brugercheckpoint-bekræftelsesstatus |
|
|
469
|
-
| `DISPATCH-PROGRESS.json` | Under hver fasemappe | Registrerer element-for-element fremskridt for parallelle opgaver (multi-platform/multi-modul) |
|
|
470
|
-
|
|
471
|
-
### 9.2 Fasestatus Flow
|
|
472
|
-
|
|
473
|
-
Hver fase følger denne status flow:
|
|
474
|
-
|
|
475
|
-
```
|
|
476
|
-
pending → in_progress → completed → confirmed
|
|
477
|
-
```
|
|
478
|
-
|
|
479
|
-
- **pending**: Endnu ikke startet
|
|
480
|
-
- **in_progress**: Under udførelse
|
|
481
|
-
- **completed**: Agent-udførelse fuldført, venter på brugerbekræftelse
|
|
482
|
-
- **confirmed**: Bruger bekræftet via endeligt checkpoint, næste fase kan starte
|
|
483
|
-
|
|
484
|
-
### 9.3 Genoptagelig Udførelse
|
|
485
|
-
|
|
486
|
-
Når du genstarter en Agent for en fase:
|
|
487
|
-
|
|
488
|
-
1. **Automatisk upstream-kontrol**: Verificerer om forrige fase er bekræftet, blokerer og prompter hvis ikke
|
|
489
|
-
2. **Checkpoint-genopretning**: Læser `.checkpoints.json`, springer beståede checkpoints over, fortsætter fra sidste afbrydelsespunkt
|
|
490
|
-
3. **Parallelle opgave-genopretning**: Læser `DISPATCH-PROGRESS.json`, genudfører kun opgaver med `pending` eller `failed` status, springer `completed` opgaver over
|
|
491
|
-
|
|
492
|
-
### 9.4 Se Nuværende Fremskridt
|
|
493
|
-
|
|
494
|
-
Se pipeline-panoramastatus via Team Leader Agent:
|
|
495
|
-
|
|
496
|
-
```
|
|
497
|
-
@speccrew-team-leader se nuværende iterationsfremskridt
|
|
498
|
-
```
|
|
499
|
-
|
|
500
|
-
Team Leader vil læse fremskridtsfilerne og vise en statusoversigt svarende til:
|
|
501
|
-
|
|
502
|
-
```
|
|
503
|
-
Pipeline Status: i001-user-management
|
|
504
|
-
01 PRD: ✅ Confirmed
|
|
505
|
-
02 Feature Design: 🔄 In Progress (Checkpoint A passed)
|
|
506
|
-
03 System Design: ⏳ Pending
|
|
507
|
-
04 Development: ⏳ Pending
|
|
508
|
-
05 Deployment: ⏳ Pending
|
|
509
|
-
06 System Test: ⏳ Pending
|
|
510
|
-
```
|
|
511
|
-
|
|
512
|
-
### 9.5 Bagudkompatibilitet
|
|
513
|
-
|
|
514
|
-
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.
|
|
515
|
-
|
|
516
|
-
---
|
|
517
|
-
|
|
518
|
-
## 10. Ofte Stillede Spørgsmål (FAQ)
|
|
519
|
-
|
|
520
|
-
### S1: Hvad gør jeg hvis Agenten ikke fungerer som forventet?
|
|
521
|
-
|
|
522
|
-
1. Kør `speccrew doctor` for at kontrollere installationsintegritet
|
|
523
|
-
2. Bekræft at vidensbasen er blevet initialiseret
|
|
524
|
-
3. Bekræft at resultatet fra forrige fase findes i den aktuelle iterationsmappe
|
|
525
|
-
|
|
526
|
-
### S2: Hvordan springer jeg en fase over?
|
|
527
|
-
|
|
528
|
-
**Anbefales ikke** — Hver fases output er input til næste fase.
|
|
529
|
-
|
|
530
|
-
Hvis du skal springe over, skal du manuelt forberede inputdokumentet for den tilsvarende fase og sikre, at det overholder formatspecifikationerne.
|
|
531
|
-
|
|
532
|
-
### S3: Hvordan håndterer jeg flere parallelle krav?
|
|
533
|
-
|
|
534
|
-
Opret uafhængige iterationsmapper for hvert krav:
|
|
535
|
-
```
|
|
536
|
-
iterations/
|
|
537
|
-
├── 001-feature-xxx/
|
|
538
|
-
├── 002-feature-yyy/
|
|
539
|
-
└── 003-feature-zzz/
|
|
540
|
-
```
|
|
541
|
-
|
|
542
|
-
Hver iteration er fuldstændigt isoleret og påvirker ikke andre.
|
|
543
|
-
|
|
544
|
-
### S4: Hvordan opdaterer jeg SpecCrew-versionen?
|
|
545
|
-
|
|
546
|
-
Opdatering kræver to trin:
|
|
547
|
-
|
|
548
|
-
```bash
|
|
549
|
-
# Trin 1: Opdater det globale CLI-værktøj
|
|
550
|
-
npm install -g speccrew@latest
|
|
551
|
-
|
|
552
|
-
# Trin 2: Synkroniser Agenter og Skills i din projektmappe
|
|
553
|
-
cd /path/to/your-project
|
|
554
|
-
speccrew update
|
|
555
|
-
```
|
|
556
|
-
|
|
557
|
-
- `npm install -g speccrew@latest`: Opdaterer CLI-værktøjet selv (nye versioner kan indeholde nye Agent/Skill-definitioner, fejlrettelser osv.)
|
|
558
|
-
- `speccrew update`: Synkroniserer Agent- og Skill-definitions filer i dit projekt til nyeste version
|
|
559
|
-
- `speccrew update --ide cursor`: Opdaterer kun konfiguration for specifik IDE
|
|
560
|
-
|
|
561
|
-
> **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.
|
|
562
|
-
|
|
563
|
-
### S5: `speccrew update` viser ny version tilgængelig men `npm install -g speccrew@latest` installerer stadig den gamle version?
|
|
564
|
-
|
|
565
|
-
Dette skyldes normalt npm-cache. Løsning:
|
|
566
|
-
|
|
567
|
-
```bash
|
|
568
|
-
# Ryd npm-cache og geninstaller
|
|
569
|
-
npm cache clean --force
|
|
570
|
-
npm install -g speccrew@latest
|
|
571
|
-
|
|
572
|
-
# Verificer version
|
|
573
|
-
npm list -g speccrew
|
|
574
|
-
```
|
|
575
|
-
|
|
576
|
-
Hvis det stadig ikke virker, prøv at installere med specifikt versionsnummer:
|
|
577
|
-
```bash
|
|
578
|
-
npm install -g speccrew@0.5.6
|
|
579
|
-
```
|
|
580
|
-
|
|
581
|
-
### S6: Hvordan ser jeg historiske iterationer?
|
|
582
|
-
|
|
583
|
-
Efter arkivering, se i `speccrew-workspace/iteration-archives/`, organiseret efter `{nummer}-{type}-{navn}-{dato}/` format.
|
|
584
|
-
|
|
585
|
-
### S7: Skal vidensbasen opdateres regelmæssigt?
|
|
586
|
-
|
|
587
|
-
Geninitialisering er påkrævet i følgende situationer:
|
|
588
|
-
- Større ændringer i projektstruktur
|
|
589
|
-
- Teknologi-stack-opgradering eller udskiftning
|
|
590
|
-
- Tilføjelse/fjernelse af forretningsmoduler
|
|
591
|
-
|
|
592
|
-
---
|
|
593
|
-
|
|
594
|
-
## 11. Hurtig Reference
|
|
595
|
-
|
|
596
|
-
### Agent Start Hurtig Reference
|
|
597
|
-
|
|
598
|
-
| Fase | Agent | Start Samtale |
|
|
599
|
-
|-------|-------|-------------------|
|
|
600
|
-
| Initialisering | Team Leader | `@speccrew-team-leader initialiser teknisk vidensbase` |
|
|
601
|
-
| Kravanalyse | Product Manager | `@speccrew-product-manager Jeg har et nyt krav: [beskrivelse]` |
|
|
602
|
-
| Funktionsdesign | Feature Designer | `@speccrew-feature-designer start funktionsdesign` |
|
|
603
|
-
| Systemdesign | System Designer | `@speccrew-system-designer start systemdesign` |
|
|
604
|
-
| Udvikling | System Developer | `@speccrew-system-developer start udvikling` |
|
|
605
|
-
| Udrulning | System Deployer | `@speccrew-system-deployer start udrulning` |
|
|
606
|
-
| Systemtest | Test Manager | `@speccrew-test-manager start test` |
|
|
607
|
-
|
|
608
|
-
### Checkpoint Tjekliste
|
|
609
|
-
|
|
610
|
-
| Fase | Antal Checkpoints | Vigtige Kontrolpunkter |
|
|
611
|
-
|-------|----------------------|-----------------|
|
|
612
|
-
| Kravanalyse | 1 | Kravnøjagtighed, forretningsregelkomplethed, acceptkriteriemålbarhed |
|
|
613
|
-
| Funktionsdesign | 1 | Scenariedækning, interaktionsklarhed, datakomplethed, undtagelseshåndtering |
|
|
614
|
-
| Systemdesign | 2 | A: Framework-evaluering; B: Pseudokode syntaks, cross-platform konsistens, fejlhåndtering |
|
|
615
|
-
| Udvikling | 1 | A: Miljøklarhed, integrationsproblemer, kodespecifikationer |
|
|
616
|
-
| Udrulning | 1 | Build-succes, migreringsfuldførelse, servicestart, smoke test bestået |
|
|
617
|
-
| Systemtest | 2 | A: Casedækning; B: Testkode-kørbarhed |
|
|
618
|
-
|
|
619
|
-
### Resultatsti Hurtig Reference
|
|
620
|
-
|
|
621
|
-
| Fase | Output-mappe | Filformat |
|
|
622
|
-
|-------|-----------------|-------------|
|
|
623
|
-
| Kravanalyse | `iterations/{iter}/01.product-requirement/` | `[name]-prd.md`, `[name]-bizs-modeling.md` |
|
|
624
|
-
| Funktionsdesign | `iterations/{iter}/02.feature-design/` | `[name]-feature-spec.md` |
|
|
625
|
-
| Systemdesign | `iterations/{iter}/03.system-design/` | `DESIGN-OVERVIEW.md`, `{platform}/INDEX.md`, `{platform}/{module}-design.md` |
|
|
626
|
-
| Udvikling | `iterations/{iter}/04.development/` | Kildekode + `delivery-report.md` |
|
|
627
|
-
| Udrulning | `iterations/{iter}/05.deployment/` | `deployment-plan.md`, `deployment-log.md`, `deployment-report.md` |
|
|
628
|
-
| Systemtest | `iterations/{iter}/06.system-test/` | `cases/`, `code/`, `reports/`, `bugs/` |
|
|
629
|
-
| Arkivering | `iteration-archives/{iter}-{date}/` | Komplet iterationskopi |
|
|
630
|
-
|
|
631
|
-
---
|
|
632
|
-
|
|
633
|
-
## Næste Trin
|
|
634
|
-
|
|
635
|
-
1. Kør `speccrew init --ide qoder` for at initialisere dit projekt
|
|
636
|
-
2. Udfør Trin Nul: Vidensbaseinitialisering
|
|
637
|
-
3. Gå frem fase for fase ifølge workflowet, nyd den specifikationsdrevne udviklingsoplevelse!
|