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.
Files changed (50) hide show
  1. package/.speccrew/agents/speccrew-team-leader.md +6 -6
  2. package/README.ar.md +5 -17
  3. package/README.de.md +5 -17
  4. package/README.en.md +5 -17
  5. package/README.es.md +5 -17
  6. package/README.fr.md +5 -17
  7. package/README.hi.md +384 -0
  8. package/README.ja.md +5 -17
  9. package/README.md +5 -17
  10. package/README.pt-BR.md +5 -17
  11. package/README.ru.md +5 -17
  12. package/docs/GETTING-STARTED.ar.md +39 -40
  13. package/docs/GETTING-STARTED.de.md +39 -40
  14. package/docs/GETTING-STARTED.en.md +39 -40
  15. package/docs/GETTING-STARTED.es.md +39 -40
  16. package/docs/GETTING-STARTED.fr.md +39 -40
  17. package/docs/GETTING-STARTED.hi.md +636 -0
  18. package/docs/GETTING-STARTED.ja.md +39 -40
  19. package/docs/GETTING-STARTED.md +39 -40
  20. package/docs/GETTING-STARTED.pt-BR.md +25 -26
  21. package/docs/GETTING-STARTED.ru.md +37 -38
  22. package/lib/commands/init.js +3 -3
  23. package/package.json +1 -1
  24. package/workspace-template/scripts/update-progress.js +5 -1
  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
