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.
Files changed (50) hide show
  1. package/.speccrew/agents/speccrew-team-leader.md +6 -6
  2. package/LICENSE +201 -21
  3. package/README.ar.md +5 -17
  4. package/README.de.md +5 -17
  5. package/README.en.md +5 -17
  6. package/README.es.md +5 -17
  7. package/README.fr.md +5 -17
  8. package/README.hi.md +384 -0
  9. package/README.ja.md +5 -17
  10. package/README.md +5 -17
  11. package/README.pt-BR.md +5 -17
  12. package/README.ru.md +5 -17
  13. package/docs/GETTING-STARTED.ar.md +39 -40
  14. package/docs/GETTING-STARTED.de.md +39 -40
  15. package/docs/GETTING-STARTED.en.md +39 -40
  16. package/docs/GETTING-STARTED.es.md +39 -40
  17. package/docs/GETTING-STARTED.fr.md +39 -40
  18. package/docs/GETTING-STARTED.hi.md +636 -0
  19. package/docs/GETTING-STARTED.ja.md +39 -40
  20. package/docs/GETTING-STARTED.md +39 -40
  21. package/docs/GETTING-STARTED.pt-BR.md +25 -26
  22. package/docs/GETTING-STARTED.ru.md +37 -38
  23. package/lib/commands/init.js +3 -3
  24. package/package.json +2 -2
  25. package/README.bn.md +0 -174
  26. package/README.bs.md +0 -394
  27. package/README.da.md +0 -394
  28. package/README.el.md +0 -174
  29. package/README.it.md +0 -394
  30. package/README.ko.md +0 -394
  31. package/README.no.md +0 -394
  32. package/README.pl.md +0 -394
  33. package/README.th.md +0 -311
  34. package/README.tr.md +0 -306
  35. package/README.uk.md +0 -306
  36. package/README.vi.md +0 -174
  37. package/README.zh-TW.md +0 -394
  38. package/docs/GETTING-STARTED.bn.md +0 -219
  39. package/docs/GETTING-STARTED.bs.md +0 -219
  40. package/docs/GETTING-STARTED.da.md +0 -637
  41. package/docs/GETTING-STARTED.el.md +0 -633
  42. package/docs/GETTING-STARTED.it.md +0 -639
  43. package/docs/GETTING-STARTED.ko.md +0 -639
  44. package/docs/GETTING-STARTED.no.md +0 -563
  45. package/docs/GETTING-STARTED.pl.md +0 -597
  46. package/docs/GETTING-STARTED.th.md +0 -219
  47. package/docs/GETTING-STARTED.tr.md +0 -597
  48. package/docs/GETTING-STARTED.uk.md +0 -597
  49. package/docs/GETTING-STARTED.vi.md +0 -217
  50. package/docs/GETTING-STARTED.zh-TW.md +0 -639
