Thực thi

Trước khi bắt đầu

• Cần biết: nội dung tasks.md và cách đọc marker [P]
• Cần có: tasks.md đã qua bước kiểm tra nhất quán, checklist chất lượng đã được duyệt
• Cần đang ở: thư mục gốc của dự án, sau /speckit-analyze

1. Lệnh này làm gì

/speckit-implement đọc tasks.md và thực thi từng task theo thứ tự phụ thuộc. Nó chạy lần lượt các giai đoạn Setup, Foundational, từng user story, rồi Polish.

Các task có marker [P] được xử lý song song khi có thể. Task không có marker đó chạy tuần tự.

2. Checklist là cổng vào

Trước khi thực thi, lệnh đọc trạng thái ô đánh dấu của checklist làm cổng. Nó đếm số mục đã đánh dấu và số mục chưa đánh dấu.

Nếu còn mục chưa đánh dấu, lệnh hỏi bạn trước khi tiếp tục. Bạn quyết định đi tiếp hay dừng lại để duyệt nốt.

Điểm quan trọng: /speckit-implement KHÔNG tự sửa tệp checklist. Marker là tài sản của người duyệt, không phải của công cụ. Với checklist tùy chỉnh, mục đã đánh dấu nghĩa là người duyệt đã xác nhận chất lượng yêu cầu, không phải việc cài đặt đã xong.

3. Chạy toàn bộ cho tính năng nhỏ

Với tính năng nhỏ, chạy một lần để dựng hết:

/speckit-implement

Kết quả mong đợi: công cụ lần lượt thực thi các task trong tasks.md và tạo ra mã nguồn tương ứng.

4. Chia theo giai đoạn cho tính năng lớn

Với tính năng lớn, chạy từng phần để không làm quá tải ngữ cảnh của công cụ AI. Giới hạn phạm vi bằng đối số, kiểm tra kết quả, rồi đi tiếp:

/speckit-implement Chỉ cài đặt giai đoạn Setup và Foundational: dựng khung dự án và mô hình dữ liệu project/task với CRUD cơ bản. Dừng trước phần user story.

Kết quả mong đợi: công cụ chỉ thực thi các task thuộc hai giai đoạn đầu và dừng lại đúng chỗ bạn yêu cầu.

Sau khi xác nhận phần đầu chạy được, tiếp tục với giai đoạn kế tiếp:

/speckit-implement Giờ cài đặt user story bảng Kanban: kéo thả giữa các cột.

Kết quả mong đợi: công cụ thực thi các task thuộc user story đó và dừng trước giai đoạn sau.

5. Kiểm tra sau mỗi giai đoạn

Trước khi chạy giai đoạn tiếp theo, hãy xác nhận phần vừa làm chạy được. Một lỗi ở giai đoạn nền sẽ lan sang mọi giai đoạn sau và khó tìm hơn nhiều.

Kết quả

Sau khi hoàn thành trang này, bạn đã:

• Thực thi được các task trong tasks.md thành mã nguồn
• Biết cách chia nhỏ lần chạy theo giai đoạn cho tính năng lớn

Cách tự xác nhận: các tệp mã nguồn tương ứng với task đã có trong dự án, và bạn tự chạy được phần vừa cài đặt.

Lỗi thường gặp

Lỗi	Nguyên nhân	Cách khắc phục
Lệnh dừng và hỏi về checklist chưa đánh dấu	Còn mục chưa được người duyệt xác nhận	Duyệt nốt checklist, hoặc xác nhận đi tiếp nếu bạn chấp nhận rủi ro
Công cụ không tự đánh dấu [x] hộ bạn	Đúng thiết kế: marker thuộc người duyệt	Tự rà và đánh dấu ở tệp checklist, không chờ công cụ làm thay
Lần chạy quá dài, công cụ bỏ sót task	Chạy toàn bộ tính năng lớn trong một lần	Chia theo giai đoạn bằng đối số và kiểm tra sau mỗi lần
Task [P] bị chạy sai thứ tự	Phụ thuộc giữa các task chưa đúng	Sửa tasks.md rồi chạy lại /speckit-analyze trước khi thực thi tiếp

---

Nguồn tham chiếu: Spec-Driven Development QuickstartPhiên bản kiểm chứng: Spec Kit 1.1.3