speccrew 0.7.45 → 0.7.47
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/LICENSE +201 -21
- 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 +2 -2
- 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,17 +1,16 @@
|
|
|
1
|
-
# SpecCrew - Руководство по быстрому запуску
|
|
1
|
+
# SpecCrew - Руководство по быстрому запуску
|
|
2
2
|
|
|
3
3
|
<p align="center">
|
|
4
4
|
<a href="./GETTING-STARTED.md">简体中文</a> |
|
|
5
|
-
<a href="./GETTING-STARTED.zh-TW.md">繁體中文</a> |
|
|
6
5
|
<a href="./GETTING-STARTED.en.md">English</a> |
|
|
7
|
-
<a href="./GETTING-STARTED.
|
|
8
|
-
<a href="./GETTING-STARTED.
|
|
6
|
+
<a href="./GETTING-STARTED.ja.md">日本語</a> |
|
|
7
|
+
<a href="./GETTING-STARTED.ru.md">Русский</a> |
|
|
9
8
|
<a href="./GETTING-STARTED.es.md">Español</a> |
|
|
9
|
+
<a href="./GETTING-STARTED.de.md">Deutsch</a> |
|
|
10
10
|
<a href="./GETTING-STARTED.fr.md">Français</a> |
|
|
11
|
-
<a href="./GETTING-STARTED.
|
|
12
|
-
<a href="./GETTING-STARTED.
|
|
13
|
-
<a href="./GETTING-STARTED.
|
|
14
|
-
<a href="./GETTING-STARTED.ar.md">العربية</a>
|
|
11
|
+
<a href="./GETTING-STARTED.pt-BR.md">Português (Brasil)</a> |
|
|
12
|
+
<a href="./GETTING-STARTED.ar.md">العربية</a> |
|
|
13
|
+
<a href="./GETTING-STARTED.hi.md">हिन्दी</a>
|
|
15
14
|
</p>
|
|
16
15
|
|
|
17
16
|
Этот документ поможет вам быстро понять, как использовать команду Agent SpecCrew для завершения полной разработки от требований до поставки в соответствии со стандартными инженерными процессами.
|
|
@@ -80,22 +79,22 @@ speccrew init --ide qoder
|
|
|
80
79
|
Для проектов с существующим исходным кодом рекомендуется сначала инициализировать базу знаний, чтобы агенты понимали вашу кодовую базу:
|
|
81
80
|
|
|
82
81
|
```
|
|
83
|
-
|
|
82
|
+
/speccrew-team-leader инициализировать техническую базу знаний
|
|
84
83
|
```
|
|
85
84
|
|
|
86
85
|
Затем:
|
|
87
86
|
|
|
88
87
|
```
|
|
89
|
-
|
|
88
|
+
/speccrew-team-leader инициализировать бизнес-базу знаний
|
|
90
89
|
```
|
|
91
90
|
|
|
92
91
|
### Шаг 3: Начните вашу первую задачу
|
|
93
92
|
|
|
94
93
|
```
|
|
95
|
-
|
|
94
|
+
/speccrew-product-manager У меня новое требование: [опишите ваше функциональное требование]
|
|
96
95
|
```
|
|
97
96
|
|
|
98
|
-
> **Совет**: Если вы не уверены, что делать, просто скажите
|
|
97
|
+
> **Совет**: Если вы не уверены, что делать, просто скажите `/speccrew-team-leader помогите мне начать` — Team Leader автоматически определит статус вашего проекта и направит вас.
|
|
99
98
|
|
|
100
99
|
---
|
|
101
100
|
|
|
@@ -104,20 +103,20 @@ speccrew init --ide qoder
|
|
|
104
103
|
Не уверены, что делать? Найдите ваш сценарий ниже:
|
|
105
104
|
|
|
106
105
|
- **У меня новое функциональное требование**
|
|
107
|
-
→
|
|
106
|
+
→ `/speccrew-product-manager У меня новое требование: [опишите ваше функциональное требование]`
|
|
108
107
|
|
|
109
108
|
- **Я хочу сканировать знания существующего проекта**
|
|
110
|
-
→
|
|
111
|
-
→ Затем:
|
|
109
|
+
→ `/speccrew-team-leader инициализировать техническую базу знаний`
|
|
110
|
+
→ Затем: `/speccrew-team-leader инициализировать бизнес-базу знаний`
|
|
112
111
|
|
|
113
112
|
- **Я хочу продолжить предыдущую работу**
|
|
114
|
-
→
|
|
113
|
+
→ `/speccrew-team-leader каков текущий прогресс?`
|
|
115
114
|
|
|
116
115
|
- **Я хочу проверить состояние здоровья системы**
|
|
117
116
|
→ Выполнить в терминале: `speccrew doctor`
|
|
118
117
|
|
|
119
118
|
- **Я не уверен, что делать**
|
|
120
|
-
→
|
|
119
|
+
→ `/speccrew-team-leader помогите мне начать`
|
|
121
120
|
→ Team Leader автоматически определит статус вашего проекта и направит вас
|
|
122
121
|
|
|
123
122
|
---
|
|
@@ -126,14 +125,14 @@ speccrew init --ide qoder
|
|
|
126
125
|
|
|
127
126
|
| Роль | Agent | Обязанности | Пример команды |
|
|
128
127
|
|------|-------|-----------------|-----------------|
|
|
129
|
-
| Лидер команды |
|
|
130
|
-
| Менеджер продукта |
|
|
131
|
-
| Дизайнер функций |
|
|
132
|
-
| Системный дизайнер |
|
|
133
|
-
| Системный разработчик |
|
|
134
|
-
| Менеджер тестирования |
|
|
128
|
+
| Лидер команды | `/speccrew-team-leader` | Навигация по проекту, инициализация базы знаний, проверка статуса | "Помогите мне начать" |
|
|
129
|
+
| Менеджер продукта | `/speccrew-product-manager` | Анализ требований, генерация PRD | "У меня новое требование: ..." |
|
|
130
|
+
| Дизайнер функций | `/speccrew-feature-designer` | Анализ функций, проектирование спецификаций, API контракты | "Начать проектирование функций для итерации X" |
|
|
131
|
+
| Системный дизайнер | `/speccrew-system-designer` | Проектирование архитектуры, детальное проектирование платформы | "Начать системное проектирование для итерации X" |
|
|
132
|
+
| Системный разработчик | `/speccrew-system-developer` | Координация разработки, генерация кода | "Начать разработку для итерации X" |
|
|
133
|
+
| Менеджер тестирования | `/speccrew-test-manager` | Планирование тестирования, проектирование случаев, выполнение | "Начать тестирование для итерации X" |
|
|
135
134
|
|
|
136
|
-
> **Примечание**: Вам не нужно запоминать всех агентов. Просто поговорите с
|
|
135
|
+
> **Примечание**: Вам не нужно запоминать всех агентов. Просто поговорите с `/speccrew-team-leader`, и он направит ваш запрос к правильному агенту.
|
|
137
136
|
|
|
138
137
|
---
|
|
139
138
|
|
|
@@ -172,7 +171,7 @@ flowchart LR
|
|
|
172
171
|
|
|
173
172
|
**Пример разговора**:
|
|
174
173
|
```
|
|
175
|
-
|
|
174
|
+
/speccrew-team-leader инициализировать техническую базу знаний
|
|
176
175
|
```
|
|
177
176
|
|
|
178
177
|
**Трехфазный процесс**:
|
|
@@ -194,7 +193,7 @@ speccrew-workspace/knowledges/techs/{platform-id}/
|
|
|
194
193
|
|
|
195
194
|
**Пример разговора**:
|
|
196
195
|
```
|
|
197
|
-
|
|
196
|
+
/speccrew-team-leader инициализировать бизнес-базу знаний
|
|
198
197
|
```
|
|
199
198
|
|
|
200
199
|
**Четырехфазный процесс**:
|
|
@@ -220,7 +219,7 @@ speccrew-workspace/knowledges/bizs/
|
|
|
220
219
|
|
|
221
220
|
**Как начать**:
|
|
222
221
|
```
|
|
223
|
-
|
|
222
|
+
/speccrew-product-manager У меня новое требование: [опишите ваше требование]
|
|
224
223
|
```
|
|
225
224
|
|
|
226
225
|
**Рабочий процесс Agent**:
|
|
@@ -247,7 +246,7 @@ iterations/{номер}-{тип}-{имя}/01.product-requirement/
|
|
|
247
246
|
|
|
248
247
|
**Как начать**:
|
|
249
248
|
```
|
|
250
|
-
|
|
249
|
+
/speccrew-feature-designer начать feature design
|
|
251
250
|
```
|
|
252
251
|
|
|
253
252
|
**Рабочий процесс Agent**:
|
|
@@ -274,7 +273,7 @@ iterations/{iter}/02.feature-design/
|
|
|
274
273
|
|
|
275
274
|
**Как начать**:
|
|
276
275
|
```
|
|
277
|
-
|
|
276
|
+
/speccrew-system-designer начать system design
|
|
278
277
|
```
|
|
279
278
|
|
|
280
279
|
**Рабочий процесс Agent**:
|
|
@@ -305,7 +304,7 @@ iterations/{iter}/03.system-design/
|
|
|
305
304
|
|
|
306
305
|
**Как начать**:
|
|
307
306
|
```
|
|
308
|
-
|
|
307
|
+
/speccrew-system-developer начать разработку
|
|
309
308
|
```
|
|
310
309
|
|
|
311
310
|
**Рабочий процесс Agent**:
|
|
@@ -336,7 +335,7 @@ iterations/{iter}/04.development/
|
|
|
336
335
|
|
|
337
336
|
**Как начать**:
|
|
338
337
|
```
|
|
339
|
-
|
|
338
|
+
/speccrew-test-manager начать тестирование
|
|
340
339
|
```
|
|
341
340
|
|
|
342
341
|
**Трехфазный процесс тестирования**:
|
|
@@ -458,7 +457,7 @@ pending → in_progress → completed → confirmed
|
|
|
458
457
|
Просмотр статуса panorama pipeline через Agent Team Leader:
|
|
459
458
|
|
|
460
459
|
```
|
|
461
|
-
|
|
460
|
+
/speccrew-team-leader просмотреть текущий прогресс итерации
|
|
462
461
|
```
|
|
463
462
|
|
|
464
463
|
Team Leader прочитает файлы прогресса и покажет обзор статуса, подобный:
|
|
@@ -560,12 +559,12 @@ npm install -g speccrew@0.5.6
|
|
|
560
559
|
|
|
561
560
|
| Фаза | Agent | Начальный разговор |
|
|
562
561
|
|-------|-------|-------------------|
|
|
563
|
-
| Инициализация | Team Leader |
|
|
564
|
-
| Анализ требований | Product Manager |
|
|
565
|
-
| Feature Design | Feature Designer |
|
|
566
|
-
| System Design | System Designer |
|
|
567
|
-
| Разработка | System Developer |
|
|
568
|
-
| Системное тестирование | Test Manager |
|
|
562
|
+
| Инициализация | Team Leader | `/speccrew-team-leader инициализировать техническую базу знаний` |
|
|
563
|
+
| Анализ требований | Product Manager | `/speccrew-product-manager У меня новое требование: [описание]` |
|
|
564
|
+
| Feature Design | Feature Designer | `/speccrew-feature-designer начать feature design` |
|
|
565
|
+
| System Design | System Designer | `/speccrew-system-designer начать system design` |
|
|
566
|
+
| Разработка | System Developer | `/speccrew-system-developer начать разработку` |
|
|
567
|
+
| Системное тестирование | Test Manager | `/speccrew-test-manager начать тестирование` |
|
|
569
568
|
|
|
570
569
|
### Контрольный список Checkpoint
|
|
571
570
|
|
package/lib/commands/init.js
CHANGED
|
@@ -422,13 +422,13 @@ async function runInit(options = {}) {
|
|
|
422
422
|
console.log(' 1. Open your project in your IDE (Qoder/Cursor/Claude Code)');
|
|
423
423
|
console.log('');
|
|
424
424
|
console.log(' 2. Initialize knowledge base (recommended for existing projects):');
|
|
425
|
-
console.log(' → Tell
|
|
425
|
+
console.log(' → Tell /speccrew-team-leader: "Initialize technical knowledge base"');
|
|
426
426
|
console.log(' → Then: "Initialize business knowledge base"');
|
|
427
427
|
console.log('');
|
|
428
428
|
console.log(' 3. Start your first requirement:');
|
|
429
|
-
console.log(' → Tell
|
|
429
|
+
console.log(' → Tell /speccrew-product-manager: "I have a new requirement: [describe it]"');
|
|
430
430
|
console.log('');
|
|
431
|
-
console.log(' Need help? → Tell
|
|
431
|
+
console.log(' Need help? → Tell /speccrew-team-leader: "Help me get started"');
|
|
432
432
|
console.log(' Troubleshooting? → Run: speccrew doctor');
|
|
433
433
|
console.log('');
|
|
434
434
|
console.log(' Documentation: speccrew-workspace/docs/GETTING-STARTED.md');
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "speccrew",
|
|
3
|
-
"version": "0.7.
|
|
3
|
+
"version": "0.7.47",
|
|
4
4
|
"description": "Spec-Driven Development toolkit for AI-powered IDEs",
|
|
5
5
|
"author": "charlesmu99",
|
|
6
6
|
"repository": {
|
|
@@ -32,5 +32,5 @@
|
|
|
32
32
|
"agents",
|
|
33
33
|
"skills"
|
|
34
34
|
],
|
|
35
|
-
"license": "
|
|
35
|
+
"license": "Apache-2.0"
|
|
36
36
|
}
|
package/README.bn.md
DELETED
|
@@ -1,174 +0,0 @@
|
|
|
1
|
-
# SpecCrew - AI-চালিত সফ্টওয়্যার ইঞ্জিনিয়ারিং ফ্রেমওয়ার্ক
|
|
2
|
-
|
|
3
|
-
<p align="center">
|
|
4
|
-
<a href="./README.md">简体中文</a> |
|
|
5
|
-
<a href="./README.zh-TW.md">繁體中文</a> |
|
|
6
|
-
<a href="./README.en.md">English</a> |
|
|
7
|
-
<a href="./README.ko.md">한국어</a> |
|
|
8
|
-
<a href="./README.de.md">Deutsch</a> |
|
|
9
|
-
<a href="./README.es.md">Español</a> |
|
|
10
|
-
<a href="./README.fr.md">Français</a> |
|
|
11
|
-
<a href="./README.it.md">Italiano</a> |
|
|
12
|
-
<a href="./README.da.md">Dansk</a> |
|
|
13
|
-
<a href="./README.ja.md">日本語</a> |
|
|
14
|
-
<a href="./README.pl.md">Polski</a> |
|
|
15
|
-
<a href="./README.ru.md">Русский</a> |
|
|
16
|
-
<a href="./README.bs.md">Bosanski</a> |
|
|
17
|
-
<a href="./README.ar.md">العربية</a> |
|
|
18
|
-
<a href="./README.no.md">Norsk</a> |
|
|
19
|
-
<a href="./README.pt-BR.md">Português (Brasil)</a> |
|
|
20
|
-
<a href="./README.th.md">ไทย</a> |
|
|
21
|
-
<a href="./README.tr.md">Türkçe</a> |
|
|
22
|
-
<a href="./README.uk.md">Українська</a> |
|
|
23
|
-
<a href="./README.bn.md">বাংলা</a> |
|
|
24
|
-
<a href="./README.el.md">Ελληνικά</a> |
|
|
25
|
-
<a href="./README.vi.md">Tiếng Việt</a>
|
|
26
|
-
</p>
|
|
27
|
-
|
|
28
|
-
<p align="center">
|
|
29
|
-
<a href="https://www.npmjs.com/package/speccrew"><img src="https://img.shields.io/npm/v/speccrew.svg" alt="npm version"></a>
|
|
30
|
-
<a href="https://www.npmjs.com/package/speccrew"><img src="https://img.shields.io/npm/dm/speccrew.svg" alt="npm downloads"></a>
|
|
31
|
-
<a href="https://github.com/charlesmu99/speccrew/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/speccrew.svg" alt="license"></a>
|
|
32
|
-
</p>
|
|
33
|
-
|
|
34
|
-
> যেকোনো সফ্টওয়্যার প্রকল্পের জন্য দ্রুত ইঞ্জিনিয়ারিং বাস্তবায়ন সক্ষম করে এমন একটি ভার্চুয়াল AI ডেভেলপমেন্ট টিম
|
|
35
|
-
|
|
36
|
-
## SpecCrew কী?
|
|
37
|
-
|
|
38
|
-
SpecCrew একটি এম্বেডেড ভার্চুয়াল AI ডেভেলপমেন্ট টিম ফ্রেমওয়ার্ক। এটি পেশাদার সফ্টওয়্যার ইঞ্জিনিয়ারিং ওয়ার্কফ্লো (PRD → Feature Design → System Design → Dev → Deployment → Test) কে পুনরায় ব্যবহারযোগ্য Agent ওয়ার্কফ্লোতে রূপান্তর করে, ডেভেলপমেন্ট টিমগুলিকে Specification-Driven Development (SDD) অর্জনে সাহায্য করে, বিশেষত বিদ্যমান প্রকল্পগুলির জন্য উপযুক্ত।
|
|
39
|
-
|
|
40
|
-
বিদ্যমান প্রকল্পগুলিতে Agent এবং Skill সংহত করে, টিমগুলি দ্রুত প্রকল্প ডকুমেন্টেশন সিস্টেম এবং ভার্চুয়াল সফ্টওয়্যার টিম চালু করতে পারে, মানক ইঞ্জিনিয়ারিং ওয়ার্কফ্লো অনুসরণ করে নতুন বৈশিষ্ট্য এবং পরিবর্তন ধাপে ধাপে বাস্তবায়ন করতে পারে।
|
|
41
|
-
|
|
42
|
-
---
|
|
43
|
-
|
|
44
|
-
## ✨ মূল বৈশিষ্ট্য
|
|
45
|
-
|
|
46
|
-
### 🏭 ভার্চুয়াল সফ্টওয়্যার টিম
|
|
47
|
-
এক ক্লিকে **7টি পেশাদার Agent ভূমিকা** + **30+টি Skill ওয়ার্কফ্লো** তৈরি, একটি সম্পূর্ণ ভার্চুয়াল সফ্টওয়্যার টিম গঠন:
|
|
48
|
-
- **Team Leader** - গ্লোবাল পরিকল্পনা এবং ইটারেশন ব্যবস্থাপনা
|
|
49
|
-
- **Product Manager** - প্রয়োজনীয়তা বিশ্লেষণ এবং PRD আউটপুট
|
|
50
|
-
- **Feature Designer** - বৈশিষ্ট্য ডিজাইন + API চুক্তি
|
|
51
|
-
- **System Designer** - Frontend/Backend/Mobile/Desktop সিস্টেম ডিজাইন
|
|
52
|
-
- **System Developer** - মাল্টিপ্ল্যাটফর্ম সমান্তরাল উন্নয়ন
|
|
53
|
-
- **Test Manager** - তিন-পর্যায়ের পরীক্ষা সমন্বয়
|
|
54
|
-
- **Task Worker** - সমান্তরাল উপ-কার্য সম্পাদন
|
|
55
|
-
|
|
56
|
-
### 📐 ISA-95 ছয়-পর্যায়ের মডেলিং
|
|
57
|
-
আন্তর্জাতিক **ISA-95** মডেলিং পদ্ধতির উপর ভিত্তি করে, ব্যবসায়িক প্রয়োজনীয়তা থেকে সফ্টওয়্যার সিস্টেমে রূপান্তরের মানকায়ন:
|
|
58
|
-
```
|
|
59
|
-
Domain Descriptions → Functions in Domains → Functions of Interest
|
|
60
|
-
↓ ↓ ↓
|
|
61
|
-
Information Flows → Categories of Information → Information Descriptions
|
|
62
|
-
```
|
|
63
|
-
- প্রতিটি পর্যায় নির্দিষ্ট UML ডায়াগ্রামের সাথে সামঞ্জস্যপূর্ণ (use case, sequence, class)
|
|
64
|
-
- ব্যবসায়িক প্রয়োজনীয়তা "ধাপে ধাপে পরিশোধিত" হয়, তথ্য ক্ষতি ছাড়াই
|
|
65
|
-
- আউটপুটগুলি উন্নয়নের জন্য সরাসরি ব্যবহারযোগ্য
|
|
66
|
-
|
|
67
|
-
### 📚 জ্ঞান ভিত্তি সিস্টেম
|
|
68
|
-
তিন-স্তরের জ্ঞান ভিত্তি আর্কিটেকচার নিশ্চিত করে যে AI সর্বদা "একক সত্যের উৎস" এর উপর ভিত্তি করে কাজ করে:
|
|
69
|
-
|
|
70
|
-
| স্তর | ডিরেক্টরি | বিষয়বস্তু | উদ্দেশ্য |
|
|
71
|
-
|------|-----------|-----------|----------|
|
|
72
|
-
| L1 সিস্টেম জ্ঞান | `knowledge/techs/` | টেক স্ট্যাক, আর্কিটেকচার, কনভেনশন | AI প্রকল্পের প্রযুক্তিগত সীমানা বোঝে |
|
|
73
|
-
| L2 ব্যবসায়িক জ্ঞান | `knowledge/bizs/` | মডিউল ফাংশন, ব্যবসায়িক প্রবাহ, সত্তা | AI ব্যবসায়িক যুক্তি বোঝে |
|
|
74
|
-
| L3 ইটারেশন আর্টিফ্যাক্ট | `iterations/iXXX/` | PRD, ডিজাইন ডকুমেন্ট, পরীক্ষার প্রতিবেদন | বর্তমান প্রয়োজনীয়তার জন্য সম্পূর্ণ ট্রেসেবিলিটি চেইন |
|
|
75
|
-
|
|
76
|
-
### 🔄 চার-পর্যায়ের জ্ঞান পাইপলাইন
|
|
77
|
-
**স্বয়ংক্রিয় জ্ঞান উৎপাদন আর্কিটেকচার**, সোর্স কোড থেকে ব্যবসায়িক/প্রযুক্তিগত ডকুমেন্টেশনের স্বয়ংক্রিয় উৎপাদন:
|
|
78
|
-
```
|
|
79
|
-
পর্যায় 1: সোর্স কোড স্ক্যান → মডিউল তালিকা তৈরি
|
|
80
|
-
পর্যায় 2: সমান্তরাল বিশ্লেষণ → বৈশিষ্ট্য বের করা (মাল্টি-ওয়ার্কার সমান্তরাল)
|
|
81
|
-
পর্যায় 3: সমান্তরাল সারাংশ → মডিউল ওভারভিউ সম্পূর্ণ করা (মাল্টি-ওয়ার্কার সমান্তরাল)
|
|
82
|
-
পর্যায় 4: সিস্টেম সংযোজন → সিস্টেম প্যানোরামা তৈরি
|
|
83
|
-
```
|
|
84
|
-
- **পূর্ণ সিঙ্কronization** এবং **ইনক্রিমেন্টাল সিঙ্কronization** সমর্থন করে (Git diff ভিত্তিক)
|
|
85
|
-
- একজন ব্যক্তি অপ্টিমাইজ করে, টিম শেয়ার করে
|
|
86
|
-
|
|
87
|
-
### 🔧 Harness বাস্তবায়ন কাঠামো
|
|
88
|
-
**স্ট্যান্ডার্ডাইজড এক্সিকিউশন ফ্রেমওয়ার্ক**, ডিজাইন ডকুমেন্টকে নির্ভুলভাবে এক্সিকিউটেবল ডেভেলপমেন্ট নির্দেশাবলীতে রূপান্তর নিশ্চিত করে:
|
|
89
|
-
- **অপারেশন ম্যানুয়াল নীতি**: Skill হল SOP, ধাপগুলি স্পষ্ট, ধারাবাহিক, স্বয়ংসম্পূর্ণ
|
|
90
|
-
- **ইনপুট-আউটপুট চুক্তি**: ইন্টারফেস স্পষ্টভাবে সংজ্ঞায়িত, সিউডোকোডের মতো কঠোরভাবে কার্যকর
|
|
91
|
-
- **গ্র্যাডুয়াল ডিসক্লোজার আর্কিটেকচার**: তথ্য স্তরে স্তরে লোড হয়, একবারে অত্যধিক প্রসঙ্গ এড়ায়
|
|
92
|
-
- **সাব-এজেন্ট ডেলিগেশন**: জটিল কাজ স্বয়ংক্রিয়ভাবে বিভক্ত হয়, সমান্তরাল কার্যকরীকরণ গুণমান নিশ্চিত করে
|
|
93
|
-
|
|
94
|
-
---
|
|
95
|
-
|
|
96
|
-
## ৮টি মূল সমস্যা সমাধান
|
|
97
|
-
|
|
98
|
-
### ১. AI বিদ্যমান প্রকল্প ডকুমেন্টেশন উপেক্ষা করে (জ্ঞান ব্যবধান)
|
|
99
|
-
**সমস্যা**: বিদ্যমান SDD বা Vibe Coding পদ্ধতিগুলি AI-এর রিয়েল-টাইমে প্রকল্প সারাংশ করার উপর নির্ভর করে, সহজেই গুরুত্বপূর্ণ প্রসঙ্গ মিস হয় এবং ডেভেলপমেন্ট ফলাফল প্রত্যাশা থেকে বিচ্যুত হয়।
|
|
100
|
-
|
|
101
|
-
**সমাধান**: `knowledge/` রিপোজিটরি প্রকল্পের "একমাত্র সত্যের উৎস" হিসাবে কাজ করে, আর্কিটেকচার ডিজাইন, কার্যকরী মডিউল এবং ব্যবসায়িক প্রক্রিয়াগুলি জমা করে নিশ্চিত করে যে প্রয়োজনীয়তাগুলি উৎস থেকে পথে থাকে।
|
|
102
|
-
|
|
103
|
-
### ২. PRD থেকে সরাসরি প্রযুক্তিগত ডকুমেন্টেশন (বিষয়বস্তু বাদ পড়া)
|
|
104
|
-
**সমস্যা**: PRD থেকে সরাসরি বিস্তারিত ডিজাইনে যাওয়া সহজেই প্রয়োজনীয়তার বিস্তারিত মিস হয়, বাস্তবায়িত বৈশিষ্ট্যগুলি প্রয়োজনীয়তা থেকে বিচ্যুত হয়।
|
|
105
|
-
|
|
106
|
-
**সমাধান**: প্রযুক্তিগত বিস্তারিত ছাড়াই শুধুমাত্র প্রয়োজনীয়তার কঙ্কালে ফোকাস করে **Feature Design ডকুমেন্ট** পর্যায় প্রবর্তন করুন:
|
|
107
|
-
- কোন পৃষ্ঠা এবং উপাদান অন্তর্ভুক্ত?
|
|
108
|
-
- পৃষ্ঠা অপারেশন প্রবাহ
|
|
109
|
-
- ব্যাকেন্ড প্রক্রিয়াকরণ লজিক
|
|
110
|
-
- ডেটা স্টোরেজ কাঠামো
|
|
111
|
-
|
|
112
|
-
ডেভেলপমেন্ট শুধুমাত্র নির্দিষ্ট টেক স্ট্যাকের উপর ভিত্তি করে "মাংস পূরণ করতে" হবে, নিশ্চিত করে যে বৈশিষ্ট্যগুলি "হাড়ের কাছাকাছি (প্রয়োজনীয়তা)" বৃদ্ধি পায়।
|
|
113
|
-
|
|
114
|
-
### ৩. Agent সার্চ সুযোগ অনিশ্চিত (অনিশ্চয়তা)
|
|
115
|
-
**সমস্যা**: জটিল প্রকল্পগুলিতে, AI-এর বিস্তৃত কোড এবং ডকুমেন্ট সার্চ অনিশ্চিত ফলাফল দেয়, সামঞ্জস্যতা নিশ্চিত করা কঠিন করে তোলে।
|
|
116
|
-
|
|
117
|
-
**সমাধান**: প্রতিটি Agent-এর প্রয়োজনের উপর ভিত্তি করে ডিজাইন করা স্পষ্ট ডকুমেন্ট ডিরেক্টরি কাঠামো এবং টেমপ্লেট, নিশ্চিততা নিশ্চিত করতে **ধাপে ধাপে প্রকাশ এবং চাহিদা অনুযায়ী লোডিং** বাস্তবায়ন করে।
|
|
118
|
-
|
|
119
|
-
### ৪. ধাপ এবং কাজ অনুপস্থিত (প্রক্রিয়া বিচ্ছেদ)
|
|
120
|
-
**সমস্যা**: সম্পূর্ণ ইঞ্জিনিয়ারিং প্রক্রিয়া কভারেজের অভাব সহজেই গুরুত্বপূর্ণ ধাপ মিস করে, গুণমান নিশ্চিত করা কঠিন করে তোলে।
|
|
121
|
-
|
|
122
|
-
**সমাধান**: সম্পূর্ণ সফ্টওয়্যার ইঞ্জিনিয়ারিং জীবনচক্র কভার করুন:
|
|
123
|
-
```
|
|
124
|
-
PRD (প্রয়োজনীয়তা) → Feature Design (বৈশিষ্ট্য ডিজাইন) → API Contract (চুক্তি)
|
|
125
|
-
→ System Design (সিস্টেম ডিজাইন) → Dev (ডেভেলপমেন্ট) → Deployment (স্থাপনা) → Test (পরীক্ষা)
|
|
126
|
-
```
|
|
127
|
-
- প্রতিটি পর্যায়ের আউটপুট পরবর্তী পর্যায়ের ইনপুট
|
|
128
|
-
- প্রতিটি ধাপ এগিয়ে যাওয়ার আগে মানব নিশ্চিতকরণ প্রয়োজন
|
|
129
|
-
- সমস্ত Agent কার্যকরীকরণে সম্পন্ন হওয়ার পরে স্ব-পরীক্ষা সহ todo তালিকা আছে
|
|
130
|
-
|
|
131
|
-
### ৫. কম টিম সহযোগিতা দক্ষতা (জ্ঞান সিলো)
|
|
132
|
-
**সমস্যা**: AI প্রোগ্রামিং অভিজ্ঞতা টিমগুলির মধ্যে ভাগ করা কঠিন, পুনরাবৃত্ত ত্রুটির দিকে নিয়ে যায়।
|
|
133
|
-
|
|
134
|
-
**সমাধান**: সমস্ত Agent, Skill এবং সম্পর্কিত ডকুমেন্ট সোর্স কোডের সাথে ভার্সন কন্ট্রোল করা হয়:
|
|
135
|
-
- একজনের অপ্টিমাইজেশন টিম দ্বারা ভাগ করা হয়
|
|
136
|
-
- জ্ঞান কোড বেসে জমা হয়
|
|
137
|
-
- টিম সহযোগিতা দক্ষতা উন্নত হয়
|
|
138
|
-
|
|
139
|
-
### ৭. একক Agent প্রসঙ্গ খুব দীর্ঘ (পারফরম্যান্স বাধা)
|
|
140
|
-
**সমস্যা**: বড় জটিল কাজগুলি একক Agent প্রসঙ্গ উইন্ডো অতিক্রম করে, বোঝাপড়া বিচ্যুতি এবং আউটপুট গুণমান হ্রাস ঘটায়।
|
|
141
|
-
|
|
142
|
-
**সমাধান**: **Sub-Agent অটো-ডিসপ্যাচ মেকানিজম**:
|
|
143
|
-
- জটিল কাজগুলি স্বয়ংক্রিয়ভাবে চিহ্নিত হয় এবং সাব-টাস্কে বিভক্ত হয়
|
|
144
|
-
- প্রতিটি সাব-টাস্ক বিচ্ছিন্ন প্রসঙ্গ সহ একটি স্বাধীন Sub-Agent দ্বারা কার্যকর করা হয়
|
|
145
|
-
- প্যারেন্ট Agent সমন্বয় এবং একত্রিত করে সামগ্রিক সামঞ্জস্য নিশ্চিত করে
|
|
146
|
-
- একক Agent প্রসঙ্গ সম্প্রসারণ এড়িয়ে আউটপুট গুণমান নিশ্চিত করে
|
|
147
|
-
|
|
148
|
-
### ৮. প্রয়োজনীয়তা পুনরাবৃত্তি বিশৃঙ্খলা (ব্যবস্থাপনা অসুবিধা)
|
|
149
|
-
**সমস্যা**: একই শাখায় মিশ্রিত একাধিক প্রয়োজনীয়তা একে অপরকে প্রভাবিত করে, ট্র্যাকিং এবং রোলব্যাক কঠিন করে তোলে।
|
|
150
|
-
|
|
151
|
-
**সমাধান**: **প্রতিটি প্রয়োজনীয়তা একটি স্বাধীন প্রকল্প হিসাবে**:
|
|
152
|
-
- প্রতিটি প্রয়োজনীয়তা একটি স্বাধীন পুনরাবৃত্তি ডিরেক্টরি তৈরি করে `iterations/iXXX-[প্রয়োজনীয়তা-নাম]/`
|
|
153
|
-
- সম্পূর্ণ বিচ্ছিন্নতা: ডকুমেন্ট, ডিজাইন, কোড এবং পরীক্ষা স্বাধীনভাবে পরিচালিত
|
|
154
|
-
- দ্রুত পুনরাবৃত্তি: ছোট গ্রানুলারিটি ডেলিভারি, দ্রুত যাচাইকরণ, দ্রুত স্থাপন
|
|
155
|
-
- নমনীয় আর্কাইভিং: সম্পন্ন হওয়ার পরে, স্পষ্ট ঐতিহাসিক ট্রেসেবিলিটি সহ `archive/`-এ আর্কাইভ করুন
|
|
156
|
-
|
|
157
|
-
### ৬. ডকুমেন্ট আপডেট বিলম্ব (জ্ঞান ক্ষয়)
|
|
158
|
-
**সমস্যা**: প্রকল্পগুলি বিকশিত হওয়ার সাথে সাথে ডকুমেন্টগুলি পুরানো হয়ে যায়, AI ভুল তথ্য নিয়ে কাজ করে।
|
|
159
|
-
|
|
160
|
-
**সমাধান**: Agent-এর স্বয়ংক্রিয় ডকুমেন্ট আপডেট ক্ষমতা আছে, জ্ঞান বেস সঠিক রাখতে রিয়েল-টাইমে প্রকল্প পরিবর্তনগুলি সিঙ্ক্রোনাইজ করে।
|
|
161
|
-
|
|
162
|
-
---
|
|
163
|
-
|
|
164
|
-
## আরও তথ্য
|
|
165
|
-
|
|
166
|
-
- **Agent জ্ঞান মানচিত্র**: [speccrew-workspace/docs/agent-knowledge-map.md](./speccrew-workspace/docs/agent-knowledge-map.md)
|
|
167
|
-
- **npm**: https://www.npmjs.com/package/speccrew
|
|
168
|
-
- **GitHub**: https://github.com/charlesmu99/speccrew
|
|
169
|
-
- **Gitee**: https://gitee.com/amutek/speccrew
|
|
170
|
-
- **Qoder IDE**: https://qoder.com/
|
|
171
|
-
|
|
172
|
-
---
|
|
173
|
-
|
|
174
|
-
> **SpecCrew ডেভেলপারদের প্রতিস্থাপন করার লক্ষ্য নয়, বরং বোরিং অংশগুলি স্বয়ংক্রিয় করে যাতে টিমগুলি আরও মূল্যবান কাজে ফোকাস করতে পারে।**
|