Kiểm tra nhất quán

Trước khi bắt đầu

• Cần biết: nội dung ba hiện vật spec.md, plan.md, tasks.md
• Cần có: tasks.md đã được sinh ở bước chia nhỏ công việc
• Cần đang ở: thư mục gốc của dự án, sau /speckit-tasks và TRƯỚC /speckit-implement

1. Lệnh này chỉ đọc

/speckit-analyze rà tính nhất quán và chất lượng giữa ba hiện vật (artifact) của tính năng. Nó chỉ đọc: không sửa spec.md, không sửa plan.md, không sửa tasks.md.

Kết quả của nó là một báo cáo. Bạn là người quyết định sửa gì và sửa ở đâu. Đây là điểm khác biệt quan trọng so với mọi lệnh khác trong quy trình.

2. Chạy lệnh trước khi thực thi

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

/speckit-analyze

Kết quả mong đợi: công cụ in ra báo cáo liệt kê các vấn đề tìm thấy giữa spec.md, plan.md và tasks.md, và không thay đổi tệp nào.

3. Ba loại vấn đề nó tìm

• Mâu thuẫn: một lựa chọn trong plan.md đi ngược lại điều spec.md yêu cầu.
• Lỗ hổng: có task trong tasks.md không ứng với yêu cầu nào, hoặc có yêu cầu không có task nào phủ.
• Chỗ mơ hồ: yêu cầu phát biểu chưa đủ rõ để kiểm chứng.

Ví dụ: một task không khớp yêu cầu nào, hoặc một quyết định trong kế hoạch (plan) trái với đặc tả (specification).

4. Sửa ở nguồn, không sửa ở báo cáo

Khi báo cáo chỉ ra vấn đề, hãy sửa ở đúng bước sở hữu vấn đề đó:

Loại vấn đề	Quay lại bước
Yêu cầu thiếu hoặc mơ hồ	/speckit-specify hoặc /speckit-clarify
Quyết định thiết kế sai	/speckit-plan
Danh sách task lệch thiết kế	/speckit-tasks

Sau khi sửa, chạy lại /speckit-analyze cho tới khi báo cáo sạch.

5. Vì sao phải sửa trước khi code

Sửa một dòng trong spec.md rẻ hơn nhiều so với sửa mã nguồn đã viết theo đặc tả sai. Bước này tồn tại để bạn trả cái giá nhỏ đó, thay vì trả giá lớn ở bước thực thi.

6. Chạy lại sau khi thực thi như một lượt rà thêm

Bạn có thể chạy /speckit-analyze một lần nữa sau khi đã cài đặt xong, như một lượt rà bổ sung. Lệnh vẫn chỉ đọc, nên nó không ảnh hưởng tới mã nguồn bạn đã viết.

Kết quả

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

• Có báo cáo nhất quán giữa spec.md, plan.md và tasks.md
• Biết quay lại bước nào để sửa từng loại vấn đề

Cách tự xác nhận: bạn có báo cáo của /speckit-analyze, và xác nhận rằng không tệp nào trong specs/NNN-*/ bị lệnh này sửa.

Lỗi thường gặp

Lỗi	Nguyên nhân	Cách khắc phục
Báo cáo trống hoặc lệnh không chạy	Chưa có đủ ba hiện vật	Kiểm tra spec.md, plan.md, tasks.md đều tồn tại
Mong đợi lệnh tự sửa tệp giúp mình	Hiểu sai tính chất chỉ đọc	Đọc báo cáo rồi tự sửa ở bước nguồn tương ứng
Sửa tasks.md bằng tay cho khớp báo cáo	Bỏ qua bước nguồn	Sửa spec.md hoặc plan.md trước, rồi chạy lại /speckit-tasks
Báo cáo vẫn còn vấn đề sau nhiều lần chạy	Sửa chưa đúng tầng sở hữu vấn đề	Xác định lại vấn đề thuộc yêu cầu, thiết kế hay danh sách task

---

Nguồn tham chiếu: Agentic SDDPhiên bản kiểm chứng: Spec Kit 1.1.3