speccrew 0.5.6 → 0.5.7
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/skills/speccrew-fd-feature-analyze/SKILL.md +26 -2
- package/.speccrew/skills/speccrew-fd-feature-analyze/templates/FEATURE-ANALYSIS-TEMPLATE.md +180 -0
- package/.speccrew/skills/speccrew-fd-feature-design/SKILL.md +22 -0
- package/.speccrew/skills/speccrew-fd-feature-design/templates/FEATURE-SPEC-TEMPLATE.md +78 -17
- package/docs/GETTING-STARTED.ar.md +22 -24
- package/docs/GETTING-STARTED.bn.md +22 -24
- package/docs/GETTING-STARTED.bs.md +22 -24
- package/docs/GETTING-STARTED.da.md +22 -24
- package/docs/GETTING-STARTED.de.md +24 -24
- package/docs/GETTING-STARTED.el.md +22 -24
- package/docs/GETTING-STARTED.en.md +24 -24
- package/docs/GETTING-STARTED.es.md +24 -24
- package/docs/GETTING-STARTED.fr.md +24 -24
- package/docs/GETTING-STARTED.it.md +22 -24
- package/docs/GETTING-STARTED.ja.md +24 -24
- package/docs/GETTING-STARTED.ko.md +4 -4
- package/docs/GETTING-STARTED.md +24 -24
- package/docs/GETTING-STARTED.no.md +22 -24
- package/docs/GETTING-STARTED.pl.md +20 -24
- package/docs/GETTING-STARTED.pt-BR.md +20 -24
- package/docs/GETTING-STARTED.ru.md +19 -24
- package/docs/GETTING-STARTED.th.md +19 -24
- package/docs/GETTING-STARTED.tr.md +19 -24
- package/docs/GETTING-STARTED.uk.md +19 -24
- package/docs/GETTING-STARTED.vi.md +19 -24
- package/docs/GETTING-STARTED.zh-TW.md +24 -24
- package/package.json +1 -1
|
@@ -90,28 +90,11 @@ flowchart LR
|
|
|
90
90
|
|
|
91
91
|
---
|
|
92
92
|
|
|
93
|
-
## 3.
|
|
93
|
+
## 3. Inicijalizacija Baze Znanja
|
|
94
94
|
|
|
95
95
|
Prije pokretanja formalnog inženjerskog procesa, morate inicijalizirati bazu znanja projekta.
|
|
96
96
|
|
|
97
|
-
### 3.1
|
|
98
|
-
|
|
99
|
-
**Primjer Razgovora**:
|
|
100
|
-
```
|
|
101
|
-
@speccrew-team-leader dijagnosticiraj projekt
|
|
102
|
-
```
|
|
103
|
-
|
|
104
|
-
**Šta će Agent Uraditi**:
|
|
105
|
-
- Skeniranje strukture projekta
|
|
106
|
-
- Otkrivanje tehnološkog steka
|
|
107
|
-
- Identifikacija poslovnih modula
|
|
108
|
-
|
|
109
|
-
**Isporuka**:
|
|
110
|
-
```
|
|
111
|
-
speccrew-workspace/knowledges/base/diagnosis-reports/diagnosis-report-{date}.md
|
|
112
|
-
```
|
|
113
|
-
|
|
114
|
-
### 3.2 Inicijalizacija Tehničke Baze Znanja
|
|
97
|
+
### 3.1 Inicijalizacija Tehničke Baze Znanja
|
|
115
98
|
|
|
116
99
|
**Primjer Razgovora**:
|
|
117
100
|
```
|
|
@@ -133,7 +116,7 @@ speccrew-workspace/knowledges/techs/{platform-id}/
|
|
|
133
116
|
└── INDEX.md # Fajl indeksa
|
|
134
117
|
```
|
|
135
118
|
|
|
136
|
-
### 3.
|
|
119
|
+
### 3.2 Inicijalizacija Poslovne Baze Znanja
|
|
137
120
|
|
|
138
121
|
**Primjer Razgovora**:
|
|
139
122
|
```
|
|
@@ -466,11 +449,26 @@ speccrew update
|
|
|
466
449
|
|
|
467
450
|
> **Napomena**: Obje korake treba izvršiti. Samo izvršavanje `speccrew update` neće ažurirati sam CLI alat; samo izvršavanje `npm install` neće ažurirati datoteke u projektu.
|
|
468
451
|
|
|
469
|
-
### P5:
|
|
452
|
+
### P5: `speccrew update` prikazuje novu verziju ali nakon instalacije je još uvijek stara?
|
|
453
|
+
|
|
454
|
+
Obično uzrokovano npm kešom. Rješenje:
|
|
455
|
+
|
|
456
|
+
```bash
|
|
457
|
+
npm cache clean --force
|
|
458
|
+
npm install -g speccrew@latest
|
|
459
|
+
npm list -g speccrew
|
|
460
|
+
```
|
|
461
|
+
|
|
462
|
+
Ako i dalje ne radi, navedite broj verzije:
|
|
463
|
+
```bash
|
|
464
|
+
npm install -g speccrew@0.5.6
|
|
465
|
+
```
|
|
466
|
+
|
|
467
|
+
### P6: Kako pogledati historijske iteracije?
|
|
470
468
|
|
|
471
469
|
Nakon arhiviranja, pogledajte u `speccrew-workspace/iteration-archives/`, organizirano u formatu `{broj}-{tip}-{ime}-{datum}/`.
|
|
472
470
|
|
|
473
|
-
###
|
|
471
|
+
### P7: Da li baza znanja treba redovno ažuriranje?
|
|
474
472
|
|
|
475
473
|
Ponovna inicijalizacija je potrebna u sljedećim situacijama:
|
|
476
474
|
- Značajne promjene u strukturi projekta
|
|
@@ -485,7 +483,7 @@ Ponovna inicijalizacija je potrebna u sljedećim situacijama:
|
|
|
485
483
|
|
|
486
484
|
| Faza | Agent | Početni Razgovor |
|
|
487
485
|
|------|-------|-------------------|
|
|
488
|
-
|
|
486
|
+
|
|
489
487
|
| Inicijalizacija | Team Leader | `@speccrew-team-leader inicijaliziraj tehničku bazu znanja` |
|
|
490
488
|
| Analiza Zahtjeva | Product Manager | `@speccrew-product-manager imam novi zahtjev: [opis]` |
|
|
491
489
|
| Dizajn Funkcija | Feature Designer | `@speccrew-feature-designer započni dizajn funkcija` |
|
|
@@ -519,5 +517,5 @@ Ponovna inicijalizacija je potrebna u sljedećim situacijama:
|
|
|
519
517
|
## Sljedeći Koraci
|
|
520
518
|
|
|
521
519
|
1. Pokrenite `speccrew init --ide qoder` da inicijalizirate svoj projekt
|
|
522
|
-
2. Izvršite
|
|
520
|
+
2. Izvršite Inicijalizaciju Baze Znanja
|
|
523
521
|
3. Napredujte kroz svaku fazu prateći radni tok, uživajte u iskustvu razvoja vođenog specifikacijama!
|
|
@@ -89,28 +89,11 @@ flowchart LR
|
|
|
89
89
|
|
|
90
90
|
---
|
|
91
91
|
|
|
92
|
-
## 3.
|
|
92
|
+
## 3. Videnbase Initialisering
|
|
93
93
|
|
|
94
94
|
Før du starter den formelle ingeniørarbejdsgang, skal du initialisere projektvidenbasen.
|
|
95
95
|
|
|
96
|
-
### 3.1
|
|
97
|
-
|
|
98
|
-
**Dialogeksempel**:
|
|
99
|
-
```
|
|
100
|
-
@speccrew-team-leader diagnosticer projekt
|
|
101
|
-
```
|
|
102
|
-
|
|
103
|
-
**Hvad agenten gør**:
|
|
104
|
-
- Scanner projektstruktur
|
|
105
|
-
- Detekterer teknologistak
|
|
106
|
-
- Identificerer forretningsmoduler
|
|
107
|
-
|
|
108
|
-
**Output**:
|
|
109
|
-
```
|
|
110
|
-
speccrew-workspace/knowledges/base/diagnosis-reports/diagnosis-report-{date}.md
|
|
111
|
-
```
|
|
112
|
-
|
|
113
|
-
### 3.2 Teknisk Videnbase Initialisering
|
|
96
|
+
### 3.1 Teknisk Videnbase Initialisering
|
|
114
97
|
|
|
115
98
|
**Dialogeksempel**:
|
|
116
99
|
```
|
|
@@ -132,7 +115,7 @@ speccrew-workspace/knowledges/techs/{platform-id}/
|
|
|
132
115
|
└── INDEX.md # Indeksfil
|
|
133
116
|
```
|
|
134
117
|
|
|
135
|
-
### 3.
|
|
118
|
+
### 3.2 Forretningsvidenbase Initialisering
|
|
136
119
|
|
|
137
120
|
**Dialogeksempel**:
|
|
138
121
|
```
|
|
@@ -465,11 +448,26 @@ speccrew update
|
|
|
465
448
|
|
|
466
449
|
> **Bemærk**: Begge trin skal udføres. Kun at køre `speccrew update` opdaterer ikke selve CLI-værktøjet; kun at køre `npm install` opdaterer ikke filerne i projektet.
|
|
467
450
|
|
|
468
|
-
### Q5:
|
|
451
|
+
### Q5: `speccrew update` viser ny version, men efter installation er det stadig den gamle?
|
|
452
|
+
|
|
453
|
+
Normalt forårsaget af npm cache. Løsning:
|
|
454
|
+
|
|
455
|
+
```bash
|
|
456
|
+
npm cache clean --force
|
|
457
|
+
npm install -g speccrew@latest
|
|
458
|
+
npm list -g speccrew
|
|
459
|
+
```
|
|
460
|
+
|
|
461
|
+
Hvis det stadig ikke virker, angiv versionsnummeret:
|
|
462
|
+
```bash
|
|
463
|
+
npm install -g speccrew@0.5.6
|
|
464
|
+
```
|
|
465
|
+
|
|
466
|
+
### Q6: Hvordan vises historiske iterationer?
|
|
469
467
|
|
|
470
468
|
Efter arkivering, se i `speccrew-workspace/iteration-archives/`, organiseret efter `{sekvens}-{type}-{navn}-{dato}/` format.
|
|
471
469
|
|
|
472
|
-
###
|
|
470
|
+
### Q7: Skal videnbasen opdateres regelmæssigt?
|
|
473
471
|
|
|
474
472
|
Følgende situationer kræver re-initialisering:
|
|
475
473
|
- Projektstruktur ændres væsentligt
|
|
@@ -484,7 +482,7 @@ Følgende situationer kræver re-initialisering:
|
|
|
484
482
|
|
|
485
483
|
| Fase | Agent | Startdialog |
|
|
486
484
|
|------|-------|----------|
|
|
487
|
-
|
|
485
|
+
|
|
488
486
|
| Initialisering | Team Leader | `@speccrew-team-leader initialiser teknisk videnbase` |
|
|
489
487
|
| Kravanalyse | Product Manager | `@speccrew-product-manager Jeg har et nyt krav: [beskrivelse]` |
|
|
490
488
|
| Funktionsdesign | Feature Designer | `@speccrew-feature-designer start funktionsdesign` |
|
|
@@ -518,5 +516,5 @@ Følgende situationer kræver re-initialisering:
|
|
|
518
516
|
## Næste Skridt
|
|
519
517
|
|
|
520
518
|
1. Kør `speccrew init --ide qoder` for at initialisere dit projekt
|
|
521
|
-
2. Udfør
|
|
519
|
+
2. Udfør Videnbase Initialisering
|
|
522
520
|
3. Følg arbejdsgangen fase for fase og nyd specifikationsdrevet udvikling!
|
|
@@ -89,28 +89,11 @@ flowchart LR
|
|
|
89
89
|
|
|
90
90
|
---
|
|
91
91
|
|
|
92
|
-
## 3. Schritt Null:
|
|
92
|
+
## 3. Schritt Null: Wissensbasis-Initialisierung
|
|
93
93
|
|
|
94
94
|
Bevor Sie den formellen Engineering-Prozess starten, müssen Sie die Projektwissensbasis initialisieren.
|
|
95
95
|
|
|
96
|
-
### 3.1
|
|
97
|
-
|
|
98
|
-
**Konversationsbeispiel**:
|
|
99
|
-
```
|
|
100
|
-
@speccrew-team-leader Projekt diagnostizieren
|
|
101
|
-
```
|
|
102
|
-
|
|
103
|
-
**Was der Agent tun wird**:
|
|
104
|
-
- Projektstruktur scannen
|
|
105
|
-
- Technologie-Stack erkennen
|
|
106
|
-
| Geschäftsmodule identifizieren
|
|
107
|
-
|
|
108
|
-
**Liefergegenstand**:
|
|
109
|
-
```
|
|
110
|
-
speccrew-workspace/knowledges/base/diagnosis-reports/diagnosis-report-{date}.md
|
|
111
|
-
```
|
|
112
|
-
|
|
113
|
-
### 3.2 Technische Wissensbasis-Initialisierung
|
|
96
|
+
### 3.1 Technische Wissensbasis-Initialisierung
|
|
114
97
|
|
|
115
98
|
**Konversationsbeispiel**:
|
|
116
99
|
```
|
|
@@ -132,7 +115,7 @@ speccrew-workspace/knowledges/techs/{platform-id}/
|
|
|
132
115
|
└── INDEX.md # Indexdatei
|
|
133
116
|
```
|
|
134
117
|
|
|
135
|
-
### 3.
|
|
118
|
+
### 3.2 Geschäftswissen-Basis-Initialisierung
|
|
136
119
|
|
|
137
120
|
**Konversationsbeispiel**:
|
|
138
121
|
```
|
|
@@ -465,11 +448,29 @@ speccrew update
|
|
|
465
448
|
|
|
466
449
|
> **Hinweis**: Beide Schritte müssen ausgeführt werden. Nur `speccrew update` auszuführen aktualisiert nicht das CLI-Tool selbst; nur `npm install` auszuführen aktualisiert nicht die Dateien im Projekt.
|
|
467
450
|
|
|
468
|
-
### Q5:
|
|
451
|
+
### Q5: `speccrew update` zeigt neue Version verfügbar an, aber `npm install -g speccrew@latest` installiert trotzdem die alte Version?
|
|
452
|
+
|
|
453
|
+
Dies wird normalerweise durch den npm-Cache verursacht. Lösung:
|
|
454
|
+
|
|
455
|
+
```bash
|
|
456
|
+
# npm-Cache leeren und neu installieren
|
|
457
|
+
npm cache clean --force
|
|
458
|
+
npm install -g speccrew@latest
|
|
459
|
+
|
|
460
|
+
# Version überprüfen
|
|
461
|
+
npm list -g speccrew
|
|
462
|
+
```
|
|
463
|
+
|
|
464
|
+
Wenn es immer noch nicht funktioniert, versuchen Sie die Installation mit einer spezifischen Versionsnummer:
|
|
465
|
+
```bash
|
|
466
|
+
npm install -g speccrew@0.5.6
|
|
467
|
+
```
|
|
468
|
+
|
|
469
|
+
### Q6: Wie historische Iterationen ansehen?
|
|
469
470
|
|
|
470
471
|
Nach Archivierung in `speccrew-workspace/iteration-archives/` ansehen, organisiert nach `{nummer}-{typ}-{name}-{date}/` Format.
|
|
471
472
|
|
|
472
|
-
###
|
|
473
|
+
### Q7: Muss die Wissensbasis regelmäßig aktualisiert werden?
|
|
473
474
|
|
|
474
475
|
Neuinitialisierung ist in folgenden Situationen erforderlich:
|
|
475
476
|
- Große Änderungen an der Projektstruktur
|
|
@@ -484,7 +485,6 @@ Neuinitialisierung ist in folgenden Situationen erforderlich:
|
|
|
484
485
|
|
|
485
486
|
| Phase | Agent | Start-Konversation |
|
|
486
487
|
|-------|-------|-------------------|
|
|
487
|
-
| Diagnose | Team Leader | `@speccrew-team-leader Projekt diagnostizieren` |
|
|
488
488
|
| Initialisierung | Team Leader | `@speccrew-team-leader technische Wissensbasis initialisieren` |
|
|
489
489
|
| Anforderungsanalyse | Product Manager | `@speccrew-product-manager Ich habe eine neue Anforderung: [Beschreibung]` |
|
|
490
490
|
| Feature Design | Feature Designer | `@speccrew-feature-designer Feature Design starten` |
|
|
@@ -518,5 +518,5 @@ Neuinitialisierung ist in folgenden Situationen erforderlich:
|
|
|
518
518
|
## Nächste Schritte
|
|
519
519
|
|
|
520
520
|
1. `speccrew init --ide qoder` ausführen um Ihr Projekt zu initialisieren
|
|
521
|
-
2. Schritt Null ausführen:
|
|
521
|
+
2. Schritt Null ausführen: Wissensbasis-Initialisierung
|
|
522
522
|
3. Durchlaufen Sie jede Phase nach dem Workflow und genießen Sie die specification-driven Entwicklungserfahrung!
|
|
@@ -90,28 +90,11 @@ flowchart LR
|
|
|
90
90
|
|
|
91
91
|
---
|
|
92
92
|
|
|
93
|
-
## 3.
|
|
93
|
+
## 3. Αρχικοποίηση Βάσης Γνώσεων
|
|
94
94
|
|
|
95
95
|
Πριν ξεκινήσετε την επίσημη διαδικασία μηχανικής, πρέπει να αρχικοποιήσετε τη βάση γνώσεων του έργου.
|
|
96
96
|
|
|
97
|
-
### 3.1
|
|
98
|
-
|
|
99
|
-
**Παράδειγμα Διαλόγου**:
|
|
100
|
-
```
|
|
101
|
-
@speccrew-team-leader διάγνωση έργου
|
|
102
|
-
```
|
|
103
|
-
|
|
104
|
-
**Τι θα Κάνει ο Agent**:
|
|
105
|
-
- Σάρωση δομής έργου
|
|
106
|
-
- Ανίχνευση τεχνολογικής στοίβας
|
|
107
|
-
- Αναγνώριση επιχειρησιακών μονάδων
|
|
108
|
-
|
|
109
|
-
**Παραδοτέο**:
|
|
110
|
-
```
|
|
111
|
-
speccrew-workspace/knowledges/base/diagnosis-reports/diagnosis-report-{date}.md
|
|
112
|
-
```
|
|
113
|
-
|
|
114
|
-
### 3.2 Αρχικοποίηση Τεχνικής Βάσης Γνώσεων
|
|
97
|
+
### 3.1 Αρχικοποίηση Τεχνικής Βάσης Γνώσεων
|
|
115
98
|
|
|
116
99
|
**Παράδειγμα Διαλόγου**:
|
|
117
100
|
```
|
|
@@ -133,7 +116,7 @@ speccrew-workspace/knowledges/techs/{platform-id}/
|
|
|
133
116
|
└── INDEX.md # Αρχείο ευρετηρίου
|
|
134
117
|
```
|
|
135
118
|
|
|
136
|
-
### 3.
|
|
119
|
+
### 3.2 Αρχικοποίηση Επιχειρησιακής Βάσης Γνώσεων
|
|
137
120
|
|
|
138
121
|
**Παράδειγμα Διαλόγου**:
|
|
139
122
|
```
|
|
@@ -466,11 +449,26 @@ speccrew update
|
|
|
466
449
|
|
|
467
450
|
> **Σημείωση**: Και τα δύο βήματα πρέπει να εκτελεστούν. Η εκτέλεση μόνο του `speccrew update` δεν θα ενημερώσει το ίδιο το εργαλείο CLI· η εκτέλεση μόνο του `npm install` δεν θα ενημερώσει τα αρχεία στο έργο.
|
|
468
451
|
|
|
469
|
-
### Ε5:
|
|
452
|
+
### Ε5: `speccrew update` εμφανίζει νέα έκδοση αλλά μετά την εγκατάσταση είναι ακόμα παλιά;
|
|
453
|
+
|
|
454
|
+
Συνήθως οφείλεται στην ενδιάμεση μνήμη npm. Λύση:
|
|
455
|
+
|
|
456
|
+
```bash
|
|
457
|
+
npm cache clean --force
|
|
458
|
+
npm install -g speccrew@latest
|
|
459
|
+
npm list -g speccrew
|
|
460
|
+
```
|
|
461
|
+
|
|
462
|
+
Αν εξακολουθεί να μην λειτουργεί, καθορίστε τον αριθμό έκδοσης:
|
|
463
|
+
```bash
|
|
464
|
+
npm install -g speccrew@0.5.6
|
|
465
|
+
```
|
|
466
|
+
|
|
467
|
+
### Ε6: Πώς να δω ιστορικές επαναλήψεις;
|
|
470
468
|
|
|
471
469
|
Μετά την αρχειοθέτηση, δείτε στο `speccrew-workspace/iteration-archives/`, οργανωμένο σε μορφή `{αριθμός}-{τύπος}-{όνομα}-{ημερομηνία}/`.
|
|
472
470
|
|
|
473
|
-
### Ε
|
|
471
|
+
### Ε7: Η βάση γνώσεων χρειάζεται τακτική ενημέρωση;
|
|
474
472
|
|
|
475
473
|
Απαιτείται επανεκκίνηση στις ακόλουθες καταστάσεις:
|
|
476
474
|
- Σημαντικές αλλαγές στη δομή του έργου
|
|
@@ -485,7 +483,7 @@ speccrew update
|
|
|
485
483
|
|
|
486
484
|
| Φάση | Agent | Διάλογος Εκκίνησης |
|
|
487
485
|
|------|-------|-------------------|
|
|
488
|
-
|
|
486
|
+
|
|
489
487
|
| Αρχικοποίηση | Team Leader | `@speccrew-team-leader αρχικοποίηση τεχνικής βάσης γνώσεων` |
|
|
490
488
|
| Ανάλυση Απαιτήσεων | Product Manager | `@speccrew-product-manager έχω μια νέα απαίτηση: [περιγραφή]` |
|
|
491
489
|
| Σχεδιασμός Χαρακτηριστικών | Feature Designer | `@speccrew-feature-designer έναρξη σχεδιασμού χαρακτηριστικών` |
|
|
@@ -519,5 +517,5 @@ speccrew update
|
|
|
519
517
|
## Επόμενα Βήματα
|
|
520
518
|
|
|
521
519
|
1. Εκτελέστε `speccrew init --ide qoder` για να αρχικοποιήσετε το έργο σας
|
|
522
|
-
2. Εκτελέστε
|
|
520
|
+
2. Εκτελέστε την Αρχικοποίηση Βάσης Γνώσεων
|
|
523
521
|
3. Προχωρήστε μέσα από κάθε φάση ακολουθώντας τη ροή εργασίας, απολαμβάνοντας την εμπειρία ανάπτυξης που καθοδηγείται από προδιαγραφές!
|
|
@@ -89,28 +89,11 @@ flowchart LR
|
|
|
89
89
|
|
|
90
90
|
---
|
|
91
91
|
|
|
92
|
-
## 3. Step Zero:
|
|
92
|
+
## 3. Step Zero: Knowledge Base Initialization
|
|
93
93
|
|
|
94
94
|
Before starting the formal engineering process, you need to initialize the project knowledge base.
|
|
95
95
|
|
|
96
|
-
### 3.1
|
|
97
|
-
|
|
98
|
-
**Conversation Example**:
|
|
99
|
-
```
|
|
100
|
-
@speccrew-team-leader diagnose project
|
|
101
|
-
```
|
|
102
|
-
|
|
103
|
-
**What the Agent Will Do**:
|
|
104
|
-
- Scan project structure
|
|
105
|
-
- Detect technology stack
|
|
106
|
-
- Identify business modules
|
|
107
|
-
|
|
108
|
-
**Deliverable**:
|
|
109
|
-
```
|
|
110
|
-
speccrew-workspace/knowledges/base/diagnosis-reports/diagnosis-report-{date}.md
|
|
111
|
-
```
|
|
112
|
-
|
|
113
|
-
### 3.2 Technical Knowledge Base Initialization
|
|
96
|
+
### 3.1 Technical Knowledge Base Initialization
|
|
114
97
|
|
|
115
98
|
**Conversation Example**:
|
|
116
99
|
```
|
|
@@ -132,7 +115,7 @@ speccrew-workspace/knowledges/techs/{platform-id}/
|
|
|
132
115
|
└── INDEX.md # Index file
|
|
133
116
|
```
|
|
134
117
|
|
|
135
|
-
### 3.
|
|
118
|
+
### 3.2 Business Knowledge Base Initialization
|
|
136
119
|
|
|
137
120
|
**Conversation Example**:
|
|
138
121
|
```
|
|
@@ -465,11 +448,29 @@ speccrew update
|
|
|
465
448
|
|
|
466
449
|
> **Note**: Both steps are required. Running only `speccrew update` will not update the CLI tool itself; running only `npm install` will not update project files.
|
|
467
450
|
|
|
468
|
-
### Q5:
|
|
451
|
+
### Q5: `speccrew update` shows new version available but `npm install -g speccrew@latest` still installs the old version?
|
|
452
|
+
|
|
453
|
+
This is usually caused by npm cache. Solution:
|
|
454
|
+
|
|
455
|
+
```bash
|
|
456
|
+
# Clear npm cache and reinstall
|
|
457
|
+
npm cache clean --force
|
|
458
|
+
npm install -g speccrew@latest
|
|
459
|
+
|
|
460
|
+
# Verify version
|
|
461
|
+
npm list -g speccrew
|
|
462
|
+
```
|
|
463
|
+
|
|
464
|
+
If it still doesn't work, try installing with a specific version number:
|
|
465
|
+
```bash
|
|
466
|
+
npm install -g speccrew@0.5.6
|
|
467
|
+
```
|
|
468
|
+
|
|
469
|
+
### Q6: How to view historical iterations?
|
|
469
470
|
|
|
470
471
|
After archiving, view in `speccrew-workspace/iteration-archives/`, organized by `{number}-{type}-{name}-{date}/` format.
|
|
471
472
|
|
|
472
|
-
###
|
|
473
|
+
### Q7: Does the knowledge base need regular updates?
|
|
473
474
|
|
|
474
475
|
Re-initialization is required in the following situations:
|
|
475
476
|
- Major changes to project structure
|
|
@@ -484,7 +485,6 @@ Re-initialization is required in the following situations:
|
|
|
484
485
|
|
|
485
486
|
| Phase | Agent | Start Conversation |
|
|
486
487
|
|-------|-------|-------------------|
|
|
487
|
-
| Diagnosis | Team Leader | `@speccrew-team-leader diagnose project` |
|
|
488
488
|
| Initialization | Team Leader | `@speccrew-team-leader initialize technical knowledge base` |
|
|
489
489
|
| Requirements Analysis | Product Manager | `@speccrew-product-manager I have a new requirement: [description]` |
|
|
490
490
|
| Feature Design | Feature Designer | `@speccrew-feature-designer start feature design` |
|
|
@@ -518,5 +518,5 @@ Re-initialization is required in the following situations:
|
|
|
518
518
|
## Next Steps
|
|
519
519
|
|
|
520
520
|
1. Run `speccrew init --ide qoder` to initialize your project
|
|
521
|
-
2. Execute Step Zero:
|
|
521
|
+
2. Execute Step Zero: Knowledge Base Initialization
|
|
522
522
|
3. Progress through each phase following the workflow, enjoying the specification-driven development experience!
|
|
@@ -89,28 +89,11 @@ flowchart LR
|
|
|
89
89
|
|
|
90
90
|
---
|
|
91
91
|
|
|
92
|
-
## 3. Paso Cero:
|
|
92
|
+
## 3. Paso Cero: Inicialización de la Base de Conocimientos
|
|
93
93
|
|
|
94
94
|
Antes de comenzar el proceso formal de ingeniería, necesita inicializar la base de conocimientos del proyecto.
|
|
95
95
|
|
|
96
|
-
### 3.1
|
|
97
|
-
|
|
98
|
-
**Ejemplo de Conversación**:
|
|
99
|
-
```
|
|
100
|
-
@speccrew-team-leader diagnosticar proyecto
|
|
101
|
-
```
|
|
102
|
-
|
|
103
|
-
**Qué Hará el Agente**:
|
|
104
|
-
- Escanear la estructura del proyecto
|
|
105
|
-
- Detectar el stack tecnológico
|
|
106
|
-
- Identificar módulos de negocio
|
|
107
|
-
|
|
108
|
-
**Entregable**:
|
|
109
|
-
```
|
|
110
|
-
speccrew-workspace/knowledges/base/diagnosis-reports/diagnosis-report-{date}.md
|
|
111
|
-
```
|
|
112
|
-
|
|
113
|
-
### 3.2 Inicialización de la Base de Conocimientos Técnica
|
|
96
|
+
### 3.1 Inicialización de la Base de Conocimientos Técnica
|
|
114
97
|
|
|
115
98
|
**Ejemplo de Conversación**:
|
|
116
99
|
```
|
|
@@ -132,7 +115,7 @@ speccrew-workspace/knowledges/techs/{platform-id}/
|
|
|
132
115
|
└── INDEX.md # Archivo de índice
|
|
133
116
|
```
|
|
134
117
|
|
|
135
|
-
### 3.
|
|
118
|
+
### 3.2 Inicialización de la Base de Conocimientos de Negocio
|
|
136
119
|
|
|
137
120
|
**Ejemplo de Conversación**:
|
|
138
121
|
```
|
|
@@ -465,11 +448,29 @@ speccrew update
|
|
|
465
448
|
|
|
466
449
|
> **Nota**: Ambos pasos deben ejecutarse. Ejecutar solo `speccrew update` no actualizará la herramienta CLI en sí; ejecutar solo `npm install` no actualizará los archivos en el proyecto.
|
|
467
450
|
|
|
468
|
-
### P5:
|
|
451
|
+
### P5: ¿`speccrew update` muestra nueva versión disponible pero `npm install -g speccrew@latest` sigue instalando la versión anterior?
|
|
452
|
+
|
|
453
|
+
Esto suele ser causado por la caché de npm. Solución:
|
|
454
|
+
|
|
455
|
+
```bash
|
|
456
|
+
# Limpiar caché de npm y reinstalar
|
|
457
|
+
npm cache clean --force
|
|
458
|
+
npm install -g speccrew@latest
|
|
459
|
+
|
|
460
|
+
# Verificar versión
|
|
461
|
+
npm list -g speccrew
|
|
462
|
+
```
|
|
463
|
+
|
|
464
|
+
Si aún no funciona, intente instalar con un número de versión específico:
|
|
465
|
+
```bash
|
|
466
|
+
npm install -g speccrew@0.5.6
|
|
467
|
+
```
|
|
468
|
+
|
|
469
|
+
### P6: ¿Cómo ver iteraciones históricas?
|
|
469
470
|
|
|
470
471
|
Después de archivar, consulte en `speccrew-workspace/iteration-archives/`, organizado en formato `{número}-{tipo}-{nombre}-{fecha}/`.
|
|
471
472
|
|
|
472
|
-
###
|
|
473
|
+
### P7: ¿La base de conocimientos necesita actualizaciones regulares?
|
|
473
474
|
|
|
474
475
|
Se requiere reinicialización en las siguientes situaciones:
|
|
475
476
|
- Cambios importantes en la estructura del proyecto
|
|
@@ -484,7 +485,6 @@ Se requiere reinicialización en las siguientes situaciones:
|
|
|
484
485
|
|
|
485
486
|
| Fase | Agente | Conversación de Inicio |
|
|
486
487
|
|------|--------|------------------------|
|
|
487
|
-
| Diagnóstico | Team Leader | `@speccrew-team-leader diagnosticar proyecto` |
|
|
488
488
|
| Inicialización | Team Leader | `@speccrew-team-leader inicializar base de conocimientos técnica` |
|
|
489
489
|
| Análisis de Requisitos | Product Manager | `@speccrew-product-manager tengo un nuevo requisito: [descripción]` |
|
|
490
490
|
| Diseño de Funcionalidades | Feature Designer | `@speccrew-feature-designer iniciar diseño de funcionalidades` |
|
|
@@ -518,5 +518,5 @@ Se requiere reinicialización en las siguientes situaciones:
|
|
|
518
518
|
## Próximos Pasos
|
|
519
519
|
|
|
520
520
|
1. Ejecute `speccrew init --ide qoder` para inicializar su proyecto
|
|
521
|
-
2. Ejecute el Paso Cero:
|
|
521
|
+
2. Ejecute el Paso Cero: Inicialización de la Base de Conocimientos
|
|
522
522
|
3. Avance a través de cada fase siguiendo el flujo de trabajo, ¡disfrutando de la experiencia de desarrollo impulsada por especificaciones!
|
|
@@ -89,28 +89,11 @@ flowchart LR
|
|
|
89
89
|
|
|
90
90
|
---
|
|
91
91
|
|
|
92
|
-
## 3. Étape Zéro :
|
|
92
|
+
## 3. Étape Zéro : Initialisation de la Base de Connaissances
|
|
93
93
|
|
|
94
94
|
Avant de commencer le processus d'ingénierie formel, vous devez initialiser la base de connaissances du projet.
|
|
95
95
|
|
|
96
|
-
### 3.1
|
|
97
|
-
|
|
98
|
-
**Exemple de Conversation** :
|
|
99
|
-
```
|
|
100
|
-
@speccrew-team-leader diagnostiquer le projet
|
|
101
|
-
```
|
|
102
|
-
|
|
103
|
-
**Ce que l'Agent fera** :
|
|
104
|
-
- Scanner la structure du projet
|
|
105
|
-
- Détecter la pile technologique
|
|
106
|
-
- Identifier les modules métier
|
|
107
|
-
|
|
108
|
-
**Livrable** :
|
|
109
|
-
```
|
|
110
|
-
speccrew-workspace/knowledges/base/diagnosis-reports/diagnosis-report-{date}.md
|
|
111
|
-
```
|
|
112
|
-
|
|
113
|
-
### 3.2 Initialisation de la Base de Connaissances Techniques
|
|
96
|
+
### 3.1 Initialisation de la Base de Connaissances Techniques
|
|
114
97
|
|
|
115
98
|
**Exemple de Conversation** :
|
|
116
99
|
```
|
|
@@ -132,7 +115,7 @@ speccrew-workspace/knowledges/techs/{platform-id}/
|
|
|
132
115
|
└── INDEX.md # Fichier d'index
|
|
133
116
|
```
|
|
134
117
|
|
|
135
|
-
### 3.
|
|
118
|
+
### 3.2 Initialisation de la Base de Connaissances Métier
|
|
136
119
|
|
|
137
120
|
**Exemple de Conversation** :
|
|
138
121
|
```
|
|
@@ -465,11 +448,29 @@ speccrew update
|
|
|
465
448
|
|
|
466
449
|
> **Remarque** : Les deux étapes doivent être exécutées. Exécuter uniquement `speccrew update` ne mettra pas à jour l'outil CLI lui-même ; exécuter uniquement `npm install` ne mettra pas à jour les fichiers dans le projet.
|
|
467
450
|
|
|
468
|
-
### Q5 :
|
|
451
|
+
### Q5 : `speccrew update` montre qu'une nouvelle version est disponible mais `npm install -g speccrew@latest` installe toujours l'ancienne version ?
|
|
452
|
+
|
|
453
|
+
Ceci est généralement causé par le cache npm. Solution :
|
|
454
|
+
|
|
455
|
+
```bash
|
|
456
|
+
# Vider le cache npm et réinstaller
|
|
457
|
+
npm cache clean --force
|
|
458
|
+
npm install -g speccrew@latest
|
|
459
|
+
|
|
460
|
+
# Vérifier la version
|
|
461
|
+
npm list -g speccrew
|
|
462
|
+
```
|
|
463
|
+
|
|
464
|
+
Si cela ne fonctionne toujours pas, essayez d'installer avec un numéro de version spécifique :
|
|
465
|
+
```bash
|
|
466
|
+
npm install -g speccrew@0.5.6
|
|
467
|
+
```
|
|
468
|
+
|
|
469
|
+
### Q6 : Comment consulter les itérations historiques ?
|
|
469
470
|
|
|
470
471
|
Après archivage, consultez dans `speccrew-workspace/iteration-archives/`, organisé par le format `{numéro}-{type}-{nom}-{date}/`.
|
|
471
472
|
|
|
472
|
-
###
|
|
473
|
+
### Q7 : La base de connaissances a-t-elle besoin de mises à jour régulières ?
|
|
473
474
|
|
|
474
475
|
La réinitialisation est nécessaire dans les situations suivantes :
|
|
475
476
|
- Changements majeurs dans la structure du projet
|
|
@@ -484,7 +485,6 @@ La réinitialisation est nécessaire dans les situations suivantes :
|
|
|
484
485
|
|
|
485
486
|
| Phase | Agent | Conversation de Démarrage |
|
|
486
487
|
|-------|-------|---------------------------|
|
|
487
|
-
| Diagnostic | Team Leader | `@speccrew-team-leader diagnostiquer le projet` |
|
|
488
488
|
| Initialisation | Team Leader | `@speccrew-team-leader initialiser la base de connaissances techniques` |
|
|
489
489
|
| Analyse des Exigences | Product Manager | `@speccrew-product-manager J'ai une nouvelle exigence : [description]` |
|
|
490
490
|
| Feature Design | Feature Designer | `@speccrew-feature-designer démarrer la conception de fonctionnalité` |
|
|
@@ -518,5 +518,5 @@ La réinitialisation est nécessaire dans les situations suivantes :
|
|
|
518
518
|
## Prochaines Étapes
|
|
519
519
|
|
|
520
520
|
1. Exécuter `speccrew init --ide qoder` pour initialiser votre projet
|
|
521
|
-
2. Exécuter l'Étape Zéro :
|
|
521
|
+
2. Exécuter l'Étape Zéro : Initialisation de la Base de Connaissances
|
|
522
522
|
3. Progresser à travers chaque phase en suivant le flux de travail, en profitant de l'expérience de développement piloté par les spécifications !
|
|
@@ -89,28 +89,11 @@ flowchart LR
|
|
|
89
89
|
|
|
90
90
|
---
|
|
91
91
|
|
|
92
|
-
## 3.
|
|
92
|
+
## 3. Inizializzazione Base Conoscenza
|
|
93
93
|
|
|
94
94
|
Prima di iniziare il processo di ingegneria formale, devi inizializzare la base di conoscenza del progetto.
|
|
95
95
|
|
|
96
|
-
### 3.1
|
|
97
|
-
|
|
98
|
-
**Esempio Conversazione**:
|
|
99
|
-
```
|
|
100
|
-
@speccrew-team-leader diagnosticare il progetto
|
|
101
|
-
```
|
|
102
|
-
|
|
103
|
-
**Cosa farà l'Agent**:
|
|
104
|
-
- Scansionare la struttura del progetto
|
|
105
|
-
- Rilevare lo stack tecnologico
|
|
106
|
-
- Identificare i moduli business
|
|
107
|
-
|
|
108
|
-
**Deliverable**:
|
|
109
|
-
```
|
|
110
|
-
speccrew-workspace/knowledges/base/diagnosis-reports/diagnosis-report-{date}.md
|
|
111
|
-
```
|
|
112
|
-
|
|
113
|
-
### 3.2 Inizializzazione Base Conoscenza Tecnica
|
|
96
|
+
### 3.1 Inizializzazione Base Conoscenza Tecnica
|
|
114
97
|
|
|
115
98
|
**Esempio Conversazione**:
|
|
116
99
|
```
|
|
@@ -132,7 +115,7 @@ speccrew-workspace/knowledges/techs/{platform-id}/
|
|
|
132
115
|
└── INDEX.md # File indice
|
|
133
116
|
```
|
|
134
117
|
|
|
135
|
-
### 3.
|
|
118
|
+
### 3.2 Inizializzazione Base Conoscenza Business
|
|
136
119
|
|
|
137
120
|
**Esempio Conversazione**:
|
|
138
121
|
```
|
|
@@ -465,11 +448,26 @@ speccrew update
|
|
|
465
448
|
|
|
466
449
|
> **Nota**: Entrambi i passaggi devono essere eseguiti. Eseguire solo `speccrew update` non aggiornerà lo strumento CLI stesso; eseguire solo `npm install` non aggiornerà i file nel progetto.
|
|
467
450
|
|
|
468
|
-
### Q5:
|
|
451
|
+
### Q5: `speccrew update` mostra una nuova versione ma dopo l'installazione è ancora la vecchia?
|
|
452
|
+
|
|
453
|
+
Solitamente è causato dalla cache npm. Soluzione:
|
|
454
|
+
|
|
455
|
+
```bash
|
|
456
|
+
npm cache clean --force
|
|
457
|
+
npm install -g speccrew@latest
|
|
458
|
+
npm list -g speccrew
|
|
459
|
+
```
|
|
460
|
+
|
|
461
|
+
Se ancora non funziona, specifica il numero di versione:
|
|
462
|
+
```bash
|
|
463
|
+
npm install -g speccrew@0.5.6
|
|
464
|
+
```
|
|
465
|
+
|
|
466
|
+
### Q6: Come visualizzare le iterazioni storiche?
|
|
469
467
|
|
|
470
468
|
Dopo l'archiviazione, visualizzare in `speccrew-workspace/iteration-archives/`, organizzate per formato `{numero}-{tipo}-{nome}-{date}/`.
|
|
471
469
|
|
|
472
|
-
###
|
|
470
|
+
### Q7: La base di conoscenza necessita di aggiornamenti regolari?
|
|
473
471
|
|
|
474
472
|
La re-inizializzazione è necessaria nelle seguenti situazioni:
|
|
475
473
|
- Cambiamenti importanti nella struttura del progetto
|
|
@@ -484,7 +482,7 @@ La re-inizializzazione è necessaria nelle seguenti situazioni:
|
|
|
484
482
|
|
|
485
483
|
| Fase | Agent | Conversazione di Avvio |
|
|
486
484
|
|------|-------|------------------------|
|
|
487
|
-
|
|
485
|
+
|
|
488
486
|
| Inizializzazione | Team Leader | `@speccrew-team-leader inizializzare la base conoscenza tecnica` |
|
|
489
487
|
| Analisi Requisiti | Product Manager | `@speccrew-product-manager Ho un nuovo requisito: [descrizione]` |
|
|
490
488
|
| Feature Design | Feature Designer | `@speccrew-feature-designer iniziare il feature design` |
|
|
@@ -518,5 +516,5 @@ La re-inizializzazione è necessaria nelle seguenti situazioni:
|
|
|
518
516
|
## Prossimi Passi
|
|
519
517
|
|
|
520
518
|
1. Eseguire `speccrew init --ide qoder` per inizializzare il tuo progetto
|
|
521
|
-
2. Eseguire
|
|
519
|
+
2. Eseguire l'inizializzazione della Base Conoscenza
|
|
522
520
|
3. Procedere attraverso ogni fase seguendo il workflow, godendoti l'esperienza di sviluppo specification-driven!
|