@@ -1,217 +0,0 @@
1
- # Hướng Dẫn Bắt Đầu Nhanh 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
- Tài liệu này giúp bạn nhanh chóng hiểu cách sử dụng nhóm Agent của SpecCrew để hoàn thành phát triển đầy đủ từ yêu cầu đến giao nộp theo quy trình kỹ thuật tiêu chuẩn.
18
-
19
- ---
20
-
21
- ## 1. Điều Kiện Tiên Quyết
22
-
23
- ### Cài Đặt SpecCrew
24
-
25
- ```bash
26
- npm install -g speccrew
27
- ```
28
-
29
- ### Khởi Tạo Dự Án
30
-
31
- ```bash
32
- speccrew init --ide qoder
33
- ```
34
-
35
- IDE được hỗ trợ: `qoder`, `cursor`, `claude`, `codex`
36
-
37
- ### Cấu Trúc Thư Mục Sau Khi Khởi Tạo
38
-
39
- ```
40
- .
41
- ├── .qoder/
42
- │ ├── agents/ # Tệp định nghĩa Agents
43
- │ └── skills/ # Tệp định nghĩa Skills
44
- ├── speccrew-workspace/ # Workspace
45
- │ ├── docs/ # Cấu hình, quy tắc, mẫu, giải pháp
46
- │ ├── iterations/ # Các iteration đang diễn ra
47
- │ ├── iteration-archives/ # Các iteration đã lưu trữ
48
- │ └── knowledges/ # Cơ sở kiến thức
49
- │ ├── base/ # Thông tin cơ bản (báo cáo chẩn đoán, nợ kỹ thuật)
50
- │ ├── bizs/ # Cơ sở kiến thức nghiệp vụ
51
- │ └── techs/ # Cơ sở kiến thức kỹ thuật
52
- ```
53
-
54
- ### Tham Khảo Nhanh Lệnh CLI
55
-
56
- | Lệnh | Mô tả |
57
- |------|------|
58
- | `speccrew list` | Liệt kê tất cả Agents và Skills có sẵn |
59
- | `speccrew doctor` | Kiểm tra tính toàn vẹn của cài đặt |
60
- | `speccrew update` | Cập nhật cấu hình dự án lên phiên bản mới nhất |
61
- | `speccrew uninstall` | Gỡ cài đặt SpecCrew |
62
-
63
- ---
64
-
65
- ## 2. Bắt Đầu Nhanh Trong 5 Phút Sau Khi Cài Đặt
66
-
67
- Sau khi chạy `speccrew init`, làm theo các bước này để nhanh chóng vào trạng thái làm việc:
68
-
69
- ### Bước 1: Chọn IDE Của Bạn
70
-
71
- | IDE | Lệnh Khởi Tạo | Kịch Bản Ứng Dụng |
72
- |-----|-----------|----------|
73
- | **Qoder** (Được khuyến nghị) | `speccrew init --ide qoder` | Điều phối agent đầy đủ, workers song song |
74
- | **Cursor** | `speccrew init --ide cursor` | Workflow dựa trên Composer |
75
- | **Claude Code** | `speccrew init --ide claude` | Phát triển CLI-first |
76
- | **Codex** | `speccrew init --ide codex` | Tích hợp hệ sinh thái OpenAI |
77
-
78
- ### Bước 2: Khởi Tạo Cơ Sở Kiến Thức (Được Khuyến Nghị)
79
-
80
- Đối với các dự án có mã nguồn hiện có, khuyến nghị khởi tạo cơ sở kiến thức trước để các agent hiểu codebase của bạn:
81
-
82
- ```
83
- @speccrew-team-leader khởi tạo cơ sở kiến thức kỹ thuật
84
- ```
85
-
86
- Sau đó:
87
-
88
- ```
89
- @speccrew-team-leader khởi tạo cơ sở kiến thức nghiệp vụ
90
- ```
91
-
92
- ### Bước 3: Bắt Đầu Tác Vụ Đầu Tiên Của Bạn
93
-
94
- ```
95
- @speccrew-product-manager Tôi có một yêu cầu mới: [mô tả yêu cầu chức năng của bạn]
96
- ```
97
-
98
- > **Mẹo**: Nếu không chắc chắn phải làm gì, chỉ cần nói `@speccrew-team-leader giúp tôi bắt đầu` — Team Leader sẽ tự động phát hiện trạng thái dự án của bạn và hướng dẫn bạn.
99
-
100
- ---
101
-
102
- ## 3. Cây Quyết Định Nhanh
103
-
104
- Không chắc chắn phải làm gì? Tìm kịch bản của bạn bên dưới:
105
-
106
- - **Tôi có một yêu cầu chức năng mới**
107
- → `@speccrew-product-manager Tôi có một yêu cầu mới: [mô tả yêu cầu chức năng của bạn]`
108
-
109
- - **Tôi muốn quét kiến thức dự án hiện có**
110
- → `@speccrew-team-leader khởi tạo cơ sở kiến thức kỹ thuật`
111
- → Sau đó: `@speccrew-team-leader khởi tạo cơ sở kiến thức nghiệp vụ`
112
-
113
- - **Tôi muốn tiếp tục công việc trước đó**
114
- → `@speccrew-team-leader tiến độ hiện tại là gì?`
115
-
116
- - **Tôi muốn kiểm tra trạng thái sức khỏe hệ thống**
117
- → Chạy trong terminal: `speccrew doctor`
118
-
119
- - **Tôi không chắc chắn phải làm gì**
120
- → `@speccrew-team-leader giúp tôi bắt đầu`
121
- → Team Leader sẽ tự động phát hiện trạng thái dự án của bạn và hướng dẫn bạn
122
-
123
- ---
124
-
125
- ## 4. Tham Khảo Nhanh Agents
126
-
127
- | Vai Trò | Agent | Trách Nhiệm | Ví Dụ Lệnh |
128
- |------|-------|-----------------|-----------------|
129
- | Trưởng Nhóm | `@speccrew-team-leader` | Điều hướng dự án, khởi tạo cơ sở kiến thức, kiểm tra trạng thái | "Giúp tôi bắt đầu" |
130
- | Quản Lý Sản Phẩm | `@speccrew-product-manager` | Phân tích yêu cầu, tạo PRD | "Tôi có một yêu cầu mới: ..." |
131
- | Nhà Thiết Kế Chức Năng | `@speccrew-feature-designer` | Phân tích chức năng, thiết kế đặc tả, hợp đồng API | "Bắt đầu thiết kế chức năng cho iteration X" |
132
- | Nhà Thiết Kế Hệ Thống | `@speccrew-system-designer` | Thiết kế kiến trúc, thiết kế chi tiết nền tảng | "Bắt đầu thiết kế hệ thống cho iteration X" |
133
- | Nhà Phát Triển Hệ Thống | `@speccrew-system-developer` | Phối hợp phát triển, tạo mã | "Bắt đầu phát triển cho iteration X" |
134
- | Quản Lý Kiểm Thử | `@speccrew-test-manager` | Lập kế hoạch kiểm thử, thiết kế ca, thực thi | "Bắt đầu kiểm thử cho iteration X" |
135
-
136
- > **Lưu ý**: Bạn không cần nhớ tất cả agents. Chỉ cần nói chuyện với `@speccrew-team-leader` và nó sẽ định tuyến yêu cầu của bạn đến agent phù hợp.
137
-
138
- ---
139
-
140
- ## 5. Tổng Quan Workflow
141
-
142
- ### Sơ Đồ Luồng Đầy Đủ
143
-
144
- ```mermaid
145
- flowchart LR
146
- PRD[Giai Đoạn 1<br/>Phân Tích Yêu Cầu<br/>Product Manager] --> FD[Giai Đoạn 2<br/>Feature Design<br/>Feature Designer]
147
- FD --> SD[Giai Đoạn 3<br/>System Design<br/>System Designer]
148
- SD --> DEV[Giai Đoạn 4<br/>Phát Triển<br/>System Developer]
149
- DEV --> TEST[Giai Đoạn 5<br/>Kiểm Thử Hệ Thống<br/>Test Manager]
150
- TEST --> ARCHIVE[Giai Đoạn 6<br/>Lưu Trữ]
151
-
152
- KB[(Cơ Sở Kiến Thức<br/>Trong Toàn Bộ Quy Trình)] -.-> PRD
153
- KB -.-> FD
154
- KB -.-> SD
155
- KB -.-> DEV
156
- KB -.-> TEST
157
- ```
158
-
159
- ### Nguyên Tắc Cốt Lõi
160
-
161
- 1. **Phụ Thuộc Giai Đoạn**: Đầu ra của mỗi giai đoạn là đầu vào cho giai đoạn tiếp theo
162
- 2. **Xác Nhận Checkpoint**: Mỗi giai đoạn có một điểm xác nhận yêu cầu phê duyệt của người dùng trước khi chuyển sang giai đoạn tiếp theo
163
- 3. **Điều Khiển Bởi Cơ Sở Kiến Thức**: Cơ sở kiến thức chạy trong toàn bộ quy trình, cung cấp ngữ cảnh cho tất cả các giai đoạn
164
-
165
- ---
166
-
167
- ## 6. Bước Không: Khởi Tạo Cơ Sở Kiến Thức
168
-
169
- Trước khi bắt đầu quy trình kỹ thuật chính thức, bạn cần khởi tạo cơ sở kiến thức của dự án.
170
-
171
- ### 6.1 Khởi Tạo Cơ Sở Kiến Thức Kỹ Thuật
172
-
173
- **Ví Dụ Hội Thoại**:
174
- ```
175
- @speccrew-team-leader khởi tạo cơ sở kiến thức kỹ thuật
176
- ```
177
-
178
- **Quy Trình Ba Giai Đoạn**:
179
- 1. Phát Hiện Nền Tảng — Xác định các nền tảng kỹ thuật trong dự án
180
- 2. Tạo Tài Liệu Kỹ Thuật — Tạo tài liệu đặc tả kỹ thuật cho mỗi nền tảng
181
- 3. Tạo Chỉ Mục — Thiết lập chỉ mục cơ sở kiến thức
182
-
183
- **Kết Quả**:
184
- ```
185
- speccrew-workspace/knowledges/techs/{platform-id}/
186
- ├── tech-stack.md # Định nghĩa stack công nghệ
187
- ├── architecture.md # Quy ước kiến trúc
188
- ├── dev-spec.md # Đặc tả phát triển
189
- ├── test-spec.md # Đặc tả kiểm thử
190
- └── INDEX.md # Tệp chỉ mục
191
- ```
192
-
193
- ### 6.2 Khởi Tạo Cơ Sở Kiến Thức Nghiệp Vụ
194
-
195
- **Ví Dụ Hội Thoại**:
196
- ```
197
- @speccrew-team-leader khởi tạo cơ sở kiến thức nghiệp vụ
198
- ```
199
-
200
- **Quy Trình Bốn Giai Đoạn**:
201
- 1. Kiểm Kê Chức Năng — Quét mã để xác định tất cả các chức năng
202
- 2. Phân Tích Chức Năng — Phân tích logic nghiệp vụ cho mỗi chức năng
203
- 3. Tóm Tắt Module — Tóm tắt các chức năng theo module
204
- 4. Tóm Tắt Hệ Thống — Tạo tổng quan nghiệp vụ cấp hệ thống
205
-
206
- **Kết Quả**:
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
- [Tiếp tục với tất cả các phần 7-11...]