Giao diện
Xây dựng tính năng theo quy trình chuẩn
Trước khi bắt đầu
- Cần biết: Spec Kit là gì và bạn đã từng gọi một lệnh
/speckit-*trong khung chat của công cụ AI - Cần có: Spec Kit 1.1.3 đã cài, một dự án đã chạy
specify init, công cụ AI lập trình đã mở trong thư mục dự án - Cần đang ở: thư mục gốc của dự án đã khởi tạo Spec Kit
1. Nhóm này dành cho ai
Nhóm Xây dựng dành cho người đang làm một tính năng hoặc một ứng dụng mới theo quy trình chuẩn. Bạn đã biết Spec Kit là gì, đã cài đặt và khởi tạo dự án, và giờ muốn đi trọn một vòng: từ nguyên tắc dự án tới mã nguồn chạy được.
Nếu bạn chưa từng cài Spec Kit, hãy đi qua nhóm Bắt đầu trước. Nhóm đó đưa bạn từ con số không tới bản đặc tả (specification) đầu tiên.
2. Bạn sẽ đi qua chín bước
Một vòng xây dựng đầy đủ gồm chín lệnh, chạy theo đúng thứ tự sau:
text
/speckit-constitution -> /speckit-specify -> /speckit-clarify -> /speckit-plan -> /speckit-checklist -> /speckit-tasks -> /speckit-analyze -> /speckit-implement -> /speckit-convergeKết quả mong đợi: bạn thấy chuỗi chín lệnh và biết mình cần chạy lệnh nào trước lệnh nào.
Trong đó /speckit-clarify, /speckit-checklist và /speckit-analyze là cổng chất lượng tùy chọn. Bạn có thể bỏ qua chúng khi tính năng đã rõ ràng, và thêm vào khi có điểm mơ hồ đáng kể.
3. Đọc theo thứ tự nào
Mười trang còn lại của nhóm được xếp theo đúng thứ tự thực hiện. Đọc từ trên xuống dưới trong lần đầu, sau đó quay lại trang bạn cần khi làm việc thật.
| # | Trang | Bạn làm được gì sau trang đó |
|---|---|---|
| 1 | Quy trình tổng quan | Nắm chín bước, biết khi nào dùng lối tắt năm bước |
| 2 | Hiến chương dự án | Tạo .specify/memory/constitution.md một lần cho cả dự án |
| 3 | Tạo đặc tả | Biến mô tả tính năng thành spec.md có cấu trúc |
| 4 | Làm rõ điểm mơ hồ | Ghi câu trả lời cho các chỗ chưa rõ ngược vào spec.md |
| 5 | Lập kế hoạch | Chốt công nghệ và kiến trúc thành plan.md cùng các hiện vật kèm theo |
| 6 | Checklist chất lượng | Kiểm tra chất lượng của chính các yêu cầu trước khi chia việc |
| 7 | Chia nhỏ công việc | Sinh tasks.md có thứ tự phụ thuộc và marker chạy song song |
| 8 | Kiểm tra nhất quán | Đọc báo cáo mâu thuẫn, lỗ hổng, chỗ mơ hồ giữa ba hiện vật |
| 9 | Thực thi | Chạy task theo thứ tự để sinh ra mã nguồn |
| 10 | Hội tụ | Đối chiếu mã nguồn với đặc tả và bù nốt phần còn thiếu |
4. Kết quả đạt được sau cả nhóm
Đi hết nhóm này, bạn có một chuỗi hiện vật (artifact) liên kết với nhau: hiến chương (constitution) làm chuẩn đối chiếu, đặc tả nói bạn xây cái gì, kế hoạch (plan) nói xây bằng gì, tasks.md nói chia việc ra sao, và mã nguồn đã hội tụ với tất cả các tầng trên.
Mỗi trang trong nhóm đều có khối "Kết quả" riêng để bạn tự đối chiếu trước khi đi tiếp. Nếu một trang chưa đạt kết quả, đừng đi tiếp — lỗi ở bước trước thường chỉ lộ ra ở bước sau.
5. Hai nơi bạn sẽ làm việc
Việc cài đặt, khởi tạo và mở tệp làm ở terminal. Việc viết đặc tả, lập kế hoạch, chia việc và thực thi làm trong khung chat của công cụ AI. Mỗi trang trong nhóm ghi rõ bạn đang gõ lệnh ở đâu, nên bạn không phải đoán.
Kết quả
Sau khi hoàn thành trang này, bạn đã:
- Biết nhóm Xây dựng dành cho ai và gồm những trang nào
- Biết thứ tự đọc và thứ tự chạy chín lệnh quy trình
Cách tự xác nhận: bạn kể được tên lệnh đầu tiên và lệnh cuối cùng của một vòng xây dựng đầy đủ mà không cần mở lại trang.
Nguồn tham chiếu: Spec-Driven Development Quickstart và Agentic SDDPhiên bản kiểm chứng: Spec Kit 1.1.3