Giao diện
Bắt đầu
Trước khi bắt đầu
- Cần biết: cách mở terminal (cửa sổ dòng lệnh) trên máy của bạn
- Cần có: một máy tính chạy Windows, macOS hoặc Linux, và một công cụ AI lập trình
- Cần đang ở: bất kỳ thư mục nào; bạn chưa cần tạo dự án trước khi đọc trang này
1. Nhóm này dành cho ai
Nhóm Bắt đầu dành cho người chưa từng dùng Spec Kit. Bạn không cần biết trước khái niệm nào. Bạn chỉ cần biết mở terminal và đã từng hỏi một công cụ AI lập trình vài câu.
Nếu bạn đã cài Spec Kit và đang cần một việc cụ thể — sửa lỗi, đánh giá một ý tưởng, áp dụng vào dự án đang chạy — bạn không cần nhóm này. Hãy vào thẳng nhóm nghiệp vụ tương ứng.
2. Nhóm này giải quyết việc gì
Rào cản lớn nhất của người mới không phải là kỹ thuật, mà là không biết bắt đầu từ đâu. Tài liệu gốc của Spec Kit viết cho người đã quen công cụ, nên người mới thường mắc ở ba chỗ:
- Không rõ Spec Kit là gì, nhầm nó với một ứng dụng phải tải về và mở lên.
- Không rõ việc nào làm ở terminal, việc nào gõ trong khung chat của công cụ AI.
- Không biết kết quả đúng trông ra sao, nên không tự kiểm tra được mình làm đúng hay sai.
Nhóm Bắt đầu trả lời dứt điểm ba chỗ đó, theo đúng thứ tự bạn cần.
3. Nên đọc theo thứ tự nào
Đọc từ trên xuống dưới, đúng bốn trang sau. Mỗi trang chỉ dùng những gì trang trước đã dựng xong.
| Thứ tự | Trang | Vì sao đọc trang này |
|---|---|---|
| 1 | Spec Kit là gì? | Biết Spec Kit là bộ quy trình cho công cụ AI, không phải ứng dụng độc lập. Đọc trang này trước để bạn không đi tìm một phần mềm để mở. |
| 2 | Cài đặt | Cài uv, cài specify-cli, kiểm tra bằng specify version, rồi khởi tạo dự án với specify init. Đây là trang duy nhất bạn làm việc hoàn toàn ở terminal. |
| 3 | Dự án đầu tiên | Mở công cụ AI trong thư mục dự án và tạo ra bản đặc tả đầu tiên. Đây là trang biến mọi thứ đã cài thành kết quả nhìn thấy được. |
| 4 | Hiểu về SDD | Hiểu vì sao quy trình có thứ tự, mỗi bước tạo ra tệp gì, và khi nào dùng lối tắt. Đọc cuối để bạn hiểu cái mình vừa làm, thay vì chỉ làm theo. |
Nếu bạn chỉ có thời gian cho một việc, hãy đọc trang 1 rồi làm trọn trang 2 và trang 3. Hai trang đó đã đủ để bạn có bản đặc tả đầu tiên.
4. Bạn cần chuẩn bị gì cho cả nhóm
Bạn không cần chuẩn bị gì để đọc trang 1. Ba trang còn lại cần những thứ sau, và bạn chỉ cần chuẩn bị khi tới đúng trang đó.
| Trang | Bạn cần có trước khi làm theo |
|---|---|
| Spec Kit là gì? | Không cần gì. Đây là trang đọc hiểu, không có lệnh nào phải chạy. |
| Cài đặt | Terminal, Python 3.11 trở lên, và quyền cài phần mềm trong thư mục người dùng của bạn. |
| Dự án đầu tiên | Một dự án đã chạy specify init xong, và một công cụ AI lập trình đã cài. |
| Hiểu về SDD | Một dự án đã khởi tạo, để bạn mở các tệp ra đối chiếu trong lúc đọc. |
Nếu bạn làm việc trên máy do tổ chức quản lý và không có quyền cài phần mềm, hãy đọc bảng lỗi thường gặp ở trang Cài đặt trước. Trang đó nêu cách cài trong thư mục người dùng mà không cần quyền quản trị.
5. Hai nơi làm việc, đừng nhầm
Đây là chỗ người mới hay mắc nhất, nên nhắc lại một lần nữa trước khi bạn đi tiếp:
- Terminal là nơi bạn cài
uv, càispecify-cli, và chạyspecify init. Lệnh ở đây bắt đầu bằng chữspecify. - Khung chat của công cụ AI là nơi bạn gõ các lệnh quy trình. Lệnh ở đây bắt đầu bằng dấu gạch chéo, dạng
/speckit-specify.
Nếu bạn gõ /speckit-specify trong terminal, terminal sẽ báo không tìm thấy lệnh. Nếu bạn gõ specify init trong khung chat, công cụ AI sẽ coi đó là câu văn bình thường. Mỗi trang trong nhóm này đều ghi rõ bạn đang làm ở đâu.
6. Sau khi đọc hết nhóm, bạn có gì
Sau bốn trang, bạn sẽ nắm trong tay:
- Cách phân biệt việc làm ở terminal và việc gõ trong khung chat của công cụ AI.
- Một bản cài Spec Kit đã kiểm tra xong, gồm lệnh
specifyvà các skill trong.dsh/skills/. - Một dự án đã khởi tạo, có thư mục
.specify/vàspecs/. - Một bản đặc tả (specification) thật trong
specs/001-*/spec.md. - Bức tranh toàn cảnh chu trình chín bước và lối tắt năm bước.
Kết quả
Sau khi hoàn thành trang này, bạn đã:
- Biết nhóm Bắt đầu dành cho ai và không dành cho ai
- Biết bốn trang cần đọc và lý do đọc từng trang
- Biết mình sẽ có gì sau khi đọc hết nhóm
Cách tự xác nhận: mở lần lượt bốn liên kết ở mục 3 và kiểm tra mỗi trang mở đúng nội dung mà bảng mô tả. Trang kế tiếp bạn nên mở là Spec Kit là gì?.
Nguồn tham chiếu: GitHub Spec KitPhiên bản kiểm chứng: Spec Kit 1.1.3