Chia nhỏ công việc

Trước khi bắt đầu

• Cần biết: nội dung spec.md, plan.md và các hiện vật thiết kế đi kèm
• Cần có: đặc tả (specification) và kế hoạch (plan) đã hoàn thành cho tính năng
• Cần đang ở: thư mục gốc của dự án, sau /speckit-plan và trước /speckit-analyze

1. Sinh danh sách công việc

/speckit-tasks đọc các hiện vật thiết kế và phân rã chúng thành danh sách việc làm được. Kết quả là tệp tasks.md có thứ tự phụ thuộc rõ ràng, để bước thực thi chỉ cần đi từ trên xuống.

Gõ trong khung chat của công cụ AI:

/speckit-tasks

Kết quả mong đợi: công cụ tạo tệp specs/NNN-*/tasks.md với các task được đánh mã và xếp theo giai đoạn.

2. Xem tệp tasks.md vừa sinh

ls specs/001-*/tasks.md

Kết quả mong đợi: đường dẫn tới tệp tasks.md hiện ra, nằm cùng thư mục với spec.md và plan.md.

3. Task được nhóm theo giai đoạn và user story

tasks.md tổ chức công việc theo thứ tự sau:

• Setup: dựng khung dự án, cấu hình ban đầu.
• Foundational: các việc nền, phải xong trước khi làm bất kỳ tính năng nào.
• Mỗi user story một giai đoạn: xếp theo mức ưu tiên, để bạn giao được từng phần hoàn chỉnh.
• Polish: các việc hoàn thiện chạy ngang nhiều phần.

Kiểm thử được sinh ngay trong giai đoạn của user story liên quan, không tách thành giai đoạn riêng.

4. Đọc định dạng một dòng task

Mỗi dòng task theo khuôn [ID] [P?] [Story] Mô tả:

[T012] [P] [US1] Tạo lược đồ bảng albums trong SQLite

Kết quả mong đợi: bạn đọc được mã task, biết task này chạy song song được hay không, và biết nó thuộc user story nào.

Cách đọc từng phần:

• [T012] là mã định danh task, dùng để tham chiếu khi thực thi và khi hội tụ.
• [P] là marker cho biết task chạy song song được với task khác cùng giai đoạn. Task không có [P] phải chạy tuần tự.
• [US1] là user story mà task phục vụ, ví dụ user story số 1.

5. Chạy lại khi hiện vật thay đổi

Nếu bạn sửa spec.md hoặc plan.md sau khi đã có tasks.md, hãy chạy lại /speckit-tasks để danh sách việc khớp lại với thiết kế. Danh sách cũ không tự cập nhật.

Kết quả

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

• Sinh được tasks.md có thứ tự phụ thuộc và nhóm theo user story
• Đọc được định dạng [ID] [P?] [Story] Mô tả và biết marker [P] nghĩa là gì

Cách tự xác nhận: mở tasks.md, thấy các giai đoạn Setup, Foundational và ít nhất một giai đoạn theo user story, cùng các mã task tăng dần.

Lỗi thường gặp

Lỗi	Nguyên nhân	Cách khắc phục
Không có tasks.md nào được tạo	Chưa có plan.md	Hoàn thành /speckit-plan rồi gọi lại lệnh
Task không có mã [T...]	Tệp bị sửa tay hoặc sinh lỗi	Chạy lại /speckit-tasks để sinh lại danh sách
Task [P] lại phụ thuộc task khác	Thứ tự phụ thuộc bị hiểu sai	Sửa thứ tự trong tasks.md, hoặc chạy lại /speckit-tasks
Danh sách việc không khớp đặc tả mới	Đặc tả đổi sau khi sinh task	Chạy lại /speckit-tasks, rồi chạy /speckit-analyze để rà lại

---

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