Giao diện
Tra cứu
Trước khi bắt đầu
- Cần biết: quy trình phát triển hướng đặc tả (Spec-Driven Development, SDD) và các pha chính ở mức tổng quan
- Cần có: một dự án Spec Kit đã khởi tạo, để đối chiếu tên tệp và thư mục khi cần
- Cần đang ở: bất kỳ đâu — đây là tài liệu tra cứu, không phải trình tự thao tác
1. Nhóm này dành cho ai
Nhóm Tra cứu dành cho người đã biết quy trình và chỉ cần tra một chi tiết cụ thể:
- Tên lệnh này viết thế nào, chạy trước hay sau lệnh kia.
- Lệnh đó tạo ra tệp gì, bắt buộc hay tùy chọn.
- Lệnh CLI có tùy chọn nào, cài ở đâu.
- Một thuật ngữ trong tài liệu gốc ứng với từ tiếng Việt nào.
Bạn không cần đọc tuần tự. Mở đúng trang chứa thông tin, tra bảng, đóng lại.
2. Khác gì so với phần học tuần tự
Năm nhóm còn lại của website dạy theo trình tự: giải thích khái niệm, rồi dẫn bạn làm từng bước và tự kiểm chứng kết quả. Nhóm Tra cứu làm ngược lại — nó giả định bạn đã hiểu và chỉ cần dữ liệu.
| Nhóm học tuần tự | Nhóm Tra cứu | |
|---|---|---|
| Đối tượng | Người mới, chưa làm quen Spec Kit | Người đã thành thạo quy trình |
| Cách đọc | Đọc từ đầu đến cuối, theo thứ tự | Nhảy thẳng tới mục cần tra |
| Nội dung | Giải thích, ví dụ, kiểm chứng từng bước | Bảng, danh sách, định nghĩa một dòng |
| Kết quả | Làm xong một việc hoàn chỉnh | Có ngay câu trả lời để quyết định bước tiếp theo |
Nếu bạn đang tìm hiểu từ đầu, hãy bắt đầu ở nhóm Bắt đầu thay vì nhóm này.
3. Nên dùng thế nào
- Xác định bạn đang cần tra loại thông tin nào: lệnh quy trình, lệnh CLI, hay thuật ngữ.
- Mở trang tương ứng ở mục 5 và tra bảng chính. Bảng được thiết kế để tra trong một lần nhìn.
- Đối chiếu cột đầu ra với tệp thật trong dự án của bạn để chắc chắn lệnh đã chạy đúng.
- Khi cần hiểu sâu một bước, quay lại nhóm Xây dựng để đọc phần giải thích đầy đủ.
Nhóm này ghi lại phiên bản Spec Kit đã kiểm chứng ở cuối mỗi trang. Nếu CLI của bạn khác phiên bản đó, hãy đối chiếu với tài liệu gốc được liên kết cùng chỗ.
4. Tra theo câu hỏi
Bảng dưới ánh xạ câu hỏi thường gặp sang đúng trang cần mở.
| Câu hỏi | Mở trang |
|---|---|
| Lệnh nào chạy trước lệnh nào? | Lệnh quy trình Spec Kit |
| Lệnh này bắt buộc hay tùy chọn? | Lệnh quy trình Spec Kit |
| Lệnh này tạo ra tệp gì? | Lệnh quy trình Spec Kit |
| Công cụ AI của tôi viết lệnh thế nào? | Lệnh quy trình Spec Kit |
| Cài thêm tiện ích mở rộng bằng lệnh gì? | Lệnh CLI specify |
Tùy chọn của specify init là gì? | Lệnh CLI specify |
| Kiểm tra CLI có bản mới không? | Lệnh CLI specify |
| "Preset" dịch là gì? | Thuật ngữ |
5. Ba trang trong nhóm
- Lệnh quy trình Spec Kit — bảng chín lệnh
/speckit-*theo thứ tự chạy, đầu ra, và cách viết lệnh theo từng công cụ AI. - Lệnh CLI
specify— bảng lệnhspecifychạy ở terminal kèm tùy chọn thường dùng. - Thuật ngữ — bảng đối chiếu thuật ngữ tiếng Việt với bản gốc tiếng Anh.
Kết quả
Sau khi đọc trang này, bạn đã:
- Biết nhóm Tra cứu dành cho ai và khác gì so với phần học tuần tự
- Biết ba trang con của nhóm và mỗi trang dùng để tra việc gì
Cách tự xác nhận: nêu được tên trang bạn sẽ mở khi cần tra thứ tự chạy của một lệnh, và tên trang bạn sẽ mở khi cần tra một tùy chọn của specify init.
Nguồn tham chiếu: Spec Kit Reference — Overview, Core Commands, Agentic SDDPhiên bản kiểm chứng: Spec Kit 1.1.3