package/README.zh-TW.md DELETED
@@ -1,394 +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 工作流,幫助開發團隊實現規範驅動開發(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** - 前端/後端/行動端/桌面端系統設計
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 圖(用例圖、序列圖、類圖等)
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
- Stage 1: 掃描原始碼 → 生成模組清單
80
- Stage 2: 並行分析 → 提取功能特性(多 Worker 並行)
81
- Stage 3: 並行匯總 → 完善模組概覽(多 Worker 並行)
82
- Stage 4: 系統聚合 → 生成系統全景圖
83
- ```
84
- - 支援 **全量同步** 和 **增量同步**(基於 Git diff)
85
- - 一人優化,團隊共享
86
-
87
- ### 🔧 Harness 實戰落地框架
88
- **標準化執行框架**,確保設計文檔精準轉化為可執行的開發指令:
89
- - **操作手冊原則**:Skill 即 SOP,步驟清晰、連續、自包含
90
- - **輸入輸出契約**:明確定義介面,像偽代碼一樣嚴謹執行
91
- - **逐級披露架構**:資訊分層載入,避免一次性上下文過載
92
- - **子 Agent 委派**:複雜任務自動拆分,並行執行確保品質
93
-
94
- ---
95
-
96
- ## 解決 8 個核心問題
97
-
98
- ### 1. AI 忽略現有專案文檔(知識斷層)
99
- **問題**:現有 SDD 或 Vibe Coding 方法依賴 AI 即時總結專案,容易遺漏關鍵上下文,導致開發結果偏離預期。
100
-
101
- **解決**:`knowledge/` 知識庫作為專案的「事實來源」,沉澱架構設計、功能模組、業務流程等核心資訊,確保需求源頭不偏差。
102
-
103
- ### 2. 需求文檔直接轉技術文檔(內容遺漏)
104
- **問題**:從 PRD 直接跳到詳細設計,容易遺漏需求細節,開發出的功能與需求脫節。
105
-
106
- **解決**:增加 **Feature Design 文檔**環節,不考慮技術細節,只聚焦需求骨架:
107
- - 包含哪些頁面和元件?
108
- - 頁面操作流程
109
- - 後端處理邏輯
110
- - 資料儲存結構
111
-
112
- 開發階段只需基於特定技術棧「填肉」,確保功能「貼著骨頭(需求)」生長。
113
-
114
- ### 3. Agent 搜尋範圍不確定(不確定性)
115
- **問題**:複雜專案中,AI 大範圍搜尋程式碼和文檔,結果不確定,難以保證一致性。
116
-
117
- **解決**:明確的文檔目錄結構和模板,基於每個 Agent 所需內容設計,實現 **逐級披露、按需載入**,確保確定性。
118
-
119
- ### 4. 環節缺失、任務遺漏(流程斷裂)
120
- **問題**:缺乏完整的工程流程覆蓋,容易遺漏關鍵步驟,品質難以保證。
121
-
122
- **解決**:覆蓋軟體工程全環節:
123
- ```
124
- PRD(需求)→ Feature Design(功能設計)→ API Contract(契約)
125
- → System Design(系統設計)→ Dev(開發)→ Deployment(部署)→ Test(測試)
126
- ```
127
- - 每個環節產出物是下一環節的輸入
128
- - 每步需人工確認後方可執行
129
- - 所有 Agent 執行都有 todo 清單,完成後自檢
130
-
131
- ### 5. 團隊協作效率低(知識孤島)
132
- **問題**:AI 程式設計經驗難以在團隊間共享,重複踩坑。
133
-
134
- **解決**:所有 Agents、Skills 和相關文檔與原始碼一起進入 Git 版本管控:
135
- - 一人優化,團隊共享
136
- - 知識沉澱在程式碼庫中
137
- - 提升團隊協同效率
138
-
139
- ### 7. 單 Agent 上下文過長(效能瓶頸)
140
- **問題**:大型複雜任務超出單 Agent 上下文視窗,導致理解偏差、輸出品質下降。
141
-
142
- **解決**:**子 Agent 自動調派機制**:
143
- - 複雜任務自動識別並拆分為子任務
144
- - 每個子任務由獨立子 Agent 執行,上下文隔離
145
- - 父 Agent 協調彙總,確保整體一致性
146
- - 避免單 Agent 上下文膨脹,保障輸出品質
147
-
148
- ### 8. 需求迭代混亂(管理困難)
149
- **問題**:多個需求混雜在同一分支,相互影響,難以追蹤和回滾。
150
-
151
- **解決**:**每個需求作為獨立專案**:
152
- - 每個需求建立獨立迭代目錄 `iterations/iXXX-[需求名]/`
153
- - 完整隔離:文檔、設計、程式碼、測試獨立管理
154
- - 快速迭代:小粒度交付,快速驗證,快速上線
155
- - 靈活歸檔:完成後歸檔至 `archive/`,歷史清晰可追溯
156
-
157
- ### 6. 文檔更新滯後(知識腐化)
158
- **問題**:專案演進後文檔過時,AI 基於錯誤資訊工作。
159
-
160
- **解決**:Agent 具有自動更新文檔的能力,即時同步專案變化,保持知識庫即時準確。
161
-
162
- ---
163
-
164
- ## 核心工作流程
165
-
166
- ```mermaid
167
- graph LR
168
- A[PRD<br/>需求文檔] --> B[Feature Design<br/>功能設計]
169
- B --> C[API Contract<br/>介面契約]
170
- C --> D[System Design<br/>系統設計]
171
- D --> E[Dev<br/>開發實現]
172
- E --> F[Deployment<br/>部署實施]
173
- F --> G[System Test<br/>系統測試]
174
- G --> H[Archive<br/>歸檔]
175
-
176
- I[Knowledge<br/>知識庫] -.-> A
177
- I -.-> B
178
- I -.-> D
179
- I -.-> E
180
- I -.-> F
181
-
182
- E -.-> I
183
- F -.-> I
184
- G -.-> I
185
- ```
186
-
187
- ### 各階段說明
188
-
189
- | 階段 | Agent | 輸入 | 輸出 | 人工確認 |
190
- |------|-------|------|------|----------|
191
- | PRD | PM | 使用者需求 | 產品需求文檔 | ✅ 必需 |
192
- | Feature Design | Feature Designer | PRD | 功能設計文檔 + 介面契約 | ✅ 必需 |
193
- | System Design | System Designer | Feature Spec | 前端/後端設計文檔 | ✅ 必需 |
194
- | Dev | Dev | Design | 程式碼 + 任務記錄 | ✅ 必需 |
195
- | Deployment | System Deployer | Dev 產出 | 部署報告 + 運行應用 | ✅ 必需 |
196
- | System Test | Test Manager | Deployment 產出 + Feature Spec | 測試案例 + 測試程式碼 + 測試報告 + Bug 報告 | ✅ 必需 |
197
-
198
- ---
199
-
200
- ## 與現有方案對比
201
-
202
- | 維度 | Vibe Coding | Ralph 循環 | **SpecCrew** |
203
- |------|-------------|------------|-------------|
204
- | 文檔依賴 | 忽略現有文檔 | 依賴 AGENTS.md | **結構化知識庫** |
205
- | 需求傳遞 | 直接編碼 | PRD → 程式碼 | **PRD → Feature Design → System Design → 程式碼** |
206
- | 人工介入 | ❌ | 啟動時 | **每階段確認** |
207
- | 流程完整性 | ❌ | 中等 | **完整工程流程** |
208
- | 團隊協作 | 難共享 | 個人效率 | **團隊知識共享** |
209
- | 上下文管理 | 單實例 | 單實例循環 | **子 Agent 自動調派** |
210
- | 迭代管理 | 混雜 | 任務列表 | **需求即專案,獨立迭代** |
211
- | 確定性 | ❌ | 中等 | **高(逐級披露)** |
212
-
213
- ---
214
-
215
- ## 快速開始
216
-
217
- ### 前置條件
218
-
219
- - Node.js >= 16.0.0
220
- - 支援的 IDE:Qoder(預設)、Cursor、Claude Code
221
-
222
- > **注意**:Cursor 和 Claude Code 的適配尚未在實際 IDE 環境中測試(程式碼層面已實現並通過 E2E 驗證,但未在真實 Cursor/Claude Code 中實測)。
223
-
224
- ### 1. 安裝 SpecCrew
225
-
226
- ```bash
227
- npm install -g speccrew
228
- ```
229
-
230
- ### 2. 初始化專案
231
-
232
- 進入你的專案根目錄,執行初始化命令:
233
-
234
- ```bash
235
- cd /path/to/your-project
236
-
237
- # 預設使用 Qoder
238
- speccrew init
239
-
240
- # 或指定 IDE
241
- speccrew init --ide qoder
242
- speccrew init --ide cursor
243
- speccrew init --ide claude
244
- ```
245
-
246
- 初始化完成後,專案中會生成:
247
- - `.qoder/agents/` / `.cursor/agents/` / `.claude/agents/` — 7 個 Agent 角色定義
248
- - `.qoder/skills/` / `.cursor/skills/` / `.claude/skills/` — 30+ 個 Skill 工作流
249
- - `speccrew-workspace/` — 工作區(迭代目錄、知識庫、文檔模板)
250
- - `.speccrewrc` — SpecCrew 配置檔案
251
-
252
- 後續如需更新指定 IDE 的 Agents 和 Skills:
253
-
254
- ```bash
255
- speccrew update --ide cursor
256
- speccrew update --ide claude
257
- ```
258
-
259
- ### 3. 開始開發流程
260
-
261
- 按照標準工程流程逐步推進:
262
-
263
- 1. **PRD**:由產品經理 Agent 分析需求,生成產品需求文檔
264
- 2. **Feature Design**:由功能設計師 Agent 生成功能設計文檔 + API 契約
265
- 3. **System Design**:由系統設計師 Agent 按端(前端/後端/移動端/桌面端)生成系統設計文檔
266
- 4. **Dev**:由系統開發者 Agent 按端並行實現開發
267
- 5. **Deployment**:由系統部署者 Agent 執行構建、資料庫遷移、服務啟動和煙霧測試
268
- 6. **System Test**:由測試管理員 Agent 協調三階段測試(案例設計 → 程式碼生成 → 執行報告)
269
- 7. **Archive**:歸檔迭代
270
-
271
- > 每個階段產出物需人工確認後方可進入下一階段。
272
-
273
- ### 4. 更新 SpecCrew
274
-
275
- 當 SpecCrew 發布新版本時,請分兩步完成更新:
276
-
277
- ```bash
278
- # Step 1: Update the global CLI tool to the latest version
279
- npm install -g speccrew@latest
280
-
281
- # Step 2: Sync Agents and Skills in your project to the latest version
282
- cd /path/to/your-project
283
- speccrew update
284
- ```
285
-
286
- > **注意**:`npm install -g speccrew@latest` 更新 CLI 工具本身,而 `speccrew update` 更新專案中的 Agent 和 Skill 定義檔案。完整更新需要兩個步驟都執行。
287
-
288
- ### 5. 其他 CLI 命令
289
-
290
- ```bash
291
- speccrew list # 列出已安裝的 agents 和 skills
292
- speccrew doctor # 診斷環境和安裝狀態
293
- speccrew update # 更新 agents 和 skills 到最新版本
294
- speccrew uninstall # 解除安裝 SpecCrew(--all 同時刪除工作區)
295
- ```
296
-
297
- 📖 **詳細使用指南**:安裝完成後,查看 [快速開始文檔](docs/GETTING-STARTED.zh-TW.md) 了解完整的工作流程和各 Agent 對話指南。
298
-
299
- ---
300
-
301
- ## 目錄結構
302
-
303
- ```
304
- your-project/
305
- ├── .qoder/ # IDE 配置目錄(Qoder 範例)
306
- │ ├── agents/ # 7 個角色 Agent
307
- │ │ ├── speccrew-team-leader.md # 團隊領導:全局調度與迭代管理
308
- │ │ ├── speccrew-product-manager.md # 產品經理:需求分析與 PRD
309
- │ │ ├── speccrew-feature-designer.md # 功能設計師:Feature Design + API 契約
310
- │ │ ├── speccrew-system-designer.md # 系統設計師:按端生成系統設計
311
- │ │ ├── speccrew-system-developer.md # 系統開發者:按端並行開發
312
- │ │ ├── speccrew-test-manager.md # 測試管理員:三階段測試協調
313
- │ │ └── speccrew-task-worker.md # 任務工人:並行子任務執行
314
- │ └── skills/ # 30+ 個 Skill(按職能分組)
315
- │ ├── speccrew-pm-*/ # 產品管理(需求分析、需求評估)
316
- │ ├── speccrew-fd-*/ # 功能設計(Feature Design、API 契約)
317
- │ ├── speccrew-sd-*/ # 系統設計(前端/後端/移動端/桌面端)
318
- │ ├── speccrew-dev-*/ # 開發實現(前端/後端/移動端/桌面端)
319
- │ ├── speccrew-test-*/ # 測試(案例設計/程式碼生成/執行報告)
320
- │ ├── speccrew-knowledge-bizs-*/ # 業務知識庫(API分析/UI分析/模組分類等)
321
- │ ├── speccrew-knowledge-techs-*/ # 技術知識庫(技術棧生成/規約/索引等)
322
- │ ├── speccrew-knowledge-graph-*/ # 知識圖譜(讀寫查詢)
323
- │ └── speccrew-*/ # 工具類(診斷/時間戳/工作流等)
324
-
325
- └── speccrew-workspace/ # 工作區(初始化時生成)
326
- ├── docs/ # 管理性文檔
327
- │ ├── configs/ # 配置檔案(平台映射、技術棧映射等)
328
- │ ├── rules/ # 規則配置
329
- │ └── solutions/ # 解決方案文檔
330
-
331
- ├── iterations/ # 迭代專案(動態生成)
332
- │ └── {序號}-{類型}-{名稱}/
333
- │ ├── 00.docs/ # 原始需求文檔
334
- │ ├── 01.product-requirement/ # 產品需求文檔
335
- │ ├── 02.feature-design/ # 功能設計
336
- │ ├── 03.system-design/ # 系統設計
337
- │ ├── 04.development/ # 開發階段
338
- │ ├── 05.deployment/ # 部署階段
339
- │ ├── 06.system-test/ # 系統測試
340
- │ └── 07.delivery/ # 交付階段
341
-
342
- ├── iteration-archives/ # 迭代歸檔
343
-
344
- └── knowledges/ # 知識庫
345
- ├── base/ # 基礎/元資料
346
- │ ├── diagnosis-reports/ # 診斷報告
347
- │ ├── sync-state/ # 同步狀態
348
- │ └── tech-debts/ # 技術債
349
- ├── bizs/ # 業務知識
350
- │ └── {platform-type}/{module-name}/
351
- └── techs/ # 技術知識
352
- └── {platform-id}/
353
- ```
354
-
355
- ---
356
-
357
- ## 核心設計原則
358
-
359
- 1. **規範驅動**:先寫規範,再由規範「長出」程式碼
360
- 2. **逐級披露**:Agent 從最小入口開始,按需獲取資訊
361
- 3. **人工確認**:每階段產出需人工確認,避免 AI 跑偏
362
- 4. **上下文隔離**:大任務拆分為小粒度、上下文隔離的子任務
363
- 5. **子 Agent 協作**:複雜任務自動調派子 Agent,避免單 Agent 上下文膨脹
364
- 6. **快速迭代**:每個需求作為獨立專案,快速交付、快速驗證
365
- 7. **知識共享**:所有配置與原始碼一起 Git 管控
366
-
367
- ---
368
-
369
- ## 適用場景
370
-
371
- ### ✅ 推薦使用
372
- - 需要規範流程的中大型專案
373
- - 團隊協作的軟體開發
374
- - 遺留專案的工程化改造
375
- - 需要長期維護的產品
376
-
377
- ### ❌ 不太適合
378
- - 個人快速原型驗證
379
- - 探索性、需求極不確定的專案
380
- - 一次性腳本或工具
381
-
382
- ---
383
-
384
- ## 更多資訊
385
-
386
- - **Agent 知識地圖**: [speccrew-workspace/docs/agent-knowledge-map.md](./speccrew-workspace/docs/agent-knowledge-map.md)
387
- - **npm**: https://www.npmjs.com/package/speccrew
388
- - **GitHub**: https://github.com/charlesmu99/speccrew
389
- - **Gitee**: https://gitee.com/amutek/speccrew
390
- - **Qoder IDE**: https://qoder.com/
391
-
392
- ---
393
-
394
- > **SpecCrew 不是取代開發者,而是自動化那些枯燥的部分,讓團隊能專注於更有價值的工作。**
@@ -1,219 +0,0 @@
1
- # SpecCrew দ্রুত শুরু করার নির্দেশিকা
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
- এই নথিটি আপনাকে দ্রুত বুঝতে সাহায্য করে কিভাবে প্রয়োজনীয়তা থেকে ডেলিভারি পর্যন্ত সম্পূর্ণ বিকাশ সম্পন্ন করতে স্ট্যান্ডার্ড ইঞ্জিনিয়ারিং প্রক্রিয়া অনুযায়ী SpecCrew এজেন্ট টিম ব্যবহার করতে হয়।
18
-
19
- ---
20
-
21
- ## 1. প্রাকশর্ত
22
-
23
- ### SpecCrew ইনস্টলেশন
24
-
25
- ```bash
26
- npm install -g speccrew
27
- ```
28
-
29
- ### প্রকল্প আরম্ভকরণ
30
-
31
- ```bash
32
- speccrew init --ide qoder
33
- ```
34
-
35
- সমর্থিত IDE: `qoder`, `cursor`, `claude`, `codex`
36
-
37
- ### আরম্ভকরণের পরে ডিরেক্টরি কাঠামো
38
-
39
- ```
40
- .
41
- ├── .qoder/
42
- │ ├── agents/ # Agents সংজ্ঞা ফাইল
43
- │ └── skills/ # Skills সংজ্ঞা ফাইল
44
- ├── speccrew-workspace/ # Workspace
45
- │ ├── docs/ # কনফিগারেশন, নিয়ম, টেমপ্লেট, সমাধান
46
- │ ├── iterations/ # চলমান ইটারেশন
47
- │ ├── iteration-archives/ # আর্কাইভ করা ইটারেশন
48
- │ └── knowledges/ # নলেজ বেস
49
- │ ├── base/ # মৌলিক তথ্য (ডায়াগনোস্টিক রিপোর্ট, টেকনিক্যাল ঋণ)
50
- │ ├── bizs/ # ব্যবসায়িক নলেজ বেস
51
- │ └── techs/ # টেকনিক্যাল নলেজ বেস
52
- ```
53
-
54
- ### CLI কমান্ড দ্রুত রেফারেন্স
55
-
56
- | কমান্ড | বিবরণ |
57
- |------|------|
58
- | `speccrew list` | সমস্ত উপলব্ধ Agents এবং Skills তালিকা |
59
- | `speccrew doctor` | ইনস্টলেশন অখণ্ডতা পরীক্ষা |
60
- | `speccrew update` | প্রকল্প কনফিগারেশন সর্বশেষ সংস্করণে আপডেট |
61
- | `speccrew uninstall` | SpecCrew আনইনস্টল |
62
-
63
- ---
64
-
65
- ## 2. ইনস্টলেশনের পরে 5 মিনিটে দ্রুত শুরু
66
-
67
- `speccrew init` চালানোর পরে, দ্রুত কাজের অবস্থায় প্রবেশ করতে এই পদক্ষেপগুলি অনুসরণ করুন:
68
-
69
- ### ধাপ 1: আপনার IDE নির্বাচন করুন
70
-
71
- | IDE | আরম্ভকরণ কমান্ড | প্রয়োগের দৃশ্যপট |
72
- |-----|-----------|----------|
73
- | **Qoder** (সুপারিশকৃত) | `speccrew init --ide qoder` | সম্পূর্ণ এজেন্ট অর্কেস্ট্রেশন, সমান্তরাল ওয়ার্কার |
74
- | **Cursor** | `speccrew init --ide cursor` | Composer-ভিত্তিক ওয়ার্কফ্লো |
75
- | **Claude Code** | `speccrew init --ide claude` | CLI-first বিকাশ |
76
- | **Codex** | `speccrew init --ide codex` | OpenAI ইকোসিস্টেম ইন্টিগ্রেশন |
77
-
78
- ### ধাপ 2: নলেজ বেস আরম্ভকরণ (সুপারিশকৃত)
79
-
80
- বিদ্যমান সোর্স কোড সহ প্রকল্পগুলির জন্য, এজেন্টগুলি আপনার কোডবেস বোঝার জন্য প্রথমে নলেজ বেস আরম্ভ করার সুপারিশ করা হয়:
81
-
82
- ```
83
- @speccrew-team-leader টেকনিক্যাল নলেজ বেস আরম্ভ করুন
84
- ```
85
-
86
- তারপর:
87
-
88
- ```
89
- @speccrew-team-leader ব্যবসায়িক নলেজ বেস আরম্ভ করুন
90
- ```
91
-
92
- ### ধাপ 3: আপনার প্রথম কাজ শুরু করুন
93
-
94
- ```
95
- @speccrew-product-manager আমার একটি নতুন প্রয়োজনীয়তা আছে: [আপনার ফাংশনাল প্রয়োজনীয়তা বর্ণনা করুন]
96
- ```
97
-
98
- > **পরামর্শ**: যদি নিশ্চিত না হন কী করতে হবে, শুধু বলুন `@speccrew-team-leader আমাকে শুরু করতে সাহায্য করুন` — Team Leader স্বয়ংক্রিয়ভাবে আপনার প্রকল্পের স্থিতি সনাক্ত করবে এবং আপনাকে নির্দেশনা দেবে।
99
-
100
- ---
101
-
102
- ## 3. দ্রুত সিদ্ধান্ত গাছ
103
-
104
- নিশ্চিত নন কী করতে হবে? নীচে আপনার দৃশ্যপট খুঁজুন:
105
-
106
- - **আমার একটি নতুন ফাংশনাল প্রয়োজনীয়তা আছে**
107
- → `@speccrew-product-manager আমার একটি নতুন প্রয়োজনীয়তা আছে: [আপনার ফাংশনাল প্রয়োজনীয়তা বর্ণনা করুন]`
108
-
109
- - **আমি বিদ্যমান প্রকল্পের নলেজ স্ক্যান করতে চাই**
110
- → `@speccrew-team-leader টেকনিক্যাল নলেজ বেস আরম্ভ করুন`
111
- → তারপর: `@speccrew-team-leader ব্যবসায়িক নলেজ বেস আরম্ভ করুন`
112
-
113
- - **আমি আগের কাজ চালিয়ে যেতে চাই**
114
- → `@speccrew-team-leader বর্তমান অগ্রগতি কী?`
115
-
116
- - **আমি সিস্টেমের স্বাস্থ্যের স্থিতি পরীক্ষা করতে চাই**
117
- → টার্মিনালে চালান: `speccrew doctor`
118
-
119
- - **আমি নিশ্চিত নই কী করতে হবে**
120
- → `@speccrew-team-leader আমাকে শুরু করতে সাহায্য করুন`
121
- → Team Leader স্বয়ংক্রিয়ভাবে আপনার প্রকল্পের স্থিতি সনাক্ত করবে এবং আপনাকে নির্দেশনা দেবে
122
-
123
- ---
124
-
125
- ## 4. এজেন্ট দ্রুত রেফারেন্স
126
-
127
- | ভূমিকা | Agent | দায়িত্ব | কমান্ড উদাহরণ |
128
- |------|-------|-----------------|-----------------|
129
- | টিম লিডার | `@speccrew-team-leader` | প্রকল্প নেভিগেশন, নলেজ বেস আরম্ভ, স্থিতি পরীক্ষা | "আমাকে শুরু করতে সাহায্য করুন" |
130
- | প্রোডাক্ট ম্যানেজার | `@speccrew-product-manager` | প্রয়োজনীয়তা বিশ্লেষণ, PRD জেনারেশন | "আমার একটি নতুন প্রয়োজনীয়তা আছে: ..." |
131
- | ফিচার ডিজাইনার | `@speccrew-feature-designer` | ফিচার বিশ্লেষণ, স্পেসিফিকেশন ডিজাইন, API চুক্তি | "ইটারেশন X এর জন্য ফিচার ডিজাইন শুরু করুন" |
132
- | সিস্টেম ডিজাইনার | `@speccrew-system-designer` | আর্কিটেকচার ডিজাইন, প্ল্যাটফর্ম বিস্তারিত ডিজাইন | "ইটারেশন X এর জন্য সিস্টেম ডিজাইন শুরু করুন" |
133
- | সিস্টেম ডেভেলপার | `@speccrew-system-developer` | বিকাশ সমন্বয়, কোড জেনারেশন | "ইটারেশন X এর জন্য বিকাশ শুরু করুন" |
134
- | টেস্ট ম্যানেজার | `@speccrew-test-manager` | টেস্টিং পরিকল্পনা, কেস ডিজাইন, এক্সিকিউশন | "ইটারেশন X এর জন্য টেস্টিং শুরু করুন" |
135
-
136
- > **নোট**: আপনার সমস্ত এজেন্ট মনে রাখতে হবে না। শুধু `@speccrew-team-leader` এর সাথে কথা বলুন এবং এটি আপনার অনুরোধ সঠিক এজেন্টের কাছে রাউট করবে।
137
-
138
- ---
139
-
140
- ## 5. ওয়ার্কফ্লো ওভারভিউ
141
-
142
- ### সম্পূর্ণ ফ্লো ডায়াগ্রাম
143
-
144
- ```mermaid
145
- flowchart LR
146
- PRD[পর্যায় 1<br/>প্রয়োজনীয়তা বিশ্লেষণ<br/>Product Manager] --> FD[পর্যায় 2<br/>Feature Design<br/>Feature Designer]
147
- FD --> SD[পর্যায় 3<br/>System Design<br/>System Designer]
148
- SD --> DEV[পর্যায় 4<br/>বিকাশ<br/>System Developer]
149
- DEV --> DEPLOY[পর্যায় 5<br/>স্থাপনা<br/>System Deployer]
150
- DEPLOY --> TEST[পর্যায় 6<br/>সিস্টেম টেস্টিং<br/>Test Manager]
151
- TEST --> ARCHIVE[পর্যায় 7<br/>আর্কাইভিং]
152
-
153
- KB[(নলেজ বেস<br/>সমগ্র প্রক্রিয়া জুড়ে)] -.-> PRD
154
- KB -.-> FD
155
- KB -.-> SD
156
- KB -.-> DEV
157
- KB -.-> DEPLOY
158
- KB -.-> TEST
159
- ```
160
-
161
- ### মূল নীতি
162
-
163
- 1. **পর্যায় নির্ভরতা**: প্রতিটি পর্যায়ের আউটপুট হল পরবর্তী পর্যায়ের জন্য ইনপুট
164
- 2. **চেকপয়েন্ট নিশ্চিতকরণ**: প্রতিটি পর্যায়ে একটি নিশ্চিতকরণ বিন্দু থাকে যা পরবর্তী পর্যায়ে যাওয়ার আগে ব্যবহারকারীর অনুমোদন প্রয়োজন
165
- 3. **নলেজ বেস চালিত**: নলেজ বেস সমগ্র প্রক্রিয়া জুড়ে চলে, সমস্ত পর্যায়ের জন্য প্রসঙ্গ প্রদান করে
166
-
167
- ---
168
-
169
- ## 6. শূন্য ধাপ: নলেজ বেস আরম্ভকরণ
170
-
171
- আনুষ্ঠানিক ইঞ্জিনিয়ারিং প্রক্রিয়া শুরু করার আগে, আপনাকে প্রকল্পের নলেজ বেস আরম্ভ করতে হবে।
172
-
173
- ### 6.1 টেকনিক্যাল নলেজ বেস আরম্ভকরণ
174
-
175
- **কথোপকথন উদাহরণ**:
176
- ```
177
- @speccrew-team-leader টেকনিক্যাল নলেজ বেস আরম্ভ করুন
178
- ```
179
-
180
- **তিন-পর্যায় প্রক্রিয়া**:
181
- 1. প্ল্যাটফর্ম সনাক্তকরণ — প্রকল্পে টেকনিক্যাল প্ল্যাটফর্ম শনাক্তকরণ
182
- 2. টেকনিক্যাল ডকুমেন্টেশন জেনারেশন — প্রতিটি প্ল্যাটফর্মের জন্য টেকনিক্যাল স্পেসিফিকেশন ডকুমেন্ট জেনারেট করুন
183
- 3. ইনডেক্স জেনারেশন — নলেজ বেস ইনডেক্স প্রতিষ্ঠা
184
-
185
- **আউটপুট**:
186
- ```
187
- speccrew-workspace/knowledges/techs/{platform-id}/
188
- ├── tech-stack.md # টেকনোলজি স্ট্যাক সংজ্ঞা
189
- ├── architecture.md # আর্কিটেকচার কনভেনশন
190
- ├── dev-spec.md # বিকাশ স্পেসিফিকেশন
191
- ├── test-spec.md # টেস্টিং স্পেসিফিকেশন
192
- └── INDEX.md # ইনডেক্স ফাইল
193
- ```
194
-
195
- ### 6.2 ব্যবসায়িক নলেজ বেস আরম্ভকরণ
196
-
197
- **কথোপকথন উদাহরণ**:
198
- ```
199
- @speccrew-team-leader ব্যবসায়িক নলেজ বেস আরম্ভ করুন
200
- ```
201
-
202
- **চার-পর্যায় প্রক্রিয়া**:
203
- 1. ফিচার ইনভেন্টরি — সমস্ত ফিচার শনাক্ত করতে কোড স্ক্যান করুন
204
- 2. ফিচার বিশ্লেষণ — প্রতিটি ফিচারের জন্য ব্যবসায়িক যুক্তি বিশ্লেষণ
205
- 3. মডিউল সংক্ষিপ্তকরণ — মডিউল অনুযায়ী ফিচার সংক্ষিপ্তকরণ
206
- 4. সিস্টেম সংক্ষিপ্তকরণ — সিস্টেম-স্তরের ব্যবসায়িক ওভারভিউ তৈরি করুন
207
-
208
- **আউটপুট**:
209
- ```
210
- speccrew-workspace/knowledges/bizs/
211
- ├── {platform-type}/
212
- │ └── {module-name}/
213
- │ └── feature-spec.md
214
- └── system-overview.md
215
- ```
216
-
217
- ---
218
-
219
- [ধাপ 7-11 সহ সমস্ত বিভাগ চালিয়ে যান...]