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,597 +0,0 @@
|
|
|
1
|
-
# SpecCrew Hızlı Başlangıç Kılavuzu
|
|
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
|
-
Bu belge, SpecCrew'ın Agent ekibini kullanarak standart mühendislik süreçlerine göre gereksinimlerden teslimata kadar tam geliştirmeyi nasıl tamamlayacağınızı hızlıca anlamanıza yardımcı olur.
|
|
18
|
-
|
|
19
|
-
---
|
|
20
|
-
|
|
21
|
-
## 1. Ön Koşullar
|
|
22
|
-
|
|
23
|
-
### SpecCrew'ı Yükle
|
|
24
|
-
|
|
25
|
-
```bash
|
|
26
|
-
npm install -g speccrew
|
|
27
|
-
```
|
|
28
|
-
|
|
29
|
-
### Projeyi Başlat
|
|
30
|
-
|
|
31
|
-
```bash
|
|
32
|
-
speccrew init --ide qoder
|
|
33
|
-
```
|
|
34
|
-
|
|
35
|
-
Desteklenen IDE'ler: `qoder`, `cursor`, `claude`, `codex`
|
|
36
|
-
|
|
37
|
-
### Başlatma Sonrası Dizin Yapısı
|
|
38
|
-
|
|
39
|
-
```
|
|
40
|
-
.
|
|
41
|
-
├── .qoder/
|
|
42
|
-
│ ├── agents/ # Agent tanım dosyaları
|
|
43
|
-
│ └── skills/ # Skill tanım dosyaları
|
|
44
|
-
├── speccrew-workspace/ # Workspace
|
|
45
|
-
│ ├── docs/ # Yapılandırmalar, kurallar, şablonlar, çözümler
|
|
46
|
-
│ ├── iterations/ # Devam eden iterasyonlar
|
|
47
|
-
│ ├── iteration-archives/ # Arşivlenmiş iterasyonlar
|
|
48
|
-
│ └── knowledges/ # Bilgi tabanı
|
|
49
|
-
│ ├── base/ # Temel bilgiler (teşhis raporları, teknik borçlar)
|
|
50
|
-
│ ├── bizs/ # İş bilgi tabanı
|
|
51
|
-
│ └── techs/ # Teknik bilgi tabanı
|
|
52
|
-
```
|
|
53
|
-
|
|
54
|
-
### CLI Komut Hızlı Başvurusu
|
|
55
|
-
|
|
56
|
-
| Komut | Açıklama |
|
|
57
|
-
|------|------|
|
|
58
|
-
| `speccrew list` | Tüm mevcut Agent'ları ve Skill'leri listele |
|
|
59
|
-
| `speccrew doctor` | Yükleme bütünlüğünü kontrol et |
|
|
60
|
-
| `speccrew update` | Proje yapılandırmasını en son sürüme güncelle |
|
|
61
|
-
| `speccrew uninstall` | SpecCrew'ı kaldır |
|
|
62
|
-
|
|
63
|
-
---
|
|
64
|
-
|
|
65
|
-
## 2. Kurulumdan Sonra 5 Dakikada Hızlı Başlangıç
|
|
66
|
-
|
|
67
|
-
`speccrew init` çalıştırdıktan sonra, hızlıca çalışma durumuna girmek için şu adımları izleyin:
|
|
68
|
-
|
|
69
|
-
### Adım 1: IDE'nizi Seçin
|
|
70
|
-
|
|
71
|
-
| IDE | Başlatma Komutu | Uygulama Senaryosu |
|
|
72
|
-
|-----|-----------|----------|
|
|
73
|
-
| **Qoder** (Önerilen) | `speccrew init --ide qoder` | Tam agent orkestrasyonu, paralel worker'lar |
|
|
74
|
-
| **Cursor** | `speccrew init --ide cursor` | Composer tabanlı iş akışları |
|
|
75
|
-
| **Claude Code** | `speccrew init --ide claude` | CLI-first geliştirme |
|
|
76
|
-
| **Codex** | `speccrew init --ide codex` | OpenAI ekosistem entegrasyonu |
|
|
77
|
-
|
|
78
|
-
### Adım 2: Bilgi Tabanını Başlat (Önerilen)
|
|
79
|
-
|
|
80
|
-
Mevcut kaynak kodu olan projeler için, agent'ların kod tabanınızı anlaması için önce bilgi tabanını başlatmanız önerilir:
|
|
81
|
-
|
|
82
|
-
```
|
|
83
|
-
@speccrew-team-leader teknik bilgi tabanını başlat
|
|
84
|
-
```
|
|
85
|
-
|
|
86
|
-
Sonra:
|
|
87
|
-
|
|
88
|
-
```
|
|
89
|
-
@speccrew-team-leader iş bilgi tabanını başlat
|
|
90
|
-
```
|
|
91
|
-
|
|
92
|
-
### Adım 3: İlk Görevinizi Başlatın
|
|
93
|
-
|
|
94
|
-
```
|
|
95
|
-
@speccrew-product-manager Yeni bir gereksinimim var: [işlevsel gereksiniminizi açıklayın]
|
|
96
|
-
```
|
|
97
|
-
|
|
98
|
-
> **İpucu**: Ne yapacağınızdan emin değilseniz, sadece `@speccrew-team-leader başlamama yardım et` deyin — Team Leader proje durumunuzu otomatik olarak algılayacak ve size rehberlik edecektir.
|
|
99
|
-
|
|
100
|
-
---
|
|
101
|
-
|
|
102
|
-
## 3. Hızlı Karar Ağacı
|
|
103
|
-
|
|
104
|
-
Ne yapacağınızdan emin değil misiniz? Senaryonuzu aşağıda bulun:
|
|
105
|
-
|
|
106
|
-
- **Yeni bir işlevsel gereksinimim var**
|
|
107
|
-
→ `@speccrew-product-manager Yeni bir gereksinimim var: [işlevsel gereksiniminizi açıklayın]`
|
|
108
|
-
|
|
109
|
-
- **Mevcut proje bilgisini taramak istiyorum**
|
|
110
|
-
→ `@speccrew-team-leader teknik bilgi tabanını başlat`
|
|
111
|
-
→ Sonra: `@speccrew-team-leader iş bilgi tabanını başlat`
|
|
112
|
-
|
|
113
|
-
- **Önceki çalışmaya devam etmek istiyorum**
|
|
114
|
-
→ `@speccrew-team-leader mevcut ilerleme nedir?`
|
|
115
|
-
|
|
116
|
-
- **Sistem sağlık durumunu kontrol etmek istiyorum**
|
|
117
|
-
→ Terminalde çalıştır: `speccrew doctor`
|
|
118
|
-
|
|
119
|
-
- **Ne yapacağımdan emin değilim**
|
|
120
|
-
→ `@speccrew-team-leader başlamama yardım et`
|
|
121
|
-
→ Team Leader proje durumunuzu otomatik olarak algılayacak ve size rehberlik edecektir
|
|
122
|
-
|
|
123
|
-
---
|
|
124
|
-
|
|
125
|
-
## 4. Agent Hızlı Başvurusu
|
|
126
|
-
|
|
127
|
-
| Rol | Agent | Sorumluluklar | Komut Örneği |
|
|
128
|
-
|------|-------|-----------------|-----------------|
|
|
129
|
-
| Takım Lideri | `@speccrew-team-leader` | Proje navigasyonu, bilgi tabanı başlatma, durum kontrolü | "Başlamama yardım et" |
|
|
130
|
-
| Ürün Yöneticisi | `@speccrew-product-manager` | Gereksinim analizi, PRD oluşturma | "Yeni bir gereksinimim var: ..." |
|
|
131
|
-
| İşlev Tasarımcısı | `@speccrew-feature-designer` | İşlev analizi, spesifikasyon tasarımı, API sözleşmeleri | "X iterasyonu için işlev tasarımını başlat" |
|
|
132
|
-
| Sistem Tasarımcısı | `@speccrew-system-designer` | Mimari tasarımım, platform detaylı tasarım | "X iterasyonu için sistem tasarımını başlat" |
|
|
133
|
-
| Sistem Geliştirici | `@speccrew-system-developer` | Geliştirme koordinasyonu, kod oluşturma | "X iterasyonu için geliştirmeyi başlat" |
|
|
134
|
-
| Test Yöneticisi | `@speccrew-test-manager` | Test planlaması, vaka tasarımı, yürütme | "X iterasyonu için testleri başlat" |
|
|
135
|
-
|
|
136
|
-
> **Not**: Tüm agent'ları hatırlamanıza gerek yok. Sadece `@speccrew-team-leader` ile konuşun, isteğinizi doğru agent'a yönlendirecektir.
|
|
137
|
-
|
|
138
|
-
---
|
|
139
|
-
|
|
140
|
-
## 5. İş Akışı Genel Bakış
|
|
141
|
-
|
|
142
|
-
### Tam Akış Diyagramı
|
|
143
|
-
|
|
144
|
-
```mermaid
|
|
145
|
-
flowchart LR
|
|
146
|
-
PRD[Aşama 1<br/>Gereksinim Analizi<br/>Product Manager] --> FD[Aşama 2<br/>İşlev Tasarımı<br/>Feature Designer]
|
|
147
|
-
FD --> SD[Aşama 3<br/>Sistem Tasarımı<br/>System Designer]
|
|
148
|
-
SD --> DEV[Aşama 4<br/>Geliştirme<br/>System Developer]
|
|
149
|
-
DEV --> TEST[Aşama 5<br/>Sistem Testi<br/>Test Manager]
|
|
150
|
-
TEST --> ARCHIVE[Aşama 6<br/>Arşivleme]
|
|
151
|
-
|
|
152
|
-
KB[(Bilgi Tabanı<br/>Tüm Süreç Boyunca)] -.-> PRD
|
|
153
|
-
KB -.-> FD
|
|
154
|
-
KB -.-> SD
|
|
155
|
-
KB -.-> DEV
|
|
156
|
-
KB -.-> TEST
|
|
157
|
-
```
|
|
158
|
-
|
|
159
|
-
### Temel İlkeler
|
|
160
|
-
|
|
161
|
-
1. **Aşama Bağımlılıkları**: Her aşamanın çıktısı bir sonraki aşamanın girdisidir
|
|
162
|
-
2. **Checkpoint Onayı**: Her aşamanın, bir sonraki aşamaya geçmeden önce kullanıcı onayı gerektiren bir onay noktası vardır
|
|
163
|
-
3. **Bilgi Tabanı Destekli**: Bilgi tabanı tüm süreç boyunca çalışır, tüm aşamalar için bağlam sağlar
|
|
164
|
-
|
|
165
|
-
---
|
|
166
|
-
|
|
167
|
-
## 6. Adım Sıfır: Bilgi Tabanı Başlatma
|
|
168
|
-
|
|
169
|
-
Resmi mühendislik sürecini başlatmadan önce, proje bilgi tabanını başlatmanız gerekir.
|
|
170
|
-
|
|
171
|
-
### 6.1 Teknik Bilgi Tabanı Başlatma
|
|
172
|
-
|
|
173
|
-
**Konuşma Örneği**:
|
|
174
|
-
```
|
|
175
|
-
@speccrew-team-leader teknik bilgi tabanını başlat
|
|
176
|
-
```
|
|
177
|
-
|
|
178
|
-
**Üç Aşamalı Süreç**:
|
|
179
|
-
1. Platform Algılama — Projedeki teknik platformları tanımla
|
|
180
|
-
2. Teknik Doküman Oluşturma — Her platform için teknik spesifikasyon belgeleri oluştur
|
|
181
|
-
3. İndeks Oluşturma — Bilgi tabanı indeksini oluştur
|
|
182
|
-
|
|
183
|
-
**Çıktı**:
|
|
184
|
-
```
|
|
185
|
-
speccrew-workspace/knowledges/techs/{platform-id}/
|
|
186
|
-
├── tech-stack.md # Teknoloji yığını tanımı
|
|
187
|
-
├── architecture.md # Mimari kurallar
|
|
188
|
-
├── dev-spec.md # Geliştirme spesifikasyonları
|
|
189
|
-
├── test-spec.md # Test spesifikasyonları
|
|
190
|
-
└── INDEX.md # İndeks dosyası
|
|
191
|
-
```
|
|
192
|
-
|
|
193
|
-
### 6.2 İş Bilgi Tabanı Başlatma
|
|
194
|
-
|
|
195
|
-
**Konuşma Örneği**:
|
|
196
|
-
```
|
|
197
|
-
@speccrew-team-leader iş bilgi tabanını başlat
|
|
198
|
-
```
|
|
199
|
-
|
|
200
|
-
**Dört Aşamalı Süreç**:
|
|
201
|
-
1. İşlev Envanteri — Tüm işlevleri tanımlamak için kodu tara
|
|
202
|
-
2. İşlev Analizi — Her işlev için iş mantığını analiz et
|
|
203
|
-
3. Modül Özeti — İşlevleri modüle göre özetle
|
|
204
|
-
4. Sistem Özeti — Sistem seviyesi iş genel görünümü oluştur
|
|
205
|
-
|
|
206
|
-
**Çıktı**:
|
|
207
|
-
```
|
|
208
|
-
speccrew-workspace/knowledges/bizs/
|
|
209
|
-
├── {platform-type}/
|
|
210
|
-
│ └── {module-name}/
|
|
211
|
-
│ └── feature-spec.md
|
|
212
|
-
└── system-overview.md
|
|
213
|
-
```
|
|
214
|
-
|
|
215
|
-
---
|
|
216
|
-
|
|
217
|
-
## 7. Aşama Aşama Konuşma Kılavuzu
|
|
218
|
-
|
|
219
|
-
### 7.1 Aşama 1: Gereksinim Analizi (Product Manager)
|
|
220
|
-
|
|
221
|
-
**Nasıl Başlatılır**:
|
|
222
|
-
```
|
|
223
|
-
@speccrew-product-manager Yeni bir gereksinimim var: [gereksiniminizi açıklayın]
|
|
224
|
-
```
|
|
225
|
-
|
|
226
|
-
**Agent İş Akışı**:
|
|
227
|
-
1. Mevcut modülleri anlamak için sistem genel görünümünü oku
|
|
228
|
-
2. Kullanıcı gereksinimlerini analiz et
|
|
229
|
-
3. Yapılandırılmış PRD belgesi oluştur
|
|
230
|
-
|
|
231
|
-
**Çıktı**:
|
|
232
|
-
```
|
|
233
|
-
iterations/{numara}-{tip}-{isim}/01.product-requirement/
|
|
234
|
-
├── [feature-name]-prd.md # Ürün Gereksinimleri Belgesi
|
|
235
|
-
└── [feature-name]-bizs-modeling.md # İş modellemesi (karmaşık gereksinimler için)
|
|
236
|
-
```
|
|
237
|
-
|
|
238
|
-
**Onay Kontrol Listesi**:
|
|
239
|
-
- [ ] Gereksinim açıklaması kullanıcı niyetini doğru şekilde yansıtıyor mu?
|
|
240
|
-
- [ ] İş kuralları eksiksiz mi?
|
|
241
|
-
- [ ] Mevcut sistemlerle entegrasyon noktaları net mi?
|
|
242
|
-
- [ ] Kabul kriterleri ölçülebilir mi?
|
|
243
|
-
|
|
244
|
-
---
|
|
245
|
-
|
|
246
|
-
### 7.2 Aşama 2: İşlev Tasarımı (Feature Designer)
|
|
247
|
-
|
|
248
|
-
**Nasıl Başlatılır**:
|
|
249
|
-
```
|
|
250
|
-
@speccrew-feature-designer işlev tasarımını başlat
|
|
251
|
-
```
|
|
252
|
-
|
|
253
|
-
**Agent İş Akışı**:
|
|
254
|
-
1. Onaylanmış PRD belgesini otomatik olarak bul
|
|
255
|
-
2. İş bilgi tabanını yükle
|
|
256
|
-
3. İşlev tasarımı oluştur (UI wireframe'leri, etkileşim akışları, veri tanımları, API sözleşmeleri dahil)
|
|
257
|
-
4. Birden fazla PRD için paralel tasarım için Task Worker kullan
|
|
258
|
-
|
|
259
|
-
**Çıktı**:
|
|
260
|
-
```
|
|
261
|
-
iterations/{iter}/02.feature-design/
|
|
262
|
-
└── [feature-name]-feature-spec.md # İşlev tasarım belgesi
|
|
263
|
-
```
|
|
264
|
-
|
|
265
|
-
**Onay Kontrol Listesi**:
|
|
266
|
-
- [ ] Tüm kullanıcı senaryoları kapsanıyor mu?
|
|
267
|
-
- [ ] Etkileşim akışları net mi?
|
|
268
|
-
- [ ] Veri alanı tanımları eksiksiz mi?
|
|
269
|
-
- [ ] İstisna yönetimi kapsamlı mı?
|
|
270
|
-
|
|
271
|
-
---
|
|
272
|
-
|
|
273
|
-
### 7.3 Aşama 3: Sistem Tasarımı (System Designer)
|
|
274
|
-
|
|
275
|
-
**Nasıl Başlatılır**:
|
|
276
|
-
```
|
|
277
|
-
@speccrew-system-designer sistem tasarımını başlat
|
|
278
|
-
```
|
|
279
|
-
|
|
280
|
-
**Agent İş Akışı**:
|
|
281
|
-
1. Feature Spec ve API Contract'ı bul
|
|
282
|
-
2. Teknik bilgi tabanını yükle (her platform için teknoloji yığını, mimari, spesifikasyonlar)
|
|
283
|
-
3. **Checkpoint A**: Framework Değerlendirmesi — Teknik boşlukları analiz et, yeni framework'ler öner (gerekirse), kullanıcı onayını bekle
|
|
284
|
-
4. DESIGN-OVERVIEW.md oluştur
|
|
285
|
-
5. Her platform için tasarımı paralel olarak dağıtmak için Task Worker kullan (frontend/backend/mobile/desktop)
|
|
286
|
-
6. **Checkpoint B**: Ortak Onay — Tüm platform tasarımlarının özetini göster, kullanıcı onayını bekle
|
|
287
|
-
|
|
288
|
-
**Çıktı**:
|
|
289
|
-
```
|
|
290
|
-
iterations/{iter}/03.system-design/
|
|
291
|
-
├── DESIGN-OVERVIEW.md # Tasarım genel görünümü
|
|
292
|
-
├── {platform-id}/
|
|
293
|
-
│ ├── INDEX.md # Platform tasarım indeksi
|
|
294
|
-
│ └── {module}-design.md # Sözde kod seviyesi modül tasarımı
|
|
295
|
-
```
|
|
296
|
-
|
|
297
|
-
**Onay Kontrol Listesi**:
|
|
298
|
-
- [ ] Sözde kod gerçek framework sözdizimini kullanıyor mu?
|
|
299
|
-
- [ ] Platformlar arası API sözleşmeleri tutarlı mı?
|
|
300
|
-
- [ ] Hata yönetimi stratejisi birleşik mi?
|
|
301
|
-
|
|
302
|
-
---
|
|
303
|
-
|
|
304
|
-
### 7.4 Aşama 4: Geliştirme (System Developer)
|
|
305
|
-
|
|
306
|
-
**Nasıl Başlatılır**:
|
|
307
|
-
```
|
|
308
|
-
@speccrew-system-developer geliştirmeyi başlat
|
|
309
|
-
```
|
|
310
|
-
|
|
311
|
-
**Agent İş Akışı**:
|
|
312
|
-
1. Sistem tasarım belgelerini oku
|
|
313
|
-
2. Her platform için teknik bilgiyi yükle
|
|
314
|
-
3. **Checkpoint A**: Ortam Ön Kontrolü — Runtime sürümlerini, bağımlılıkları, hizmet kullanılabilirliğini kontrol et; başarısız olursa kullanıcı çözümünü bekle
|
|
315
|
-
4. Her platform için geliştirmeyi paralel olarak dağıtmak için Task Worker kullan
|
|
316
|
-
5. Entegrasyon kontrolü: API sözleşme hizalaması, veri tutarlılığı
|
|
317
|
-
6. Teslim raporu oluştur
|
|
318
|
-
|
|
319
|
-
**Çıktı**:
|
|
320
|
-
```
|
|
321
|
-
# Kaynak kod proje gerçek kaynak dizinine yazılır
|
|
322
|
-
iterations/{iter}/04.development/
|
|
323
|
-
├── {platform-id}/
|
|
324
|
-
│ └── tasks/ # Geliştirme görev kayıtları
|
|
325
|
-
└── delivery-report.md
|
|
326
|
-
```
|
|
327
|
-
|
|
328
|
-
**Onay Kontrol Listesi**:
|
|
329
|
-
- [ ] Ortam hazır mı?
|
|
330
|
-
- [ ] Entegrasyon sorunları kabul edilebilir aralıkta mı?
|
|
331
|
-
- [ ] Kod geliştirme spesifikasyonlarına uygun mu?
|
|
332
|
-
|
|
333
|
-
---
|
|
334
|
-
|
|
335
|
-
### 7.5 Aşama 5: Sistem Testi (Test Manager)
|
|
336
|
-
|
|
337
|
-
**Nasıl Başlatılır**:
|
|
338
|
-
```
|
|
339
|
-
@speccrew-test-manager testleri başlat
|
|
340
|
-
```
|
|
341
|
-
|
|
342
|
-
**Üç Aşamalı Test Süreci**:
|
|
343
|
-
|
|
344
|
-
| Aşama | Açıklama | Checkpoint |
|
|
345
|
-
|-------|-------------|------------|
|
|
346
|
-
| Test Vaka Tasarımı | PRD ve Feature Spec'e dayalı test vakaları oluştur | A: Vaka kapsam istatistiklerini ve izlenebilirlik matrisini göster, yeterli kapsam kullanıcı onayını bekle |
|
|
347
|
-
| Test Kodu Oluşturma | Yürütülebilir test kodu oluştur | B: Oluşturulan test dosyalarını ve vaka eşlemesini göster, kullanıcı onayını bekle |
|
|
348
|
-
| Test Yürütme ve Hata Raporlama | Testleri otomatik olarak yürüt ve raporlar oluştur | Yok (otomatik yürütme) |
|
|
349
|
-
|
|
350
|
-
**Çıktı**:
|
|
351
|
-
```
|
|
352
|
-
iterations/{iter}/05.system-test/
|
|
353
|
-
├── cases/
|
|
354
|
-
│ └── {platform-id}/ # Test vaka belgeleri
|
|
355
|
-
├── code/
|
|
356
|
-
│ └── {platform-id}/ # Test kodu planı
|
|
357
|
-
├── reports/
|
|
358
|
-
│ └── test-report-{date}.md # Test raporu
|
|
359
|
-
└── bugs/
|
|
360
|
-
└── BUG-{id}-{title}.md # Hata raporları (hata başına bir dosya)
|
|
361
|
-
```
|
|
362
|
-
|
|
363
|
-
**Onay Kontrol Listesi**:
|
|
364
|
-
- [ ] Vaka kapsamı eksiksiz mi?
|
|
365
|
-
- [ ] Test kodu yürütülebilir mi?
|
|
366
|
-
- [ ] Hata önem derecelendirmesi doğru mu?
|
|
367
|
-
|
|
368
|
-
---
|
|
369
|
-
|
|
370
|
-
### 7.6 Aşama 6: Arşivleme
|
|
371
|
-
|
|
372
|
-
İterasyonlar tamamlandıktan sonra otomatik olarak arşivlenir:
|
|
373
|
-
|
|
374
|
-
```
|
|
375
|
-
speccrew-workspace/iteration-archives/
|
|
376
|
-
└── {numara}-{tip}-{isim}-{tarih}/
|
|
377
|
-
├── 01.product-requirement/
|
|
378
|
-
├── 02.feature-design/
|
|
379
|
-
├── 03.system-design/
|
|
380
|
-
├── 04.development/
|
|
381
|
-
└── 05.system-test/
|
|
382
|
-
```
|
|
383
|
-
|
|
384
|
-
---
|
|
385
|
-
|
|
386
|
-
## 8. Bilgi Tabanı Genel Bakış
|
|
387
|
-
|
|
388
|
-
### 8.1 İş Bilgi Tabanı (bizs)
|
|
389
|
-
|
|
390
|
-
**Amaç**: Proje iş işlevi açıklamalarını, modül bölümlerini, API özelliklerini sakla
|
|
391
|
-
|
|
392
|
-
**Dizin Yapısı**:
|
|
393
|
-
```
|
|
394
|
-
knowledges/bizs/
|
|
395
|
-
├── {platform-type}/
|
|
396
|
-
│ └── {module-name}/
|
|
397
|
-
│ └── feature-spec.md
|
|
398
|
-
└── system-overview.md
|
|
399
|
-
```
|
|
400
|
-
|
|
401
|
-
**Kullanım Senaryoları**: Product Manager, Feature Designer
|
|
402
|
-
|
|
403
|
-
### 8.2 Teknik Bilgi Tabanı (techs)
|
|
404
|
-
|
|
405
|
-
**Amaç**: Proje teknoloji yığınını, mimari kurallarını, geliştirme spesifikasyonlarını, test spesifikasyonlarını sakla
|
|
406
|
-
|
|
407
|
-
**Dizin Yapısı**:
|
|
408
|
-
```
|
|
409
|
-
knowledges/techs/{platform-id}/
|
|
410
|
-
├── tech-stack.md
|
|
411
|
-
├── architecture.md
|
|
412
|
-
├── dev-spec.md
|
|
413
|
-
├── test-spec.md
|
|
414
|
-
└── INDEX.md
|
|
415
|
-
```
|
|
416
|
-
|
|
417
|
-
**Kullanım Senaryoları**: System Designer, System Developer, Test Manager
|
|
418
|
-
|
|
419
|
-
---
|
|
420
|
-
|
|
421
|
-
## 9. İş Akışı İlerleme Yönetimi
|
|
422
|
-
|
|
423
|
-
SpecCrew sanal takımı, her aşamanın bir sonrakine geçmeden önce kullanıcı tarafından onaylanması gereken sıkı bir aşama gate mekanizması izler. Ayrıca yeniden başlatılabilir yürütmeyi de destekler — kesinti sonrası yeniden başlatıldığında, kaldığı yerden otomatik olarak devam eder.
|
|
424
|
-
|
|
425
|
-
### 9.1 Üç Katmanlı İlerleme Dosyaları
|
|
426
|
-
|
|
427
|
-
İş akışı, iterasyon dizininde bulunan üç tür JSON ilerleme dosyasını otomatik olarak sürdürür:
|
|
428
|
-
|
|
429
|
-
| Dosya | Konum | Amaç |
|
|
430
|
-
|------|----------|---------|
|
|
431
|
-
| `WORKFLOW-PROGRESS.json` | `iterations/{iter}/` | Her pipeline aşamasının durumunu kaydeder |
|
|
432
|
-
| `.checkpoints.json` | Her aşama dizini altında | Kullanıcı checkpoint onay durumunu kaydeder |
|
|
433
|
-
| `DISPATCH-PROGRESS.json` | Her aşama dizini altında | Paralel görevler için öğe öğe ilerlemeyi kaydeder (çoklu platform/çoklu modül) |
|
|
434
|
-
|
|
435
|
-
### 9.2 Aşama Durum Akışı
|
|
436
|
-
|
|
437
|
-
Her aşama bu durum akışını izler:
|
|
438
|
-
|
|
439
|
-
```
|
|
440
|
-
pending → in_progress → completed → confirmed
|
|
441
|
-
```
|
|
442
|
-
|
|
443
|
-
- **pending**: Henüz başlatılmadı
|
|
444
|
-
- **in_progress**: Yürütülüyor
|
|
445
|
-
- **completed**: Agent yürütmesi tamamlandı, kullanıcı onayı bekleniyor
|
|
446
|
-
- **confirmed**: Kullanıcı son checkpoint üzerinden onayladı, sonraki aşama başlayabilir
|
|
447
|
-
|
|
448
|
-
### 9.3 Yeniden Başlatılabilir Yürütme
|
|
449
|
-
|
|
450
|
-
Bir aşama için Agent'ı yeniden başlatırken:
|
|
451
|
-
|
|
452
|
-
1. **Otomatik upstream kontrolü**: Önceki aşamanın onaylanıp onaylanmadığını doğrular, onaylanmadıysa engeller ve ister
|
|
453
|
-
2. **Checkpoint kurtarma**: `.checkpoints.json` okur, geçen checkpoint'leri atlar, son kesinti noktasından devam eder
|
|
454
|
-
3. **Paralel görev kurtarma**: `DISPATCH-PROGRESS.json` okur, sadece `pending` veya `failed` durumundaki görevleri yeniden yürütür, `completed` görevleri atlar
|
|
455
|
-
|
|
456
|
-
### 9.4 Mevcut İlerlemeyi Görüntüle
|
|
457
|
-
|
|
458
|
-
Team Leader Agent üzerinden pipeline panorama durumunu görüntüle:
|
|
459
|
-
|
|
460
|
-
```
|
|
461
|
-
@speccrew-team-leader mevcut iterasyon ilerlemesini görüntüle
|
|
462
|
-
```
|
|
463
|
-
|
|
464
|
-
Team Leader ilerleme dosyalarını okuyacak ve şuna benzer bir durum genel görünümü gösterecek:
|
|
465
|
-
|
|
466
|
-
```
|
|
467
|
-
Pipeline Status: i001-user-management
|
|
468
|
-
01 PRD: ✅ Confirmed
|
|
469
|
-
02 Feature Design: 🔄 In Progress (Checkpoint A passed)
|
|
470
|
-
03 System Design: ⏳ Pending
|
|
471
|
-
04 Development: ⏳ Pending
|
|
472
|
-
05 System Test: ⏳ Pending
|
|
473
|
-
```
|
|
474
|
-
|
|
475
|
-
### 9.5 Geriye Dönük Uyumluluk
|
|
476
|
-
|
|
477
|
-
İlerleme dosyası mekanizması tamamen geriye dönük uyumludur — ilerleme dosyaları yoksa (örn. eski projelerde veya yeni iterasyonlarda), tüm Agent'lar orijinal mantığa göre normal şekilde yürütülecektir.
|
|
478
|
-
|
|
479
|
-
---
|
|
480
|
-
|
|
481
|
-
## 10. Sıkça Sorulan Sorular (SSS)
|
|
482
|
-
|
|
483
|
-
### S1: Agent beklenildiği gibi çalışmazsa ne yapmalıyım?
|
|
484
|
-
|
|
485
|
-
1. Yükleme bütünlüğünü kontrol etmek için `speccrew doctor` çalıştır
|
|
486
|
-
2. Bilgi tabanının başlatıldığını onayla
|
|
487
|
-
3. Önceki aşamanın çıktısının mevcut iterasyon dizininde olduğunu onayla
|
|
488
|
-
|
|
489
|
-
### S2: Bir aşamayı nasıl atlarım?
|
|
490
|
-
|
|
491
|
-
**Önerilmez** — Her aşamanın çıktısı bir sonraki aşamanın girdisidir.
|
|
492
|
-
|
|
493
|
-
Atlamanız gerekirse, ilgili aşamanın giriş belgesini manuel olarak hazırlayın ve format spesifikasyonlarına uygun olduğundan emin olun.
|
|
494
|
-
|
|
495
|
-
### S3: Birden fazla paralel gereksinimi nasıl yönetirim?
|
|
496
|
-
|
|
497
|
-
Her gereksinim için bağımsız iterasyon dizinleri oluşturun:
|
|
498
|
-
```
|
|
499
|
-
iterations/
|
|
500
|
-
├── 001-feature-xxx/
|
|
501
|
-
├── 002-feature-yyy/
|
|
502
|
-
└── 003-feature-zzz/
|
|
503
|
-
```
|
|
504
|
-
|
|
505
|
-
Her iterasyon tamamen izole edilmiştir ve diğerlerini etkilemez.
|
|
506
|
-
|
|
507
|
-
### S4: SpecCrew sürümünü nasıl güncellerim?
|
|
508
|
-
|
|
509
|
-
Güncelleme iki adım gerektirir:
|
|
510
|
-
|
|
511
|
-
```bash
|
|
512
|
-
# Adım 1: Global CLI aracını güncelle
|
|
513
|
-
npm install -g speccrew@latest
|
|
514
|
-
|
|
515
|
-
# Adım 2: Proje dizininde Agent'ları ve Skill'leri senkronize et
|
|
516
|
-
cd /path/to/your-project
|
|
517
|
-
speccrew update
|
|
518
|
-
```
|
|
519
|
-
|
|
520
|
-
- `npm install -g speccrew@latest`: CLI aracının kendisini günceller (yeni sürümler yeni Agent/Skill tanımları, hata düzeltmeleri vb. içerebilir)
|
|
521
|
-
- `speccrew update`: Projenizdeki Agent ve Skill tanım dosyalarını en son sürüme senkronize eder
|
|
522
|
-
- `speccrew update --ide cursor`: Sadece belirli IDE için yapılandırmayı günceller
|
|
523
|
-
|
|
524
|
-
> **Not**: Her iki adım da gereklidir. Sadece `speccrew update` çalıştırmak CLI aracının kendisini güncellemez; sadece `npm install` çalıştırmak proje dosyalarını güncellemez.
|
|
525
|
-
|
|
526
|
-
### S5: `speccrew update` yeni sürüm mevcut olduğunu gösteriyor ama `npm install -g speccrew@latest` hala eski sürümü yüklüyor?
|
|
527
|
-
|
|
528
|
-
Bu genellikle npm önbelleğinden kaynaklanır. Çözüm:
|
|
529
|
-
|
|
530
|
-
```bash
|
|
531
|
-
# npm önbelleğini temizle ve yeniden yükle
|
|
532
|
-
npm cache clean --force
|
|
533
|
-
npm install -g speccrew@latest
|
|
534
|
-
|
|
535
|
-
# Sürümü doğrula
|
|
536
|
-
npm list -g speccrew
|
|
537
|
-
```
|
|
538
|
-
|
|
539
|
-
Hala çalışmıyorsa, belirli bir sürüm numarası ile yüklemeyi deneyin:
|
|
540
|
-
```bash
|
|
541
|
-
npm install -g speccrew@0.5.6
|
|
542
|
-
```
|
|
543
|
-
|
|
544
|
-
### S6: Geçmiş iterasyonları nasıl görüntülerim?
|
|
545
|
-
|
|
546
|
-
Arşivlemeden sonra, `speccrew-workspace/iteration-archives/` içinde görüntüleyin, `{numara}-{tip}-{isim}-{tarih}/` formatına göre düzenlenmiş.
|
|
547
|
-
|
|
548
|
-
### S7: Bilgi tabanının düzenli olarak güncellenmesi gerekir mi?
|
|
549
|
-
|
|
550
|
-
Aşağıdaki durumlarda yeniden başlatma gereklidir:
|
|
551
|
-
- Proje yapısında büyük değişiklikler
|
|
552
|
-
- Teknoloji yığını yükseltmesi veya değişimi
|
|
553
|
-
- İş modüllerinin eklenmesi/kaldırılması
|
|
554
|
-
|
|
555
|
-
---
|
|
556
|
-
|
|
557
|
-
## 11. Hızlı Başvuru
|
|
558
|
-
|
|
559
|
-
### Agent Başlatma Hızlı Başvurusu
|
|
560
|
-
|
|
561
|
-
| Aşama | Agent | Başlatma Konuşması |
|
|
562
|
-
|-------|-------|-------------------|
|
|
563
|
-
| Başlatma | Team Leader | `@speccrew-team-leader teknik bilgi tabanını başlat` |
|
|
564
|
-
| Gereksinim Analizi | Product Manager | `@speccrew-product-manager Yeni bir gereksinimim var: [açıklama]` |
|
|
565
|
-
| İşlev Tasarımı | Feature Designer | `@speccrew-feature-designer işlev tasarımını başlat` |
|
|
566
|
-
| Sistem Tasarımı | System Designer | `@speccrew-system-designer sistem tasarımını başlat` |
|
|
567
|
-
| Geliştirme | System Developer | `@speccrew-system-developer geliştirmeyi başlat` |
|
|
568
|
-
| Sistem Testi | Test Manager | `@speccrew-test-manager testleri başlat` |
|
|
569
|
-
|
|
570
|
-
### Checkpoint Kontrol Listesi
|
|
571
|
-
|
|
572
|
-
| Aşama | Checkpoint Sayısı | Ana Kontrol Öğeleri |
|
|
573
|
-
|-------|----------------------|-----------------|
|
|
574
|
-
| Gereksinim Analizi | 1 | Gereksinim doğruluğu, iş kuralı bütünlüğü, kabul kriteri ölçülebilirliği |
|
|
575
|
-
| İşlev Tasarımı | 1 | Senaryo kapsamı, etkileşim netliği, veri bütünlüğü, istisna yönetimi |
|
|
576
|
-
| Sistem Tasarımı | 2 | A: Framework değerlendirmesi; B: Sözde kod sözdizimi, platformlar arası tutarlılık, hata yönetimi |
|
|
577
|
-
| Geliştirme | 1 | A: Ortam hazır olması, entegrasyon sorunları, kod spesifikasyonları |
|
|
578
|
-
| Sistem Testi | 2 | A: Vaka kapsamı; B: Test kodu yürütülebilirliği |
|
|
579
|
-
|
|
580
|
-
### Çıktı Yolu Hızlı Başvurusu
|
|
581
|
-
|
|
582
|
-
| Aşama | Çıktı Dizini | Dosya Formatı |
|
|
583
|
-
|-------|-----------------|-------------|
|
|
584
|
-
| Gereksinim Analizi | `iterations/{iter}/01.product-requirement/` | `[name]-prd.md`, `[name]-bizs-modeling.md` |
|
|
585
|
-
| İşlev Tasarımı | `iterations/{iter}/02.feature-design/` | `[name]-feature-spec.md` |
|
|
586
|
-
| Sistem Tasarımı | `iterations/{iter}/03.system-design/` | `DESIGN-OVERVIEW.md`, `{platform}/INDEX.md`, `{platform}/{module}-design.md` |
|
|
587
|
-
| Geliştirme | `iterations/{iter}/04.development/` | Kaynak kod + `delivery-report.md` |
|
|
588
|
-
| Sistem Testi | `iterations/{iter}/05.system-test/` | `cases/`, `code/`, `reports/`, `bugs/` |
|
|
589
|
-
| Arşivleme | `iteration-archives/{iter}-{date}/` | Tam iterasyon kopyası |
|
|
590
|
-
|
|
591
|
-
---
|
|
592
|
-
|
|
593
|
-
## Sonraki Adımlar
|
|
594
|
-
|
|
595
|
-
1. Projenizi başlatmak için `speccrew init --ide qoder` çalıştırın
|
|
596
|
-
2. Adım Sıfır'ı yürütün: Bilgi Tabanı Başlatma
|
|
597
|
-
3. İş akışına göre aşama aşama ilerleyin, spesifikasyon destekli geliştirme deneyiminin keyfini çıkarın!
|