speccrew 0.5.6 → 0.5.8
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
- package/workspace-template/scripts/update-progress.js +168 -1
|
@@ -89,28 +89,11 @@ flowchart LR
|
|
|
89
89
|
|
|
90
90
|
---
|
|
91
91
|
|
|
92
|
-
## 3. ステップ0
|
|
92
|
+
## 3. ステップ0:ナレッジベース初期化
|
|
93
93
|
|
|
94
94
|
正式なエンジニアリングフローを開始する前に、プロジェクトナレッジベースを初期化する必要があります。
|
|
95
95
|
|
|
96
|
-
### 3.1
|
|
97
|
-
|
|
98
|
-
**会話例**:
|
|
99
|
-
```
|
|
100
|
-
@speccrew-team-leader プロジェクトを診断
|
|
101
|
-
```
|
|
102
|
-
|
|
103
|
-
**エージェントの動作**:
|
|
104
|
-
- プロジェクト構造をスキャン
|
|
105
|
-
- テクノロジースタックを検出
|
|
106
|
-
- ビジネスモジュールを識別
|
|
107
|
-
|
|
108
|
-
**成果物**:
|
|
109
|
-
```
|
|
110
|
-
speccrew-workspace/knowledges/base/diagnosis-reports/diagnosis-report-{date}.md
|
|
111
|
-
```
|
|
112
|
-
|
|
113
|
-
### 3.2 テクニカルナレッジベース初期化
|
|
96
|
+
### 3.1 テクニカルナレッジベース初期化
|
|
114
97
|
|
|
115
98
|
**会話例**:
|
|
116
99
|
```
|
|
@@ -132,7 +115,7 @@ speccrew-workspace/knowledges/techs/{platform-id}/
|
|
|
132
115
|
└── INDEX.md # インデックスファイル
|
|
133
116
|
```
|
|
134
117
|
|
|
135
|
-
### 3.
|
|
118
|
+
### 3.2 ビジネスナレッジベース初期化
|
|
136
119
|
|
|
137
120
|
**会話例**:
|
|
138
121
|
```
|
|
@@ -465,11 +448,29 @@ speccrew update
|
|
|
465
448
|
|
|
466
449
|
> **注意**:両方のステップを実行する必要があります。`speccrew update`のみを実行してもCLIツール自体は更新されません;`npm install`のみを実行してもプロジェクト内のファイルは更新されません。
|
|
467
450
|
|
|
468
|
-
### Q5:
|
|
451
|
+
### Q5: `speccrew update` で新バージョンが利用可能と表示されるが、`npm install -g speccrew@latest` でも古いバージョンがインストールされる?
|
|
452
|
+
|
|
453
|
+
これは通常npmキャッシュが原因です。解決方法:
|
|
454
|
+
|
|
455
|
+
```bash
|
|
456
|
+
# npmキャッシュをクリアして再インストール
|
|
457
|
+
npm cache clean --force
|
|
458
|
+
npm install -g speccrew@latest
|
|
459
|
+
|
|
460
|
+
# バージョンを確認
|
|
461
|
+
npm list -g speccrew
|
|
462
|
+
```
|
|
463
|
+
|
|
464
|
+
それでも解決しない場合は、特定のバージョン番号を指定してインストールしてみてください:
|
|
465
|
+
```bash
|
|
466
|
+
npm install -g speccrew@0.5.6
|
|
467
|
+
```
|
|
468
|
+
|
|
469
|
+
### Q6: 過去のイテレーションを表示するには?
|
|
469
470
|
|
|
470
471
|
アーカイブ後、`speccrew-workspace/iteration-archives/`で表示、`{シーケンス}-{タイプ}-{名前}-{日付}/`形式で整理。
|
|
471
472
|
|
|
472
|
-
###
|
|
473
|
+
### Q7: ナレッジベースは定期的に更新が必要ですか?
|
|
473
474
|
|
|
474
475
|
以下の場合は再初期化が必要です:
|
|
475
476
|
- プロジェクト構造が大幅に変更
|
|
@@ -484,7 +485,6 @@ speccrew update
|
|
|
484
485
|
|
|
485
486
|
| フェーズ | エージェント | 起動会話 |
|
|
486
487
|
|------|-------|----------|
|
|
487
|
-
| 診断 | Team Leader | `@speccrew-team-leader プロジェクトを診断` |
|
|
488
488
|
| 初期化 | Team Leader | `@speccrew-team-leader テクニカルナレッジベースを初期化` |
|
|
489
489
|
| 要件分析 | Product Manager | `@speccrew-product-manager 新しい要件があります:[説明]` |
|
|
490
490
|
| 機能設計 | Feature Designer | `@speccrew-feature-designer 機能設計を開始` |
|
|
@@ -518,5 +518,5 @@ speccrew update
|
|
|
518
518
|
## 9. 次のステップ
|
|
519
519
|
|
|
520
520
|
1. `speccrew init --ide qoder`を実行してプロジェクトを初期化
|
|
521
|
-
2. ステップ0
|
|
521
|
+
2. ステップ0を実行:ナレッジベース初期化
|
|
522
522
|
3. ワークフローに従ってフェーズごとに進め、仕様駆動の開発体験を楽しんでください!
|
|
@@ -89,7 +89,7 @@ flowchart LR
|
|
|
89
89
|
|
|
90
90
|
---
|
|
91
91
|
|
|
92
|
-
## 3. 0단계:
|
|
92
|
+
## 3. 0단계: 지식 기반 초기화
|
|
93
93
|
|
|
94
94
|
공식 엔지니어링 프로세스를 시작하기 전에 프로젝트 지식 기반을 초기화해야 합니다.
|
|
95
95
|
|
|
@@ -132,7 +132,7 @@ speccrew-workspace/knowledges/techs/{platform-id}/
|
|
|
132
132
|
└── INDEX.md # 인덱스 파일
|
|
133
133
|
```
|
|
134
134
|
|
|
135
|
-
### 3.
|
|
135
|
+
### 3.2 비즈니스 지식 기반 초기화
|
|
136
136
|
|
|
137
137
|
**대화 예시**:
|
|
138
138
|
```
|
|
@@ -469,7 +469,7 @@ speccrew update
|
|
|
469
469
|
|
|
470
470
|
보관 후 `speccrew-workspace/iteration-archives/`에서 `{번호}-{유형}-{이름}-{날짜}/` 형식으로 확인할 수 있습니다.
|
|
471
471
|
|
|
472
|
-
###
|
|
472
|
+
### Q7: 지식 기반을 정기적으로 업데이트해야 하나요?
|
|
473
473
|
|
|
474
474
|
다음 상황에서 재초기화가 필요합니다:
|
|
475
475
|
- 프로젝트 구조의 주요 변경
|
|
@@ -518,5 +518,5 @@ speccrew update
|
|
|
518
518
|
## 9. 다음 단계
|
|
519
519
|
|
|
520
520
|
1. `speccrew init --ide qoder`를 실행하여 프로젝트 초기화
|
|
521
|
-
2. 0단계 실행:
|
|
521
|
+
2. 0단계 실행: 지식 기반 초기화
|
|
522
522
|
3. 워크플로우에 따라 각 단계를 진행하며 명세 기반 개발 경험을 즐기세요!
|
package/docs/GETTING-STARTED.md
CHANGED
|
@@ -89,28 +89,11 @@ flowchart LR
|
|
|
89
89
|
|
|
90
90
|
---
|
|
91
91
|
|
|
92
|
-
## 3.
|
|
92
|
+
## 3. 第零步:知识库初始化
|
|
93
93
|
|
|
94
94
|
在开始正式工程流程前,需要先初始化项目知识库。
|
|
95
95
|
|
|
96
|
-
### 3.1
|
|
97
|
-
|
|
98
|
-
**对话示例**:
|
|
99
|
-
```
|
|
100
|
-
@speccrew-team-leader 诊断项目
|
|
101
|
-
```
|
|
102
|
-
|
|
103
|
-
**Agent 会做什么**:
|
|
104
|
-
- 扫描项目结构
|
|
105
|
-
- 检测技术栈
|
|
106
|
-
- 识别业务模块
|
|
107
|
-
|
|
108
|
-
**产出物**:
|
|
109
|
-
```
|
|
110
|
-
speccrew-workspace/knowledges/base/diagnosis-reports/diagnosis-report-{date}.md
|
|
111
|
-
```
|
|
112
|
-
|
|
113
|
-
### 3.2 技术知识库初始化
|
|
96
|
+
### 3.1 技术知识库初始化
|
|
114
97
|
|
|
115
98
|
**对话示例**:
|
|
116
99
|
```
|
|
@@ -132,7 +115,7 @@ speccrew-workspace/knowledges/techs/{platform-id}/
|
|
|
132
115
|
└── INDEX.md # 索引文件
|
|
133
116
|
```
|
|
134
117
|
|
|
135
|
-
### 3.
|
|
118
|
+
### 3.2 业务知识库初始化
|
|
136
119
|
|
|
137
120
|
**对话示例**:
|
|
138
121
|
```
|
|
@@ -465,11 +448,29 @@ speccrew update
|
|
|
465
448
|
|
|
466
449
|
> **注意**:两步都需要执行。仅执行 `speccrew update` 不会更新 CLI 工具本身;仅执行 `npm install` 不会更新项目中的文件。
|
|
467
450
|
|
|
468
|
-
### Q5:
|
|
451
|
+
### Q5: `speccrew update` 提示有新版本但 `npm install -g speccrew@latest` 安装后仍是旧版本?
|
|
452
|
+
|
|
453
|
+
这通常是 npm 缓存问题。解决方法:
|
|
454
|
+
|
|
455
|
+
```bash
|
|
456
|
+
# 清除 npm 缓存后重新安装
|
|
457
|
+
npm cache clean --force
|
|
458
|
+
npm install -g speccrew@latest
|
|
459
|
+
|
|
460
|
+
# 验证版本
|
|
461
|
+
npm list -g speccrew
|
|
462
|
+
```
|
|
463
|
+
|
|
464
|
+
如果仍然不行,尝试指定具体版本号安装:
|
|
465
|
+
```bash
|
|
466
|
+
npm install -g speccrew@0.5.6
|
|
467
|
+
```
|
|
468
|
+
|
|
469
|
+
### Q6: 如何查看历史迭代?
|
|
469
470
|
|
|
470
471
|
归档后在 `speccrew-workspace/iteration-archives/` 中查看,按 `{序号}-{类型}-{名称}-{日期}/` 格式组织。
|
|
471
472
|
|
|
472
|
-
###
|
|
473
|
+
### Q7: 知识库需要定期更新吗?
|
|
473
474
|
|
|
474
475
|
以下情况需要重新初始化:
|
|
475
476
|
- 项目结构发生重大变化
|
|
@@ -484,7 +485,6 @@ speccrew update
|
|
|
484
485
|
|
|
485
486
|
| 阶段 | Agent | 启动对话 |
|
|
486
487
|
|------|-------|----------|
|
|
487
|
-
| 诊断 | Team Leader | `@speccrew-team-leader 诊断项目` |
|
|
488
488
|
| 初始化 | Team Leader | `@speccrew-team-leader 初始化技术知识库` |
|
|
489
489
|
| 需求分析 | Product Manager | `@speccrew-product-manager 我有一个新需求:[描述]` |
|
|
490
490
|
| 功能设计 | Feature Designer | `@speccrew-feature-designer 开始功能设计` |
|
|
@@ -518,5 +518,5 @@ speccrew update
|
|
|
518
518
|
## 下一步
|
|
519
519
|
|
|
520
520
|
1. 运行 `speccrew init --ide qoder` 初始化您的项目
|
|
521
|
-
2.
|
|
521
|
+
2. 执行第零步:知识库初始化
|
|
522
522
|
3. 按照工作流程逐阶段推进,享受规范驱动的开发体验!
|
|
@@ -90,28 +90,11 @@ flowchart LR
|
|
|
90
90
|
|
|
91
91
|
---
|
|
92
92
|
|
|
93
|
-
## 3.
|
|
93
|
+
## 3. Kunnskapsbase-initialisering
|
|
94
94
|
|
|
95
95
|
Før du starter den formelle ingeniørprosessen, må du initialisere prosjektets kunnskapsbase.
|
|
96
96
|
|
|
97
|
-
### 3.1
|
|
98
|
-
|
|
99
|
-
**Eksempel på Dialog**:
|
|
100
|
-
```
|
|
101
|
-
@speccrew-team-leader diagnostiser prosjekt
|
|
102
|
-
```
|
|
103
|
-
|
|
104
|
-
**Hva Agenten Vil Gjøre**:
|
|
105
|
-
- Skann prosjektstruktur
|
|
106
|
-
- Oppdag teknologistabel
|
|
107
|
-
- Identifiser forretningsmoduler
|
|
108
|
-
|
|
109
|
-
**Leveranse**:
|
|
110
|
-
```
|
|
111
|
-
speccrew-workspace/knowledges/base/diagnosis-reports/diagnosis-report-{date}.md
|
|
112
|
-
```
|
|
113
|
-
|
|
114
|
-
### 3.2 Initialiser Teknisk Kunnskapsbase
|
|
97
|
+
### 3.1 Initialiser Teknisk Kunnskapsbase
|
|
115
98
|
|
|
116
99
|
**Eksempel på Dialog**:
|
|
117
100
|
```
|
|
@@ -133,7 +116,7 @@ speccrew-workspace/knowledges/techs/{platform-id}/
|
|
|
133
116
|
└── INDEX.md # Indeksfil
|
|
134
117
|
```
|
|
135
118
|
|
|
136
|
-
### 3.
|
|
119
|
+
### 3.2 Initialiser Forretningskunnskapsbase
|
|
137
120
|
|
|
138
121
|
**Eksempel på Dialog**:
|
|
139
122
|
```
|
|
@@ -466,11 +449,26 @@ speccrew update
|
|
|
466
449
|
|
|
467
450
|
> **Merk**: Begge trinnene er nødvendige. Hvis du bare kjører `speccrew update`, oppdateres ikke selve CLI-verktøyet; hvis du bare kjører `npm install`, oppdateres ikke prosjektfilene.
|
|
468
451
|
|
|
469
|
-
### S5:
|
|
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?
|
|
470
468
|
|
|
471
469
|
Etter arkivering, se i `speccrew-workspace/iteration-archives/`, organisert i formatet `{nummer}-{type}-{navn}-{dato}/`.
|
|
472
470
|
|
|
473
|
-
###
|
|
471
|
+
### S7: Trenger kunnskapsbasen regelmessig oppdatering?
|
|
474
472
|
|
|
475
473
|
Re-initialisering kreves i følgende situasjoner:
|
|
476
474
|
- Betydelige endringer i prosjektstruktur
|
|
@@ -485,7 +483,7 @@ Re-initialisering kreves i følgende situasjoner:
|
|
|
485
483
|
|
|
486
484
|
| Fase | Agent | Startdialog |
|
|
487
485
|
|------|-------|-------------------|
|
|
488
|
-
|
|
486
|
+
|
|
489
487
|
| Initialisering | Team Leader | `@speccrew-team-leader initialiser teknisk kunnskapsbase` |
|
|
490
488
|
| Kravanalyse | Product Manager | `@speccrew-product-manager jeg har et nytt krav: [beskrivelse]` |
|
|
491
489
|
| Funksjonsdesign | Feature Designer | `@speccrew-feature-designer start funksjonsdesign` |
|
|
@@ -519,5 +517,5 @@ Re-initialisering kreves i følgende situasjoner:
|
|
|
519
517
|
## Neste Steg
|
|
520
518
|
|
|
521
519
|
1. Kjør `speccrew init --ide qoder` for å initialisere prosjektet ditt
|
|
522
|
-
2. Utfør
|
|
520
|
+
2. Utfør Kunnskapsbase-initialisering
|
|
523
521
|
3. Beveg deg gjennom hver fase etter arbeidsflyten, nyt spesifikasjonsdrevet utviklingserfaring!
|
|
@@ -90,28 +90,11 @@ flowchart LR
|
|
|
90
90
|
|
|
91
91
|
---
|
|
92
92
|
|
|
93
|
-
## 3. Krok zerowy:
|
|
93
|
+
## 3. Krok zerowy: Inicjalizacja bazy wiedzy
|
|
94
94
|
|
|
95
95
|
Przed rozpoczęciem formalnego procesu inżynieryjnego musisz zainicjować bazę wiedzy projektu.
|
|
96
96
|
|
|
97
|
-
### 3.1
|
|
98
|
-
|
|
99
|
-
**Przykład rozmowy**:
|
|
100
|
-
```
|
|
101
|
-
@speccrew-team-leader zdiagnozuj projekt
|
|
102
|
-
```
|
|
103
|
-
|
|
104
|
-
**Co zrobi Agent**:
|
|
105
|
-
- Skanowanie struktury projektu
|
|
106
|
-
- Wykrywanie stosu technologicznego
|
|
107
|
-
- Identyfikacja modułów biznesowych
|
|
108
|
-
|
|
109
|
-
**Dostarczalny**:
|
|
110
|
-
```
|
|
111
|
-
speccrew-workspace/knowledges/base/diagnosis-reports/diagnosis-report-{date}.md
|
|
112
|
-
```
|
|
113
|
-
|
|
114
|
-
### 3.2 Inicjalizacja bazy wiedzy technicznej
|
|
97
|
+
### 3.1 Inicjalizacja bazy wiedzy technicznej
|
|
115
98
|
|
|
116
99
|
**Przykład rozmowy**:
|
|
117
100
|
```
|
|
@@ -133,7 +116,7 @@ speccrew-workspace/knowledges/techs/{platform-id}/
|
|
|
133
116
|
└── INDEX.md # Plik indeksu
|
|
134
117
|
```
|
|
135
118
|
|
|
136
|
-
### 3.
|
|
119
|
+
### 3.2 Inicjalizacja bazy wiedzy biznesowej
|
|
137
120
|
|
|
138
121
|
**Przykład rozmowy**:
|
|
139
122
|
```
|
|
@@ -466,11 +449,24 @@ speccrew update
|
|
|
466
449
|
|
|
467
450
|
> **Uwaga**: Oba kroki są wymagane. Uruchomienie tylko `speccrew update` nie zaktualizuje samego narzędzia CLI; uruchomienie tylko `npm install` nie zaktualizuje plików projektu.
|
|
468
451
|
|
|
469
|
-
### P5:
|
|
452
|
+
### P5: `speccrew update` pokazuje nową wersję, ale po instalacji nadal jest stara?
|
|
453
|
+
|
|
454
|
+
Zazwyczaj jest to spowodowane pamięcią podręczną npm. Rozwiązanie:
|
|
455
|
+
```bash
|
|
456
|
+
npm cache clean --force
|
|
457
|
+
npm install -g speccrew@latest
|
|
458
|
+
npm list -g speccrew
|
|
459
|
+
```
|
|
460
|
+
Jeśli nadal nie działa, zainstaluj określoną wersję:
|
|
461
|
+
```bash
|
|
462
|
+
npm install -g speccrew@0.5.6
|
|
463
|
+
```
|
|
464
|
+
|
|
465
|
+
### P6: Jak wyświetlić historyczne iteracje?
|
|
470
466
|
|
|
471
467
|
Po zarchiwizowaniu przejrzyj w `speccrew-workspace/iteration-archives/`, zorganizowane w formacie `{numer}-{typ}-{nazwa}-{data}/`.
|
|
472
468
|
|
|
473
|
-
###
|
|
469
|
+
### P7: Czy baza wiedzy wymaga regularnej aktualizacji?
|
|
474
470
|
|
|
475
471
|
Ponowna inicjalizacja jest wymagana w następujących sytuacjach:
|
|
476
472
|
- Znaczne zmiany w strukturze projektu
|
|
@@ -485,7 +481,7 @@ Ponowna inicjalizacja jest wymagana w następujących sytuacjach:
|
|
|
485
481
|
|
|
486
482
|
| Faza | Agent | Rozmowa początkowa |
|
|
487
483
|
|------|-------|-------------------|
|
|
488
|
-
|
|
484
|
+
|
|
489
485
|
| Inicjalizacja | Team Leader | `@speccrew-team-leader zainicjuj bazę wiedzy technicznej` |
|
|
490
486
|
| Analiza wymagań | Product Manager | `@speccrew-product-manager mam nowe wymaganie: [opis]` |
|
|
491
487
|
| Projektowanie funkcji | Feature Designer | `@speccrew-feature-designer rozpocznij projektowanie funkcji` |
|
|
@@ -519,5 +515,5 @@ Ponowna inicjalizacja jest wymagana w następujących sytuacjach:
|
|
|
519
515
|
## Następne kroki
|
|
520
516
|
|
|
521
517
|
1. Uruchom `speccrew init --ide qoder`, aby zainicjować swój projekt
|
|
522
|
-
2. Wykonaj Krok zerowy:
|
|
518
|
+
2. Wykonaj Krok zerowy: Inicjalizacja bazy wiedzy
|
|
523
519
|
3. Przechodź przez każdą fazę zgodnie z przepływem pracy, ciesząc się doświadczeniem rozwoju opartego na specyfikacjach!
|
|
@@ -90,28 +90,11 @@ flowchart LR
|
|
|
90
90
|
|
|
91
91
|
---
|
|
92
92
|
|
|
93
|
-
## 3. Passo Zero:
|
|
93
|
+
## 3. Passo Zero: Inicialização da Base de Conhecimento
|
|
94
94
|
|
|
95
95
|
Antes de iniciar o processo formal de engenharia, você precisa inicializar a base de conhecimento do projeto.
|
|
96
96
|
|
|
97
|
-
### 3.1
|
|
98
|
-
|
|
99
|
-
**Exemplo de Conversa**:
|
|
100
|
-
```
|
|
101
|
-
@speccrew-team-leader diagnosticar projeto
|
|
102
|
-
```
|
|
103
|
-
|
|
104
|
-
**O que o Agente fará**:
|
|
105
|
-
- Escanear estrutura do projeto
|
|
106
|
-
- Detectar stack tecnológico
|
|
107
|
-
- Identificar módulos de negócio
|
|
108
|
-
|
|
109
|
-
**Entregável**:
|
|
110
|
-
```
|
|
111
|
-
speccrew-workspace/knowledges/base/diagnosis-reports/diagnosis-report-{date}.md
|
|
112
|
-
```
|
|
113
|
-
|
|
114
|
-
### 3.2 Inicialização da Base de Conhecimento Técnica
|
|
97
|
+
### 3.1 Inicialização da Base de Conhecimento Técnica
|
|
115
98
|
|
|
116
99
|
**Exemplo de Conversa**:
|
|
117
100
|
```
|
|
@@ -133,7 +116,7 @@ speccrew-workspace/knowledges/techs/{platform-id}/
|
|
|
133
116
|
└── INDEX.md # Arquivo de índice
|
|
134
117
|
```
|
|
135
118
|
|
|
136
|
-
### 3.
|
|
119
|
+
### 3.2 Inicialização da Base de Conhecimento de Negócio
|
|
137
120
|
|
|
138
121
|
**Exemplo de Conversa**:
|
|
139
122
|
```
|
|
@@ -466,11 +449,24 @@ speccrew update
|
|
|
466
449
|
|
|
467
450
|
> **Nota**: Ambas as etapas são necessárias. Executar apenas `speccrew update` não atualizará a própria ferramenta CLI; executar apenas `npm install` não atualizará os arquivos do projeto.
|
|
468
451
|
|
|
469
|
-
### P5:
|
|
452
|
+
### P5: `speccrew update` mostra nova versão mas após instalação ainda é a antiga?
|
|
453
|
+
|
|
454
|
+
Geralmente é causado pelo cache do npm. Solução:
|
|
455
|
+
```bash
|
|
456
|
+
npm cache clean --force
|
|
457
|
+
npm install -g speccrew@latest
|
|
458
|
+
npm list -g speccrew
|
|
459
|
+
```
|
|
460
|
+
Se ainda não funcionar, instale uma versão específica:
|
|
461
|
+
```bash
|
|
462
|
+
npm install -g speccrew@0.5.6
|
|
463
|
+
```
|
|
464
|
+
|
|
465
|
+
### P6: Como ver iterações históricas?
|
|
470
466
|
|
|
471
467
|
Após arquivar, consulte em `speccrew-workspace/iteration-archives/`, organizado no formato `{número}-{tipo}-{nome}-{data}/`.
|
|
472
468
|
|
|
473
|
-
###
|
|
469
|
+
### P7: A base de conhecimento precisa de atualizações regulares?
|
|
474
470
|
|
|
475
471
|
Reinicialização é necessária nas seguintes situações:
|
|
476
472
|
- Mudanças significativas na estrutura do projeto
|
|
@@ -485,7 +481,7 @@ Reinicialização é necessária nas seguintes situações:
|
|
|
485
481
|
|
|
486
482
|
| Fase | Agente | Conversa de Início |
|
|
487
483
|
|------|--------|-------------------|
|
|
488
|
-
|
|
484
|
+
|
|
489
485
|
| Inicialização | Team Leader | `@speccrew-team-leader inicializar base de conhecimento técnica` |
|
|
490
486
|
| Análise de Requisitos | Product Manager | `@speccrew-product-manager tenho um novo requisito: [descrição]` |
|
|
491
487
|
| Design de Funcionalidades | Feature Designer | `@speccrew-feature-designer iniciar design de funcionalidades` |
|
|
@@ -519,5 +515,5 @@ Reinicialização é necessária nas seguintes situações:
|
|
|
519
515
|
## Próximos Passos
|
|
520
516
|
|
|
521
517
|
1. Execute `speccrew init --ide qoder` para inicializar seu projeto
|
|
522
|
-
2. Execute o Passo Zero:
|
|
518
|
+
2. Execute o Passo Zero: Inicialização da Base de Conhecimento
|
|
523
519
|
3. Avance através de cada fase seguindo o fluxo de trabalho, aproveitando a experiência de desenvolvimento orientada por especificações!
|
|
@@ -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
|
-
**Что сделает Агент**:
|
|
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,24 @@ speccrew update
|
|
|
466
449
|
|
|
467
450
|
> **Примечание**: Оба этапа обязательны. Выполнение только `speccrew update` не обновит сам CLI-инструмент; выполнение только `npm install` не обновит файлы проекта.
|
|
468
451
|
|
|
469
|
-
### В5:
|
|
452
|
+
### В5: `speccrew update` показывает новую версию, но после установки всё ещё старая?
|
|
453
|
+
|
|
454
|
+
Обычно это вызвано кэшем npm. Решение:
|
|
455
|
+
```bash
|
|
456
|
+
npm cache clean --force
|
|
457
|
+
npm install -g speccrew@latest
|
|
458
|
+
npm list -g speccrew
|
|
459
|
+
```
|
|
460
|
+
Если всё ещё не работает, установите конкретную версию:
|
|
461
|
+
```bash
|
|
462
|
+
npm install -g speccrew@0.5.6
|
|
463
|
+
```
|
|
464
|
+
|
|
465
|
+
### В6: Как посмотреть исторические итерации?
|
|
470
466
|
|
|
471
467
|
После архивирования смотрите в `speccrew-workspace/iteration-archives/`, организовано в формате `{номер}-{тип}-{имя}-{дата}/`.
|
|
472
468
|
|
|
473
|
-
### В
|
|
469
|
+
### В7: Нужна ли базе знаний регулярная актуализация?
|
|
474
470
|
|
|
475
471
|
Реинициализация требуется в следующих ситуациях:
|
|
476
472
|
- Значительные изменения структуры проекта
|
|
@@ -485,7 +481,6 @@ speccrew update
|
|
|
485
481
|
|
|
486
482
|
| Этап | Агент | Начальный диалог |
|
|
487
483
|
|------|-------|-------------------|
|
|
488
|
-
| Диагностика | Team Leader | `@speccrew-team-leader диагностировать проект` |
|
|
489
484
|
| Инициализация | Team Leader | `@speccrew-team-leader инициализировать техническую базу знаний` |
|
|
490
485
|
| Анализ требований | Product Manager | `@speccrew-product-manager у меня новое требование: [описание]` |
|
|
491
486
|
| Проектирование функций | Feature Designer | `@speccrew-feature-designer начать проектирование функций` |
|
|
@@ -519,5 +514,5 @@ speccrew update
|
|
|
519
514
|
## Следующие шаги
|
|
520
515
|
|
|
521
516
|
1. Выполните `speccrew init --ide qoder` для инициализации вашего проекта
|
|
522
|
-
2. Выполните Нулевой шаг:
|
|
517
|
+
2. Выполните Нулевой шаг: Инициализация базы знаний
|
|
523
518
|
3. Продвигайтесь через каждый этап следуя рабочему процессу, наслаждаясь опытом разработки на основе спецификаций!
|
|
@@ -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
|
-
**เอเจนต์จะทำอะไร**:
|
|
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,24 @@ speccrew update
|
|
|
466
449
|
|
|
467
450
|
> **หมายเหตุ**: จำเป็นต้องทำทั้งสองขั้นตอน การรันเฉพาะ `speccrew update` จะไม่อัปเดตเครื่องมือ CLI เอง การรันเฉพาะ `npm install` จะไม่อัปเดตไฟล์โปรเจกต์
|
|
468
451
|
|
|
469
|
-
### ค5:
|
|
452
|
+
### ค5: `speccrew update` แสดงเวอร์ชันใหม่ แต่หลังติดตั้งยังเป็นเวอร์ชันเก่า?
|
|
453
|
+
|
|
454
|
+
มักเกิดจากแคช npm วิธีแก้ไข:
|
|
455
|
+
```bash
|
|
456
|
+
npm cache clean --force
|
|
457
|
+
npm install -g speccrew@latest
|
|
458
|
+
npm list -g speccrew
|
|
459
|
+
```
|
|
460
|
+
ถ้ายังไม่ได้ ให้ติดตั้งเวอร์ชันที่ระบุ:
|
|
461
|
+
```bash
|
|
462
|
+
npm install -g speccrew@0.5.6
|
|
463
|
+
```
|
|
464
|
+
|
|
465
|
+
### ค6: วิธีดูการทำซ้ำในอดีต?
|
|
470
466
|
|
|
471
467
|
หลังจากเก็บถาวร ดูใน `speccrew-workspace/iteration-archives/` จัดรูปแบบเป็น `{หมายเลข}-{ประเภท}-{ชื่อ}-{วันที่}/`
|
|
472
468
|
|
|
473
|
-
### ค
|
|
469
|
+
### ค7: ฐานความรู้ต้องอัปเดตเป็นประจำหรือไม่?
|
|
474
470
|
|
|
475
471
|
ต้องเริ่มต้นใหม่ในสถานการณ์ต่อไปนี้:
|
|
476
472
|
- การเปลี่ยนแปลงโครงสร้างโปรเจกต์อย่างมีนัยสำคัญ
|
|
@@ -485,7 +481,6 @@ speccrew update
|
|
|
485
481
|
|
|
486
482
|
| ระยะ | เอเจนต์ | บทสนทนาเริ่มต้น |
|
|
487
483
|
|------|-------|-------------------|
|
|
488
|
-
| การวินิจฉัย | Team Leader | `@speccrew-team-leader วินิจฉัยโปรเจกต์` |
|
|
489
484
|
| การเริ่มต้น | Team Leader | `@speccrew-team-leader เริ่มต้นฐานความรู้เทคนิค` |
|
|
490
485
|
| การวิเคราะห์ความต้องการ | Product Manager | `@speccrew-product-manager ฉันมีความต้องการใหม่: [คำอธิบาย]` |
|
|
491
486
|
| การออกแบบฟีเจอร์ | Feature Designer | `@speccrew-feature-designer เริ่มการออกแบบฟีเจอร์` |
|
|
@@ -519,5 +514,5 @@ speccrew update
|
|
|
519
514
|
## 9. ขั้นตอนถัดไป
|
|
520
515
|
|
|
521
516
|
1. รัน `speccrew init --ide qoder` เพื่อเริ่มต้นโปรเจกต์ของคุณ
|
|
522
|
-
2. ทำขั้นตอนที่ศูนย์:
|
|
517
|
+
2. ทำขั้นตอนที่ศูนย์: การเริ่มต้นฐานความรู้
|
|
523
518
|
3. ดำเนินการผ่านแต่ละระยะตามเวิร์กโฟลว์ สนุกกับประสบการณ์การพัฒนาแบบขับเคลื่อนด้วยข้อมูลจำเพาะ!
|