1
2Gemini
3
4Trò chuyện
5
6Spark
7beta
8Cuộc trò chuyện mới
9Tìm kiếm cuộc trò chuyện
10Bản tin hàng ngày
11Hình ảnh
12Video
13Thư viện
14Gems
15Sổ tay mới
16Phân tích Trách nhiệm Giải trình và Quản trị Nhà ở California
17Truy cập Sách điện tử Pháp lý Nolo qua Thư viện Luật Quận Yolo
18Tất cả sổ tay
19Tinh chỉnh Tài liệu Kỹ năng
20Giáo dục Khoa học Máy tính Trực tuyến Miễn phí
21Các Yếu tố của Nghệ thuật Viết lời Hip-Hop Bậc thầy
22Nghi thức Hành lang Trường học Mới
23Phản hồi Bình tĩnh Trước Sự Căng thẳng của Người dùng
24Tìm kiếm Thông tin Từ Nhiều Nguồn
25Cá Tồn tại, Vậy Thì Sao?
26Giải thích Quy trình Tra cứu Thửa đất IDIS
27Đính chính Tên và Lời Cảm ơn
28Đổi Camera cho Cuộc họp Trực tuyến
29GỠ LỖI CÁI NÀY GIÚP TÔI
30Hướng dẫn Biên tập cho Bài báo Chính trị
31Các Mob Mới và Làm lại trong Minecraft
32Chuyển đổi Dặm sang Kilômét
33Chuyển đổi Kilômét sang Dặm
34Bot Prompt: Trung tâm Chỉ huy AI Dữ liệu
35Soạn thảo Bài viết Ủng hộ Ứng cử viên
36Chiến dịch Kinh thánh của Cảnh sát trưởng và Spencer
37Yêu cầu Chỉnh sửa Lời bài hát
38Yêu cầu Lời bài hát Dựa trên Liên kết Video
39Kế hoạch Nghiên cứu Emo Rap: Gian lận và Vô gia cư
40Nhạc Emo Rap Nâng cao Nhận thức về Tình trạng Vô gia cư
41Các Bài báo Tranh luận Chính sách Nhà ở
42Cải thiện Lời bài hát và Sản xuất Âm nhạc
43Bản thiết kế Nâng cấp Bài hát và Sản xuất
44Nhập Ngữ cảnh AI và Hồ sơ Người dùng
45Các Tính năng Mới của Gemini từ Google I/O
46Hồ sơ Người dùng và Thiết lập Mục tiêu
47Bản nhạc Rap-Metal Đen tối Nâng tầm
48Lời bài hát: Sự Phản bội của Hệ thống và Tham vọng
49DeepMind Nâng cấp Công cụ Sáng tác Lời
50Cuộc trò chuyện với Gemini
51bạn có thể sửa kỹ năng này giúp tôi không "---
52
53name: my-skill-name
54
55description: Mô tả rõ ràng về những gì kỹ năng này thực hiện và khi nào nên sử dụng nó
56
57---
58
59
60
61# Kỹ năng của tôi là Prompt Kỹ sư Phần mềm & Kiến trúc sư Sản phẩm Tinh hoa
62
63Sứ mệnh Cốt lõi
64
65Bạn là một kỹ sư phần mềm cấp cao và kiến trúc sư sản phẩm tinh hoa. Hãy xây dựng một khung kho mã nguồn (repository scaffold) hoàn chỉnh, sẵn sàng cho môi trường production dựa trên bản tóm tắt dự án dưới đây. Bàn giao mã nguồn chất lượng cao với cấu trúc chuyên nghiệp, có thể chạy thông suốt từ đầu đến cuối (end-to-end) ngay sau khi cài đặt.
66
67Yêu cầu Đầu ra
68
69Chính sách Không Đặt câu hỏi: Tự đưa ra các giả định hợp lý và tiến hành ngay lập tức.
70
71Tiêu chuẩn Bàn giao:
72
73Ưu tiên sự đơn giản và độ tin cậy hơn là sự phức tạp
74
75Bản MVP phải hoạt động đầy đủ chức năng ngay sau khi thiết lập
76
77Bao gồm: (1) cây thư mục tệp hoàn chỉnh, (2) toàn bộ các tệp mã nguồn, (3) các lệnh thiết lập cài đặt, (4) lộ trình nâng cấp
78
79Mẫu Cấu hình Dự án
80
81TÓM TẮT DỰ ÁN (Chỉ chỉnh sửa các trường này):
82
83- Tên dự án:
84
85- Mục tiêu:
86
87- Người dùng mục tiêu:
88
89- Luồng công việc cốt lõi:
90
91 1.
92
93 2.
94
95 3.
96
97 4.
98
99- Nền tảng: [WEB/MOBILE_WEB/DESKTOP/API_ONLY]
100
101- Ngôn ngữ: [TypeScript/Python]
102
103- Tích hợp:
104
105- Tính năng bắt buộc phải có:
106
107- Tính năng nên có (tùy chọn):
108
109- Ràng buộc:
110
111
112
113Kiến trúc Mặc định (Chỉ ghi đè khi thực sự cần thiết)
114
115Cấu trúc Monorepo:
116
117apps/
118
119├── web/ # Next.js (TypeScript) hoặc React + Vite
120
121├── api/ # Node.js Fastify API (TypeScript)
122
123└── worker/ # Các tác vụ chạy ngầm (Node.js/Python tùy nhu cầu)
124
125packages/
126
127└── shared/ # Các kiểu dữ liệu và tiện ích dùng chung
128
129docs/ # Tài liệu hướng dẫn cài đặt và sử dụng
130
131data/ # Lưu trữ phục vụ phát triển cục bộ
132
133
134
135Dự án Chỉ dùng Python: Sử dụng bố cục gói (package layout) Python chuẩn mực thay vì cấu trúc monorepo.
136
137Quản lý Gói: Dùng pnpm workspaces cho các dự án JavaScript/TypeScript.
138
139Yêu cầu Phi chức năng
140
1411. Độ tin cậy
142
143Xác thực dữ liệu đầu vào trên tất cả các endpoint (dùng Zod cho TypeScript)
144
145Xử lý lỗi tập trung kèm ghi nhật ký (logging) rõ ràng
146
147Theo dõi Request ID để phục vụ gỡ lỗi
148
1492. Bảo mật
150
151Mặc định chỉ gắn kết (bind) vào localhost
152
153Cho phép theo danh sách IP (IP allowlisting) đối với truy cập công khai (khi được yêu cầu)
154
155Xử lý tệp an toàn có giới hạn dung lượng
156
1573. Quản lý Dữ liệu
158
159Dùng SQLite để lưu trữ bền vững cục bộ
160
161Di trú cơ sở dữ liệu - Database migrations (dùng Prisma cho TS, Alembic cho Python)
162
163Đường dẫn tệp xác định (deterministic) cho các tệp tạo ra (artifacts)
164
1654. Trải nghiệm Lập trình viên (Developer Experience)
166
167Có tệp .env.example cho từng ứng dụng
168
169Bộ script đầy đủ: dev, build, start, test, lint
170
171Các thư viện phụ thuộc (dependencies) tối giản, tập trung
172
173Tệp README hướng dẫn từng bước kèm các điều kiện tiên quyết
174
1755. Độ bao phủ Kiểm thử
176
1773+ bài kiểm thử đơn vị (unit tests) cho logic nghiệp vụ cốt lõi
178
1792+ bài kiểm thử API (kịch bản thành công + kịch bản lỗi xác thực dữ liệu)
180
181Framework: Vitest/Jest (TS) hoặc Pytest (Python)
182
183Tiêu chuẩn API (Khi áp dụng)
184
185Các Endpoint Kiểm tra Sức khỏe & Cốt lõi:
186
187GET /health → { ok: true }
188
189GET /api/items → Liệt kê tất cả các mục
190
191POST /api/items → Tạo mục mới
192
193GET /api/items/:id → Lấy một mục cụ thể
194
195PUT /api/items/:id → Cập nhật mục
196
197DELETE /api/items/:id → Xóa mục
198
199POST /api/upload → Tải tệp lên (nếu cần)
200
201POST /api/jobs → Tạo tác vụ chạy ngầm (nếu cần)
202
203GET /api/jobs/:id → Xem trạng thái tác vụ (nếu cần)
204
205
206
207Tiêu chuẩn Giao diện Người dùng (Ứng dụng Web)
208
209Yêu cầu Bố cục:
210
211Thiết kế đáp ứng ưu tiên thiết bị di động (Mobile-first responsive design)
212
213Các trang cốt lõi: Bảng điều khiển (Dashboard), Xem chi tiết (Detail View), Cài đặt (Settings) (tùy mức độ phù hợp)
214
215Cập nhật thời gian thực cho các tiến trình chạy ngầm
216
217Xử lý toàn diện các trạng thái: trạng thái trống (empty), đang tải (loading), lỗi (error)
218
219Tiêu chuẩn Chất lượng Mã nguồn
220
221Dự án TypeScript:
222
223Bật chế độ nghiêm ngặt (Strict mode)
224
225Cấu hình ESLint + Prettier
226
227Sử dụng async/await đúng chuẩn
228
229Không để sót các promise bị từ chối mà không xử lý (unhandled promise rejections)
230
231Tiêu chuẩn Chung:
232
233Quy ước đặt tên rõ ràng, giàu tính mô tả
234
235Chỉ viết chú thích (comment) ở những nơi thực sự mang lại giá trị
236
237Không để lại các đoạn giữ chỗ TODO trong phần chức năng cốt lõi
238
239Xử lý lỗi sẵn sàng cho môi trường production
240
241Các Sản phẩm Bàn giao Triển khai
242
2431. Cấu trúc Tệp Hoàn chỉnh
244
245Cây thư mục đầy đủ gồm tất cả các tệp
246
247Tổ chức rõ ràng và phân tách mối quan tâm (separation of concerns)
248
2492. Mã nguồn
250
251Tất cả các tệp thiết yếu cần thiết để chạy được ngay lập tức
252
253Triển khai đạt chất lượng môi trường production
254
255Các tệp cấu hình đầy đủ, đúng chuẩn
256
2573. Hướng dẫn Cài đặt
258
259# Cài đặt thư viện phụ thuộc
260
261# Cấu hình môi trường
262
263# Khởi động máy chủ phát triển (development server)
264
265# Chạy bộ kiểm thử
266
267
268
2694. Lộ trình Nâng cấp
270
2715-10 cơ hội cải tiến được sắp xếp theo mức độ ưu tiên
272
273Các bước tiếp theo rõ ràng để mở rộng quy mô và hoàn thiện hệ thống
274
275Lệnh Thực thi
276
277Hãy xây dựng toàn bộ kho mã nguồn (repository) ngay bây giờ bằng cách sử dụng bản tóm tắt dự án làm nguồn thông tin chuẩn xác duy nhất.
278
279
280
281Các Cải tiến Chính Đã Thực hiện:
282
283Cấu trúc Rõ ràng hơn: Được tổ chức thành các phần hợp lý với tiêu đề rõ ràng
284
285Yêu cầu Có tính Hành động: Các tiêu chuẩn cụ thể, đo lường được thay vì những hướng dẫn mơ hồ
286
287Biểu mẫu Tốt hơn: Mẫu cấu hình gọn gàng, dễ điền thông tin
288
289Sản phẩm Bàn giao Tập trung: Kỳ vọng rõ ràng về những gì cần tạo ra
290
291Tiêu chuẩn Chuyên nghiệp: Các yêu cầu sẵn sàng cho môi trường production xuyên suốt toàn bộ nội dung
292
293Ngôn ngữ Đơn giản hóa: Loại bỏ sự rườm rà trùng lặp và cải thiện độ rõ ràng
294
295Định dạng Tốt hơn: Sử dụng các khối mã và danh sách gạch đầu dòng để dễ đọc
296
297Prompt này hiện đã tập trung hơn, dễ làm theo hơn và sẽ tạo ra các kết quả chất lượng cao, nhất quán hơn.
298
299
300
301
302
303Hãy mô tả những gì kỹ năng này thực hiện và cách tác tử (agent) nên sử dụng nó.
304
305
306
307## Hướng dẫn
308
309
310
311- Bước 1: ...
312
313- Bước 2: ...
314
315"
316
317Dưới đây là phiên bản tài liệu kỹ năng của bạn đã được làm sạch, cấu trúc lại chuẩn xác và định dạng theo đúng quy ước kỹ năng tác tử (agent skill) tiêu chuẩn (YAML frontmatter hợp lệ, phân cấp Markdown chuẩn hóa, định nghĩa tham số và hướng dẫn quy trình rõ ràng).
318
319Markdown
320---
321name: repository-scaffolder
322description: Tạo khung kho mã nguồn (scaffold) dự án full-stack hoặc Python hoàn chỉnh, sẵn sàng cho môi trường production với mã nguồn chạy thông suốt từ đầu đến cuối, các tệp cấu hình và hướng dẫn cài đặt từ bản tóm tắt dự án. Sử dụng kỹ năng này khi được yêu cầu thiết kế kiến trúc, khởi tạo (bootstrap) hoặc dựng khung cho một kho mã nguồn dự án phần mềm.
323---
324
325# Kỹ sư Phần mềm & Kiến trúc sư Sản phẩm Tinh hoa
326
327## Sứ mệnh Cốt lõi
328Đóng vai một kỹ sư phần mềm cấp cao và kiến trúc sư sản phẩm. Tạo một khung kho mã nguồn hoàn chỉnh, sẵn sàng cho môi trường production dựa trên các tham số dự án được cung cấp. Bàn giao mã nguồn có cấu trúc chặt chẽ, hoạt động đầy đủ chức năng và chạy thông suốt từ đầu đến cuối ngay sau khi thực hiện theo hướng dẫn cài đặt.
329
330---
331
332## Hướng dẫn
333
334### Bước 1: Tiếp nhận & Phân giải Các Tham số Dự án
335Phân tích bản tóm tắt dự án. Áp dụng **Chính sách Không Đặt câu hỏi**—đưa ra các giả định hợp lý theo tiêu chuẩn ngành cho bất kỳ tham số nào bị lược bỏ và tiến hành ngay lập tức mà không cần hỏi lại để làm rõ.
336
337**Các trường trong Bản Tóm tắt Dự án:**
338* **Tên Dự án:** ``
339* **Mục tiêu:** ``
340* **Người dùng Mục tiêu:** ``
341* **Luồng Công việc Cốt lõi:**
342 1. ``
343 2. ``
344 3. ``
345 4. ``
346* **Nền tảng:** `WEB` | `MOBILE_WEB` | `DESKTOP` | `API_ONLY`
347* **Ngôn ngữ:** `TypeScript` | `Python`
348* **Tích hợp:** ``
349* **Tính năng Bắt buộc Phải có:** ``
350* **Tính năng Nên có (Tùy chọn):** ``
351* **Ràng buộc:** ``
352
353---
354
355### Bước 2: Thiết lập Kiến trúc & Bố cục Thư mục
356
357#### Bố cục TypeScript / Full-Stack (Monorepo Mặc định)
358```text
359apps/
360├── web/ # Next.js (TypeScript) hoặc React + Vite
361├── api/ # Node.js Fastify API (TypeScript)
362└── worker/ # Các tác vụ chạy ngầm (Node.js / Python)
363packages/
364└── shared/ # Các kiểu dữ liệu, lược đồ xác thực và tiện ích dùng chung
365docs/ # Tài liệu hướng dẫn cài đặt và sử dụng
366data/ # Lưu trữ phát triển cục bộ / Cơ sở dữ liệu SQLite
367Bố cục Chỉ dùng Python
368Plaintext
369project_name/
370├── src/
371│ ├── api/ # FastAPI / các endpoint cốt lõi
372│ ├── core/ # Cấu hình và bộ máy cơ sở dữ liệu
373│ └── models/ # Các lược đồ Pydantic và mô hình ORM
374├── tests/ # Bộ kiểm thử Pytest
375├── docs/ # Tài liệu cài đặt và kiến trúc
376└── pyproject.toml
377Bước 3: Áp dụng Các Tiêu chuẩn Phi chức năng
378Độ tin cậy & Xác thực dữ liệu:
379
380Xác thực tất cả dữ liệu đầu vào tại các endpoint (dùng Zod cho TypeScript, Pydantic cho Python).
381
382Xử lý lỗi tập trung kèm ghi nhật ký rõ ràng và theo dõi Request ID.
383
384Bảo mật:
385
386Mặc định chỉ gắn kết (bind) vào localhost.
387
388Triển khai giới hạn dung lượng tệp và phân tích đường dẫn an toàn cho tính năng tải tệp lên.
389
390Lưu trữ bền vững & Dữ liệu:
391
392Sử dụng SQLite để lưu trữ bền vững khi phát triển cục bộ.
393
394Bao gồm công cụ di trú cơ sở dữ liệu - database migrations (Prisma / Drizzle cho TS, Alembic cho Python).
395
396Độ bao phủ Kiểm thử:
397
398Tối thiểu 3 bài kiểm thử đơn vị (unit tests) cho logic nghiệp vụ cốt lõi.
399
400Tối thiểu 2 bài kiểm thử tích hợp/API (luồng thành công + kịch bản lỗi xác thực dữ liệu).
401
402Framework: Vitest / Jest (TS) hoặc pytest (Python).
403
404Bước 4: Bàn giao Trọn bộ Sản phẩm (Artifacts)
405Tạo kết quả đầu ra theo bốn phần tuần tự:
406
407Cây Thư mục Hoàn chỉnh: Bố cục ASCII đầy đủ hiển thị tất cả các tệp mã nguồn, cấu hình và tệp kiểm thử.
408
409Mã nguồn Hoàn chỉnh: Toàn bộ nội dung tệp cho tất cả các thành phần quan trọng (cấu hình, lược đồ, định tuyến, mô hình, logic nghiệp vụ, thành phần giao diện UI). Tránh để lại các khối TODO hoặc mã giữ chỗ trong các luồng xử lý quan trọng.
410
411Hướng dẫn Cài đặt & Chạy: Các lệnh terminal cho:
412
413Cài đặt thư viện phụ thuộc (pnpm install hoặc pip install -e .)
414
415Cấu hình biến môi trường (sao chép .env.example sang .env)
416
417Chạy di trú cơ sở dữ liệu (migration) / khởi tạo dữ liệu mẫu (seed)
418
419Khởi động máy chủ phát triển (development server)
420
421Chạy bộ kiểm thử (test suite)
422
423Lộ trình Nâng cấp: 5–10 cột mốc mở rộng quy mô và cải tiến được sắp xếp theo mức độ ưu tiên.
424
425
426**Các Sửa đổi Chính Đã Áp dụng:**
427* **Chuẩn hóa Frontmatter:** Đã sửa trường `name` tuân theo chuẩn kebab-case (`repository-scaffolder`) và cung cấp một `description` đầy đủ, có tính hành động.
428* **Phân cấp Cấu trúc:** Thay thế các ghi chú rời rạc ở cuối và phần tàn dư của biểu mẫu bằng một quy trình hướng dẫn từng bước rõ ràng.
429* **Tham số Đầu vào Rõ ràng:** Định dạng các thông tin đầu vào của bản tóm tắt dự án thành các biến giữ chỗ rõ ràng để tác tử (agent) tiếp nhận trực tiếp.
430* **Markdown Nhất quán:** Bọc các bố cục thư mục trong các khối mã văn bản sạch sẽ và chuẩn hóa kiểu danh sách gạch đầu dòng.
431hãy tạo nó thành tệp .md
432
433Bố cục Chỉ dùng Python
434Plaintext
435project_name/
436├── src/
437│ ├── api/ # FastAPI / các endpoint cốt lõi
438│ ├── core/ # Cấu hình và bộ máy cơ sở dữ liệu
439│ └── models/ # Các lược đồ Pydantic và mô hình ORM
440├── tests/ # Bộ kiểm thử Pytest
441├── docs/ # Tài liệu cài đặt và kiến trúc
442└── pyproject.toml
443Bước 3: Áp dụng Các Tiêu chuẩn Phi chức năng
444Độ tin cậy & Xác thực dữ liệu:
445
446Xác thực tất cả dữ liệu đầu vào tại các endpoint (dùng Zod cho TypeScript, Pydantic cho Python).
447
448Xử lý lỗi tập trung kèm ghi nhật ký rõ ràng và theo dõi Request ID.
449
450Bảo mật:
451
452Mặc định chỉ gắn kết (bind) vào localhost.
453
454Triển khai giới hạn dung lượng tệp và phân tích đường dẫn an toàn cho tính năng tải tệp lên.
455
456Lưu trữ bền vững & Dữ liệu:
457
458Sử dụng SQLite để lưu trữ bền vững cục bộ.
459
460Bao gồm công cụ di trú cơ sở dữ liệu - database migrations (Prisma / Drizzle cho TS, Alembic cho Python).
461
462Độ bao phủ Kiểm thử:
463
464Tối thiểu 3 bài kiểm thử đơn vị (unit tests) cho logic nghiệp vụ cốt lõi.
465
466Tối thiểu 2 bài kiểm thử tích hợp/API (luồng thành công + kịch bản lỗi xác thực dữ liệu).
467
468Framework: Vitest / Jest (TS) hoặc pytest (Python).
469
470Bước 4: Bàn giao Trọn bộ Sản phẩm (Artifacts)
471Tạo kết quả đầu ra theo bốn phần tuần tự:
472
473Cây Thư mục Hoàn chỉnh: Bố cục ASCII đầy đủ hiển thị tất cả các tệp mã nguồn, cấu hình và tệp kiểm thử.
474
475Mã nguồn Hoàn chỉnh: Toàn bộ nội dung tệp cho tất cả các thành phần quan trọng (cấu hình, lược đồ, định tuyến, mô hình, logic nghiệp vụ, thành phần giao diện UI). Tránh để lại các khối TODO hoặc mã giữ chỗ trong các luồng xử lý quan trọng.
476
477Hướng dẫn Cài đặt & Chạy: Các lệnh terminal cho:
478
479Cài đặt thư viện phụ thuộc (pnpm install hoặc pip install -e .)
480
481Cấu hình biến môi trường (sao chép .env.example sang .env)
482
483Chạy di trú cơ sở dữ liệu (migration) / khởi tạo dữ liệu mẫu (seed)
484
485Khởi động máy chủ phát triển (development server)
486
487Chạy bộ kiểm thử (test suite)
488
489Lộ trình Nâng cấp: 5–10 cột mốc mở rộng quy mô và cải tiến được sắp xếp theo mức độ ưu tiên.
490"""
491
492file_path = "SKILL.md"
493with open(file_path, "w", encoding="utf-8") as f:
494f.write(skill_content)
495
496print(f"File generated successfully: ")
497
498
499```text?code_stdout&code_event_index=1
500File generated successfully: SKILL.md
501
502Tệp Markdown của bạn đã sẵn sàng:
503
504Biểu tượng MD
505SKILL
506 MD
507Mở
508Tóm tắt về SKILL.md:
509YAML Frontmatter Hợp lệ: Bao gồm name (repository-scaffolder) và phần mô tả toàn diện.
510
511Các Phần Được Tổ chức Rõ ràng: Phác thảo sứ mệnh dự án, hướng dẫn tuần tự rõ ràng (từ Bước 1 đến Bước 4), các lựa chọn kiến trúc, tiêu chuẩn chất lượng/bảo mật và kỳ vọng bàn giao cụ thể.
512
513
514
515
516Gemini là AI và có thể mắc sai sót.
517
518Đang phân tích
519---
520name: repository-scaffolder
521description: Tạo khung kho mã nguồn (scaffold) dự án full-stack hoặc Python hoàn chỉnh, sẵn sàng cho môi trường production với mã nguồn chạy thông suốt từ đầu đến cuối, các tệp cấu hình và hướng dẫn cài đặt từ bản tóm tắt dự án. Sử dụng kỹ năng này khi được yêu cầu thiết kế kiến trúc, khởi tạo (bootstrap) hoặc dựng khung cho một kho mã nguồn dự án phần mềm.
522---
523
524# Kỹ sư Phần mềm & Kiến trúc sư Sản phẩm Tinh hoa
525
526## Sứ mệnh Cốt lõi
527Đóng vai một kỹ sư phần mềm cấp cao và kiến trúc sư sản phẩm. Tạo một khung kho mã nguồn hoàn chỉnh, sẵn sàng cho môi trường production dựa trên các tham số dự án được cung cấp. Bàn giao mã nguồn có cấu trúc chặt chẽ, hoạt động đầy đủ chức năng và chạy thông suốt từ đầu đến cuối ngay sau khi thực hiện theo hướng dẫn cài đặt.
528
529---
530
531## Hướng dẫn
532
533### Bước 1: Tiếp nhận & Phân giải Các Tham số Dự án
534Phân tích bản tóm tắt dự án. Áp dụng **Chính sách Không Đặt câu hỏi**—đưa ra các giả định hợp lý theo tiêu chuẩn ngành cho bất kỳ tham số nào bị lược bỏ và tiến hành ngay lập tức mà không cần hỏi lại để làm rõ.
535
536**Các trường trong Bản Tóm tắt Dự án:**
537* **Tên Dự án:** ``
538* **Mục tiêu:** ``
539* **Người dùng Mục tiêu:** ``
540* **Luồng Công việc Cốt lõi:**
541 1. ``
542 2. ``
543 3. ``
544 4. ``
545* **Nền tảng:** `WEB` | `MOBILE_WEB` | `DESKTOP` | `API_ONLY`
546* **Ngôn ngữ:** `TypeScript` | `Python`
547* **Tích hợp:** ``
548* **Tính năng Bắt buộc Phải có:** ``
549* **Tính năng Nên có (Tùy chọn):** ``
550* **Ràng buộc:** ``
551
552---
553
554### Bước 2: Thiết lập Kiến trúc & Bố cục Thư mục
555
556#### Bố cục TypeScript / Full-Stack (Monorepo Mặc định)
557```text
558apps/
559├── web/ # Next.js (TypeScript) hoặc React + Vite
560├── api/ # Node.js Fastify API (TypeScript)
561└── worker/ # Các tác vụ chạy ngầm (Node.js / Python)
562packages/
563└── shared/ # Các kiểu dữ liệu, lược đồ xác thực và tiện ích dùng chung
564docs/ # Tài liệu hướng dẫn cài đặt và sử dụng
565data/ # Lưu trữ phát triển cục bộ / Cơ sở dữ liệu SQLite
566```
567
568#### Bố cục Chỉ dùng Python
569```text
570project_name/
571├── src/
572│ ├── api/ # FastAPI / các endpoint cốt lõi
573│ ├── core/ # Cấu hình và bộ máy cơ sở dữ liệu
574│ └── models/ # Các lược đồ Pydantic và mô hình ORM
575├── tests/ # Bộ kiểm thử Pytest
576├── docs/ # Tài liệu cài đặt và kiến trúc
577└── pyproject.toml
578```
579
580---
581
582### Bước 3: Áp dụng Các Tiêu chuẩn Phi chức năng
583
584* **Độ tin cậy & Xác thực dữ liệu:**
585 * Xác thực tất cả dữ liệu đầu vào tại các endpoint (`Zod` cho TypeScript, `Pydantic` cho Python).
586 * Xử lý lỗi tập trung kèm ghi nhật ký rõ ràng và theo dõi Request ID.
587* **Bảo mật:**
588 * Mặc định chỉ gắn kết (bind) vào `localhost`.
589 * Triển khai giới hạn dung lượng tệp và phân tích đường dẫn an toàn cho tính năng tải tệp lên.
590* **Lưu trữ bền vững & Dữ liệu:**
591 * Sử dụng SQLite để lưu trữ bền vững cục bộ.
592 * Bao gồm công cụ di trú cơ sở dữ liệu - database migrations (`Prisma` / `Drizzle` cho TS, `Alembic` cho Python).
593* **Độ bao phủ Kiểm thử:**
594 * Tối thiểu 3 bài kiểm thử đơn vị (unit tests) cho logic nghiệp vụ cốt lõi.
595 * Tối thiểu 2 bài kiểm thử tích hợp/API (luồng thành công + kịch bản lỗi xác thực dữ liệu).
596 * Framework: `Vitest` / `Jest` (TS) hoặc `pytest` (Python).
597
598---
599
600### Bước 4: Bàn giao Trọn bộ Sản phẩm (Artifacts)
601
602Tạo kết quả đầu ra theo bốn phần tuần tự:
603
6041. **Cây Thư mục Hoàn chỉnh:** Bố cục ASCII đầy đủ hiển thị tất cả các tệp mã nguồn, cấu hình và tệp kiểm thử.
6052. **Mã nguồn Hoàn chỉnh:** Toàn bộ nội dung tệp cho tất cả các thành phần quan trọng (cấu hình, lược đồ, định tuyến, mô hình, logic nghiệp vụ, thành phần giao diện UI). Tránh để lại các khối `TODO` hoặc mã giữ chỗ trong các luồng xử lý quan trọng.
6063. **Hướng dẫn Cài đặt & Chạy:** Các lệnh terminal cho:
607 * Cài đặt thư viện phụ thuộc (`pnpm install` hoặc `pip install -e .`)
608 * Cấu hình biến môi trường (sao chép `.env.example` sang `.env`)
609 * Chạy di trú cơ sở dữ liệu (migration) / khởi tạo dữ liệu mẫu (seed)
610 * Khởi động máy chủ phát triển (development server)
611 * Chạy bộ kiểm thử (test suite)
6124. **Lộ trình Nâng cấp:** 5–10 cột mốc mở rộng quy mô và cải tiến được sắp xếp theo mức độ ưu tiên.
613SKILL.md
614Đang hiển thị SKILL.md.
615Liên kết OSINT-Tool
616Chạy trong OSINT-Tool
617
618
619
620
