Hướng dẫn Spec Kit

Giao diện

Lập kế hoạch ​

Trước khi bắt đầu

  • Cần biết: nội dung spec.md và các quyết định đã chốt ở bước làm rõ
  • Cần có: spec.md đã hoàn chỉnh trong specs/NNN-*/
  • Cần đang ở: thư mục gốc của dự án, sau /speckit-clarify và trước /speckit-tasks

1. Đây là nơi quyết định công nghệ ​

Nếu bước tạo đặc tả (specification) chỉ nói WHAT và WHY, thì đây là bước nói HOW. Bạn nêu công nghệ, kiến trúc, ràng buộc kỹ thuật và các lựa chọn triển khai. Công cụ AI dùng những thông tin đó để sinh ra kế hoạch (plan).

Đưa càng cụ thể càng tốt: framework nào, cơ sở dữ liệu nào, giao diện nào, ràng buộc hiệu năng nào. Đây là chỗ duy nhất trong quy trình mà những chi tiết này thuộc về.

2. Gọi lệnh kèm lựa chọn kỹ thuật ​

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

text
/speckit-plan Ứng dụng dùng Vite với số thư viện tối thiểu. Dùng HTML, CSS và JavaScript thuần càng nhiều càng tốt. Ảnh không tải lên đâu cả, siêu dữ liệu lưu trong SQLite cục bộ.

Kết quả mong đợi: công cụ tạo ra plan.md và các hiện vật thiết kế đi kèm trong specs/NNN-*/.

3. Năm hiện vật được tạo ra ​

Hiện vậtNội dung
plan.mdKế hoạch triển khai: kiến trúc, công nghệ, các giai đoạn thực hiện
research.mdGhi chú nghiên cứu và lý do chọn giữa các phương án
data-model.mdMô hình dữ liệu: thực thể, trường, quan hệ
contracts/Thư mục chứa hợp đồng giao diện giữa các thành phần
quickstart.mdHướng dẫn nhanh để chạy và kiểm tra kết quả

4. Xem các hiện vật vừa tạo ​

bash
ls specs/001-*/

Kết quả mong đợi: bạn thấy plan.md, research.md, data-model.md, contracts/ và quickstart.md nằm cạnh spec.md.

Nếu thiếu một trong các tệp trên, hãy chạy lại lệnh kèm mô tả kỹ thuật đầy đủ hơn.

5. Đối chiếu kế hoạch với hiến chương ​

Đọc plan.md và so với .specify/memory/constitution.md. Mọi lựa chọn kỹ thuật phải tuân theo nguyên tắc dự án. Nếu có chỗ xung đột, sửa ở đây ngay — trước khi công việc được chia nhỏ.

6. Khi nào chạy lại lệnh này ​

Chạy lại /speckit-plan khi đặc tả thay đổi đáng kể, hoặc khi bạn đổi một quyết định kỹ thuật lớn. Kế hoạch cũ không tự cập nhật theo đặc tả mới.

Kết quả ​

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

  • Chốt được công nghệ và kiến trúc cho tính năng
  • Có plan.md cùng bốn hiện vật thiết kế kèm theo

Cách tự xác nhận: trong thư mục specs/NNN-*/ có đủ plan.md, research.md, data-model.md, contracts/ và quickstart.md.

Lỗi thường gặp ​

LỗiNguyên nhânCách khắc phục
Kế hoạch quá chung, không chọn công nghệLệnh gọi mà không truyền ràng buộc kỹ thuậtGọi lại lệnh kèm mô tả công nghệ và kiến trúc
Không thấy thư mục contracts/Lệnh chạy khi chưa có spec.mdChạy /speckit-specify trước, rồi chạy lại /speckit-plan
plan.md vi phạm nguyên tắc trong hiến chươngChưa đối chiếu sau khi sinh kế hoạchSửa plan.md, hoặc cập nhật hiến chương nếu nguyên tắc đã đổi
Kế hoạch lẫn yêu cầu mới chưa có trong spec.mdThêm yêu cầu thẳng vào lệnh planQuay lại /speckit-specify hoặc /speckit-clarify để bổ sung đặc tả

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

Trước khi làm theo trang này

  • Kiểm tra phiên bản: chạy specify version ở terminal để biết bạn đang dùng bản nào. Nội dung trang này được kiểm chứng với Spec Kit 1.1.3.
  • Thiết bị: các bước cài đặt và mọi dòng lệnh trong tài liệu này cần máy tính có terminal. Bạn đọc được trên điện thoại, nhưng phải dùng máy tính để chạy lệnh.

Tài liệu tiếng Việt, chắt lọc từ tài liệu chính thức của GitHub Spec Kit.

Nội dung tham chiếu Spec Kit 1.1.3