Lệnh quy trình Spec Kit

Trước khi bắt đầu

• Cần biết: quy trình phát triển hướng đặc tả (Spec-Driven Development, SDD) và vai trò của đặc tả, kế hoạch, phân rã công việc
• Cần có: một dự án đã chạy specify init với tích hợp công cụ AI bạn dùng
• Cần đang ở: thư mục gốc của dự án, đã mở công cụ AI tại đó

1. Bảng tra cứu chín lệnh quy trình

Chín lệnh dưới đây chạy theo đúng thứ tự từ trên xuống. Cột "Bắt buộc?" cho biết lệnh nào có thể bỏ qua.

Thứ tự	Lệnh	Làm gì	Tạo ra	Bắt buộc?
1	/speckit-constitution	Thiết lập nguyên tắc dự án	.specify/memory/constitution.md	Bắt buộc, một lần mỗi dự án
2	/speckit-specify	Tạo đặc tả (specification) từ mô tả	specs/NNN-*/spec.md	Bắt buộc
3	/speckit-clarify	Làm rõ chỗ mơ hồ trong đặc tả	Cập nhật spec.md	Tùy chọn (cổng chất lượng)
4	/speckit-plan	Lập kế hoạch kỹ thuật	plan.md, research.md, data-model.md, contracts/, quickstart.md	Bắt buộc
5	/speckit-checklist	Sinh checklist chất lượng	specs/NNN-*/checklists/*.md	Tùy chọn (cổng chất lượng)
6	/speckit-tasks	Chia nhỏ công việc	tasks.md	Bắt buộc
7	/speckit-analyze	Kiểm tra nhất quán giữa các hiện vật	Báo cáo, chỉ đọc	Tùy chọn (cổng chất lượng)
8	/speckit-implement	Thực thi	Mã nguồn	Bắt buộc
9	/speckit-converge	Đối chiếu và bổ sung	Cập nhật tasks.md	Bắt buộc

Ba lệnh /speckit-clarify, /speckit-checklist, /speckit-analyze là cổng chất lượng (quality gate): bạn thêm chúng khi đặc tả còn mơ hồ hoặc khi cần kiểm tra trước lúc viết mã. Riêng /speckit-analyze chỉ đọc — nó không sửa tệp nào.

/speckit-implement đọc trạng thái checkbox của checklist làm cổng trước khi chạy task, nhưng không tự sửa các marker đó.

2. Cách viết lệnh theo từng công cụ AI

Các lệnh này gõ TRONG KHUNG CHAT của công cụ AI, không phải trong terminal. Tên lệnh giống nhau, chỉ khác cách viết tùy công cụ và tùy chế độ cài đặt.

Công cụ	Cách viết
DeepSeek Harness (DSH)	/speckit-specify — skill cài vào .dsh/skills/
GitHub Copilot (chế độ skills mặc định)	/speckit-specify
Cách viết trong tài liệu tham chiếu chính thức	/speckit.specify
Codex, Command Code, ZCode	$speckit-specify
Kimi	/skill:speckit-specify

Ví dụ với DSH, gõ trong khung chat:

/speckit-specify Tạo trang đăng nhập cho người dùng nội bộ

Kết quả mong đợi: công cụ tạo thư mục specs/NNN-*/ chứa tệp spec.md.

Nếu công cụ của bạn không nhận dạng lệnh, hãy đối chiếu với bảng trên rồi thử cách viết khác. Các lệnh terminal như specify init hay specify check vẫn gõ ở terminal — xem bảng ở trang Lệnh CLI specify.

3. Hai lối đi

Bạn chọn giữa chuỗi rút gọn và đường đầy đủ tùy mức độ mơ hồ của tính năng.

Tiêu chí	Lối tắt 5 bước	Đường đầy đủ 9 bước
Chuỗi lệnh	/speckit-constitution → /speckit-specify → /speckit-plan → /speckit-tasks → /speckit-implement → /speckit-converge	Cả chín lệnh, theo đúng thứ tự ở mục 1
Ba cổng chất lượng	Bỏ qua /speckit-clarify, /speckit-checklist, /speckit-analyze	Chạy đủ ba cổng
Dùng khi	Tính năng nhỏ, yêu cầu đã rõ, một người làm	Yêu cầu còn mơ hồ, nhiều bên liên quan, cần kiểm tra chéo
Rủi ro	Sai sót ở đặc tả chỉ lộ ra khi đã viết mã	Tốn thêm thời gian ở giai đoạn đầu

Dù chọn lối nào, /speckit-converge luôn là bước cuối: nó đối chiếu mã nguồn với đặc tả, kế hoạch và danh sách task, rồi bổ sung task còn thiếu vào tasks.md. Chạy nó sau khi /speckit-implement đã chạy trên tasks.md hiện tại.

4. Ghi chú về /speckit-taskstoissues

Lệnh /speckit-taskstoissues chuyển tasks.md thành các GitHub issue. Lệnh này không nằm trong chín lệnh bắt buộc và không cần cho việc thực thi hay hội tụ.

GitHub đang chuyển việc theo dõi issue ra khỏi phần lõi, vào tiện ích mở rộng (extension) github dưới dạng /speckit.github.taskstoissues. /speckit-taskstoissues hiện vẫn chạy và chưa đổi. Cài bản thay thế bằng:

specify extension add github

Kết quả mong đợi: tiện ích github được cài và lệnh /speckit.github.taskstoissues xuất hiện trong công cụ AI.

Kết quả

Sau khi đọc trang này, bạn đã:

• Tra được tên, thứ tự chạy, đầu ra và mức bắt buộc của cả chín lệnh quy trình
• Biết cách viết lệnh cho công cụ AI mình đang dùng
• Chọn được giữa lối tắt 5 bước và đường đầy đủ 9 bước

Cách tự xác nhận: trả lời được câu "lệnh nào làm rõ điểm mơ hồ, và nó chạy trước hay sau bước lập kế hoạch" chỉ bằng bảng ở mục 1.

Lỗi thường gặp

Lỗi	Nguyên nhân	Cách khắc phục
command not found: /speckit-specify	Gõ lệnh quy trình ở terminal thay vì trong khung chat	Mở công cụ AI tại thư mục dự án rồi gõ lệnh trong khung chat
Công cụ báo không nhận lệnh /speckit.specify	Công cụ dùng dấu gạch ngang thay vì dấu chấm	Đổi sang cách viết đúng ở mục 2, ví dụ /speckit-specify
Lệnh không xuất hiện trong gợi ý	Skill chưa được cài hoặc tích hợp chưa đúng	Chạy specify check và specify integration status ở terminal
/speckit-converge báo thiếu task	Chạy converge trước khi thực thi	Chạy /speckit-implement trước, rồi chạy lại /speckit-converge
/speckit-analyze không sửa được lỗi giúp bạn	Lệnh này chỉ đọc, không ghi tệp	Sửa tại nguồn: /speckit-specify hoặc /speckit-clarify cho đặc tả, /speckit-plan cho thiết kế

---

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