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 Rask Start Guide
|
|
2
2
|
|
|
3
3
|
<p align="center">
|
|
4
4
|
<a href="./GETTING-STARTED.md">简体中文</a> |
|
|
@@ -11,11 +11,10 @@
|
|
|
11
11
|
<a href="./GETTING-STARTED.it.md">Italiano</a> |
|
|
12
12
|
<a href="./GETTING-STARTED.da.md">Dansk</a> |
|
|
13
13
|
<a href="./GETTING-STARTED.ja.md">日本語</a> |
|
|
14
|
-
<a href="./GETTING-STARTED.ar.md">العربية</a>
|
|
15
|
-
<a href="./GETTING-STARTED.no.md">Norsk</a>
|
|
14
|
+
<a href="./GETTING-STARTED.ar.md">العربية</a>
|
|
16
15
|
</p>
|
|
17
16
|
|
|
18
|
-
Dette dokumentet hjelper deg med raskt å forstå hvordan du bruker
|
|
17
|
+
Dette dokumentet hjelper deg med raskt å forstå hvordan du bruker SpecCrews Agent-team for å fullføre den komplette utviklingen fra krav til levering etter standard engineering-prosesser.
|
|
19
18
|
|
|
20
19
|
---
|
|
21
20
|
|
|
@@ -33,489 +32,159 @@ npm install -g speccrew
|
|
|
33
32
|
speccrew init --ide qoder
|
|
34
33
|
```
|
|
35
34
|
|
|
36
|
-
Støttede
|
|
35
|
+
Støttede IDEer: `qoder`, `cursor`, `claude`, `codex`
|
|
37
36
|
|
|
38
37
|
### Katalogstruktur Etter Initialisering
|
|
39
38
|
|
|
40
39
|
```
|
|
41
40
|
.
|
|
42
41
|
├── .qoder/
|
|
43
|
-
│ ├── agents/ # Agent
|
|
44
|
-
│ └── skills/ # Skill
|
|
45
|
-
├── speccrew-workspace/ #
|
|
42
|
+
│ ├── agents/ # Agent definisjonsfiler
|
|
43
|
+
│ └── skills/ # Skill definisjonsfiler
|
|
44
|
+
├── speccrew-workspace/ # Workspace
|
|
46
45
|
│ ├── docs/ # Konfigurasjoner, regler, maler, løsninger
|
|
47
|
-
│ ├── iterations/ #
|
|
46
|
+
│ ├── iterations/ # Nåværende kjørende iterasjoner
|
|
48
47
|
│ ├── iteration-archives/ # Arkiverte iterasjoner
|
|
49
48
|
│ └── knowledges/ # Kunnskapsbase
|
|
50
|
-
│ ├── base/ #
|
|
49
|
+
│ ├── base/ # Basisinformasjon (diagnoserapporter, teknisk gjeld)
|
|
51
50
|
│ ├── bizs/ # Forretningskunnskapsbase
|
|
52
51
|
│ └── techs/ # Teknisk kunnskapsbase
|
|
53
52
|
```
|
|
54
53
|
|
|
55
|
-
### CLI
|
|
54
|
+
### CLI Kommando Rask Referanse
|
|
56
55
|
|
|
57
56
|
| Kommando | Beskrivelse |
|
|
58
|
-
|
|
59
|
-
| `speccrew list` | List
|
|
57
|
+
|------|------|
|
|
58
|
+
| `speccrew list` | List alle tilgjengelige Agenter og Skills |
|
|
60
59
|
| `speccrew doctor` | Sjekk installasjonsintegritet |
|
|
61
60
|
| `speccrew update` | Oppdater prosjektkonfigurasjon til nyeste versjon |
|
|
62
61
|
| `speccrew uninstall` | Avinstaller SpecCrew |
|
|
63
62
|
|
|
64
63
|
---
|
|
65
64
|
|
|
66
|
-
## 2.
|
|
65
|
+
## 2. Rask Start på 5 Minutter Etter Installasjon
|
|
67
66
|
|
|
68
|
-
|
|
67
|
+
Etter kjøring av `speccrew init`, følg disse trinnene for raskt å komme i arbeidstilstand:
|
|
69
68
|
|
|
70
|
-
|
|
71
|
-
flowchart LR
|
|
72
|
-
PRD[Fase 1<br/>Kravanalyse<br/>Product Manager] --> FD[Fase 2<br/>Funksjonsdesign<br/>Feature Designer]
|
|
73
|
-
FD --> SD[Fase 3<br/>Systemdesign<br/>System Designer]
|
|
74
|
-
SD --> DEV[Fase 4<br/>Utvikling<br/>System Developer]
|
|
75
|
-
DEV --> TEST[Fase 5<br/>Systemtesting<br/>Test Manager]
|
|
76
|
-
TEST --> ARCHIVE[Fase 6<br/>Arkivering]
|
|
77
|
-
|
|
78
|
-
KB[(Kunnskapsbase<br/>Gjennom Hele Prosessen)] -.-> PRD
|
|
79
|
-
KB -.-> FD
|
|
80
|
-
KB -.-> SD
|
|
81
|
-
KB -.-> DEV
|
|
82
|
-
KB -.-> TEST
|
|
83
|
-
```
|
|
84
|
-
|
|
85
|
-
### Grunnleggende Prinsipper
|
|
69
|
+
### Trinn 1: Velg Din IDE
|
|
86
70
|
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
71
|
+
| IDE | Initialiseringskommando | Anvendelsesscenario |
|
|
72
|
+
|-----|-----------|----------|
|
|
73
|
+
| **Qoder** (Anbefalt) | `speccrew init --ide qoder` | Full agent-orkestrering, parallelle workers |
|
|
74
|
+
| **Cursor** | `speccrew init --ide cursor` | Composer-baserte arbeidsflyter |
|
|
75
|
+
| **Claude Code** | `speccrew init --ide claude` | CLI-først utvikling |
|
|
76
|
+
| **Codex** | `speccrew init --ide codex` | OpenAI økosystemintegrasjon |
|
|
90
77
|
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
## 3. Kunnskapsbase-initialisering
|
|
94
|
-
|
|
95
|
-
Før du starter den formelle ingeniørprosessen, må du initialisere prosjektets kunnskapsbase.
|
|
78
|
+
### Trinn 2: Initialiser Kunnskapsbase (Anbefalt)
|
|
96
79
|
|
|
97
|
-
|
|
80
|
+
For prosjekter med eksisterende kildekode anbefales det å initialisere kunnskapsbasen først, slik at agenter forstår din kodebase:
|
|
98
81
|
|
|
99
|
-
**Eksempel på Dialog**:
|
|
100
82
|
```
|
|
101
83
|
@speccrew-team-leader initialiser teknisk kunnskapsbase
|
|
102
84
|
```
|
|
103
85
|
|
|
104
|
-
|
|
105
|
-
1. Plattformoppdagelse — Identifiser teknologiplattformer i prosjektet
|
|
106
|
-
2. Teknisk Dokumentasjonsgenerering — Generer tekniske spesifikasjonsdokumenter for hver plattform
|
|
107
|
-
3. Indeksgenerering — Etabler kunnskapsbase-indeks
|
|
86
|
+
Deretter:
|
|
108
87
|
|
|
109
|
-
**Leveranse**:
|
|
110
|
-
```
|
|
111
|
-
speccrew-workspace/knowledges/techs/{platform-id}/
|
|
112
|
-
├── tech-stack.md # Teknologistabeldefinisjon
|
|
113
|
-
├── architecture.md # Arkitekturkonvensjoner
|
|
114
|
-
├── dev-spec.md # Utviklingsspesifikasjoner
|
|
115
|
-
├── test-spec.md # Testspesifikasjoner
|
|
116
|
-
└── INDEX.md # Indeksfil
|
|
117
|
-
```
|
|
118
|
-
|
|
119
|
-
### 3.2 Initialiser Forretningskunnskapsbase
|
|
120
|
-
|
|
121
|
-
**Eksempel på Dialog**:
|
|
122
88
|
```
|
|
123
89
|
@speccrew-team-leader initialiser forretningskunnskapsbase
|
|
124
90
|
```
|
|
125
91
|
|
|
126
|
-
|
|
127
|
-
1. Funksjonsinventar — Skann kode for å identifisere alle funksjoner
|
|
128
|
-
2. Funksjonsanalyse — Analyser forretningslogikk for hver funksjon
|
|
129
|
-
3. Modulsammendrag — Oppsummer funksjoner etter modul
|
|
130
|
-
4. Systemsammendrag — Generer forretningsoversikt på systemnivå
|
|
131
|
-
|
|
132
|
-
**Leveranse**:
|
|
133
|
-
```
|
|
134
|
-
speccrew-workspace/knowledges/bizs/
|
|
135
|
-
├── {platform-type}/
|
|
136
|
-
│ └── {module-name}/
|
|
137
|
-
│ └── feature-spec.md
|
|
138
|
-
└── system-overview.md
|
|
139
|
-
```
|
|
140
|
-
|
|
141
|
-
---
|
|
142
|
-
|
|
143
|
-
## 4. Fase-for-Fase Dialogguide
|
|
144
|
-
|
|
145
|
-
### 4.1 Fase 1: Kravanalyse (Product Manager)
|
|
92
|
+
### Trinn 3: Start Din Første Oppgave
|
|
146
93
|
|
|
147
|
-
**Hvordan Starte**:
|
|
148
94
|
```
|
|
149
|
-
@speccrew-product-manager
|
|
95
|
+
@speccrew-product-manager Jeg har et nytt krav: [beskriv ditt funksjonskrav]
|
|
150
96
|
```
|
|
151
97
|
|
|
152
|
-
**
|
|
153
|
-
1. Les systemoversikt for å forstå eksisterende moduler
|
|
154
|
-
2. Analyser brukerkrav
|
|
155
|
-
3. Generer strukturert PRD-dokument
|
|
156
|
-
|
|
157
|
-
**Leveranse**:
|
|
158
|
-
```
|
|
159
|
-
iterations/{nummer}-{type}-{navn}/01.product-requirement/
|
|
160
|
-
├── [feature-name]-prd.md # Produktkravdokument
|
|
161
|
-
└── [feature-name]-bizs-modeling.md # Forretningsmodellering (for komplekse krav)
|
|
162
|
-
```
|
|
163
|
-
|
|
164
|
-
**Bekreftelseskontrollliste**:
|
|
165
|
-
- [ ] Reflekterer kravbeskrivelsen brukerens intensjon nøyaktig?
|
|
166
|
-
- [ ] Er forretningsregler komplette?
|
|
167
|
-
- [ ] Er integrasjonspunkter med eksisterende systemer klare?
|
|
168
|
-
- [ ] Er akseptkriterier målbare?
|
|
98
|
+
> **Tips**: Hvis du er usikker på hva du skal gjøre, si bare `@speccrew-team-leader hjelp meg med å komme i gang` — Team Leader vil automatisk oppdage prosjektstatusen din og veilede deg.
|
|
169
99
|
|
|
170
100
|
---
|
|
171
101
|
|
|
172
|
-
|
|
102
|
+
## 3. Raskt Beslutningstre
|
|
173
103
|
|
|
174
|
-
|
|
175
|
-
```
|
|
176
|
-
@speccrew-feature-designer start funksjonsdesign
|
|
177
|
-
```
|
|
104
|
+
Usikker på hva du skal gjøre? Finn scenarioet ditt nedenfor:
|
|
178
105
|
|
|
179
|
-
**
|
|
180
|
-
|
|
181
|
-
2. Last inn forretningskunnskapsbase
|
|
182
|
-
3. Generer funksjonsdesign (inkludert UI-wireframes, interaksjonsflyter, datadefinisjoner, API-kontrakter)
|
|
183
|
-
4. For flere PRD-er, bruk Task Worker for parallell design
|
|
106
|
+
- **Jeg har et nytt funksjonskrav**
|
|
107
|
+
→ `@speccrew-product-manager Jeg har et nytt krav: [beskriv ditt funksjonskrav]`
|
|
184
108
|
|
|
185
|
-
**
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
└── [feature-name]-feature-spec.md # Funksjonsdesigndokument
|
|
189
|
-
```
|
|
109
|
+
- **Jeg vil skanne eksisterende prosjektviten**
|
|
110
|
+
→ `@speccrew-team-leader initialiser teknisk kunnskapsbase`
|
|
111
|
+
→ Deretter: `@speccrew-team-leader initialiser forretningskunnskapsbase`
|
|
190
112
|
|
|
191
|
-
**
|
|
192
|
-
-
|
|
193
|
-
- [ ] Er interaksjonsflyter klare?
|
|
194
|
-
- [ ] Er datafeltdefinisjoner komplette?
|
|
195
|
-
- [ ] Er unntakshåndtering omfattende?
|
|
113
|
+
- **Jeg vil fortsette tidligere arbeid**
|
|
114
|
+
→ `@speccrew-team-leader hva er den nåværende fremgangen?`
|
|
196
115
|
|
|
197
|
-
|
|
116
|
+
- **Jeg vil sjekke systemets helsetilstand**
|
|
117
|
+
→ Kjør i terminal: `speccrew doctor`
|
|
198
118
|
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
```
|
|
203
|
-
@speccrew-system-designer start systemdesign
|
|
204
|
-
```
|
|
205
|
-
|
|
206
|
-
**Agent Arbeidsflyt**:
|
|
207
|
-
1. Finn Feature Spec og API Contract
|
|
208
|
-
2. Last inn teknisk kunnskapsbase (teknologistabel, arkitektur, spesifikasjoner for hver plattform)
|
|
209
|
-
3. **Kontrollpunkt A**: Rammeverkvurdering — Analyser tekniske gap, anbefal nye rammeverk (om nødvendig), vent på brukerbekreftelse
|
|
210
|
-
4. Generer DESIGN-OVERVIEW.md
|
|
211
|
-
5. Bruk Task Worker for parallell designdistribusjon for hver plattform (frontend/backend/mobil/skrivebord)
|
|
212
|
-
6. **Kontrollpunkt B**: Felles Bekreftelse — Vis oppsummering av alle plattformdesign, vent på brukerbekreftelse
|
|
213
|
-
|
|
214
|
-
**Leveranse**:
|
|
215
|
-
```
|
|
216
|
-
iterations/{iter}/03.system-design/
|
|
217
|
-
├── DESIGN-OVERVIEW.md # Designoversikt
|
|
218
|
-
├── {platform-id}/
|
|
219
|
-
│ ├── INDEX.md # Plattformdesign-indeks
|
|
220
|
-
│ └── {module}-design.md # Moduldesign på pseudokodenivå
|
|
221
|
-
```
|
|
222
|
-
|
|
223
|
-
**Bekreftelseskontrollliste**:
|
|
224
|
-
- [ ] Bruker pseudokoden faktisk rammeverksyntaks?
|
|
225
|
-
- [ ] Er cross-plattform API-kontrakter konsistente?
|
|
226
|
-
- [ ] Er feilhåndteringsstrategi unified?
|
|
227
|
-
|
|
228
|
-
---
|
|
229
|
-
|
|
230
|
-
### 4.4 Fase 4: Utviklingsimplementering (System Developer)
|
|
231
|
-
|
|
232
|
-
**Hvordan Starte**:
|
|
233
|
-
```
|
|
234
|
-
@speccrew-system-developer start utvikling
|
|
235
|
-
```
|
|
236
|
-
|
|
237
|
-
**Agent Arbeidsflyt**:
|
|
238
|
-
1. Les systemdesigndokumenter
|
|
239
|
-
2. Last inn teknisk kunnskap for hver plattform
|
|
240
|
-
3. **Kontrollpunkt A**: Miljø-forhåndsverifisering — Verifiser runtime-versjoner, avhengigheter, tjenestetilgjengelighet; hvis mislykkes, vent på brukerløsning
|
|
241
|
-
4. Bruk Task Worker for parallell utviklingsdistribusjon for hver plattform
|
|
242
|
-
5. Integrasjonsverifisering: API-kontraktsjustering, datakonsistens
|
|
243
|
-
6. Output leveranserapport
|
|
244
|
-
|
|
245
|
-
**Leveranse**:
|
|
246
|
-
```
|
|
247
|
-
# Kildekode skrives til prosjektets faktiske kildekodekatalog
|
|
248
|
-
iterations/{iter}/04.development/
|
|
249
|
-
├── {platform-id}/
|
|
250
|
-
│ └── tasks/ # Utviklingsopptegnelser
|
|
251
|
-
└── delivery-report.md
|
|
252
|
-
```
|
|
253
|
-
|
|
254
|
-
**Bekreftelseskontrollliste**:
|
|
255
|
-
- [ ] Er miljøet klart?
|
|
256
|
-
- [ ] Er integrasjonsproblemer innen akseptabelt område?
|
|
257
|
-
- [ ] Følger koden utviklingsspesifikasjoner?
|
|
258
|
-
|
|
259
|
-
---
|
|
260
|
-
|
|
261
|
-
### 4.5 Fase 5: Systemtesting (Test Manager)
|
|
262
|
-
|
|
263
|
-
**Hvordan Starte**:
|
|
264
|
-
```
|
|
265
|
-
@speccrew-test-manager start testing
|
|
266
|
-
```
|
|
267
|
-
|
|
268
|
-
**Tre-fase Testprosess**:
|
|
269
|
-
|
|
270
|
-
| Fase | Beskrivelse | Kontrollpunkt |
|
|
271
|
-
|------|----------|-------------------|
|
|
272
|
-
| Testtilfelldesign | Generer testtilfeller basert på PRD og Feature Spec | A: Vis testtilfelde-dekningsstatistikk og sporbarhetsmatrise, vent på brukerbekreftelse på tilstrekkelig dekning |
|
|
273
|
-
| Testkodegenerering | Generer kjørbart testkode | B: Vis genererte testfiler og用例-mapping, vent på brukerbekreftelse |
|
|
274
|
-
| Testutførelse og Feilrapport | Utfør tester automatisk og generer rapporter | Ingen (automatisk utførelse) |
|
|
275
|
-
|
|
276
|
-
**Leveranse**:
|
|
277
|
-
```
|
|
278
|
-
iterations/{iter}/05.system-test/
|
|
279
|
-
├── cases/
|
|
280
|
-
│ └── {platform-id}/ # Testtilfelldokumenter
|
|
281
|
-
├── code/
|
|
282
|
-
│ └── {platform-id}/ # Testkodeplan
|
|
283
|
-
├── reports/
|
|
284
|
-
│ └── test-report-{date}.md # Testrapport
|
|
285
|
-
└── bugs/
|
|
286
|
-
└── BUG-{id}-{title}.md # Feilrapporter (én fil per feil)
|
|
287
|
-
```
|
|
288
|
-
|
|
289
|
-
**Bekreftelseskontrollliste**:
|
|
290
|
-
- [ ] Er testtilfelledekning komplett?
|
|
291
|
-
- [ ] Er testkoden kjørbar?
|
|
292
|
-
- [ ] Er feilalvorlighetsvurdering nøyaktig?
|
|
119
|
+
- **Jeg er usikker på hva jeg skal gjøre**
|
|
120
|
+
→ `@speccrew-team-leader hjelp meg med å komme i gang`
|
|
121
|
+
→ Team Leader vil automatisk oppdage prosjektstatusen din og veilede deg
|
|
293
122
|
|
|
294
123
|
---
|
|
295
124
|
|
|
296
|
-
|
|
125
|
+
## 4. Agent Rask Referanse
|
|
297
126
|
|
|
298
|
-
|
|
127
|
+
| Rolle | Agent | Ansvarsområder | Kommandoeksempel |
|
|
128
|
+
|------|-------|-----------------|-----------------|
|
|
129
|
+
| Teamleder | `@speccrew-team-leader` | Prosjektnavigasjon, kunnskapsbaseinitialisering, statuskontroll | "Hjelp meg med å komme i gang" |
|
|
130
|
+
| Produktleder | `@speccrew-product-manager` | Kravanalyse, PRD-generering | "Jeg har et nytt krav: ..." |
|
|
131
|
+
| Funksjonsdesigner | `@speccrew-feature-designer` | Funksjonsanalyse, spesifikasjonsdesign, API-kontrakter | "Start funksjonsdesign for iterasjon X" |
|
|
132
|
+
| Systemdesigner | `@speccrew-system-designer` | Arkitekturdesign, plattformdetaljert design | "Start systemdesign for iterasjon X" |
|
|
133
|
+
| Systemutvikler | `@speccrew-system-developer` | Utviklingskoordinering, kodegenerering | "Start utvikling for iterasjon X" |
|
|
134
|
+
| Testleder | `@speccrew-test-manager` | Testplanlegging, casestudier, utførelse | "Start test for iterasjon X" |
|
|
299
135
|
|
|
300
|
-
|
|
301
|
-
speccrew-workspace/iteration-archives/
|
|
302
|
-
└── {nummer}-{type}-{navn}-{dato}/
|
|
303
|
-
├── 01.product-requirement/
|
|
304
|
-
├── 02.feature-design/
|
|
305
|
-
├── 03.system-design/
|
|
306
|
-
├── 04.development/
|
|
307
|
-
└── 05.system-test/
|
|
308
|
-
```
|
|
136
|
+
> **Merk**: Du trenger ikke huske alle agenter. Bare snakk med `@speccrew-team-leader`, og den vil rute forespørselen din til riktig agent.
|
|
309
137
|
|
|
310
138
|
---
|
|
311
139
|
|
|
312
|
-
## 5.
|
|
313
|
-
|
|
314
|
-
### 5.1 Forretningskunnskapsbase (bizs)
|
|
315
|
-
|
|
316
|
-
**Formål**: Lagre prosjektets forretningsfunksjonsbeskrivelser, moduloppdelinger, API-kjennetegn
|
|
317
|
-
|
|
318
|
-
**Katalogstruktur**:
|
|
319
|
-
```
|
|
320
|
-
knowledges/bizs/
|
|
321
|
-
├── {platform-type}/
|
|
322
|
-
│ └── {module-name}/
|
|
323
|
-
│ └── feature-spec.md
|
|
324
|
-
└── system-overview.md
|
|
325
|
-
```
|
|
326
|
-
|
|
327
|
-
**Bruksscenarier**: Product Manager, Feature Designer
|
|
328
|
-
|
|
329
|
-
### 5.2 Teknisk Kunnskapsbase (techs)
|
|
140
|
+
## 5. Arbeidsflyt Oversikt
|
|
330
141
|
|
|
331
|
-
|
|
142
|
+
### Komplett Flytdiagram
|
|
332
143
|
|
|
333
|
-
|
|
334
|
-
|
|
335
|
-
|
|
336
|
-
|
|
337
|
-
|
|
338
|
-
|
|
339
|
-
|
|
340
|
-
|
|
341
|
-
|
|
342
|
-
|
|
343
|
-
|
|
344
|
-
|
|
345
|
-
|
|
346
|
-
|
|
347
|
-
## 6. Arbeidsflytforløpsstyring
|
|
348
|
-
|
|
349
|
-
Det virtuelle SpecCrew-teamet følger en streng fase-port-mekanisme hvor hver fase må bekreftes av brukeren før man fortsetter til den neste. Det støtter også gjenopptakbar utførelse — når det startes på nytt etter avbrudd, fortsetter det automatisk fra hvor det slapp.
|
|
350
|
-
|
|
351
|
-
### 6.1 Trelagsforløpsfiler
|
|
352
|
-
|
|
353
|
-
Arbeidsflyten vedlikeholder automatisk tre typer JSON-forløpsfiler, plassert i iterasjonskatalogen:
|
|
354
|
-
|
|
355
|
-
| Fil | Plassering | Formål |
|
|
356
|
-
|------|----------|---------|
|
|
357
|
-
| `WORKFLOW-PROGRESS.json` | `iterations/{iter}/` | Registrerer status for hver pipeline-fase |
|
|
358
|
-
| `.checkpoints.json` | Under hver fasekatalog | Registrerer brukerens sjekkpunkt-bekreftelsesstatus |
|
|
359
|
-
| `DISPATCH-PROGRESS.json` | Under hver fasekatalog | Registrerer punkt-for-punkt forløp for parallelle oppgaver (multi-plattform/multi-modul) |
|
|
360
|
-
|
|
361
|
-
### 6.2 Fasestatusforløp
|
|
362
|
-
|
|
363
|
-
Hver fase følger dette statusforløpet:
|
|
364
|
-
|
|
365
|
-
```
|
|
366
|
-
pending → in_progress → completed → confirmed
|
|
367
|
-
```
|
|
368
|
-
|
|
369
|
-
- **pending**: Ikke startet ennå
|
|
370
|
-
- **in_progress**: Utføres for øyeblikket
|
|
371
|
-
- **completed**: Agent-utførelse fullført, venter på brukerbekreftelse
|
|
372
|
-
- **confirmed**: Bruker bekreftet gjennom siste sjekkpunkt, neste fase kan starte
|
|
373
|
-
|
|
374
|
-
### 6.3 Gjenopptakbar Utførelse
|
|
375
|
-
|
|
376
|
-
Når en Agent startes på nytt for en fase:
|
|
377
|
-
|
|
378
|
-
1. **Automatisk oppstrømskontroll**: Verifiserer om den forrige fasen er bekreftet, blokkerer og varsler hvis ikke
|
|
379
|
-
2. **Sjekkpunkt-gjenoppretting**: Leser `.checkpoints.json`, hopper over passerte sjekkpunkter, fortsetter fra det siste avbruddspunktet
|
|
380
|
-
3. **Parallell oppgave-gjenoppretting**: Leser `DISPATCH-PROGRESS.json`, utfører kun oppgaver med `pending` eller `failed` status på nytt, hopper over `completed` oppgaver
|
|
381
|
-
|
|
382
|
-
### 6.4 Vise Nåværende Forløp
|
|
383
|
-
|
|
384
|
-
Vis pipeline-panorama-status gjennom Team Leader Agent:
|
|
385
|
-
|
|
386
|
-
```
|
|
387
|
-
@speccrew-team-leader vis nåværende iterasjonsforløp
|
|
388
|
-
```
|
|
389
|
-
|
|
390
|
-
Team Leader vil lese forløpsfilene og vise en statusoversikt som ligner på:
|
|
391
|
-
|
|
392
|
-
```
|
|
393
|
-
Pipeline Status: i001-user-management
|
|
394
|
-
01 PRD: ✅ Bekreftet
|
|
395
|
-
02 Feature Design: 🔄 Pågår (Sjekkpunkt A passert)
|
|
396
|
-
03 System Design: ⏳ Avventer
|
|
397
|
-
04 Development: ⏳ Avventer
|
|
398
|
-
05 System Test: ⏳ Avventer
|
|
144
|
+
```mermaid
|
|
145
|
+
flowchart LR
|
|
146
|
+
PRD[Trinn 1<br/>Kravanalyse<br/>Product Manager] --> FD[Trinn 2<br/>Funksjonsdesign<br/>Feature Designer]
|
|
147
|
+
FD --> SD[Trinn 3<br/>Systemdesign<br/>System Designer]
|
|
148
|
+
SD --> DEV[Trinn 4<br/>Utvikling<br/>System Developer]
|
|
149
|
+
DEV --> TEST[Trinn 5<br/>Systemtest<br/>Test Manager]
|
|
150
|
+
TEST --> ARCHIVE[Trinn 6<br/>Arkivering]
|
|
151
|
+
|
|
152
|
+
KB[(Kunnskapsbase<br/>Gjennom Hele Prosessen)] -.-> PRD
|
|
153
|
+
KB -.-> FD
|
|
154
|
+
KB -.-> SD
|
|
155
|
+
KB -.-> DEV
|
|
156
|
+
KB -.-> TEST
|
|
399
157
|
```
|
|
400
158
|
|
|
401
|
-
###
|
|
159
|
+
### Kjerneprinsipper
|
|
402
160
|
|
|
403
|
-
|
|
161
|
+
1. **Trinnavhengigheter**: Hvert trinns resultat er input til neste trinn
|
|
162
|
+
2. **Checkpoint-bekreftelse**: Hvert trinn har et bekreftelsespunkt som krever brukergodkjenning før fortsettelse til neste trinn
|
|
163
|
+
3. **Kunnskapsbase-drevet**: Kunnskapsbasen kjører gjennom hele prosessen og gir kontekst for alle trinn
|
|
404
164
|
|
|
405
165
|
---
|
|
406
166
|
|
|
407
|
-
##
|
|
408
|
-
|
|
409
|
-
### S1: Hva gjør jeg hvis Agenten ikke fungerer som forventet?
|
|
410
|
-
|
|
411
|
-
1. Kjør `speccrew doctor` for å sjekke installasjonsintegritet
|
|
412
|
-
2. Bekreft at kunnskapsbasen er initialisert
|
|
413
|
-
3. Bekreft at forrige fases leveranse finnes i gjeldende iterasjonskatalog
|
|
414
|
-
|
|
415
|
-
### S2: Hvordan hoppe over en fase?
|
|
167
|
+
## 6. Trinn Null: Kunnskapsbaseinitialisering
|
|
416
168
|
|
|
417
|
-
|
|
169
|
+
Før du starter den formelle engineering-prosessen, må du initialisere prosjektets kunnskapsbase.
|
|
418
170
|
|
|
419
|
-
|
|
171
|
+
### 6.1 Teknisk Kunnskapsbaseinitialisering
|
|
420
172
|
|
|
421
|
-
|
|
422
|
-
|
|
423
|
-
Opprett uavhengige iterasjonskataloger for hvert krav:
|
|
173
|
+
**Samtaleeksempel**:
|
|
424
174
|
```
|
|
425
|
-
|
|
426
|
-
├── 001-feature-xxx/
|
|
427
|
-
├── 002-feature-yyy/
|
|
428
|
-
└── 003-feature-zzz/
|
|
175
|
+
@speccrew-team-leader initialiser teknisk kunnskapsbase
|
|
429
176
|
```
|
|
430
177
|
|
|
431
|
-
|
|
432
|
-
|
|
433
|
-
|
|
434
|
-
|
|
435
|
-
Oppdatering krever to trinn:
|
|
436
|
-
|
|
437
|
-
```bash
|
|
438
|
-
# Trinn 1: Oppdater globalt CLI-verktøy
|
|
439
|
-
npm install -g speccrew@latest
|
|
178
|
+
**Tre-fase prosess**:
|
|
179
|
+
1. Plattformdeteksjon — Identifiser tekniske plattformer i prosjektet
|
|
180
|
+
2. Teknisk dokumentgenerering — Generer tekniske spesifikasjonsdokumenter for hver plattform
|
|
181
|
+
3. Indeksgenerering — Etabler kunnskapsbaseindeks
|
|
440
182
|
|
|
441
|
-
|
|
442
|
-
cd /path/to/your-project
|
|
443
|
-
speccrew update
|
|
183
|
+
**Resultat**:
|
|
444
184
|
```
|
|
445
|
-
|
|
446
|
-
|
|
447
|
-
|
|
448
|
-
-
|
|
449
|
-
|
|
450
|
-
|
|
451
|
-
|
|
452
|
-
### S5: `speccrew update` viser ny versjon men etter installasjon er det fortsatt den gamle?
|
|
453
|
-
|
|
454
|
-
Vanligvis forårsaket av npm-hurtigbuffer. Løsning:
|
|
455
|
-
|
|
456
|
-
```bash
|
|
457
|
-
npm cache clean --force
|
|
458
|
-
npm install -g speccrew@latest
|
|
459
|
-
npm list -g speccrew
|
|
460
|
-
```
|
|
461
|
-
|
|
462
|
-
Hvis det fortsatt ikke fungerer, spesifiser versjonsnummeret:
|
|
463
|
-
```bash
|
|
464
|
-
npm install -g speccrew@0.5.6
|
|
465
|
-
```
|
|
466
|
-
|
|
467
|
-
### S6: Hvordan se historiske iterasjoner?
|
|
468
|
-
|
|
469
|
-
Etter arkivering, se i `speccrew-workspace/iteration-archives/`, organisert i formatet `{nummer}-{type}-{navn}-{dato}/`.
|
|
470
|
-
|
|
471
|
-
### S7: Trenger kunnskapsbasen regelmessig oppdatering?
|
|
472
|
-
|
|
473
|
-
Re-initialisering kreves i følgende situasjoner:
|
|
474
|
-
- Betydelige endringer i prosjektstruktur
|
|
475
|
-
- Oppdatering eller erstatning av teknologistabel
|
|
476
|
-
- Legge til/fjerne forretningsmoduler
|
|
477
|
-
|
|
478
|
-
---
|
|
479
|
-
|
|
480
|
-
## 8. Hurtigreferanse
|
|
481
|
-
|
|
482
|
-
### Agent-start Hurtigreferanse
|
|
483
|
-
|
|
484
|
-
| Fase | Agent | Startdialog |
|
|
485
|
-
|------|-------|-------------------|
|
|
486
|
-
|
|
487
|
-
| Initialisering | Team Leader | `@speccrew-team-leader initialiser teknisk kunnskapsbase` |
|
|
488
|
-
| Kravanalyse | Product Manager | `@speccrew-product-manager jeg har et nytt krav: [beskrivelse]` |
|
|
489
|
-
| Funksjonsdesign | Feature Designer | `@speccrew-feature-designer start funksjonsdesign` |
|
|
490
|
-
| Systemdesign | System Designer | `@speccrew-system-designer start systemdesign` |
|
|
491
|
-
| Utvikling | System Developer | `@speccrew-system-developer start utvikling` |
|
|
492
|
-
| Systemtesting | Test Manager | `@speccrew-test-manager start testing` |
|
|
493
|
-
|
|
494
|
-
### Kontrollpunkter Kontrollliste
|
|
495
|
-
|
|
496
|
-
| Fase | Antall Kontrollpunkter | Nøkkelelementer for Verifisering |
|
|
497
|
-
|------|------------------------|--------------------------------|
|
|
498
|
-
| Kravanalyse | 1 | Kravnøyaktighet, forretningsregler kompletthet, akseptkriterier målbarhet |
|
|
499
|
-
| Funksjonsdesign | 1 | Szenariedekning, interaksjonsklarhet, datakompletthet, unntakshåndtering |
|
|
500
|
-
| Systemdesign | 2 | A: Rammeverkvurdering; B: Pseudokodesyntaks, cross-plattform konsistens, feilhåndtering |
|
|
501
|
-
| Utvikling | 1 | A: Miljøklarhet, integrasjonsproblemer, kodespesifikasjoner |
|
|
502
|
-
| Systemtesting | 2 | A: Tilfelledekning; B: Testkodekjørbarhet |
|
|
503
|
-
|
|
504
|
-
### Leveransesti Hurtigreferanse
|
|
505
|
-
|
|
506
|
-
| Fase | Output-katalog | Filformat |
|
|
507
|
-
|------|------------------|-------------|
|
|
508
|
-
| Kravanalyse | `iterations/{iter}/01.product-requirement/` | `[name]-prd.md`, `[name]-bizs-modeling.md` |
|
|
509
|
-
| Funksjonsdesign | `iterations/{iter}/02.feature-design/` | `[name]-feature-spec.md` |
|
|
510
|
-
| Systemdesign | `iterations/{iter}/03.system-design/` | `DESIGN-OVERVIEW.md`, `{platform}/INDEX.md`, `{platform}/{module}-design.md` |
|
|
511
|
-
| Utvikling | `iterations/{iter}/04.development/` | Kildekode + `delivery-report.md` |
|
|
512
|
-
| Systemtesting | `iterations/{iter}/05.system-test/` | `cases/`, `code/`, `reports/`, `bugs/` |
|
|
513
|
-
| Arkivering | `iteration-archives/{iter}-{dato}/` | Fullstendig kopi av iterasjonen |
|
|
514
|
-
|
|
515
|
-
---
|
|
516
|
-
|
|
517
|
-
## Neste Steg
|
|
518
|
-
|
|
519
|
-
1. Kjør `speccrew init --ide qoder` for å initialisere prosjektet ditt
|
|
520
|
-
2. Utfør Kunnskapsbase-initialisering
|
|
521
|
-
3. Beveg deg gjennom hver fase etter arbeidsflyten, nyt spesifikasjonsdrevet utviklingserfaring!
|
|
185
|
+
speccrew-workspace/knowledges/techs/{platform-id}/
|
|
186
|
+
├── tech-stack.md # Teknologi-stack-definisjon
|
|
187
|
+
├── architecture.md # Arkitekturkonvensjoner
|
|
188
|
+
├── dev-spec.md # Utviklingsspesifikasjoner
|
|
189
|
+
├── test-spec.md # Testspesifikasjoner
|
|
190
|
+
└── INDEX.md # Indeksf
|