Trải nghiệm khi dùng Spec Kit
Bạn cài công cụ dòng lệnh specify bằng uv, rồi tạo một dự án mới bằng lệnh init, chọn agent bạn đang dùng, ví dụ GitHub Copilot. Dự án được tạo kèm các mẫu và lệnh sẵn để agent hiểu quy trình. Bạn mở agent trong thư mục đó và làm việc ngay trong khung chat của nó.
Trong khung chat, bạn gõ lần lượt vài lệnh: lập nguyên tắc của dự án một lần, mô tả cái muốn xây, nêu lựa chọn công nghệ, tạo danh sách việc rồi cho thực hiện. Sau mỗi bước bạn dừng lại đọc kết quả rồi mới sang bước tiếp, giống như duyệt từng giai đoạn của một dự án thật.
Cách làm này chậm hơn nhờ AI viết một mạch, nhưng để lại nhiều tài liệu rõ ràng: đặc tả, kế hoạch, danh sách việc, báo cáo. Nó hợp với dự án nghiêm túc hơn là chỉ thử nhanh một đoạn code. Cũng có thể mở rộng bằng extension, preset và workflow.
Tính năng nổi bật
Phát triển theo đặc tả
Chuỗi lệnh constitution, specify, plan, tasks, implement, converge dẫn từ ý tưởng tới code và kiểm tra mức độ khớp với đặc tả.
Quy trình sửa lỗi
Extension bug đánh giá nguyên nhân, sửa và kiểm chứng, rồi ghi kết luận verified, partial hoặc failed.
Đánh giá ý tưởng
Extension assess thu thập bằng chứng để đi tới kết luận go, cần làm rõ hay dừng, ngay cả khi chưa có code.
Dùng với nhiều agent
Cơ chế integration cho phép kết nối hoặc đổi qua lại giữa các coding agent; ví dụ trong README dùng GitHub Copilot.
Tuỳ biến linh hoạt
Extension, preset, workflow và bundle cho phép đổi mẫu, thêm bước kiểm duyệt hay áp dụng chuẩn của tổ chức.
Danh mục cộng đồng
Có catalog extension, preset, workflow; README nhắc catalog không phải là kiểm toán nên cần tự xem mã trước khi cài.
Tận dụng Spec Kit vào việc gì?
Lập trình viên, nhóm sản phẩm
Xây tính năng mới có tài liệu rõ ràng
Viết đặc tả trước để cả người và AI cùng hiểu mục tiêu, giảm làm lại giữa chừng.
Lập trình viên bảo trì
Sửa lỗi có bằng chứng
Dùng quy trình bug để ghi nguyên nhân, phạm vi sửa và kiểm chứng triệu chứng ban đầu đã hết.
Chủ sản phẩm, người khởi nghiệp
Cân nhắc có nên làm một ý tưởng không
Chạy quy trình assess để tổng hợp bằng chứng trước khi đầu tư thời gian, kể cả khi quyết định dừng cũng là kết quả có giá trị.
Quản lý kỹ thuật
Áp chuẩn chung cho tổ chức
Dùng preset để mọi dự án dùng cùng mẫu đặc tả và thuật ngữ, hợp với yêu cầu quy định nội bộ.
Cần chuẩn bị gì?
- Python 3.11 trở lên và công cụ uv.
- Một coding agent được hỗ trợ (ví dụ GitHub Copilot), có tài khoản hợp lệ.
- Windows, macOS hoặc Linux có Terminal và Git.
- Quen với việc làm việc trong dự án code và đọc tài liệu tiếng Anh.
Hướng dẫn cài đặt chi tiết
Cài trên uv (mọi hệ điều hành)
Cài uv theo hướng dẫn trong tài liệu của Spec Kit (trang install/uv). Cần có Python 3.11 trở lên.
Cài công cụ specify, rồi tạo dự án mới. Lệnh mẫu của README dùng GitHub Copilot; thay tên dự án và agent theo ý bạn.
uv tool install specify-cli specify init my-project --integration copilot cd my-projectMở agent trong thư mục dự án vừa tạo rồi chọn quy trình muốn dùng. Các cách cài khác, CI, nâng cấp và xử lý sự cố có trong tài liệu Installation.
Cài trên Dự án sẵn có
Nếu đã có code, xem hướng dẫn Existing projects trong tài liệu chính thức để áp dụng Spec Kit lên dự án hiện tại.
Với agent khác, tra bảng Integrations để lấy khoá tích hợp và cú pháp gọi lệnh tương ứng trong tài liệu github.github.io/spec-kit.
Dùng thử lần đầu
Mở agent trong thư mục dự án mới. Lệnh dưới đây gõ trong khung chat của agent chứ không phải Terminal. Bắt đầu bằng việc lập nguyên tắc.
/speckit-constitution Create principles focused on code quality, testing, and maintainability.Mô tả cái cần xây, ví dụ một ứng dụng sắp xếp ảnh theo album ngày tháng, rồi đọc đặc tả được tạo.
/speckit-specify Build a photo organizer with albums grouped by date and a tile preview of each album.Nêu công nghệ muốn dùng để tạo kế hoạch, rồi tạo danh sách việc.
/speckit-plan Use Vite with vanilla JavaScript. Keep images local and store metadata in SQLite. /speckit-tasksCho thực hiện và kiểm tra mức khớp với đặc tả; lặp lại hai bước này cho đến khi báo cáo cho kết quả Converged.
/speckit-implement /speckit-converge
Mẹo dùng hay
- Chạy từng lệnh một và đọc kỹ kết quả trước khi sang lệnh tiếp theo, đừng bấm liên tục.
- Cú pháp lệnh khác nhau giữa các agent, hãy tra bảng invocation trong tài liệu nếu không dùng Copilot.
- Quy trình sửa lỗi và đánh giá ý tưởng là extension, cài bằng specify extension add bug hoặc assess khi cần.
- Có thể tìm thêm tiện ích bằng lệnh specify extension search, nhưng hãy đọc mã nguồn trước khi cài.
Lưu ý và hạn chế
- Quy trình nhiều bước và nhiều tài liệu nên chậm và tốn token hơn so với nhờ AI viết nhanh một đoạn code.
- Các cách cài đặt và lệnh có thể thay đổi nhanh; luôn đối chiếu với tài liệu hiện hành tại github.github.io/spec-kit.
- Tiện ích cộng đồng trong catalog không được GitHub kiểm toán hay bảo chứng, nên tự chịu trách nhiệm khi cài.
Câu hỏi thường gặp
Spec Kit có miễn phí không?
Mã nguồn dùng giấy phép MIT, miễn phí. Bạn vẫn có thể phải trả tiền cho agent như GitHub Copilot hoặc mô hình AI bạn dùng.
Có cần dùng GitHub Copilot không?
Không. Ví dụ trong README dùng Copilot nhưng công cụ hỗ trợ nhiều agent qua cơ chế integration.
Người mới học code có dùng được không?
Khá khó vì cần Python, uv và quen quy trình phần mềm. Phù hợp hơn với người đã làm dự án và muốn có quy trình rõ ràng cùng AI.
Tải mã nguồn về máy
Nếu bạn muốn xem hoặc sửa mã nguồn, mở Terminal (trên Windows là PowerShell) và chạy lệnh dưới. Máy cần cài sẵn Git.
git clone https://github.com/github/spec-kit.gitRepo tương tự nên xem
Superpowers
obra / superpowers
Bộ kỹ năng biến trợ lý AI thành người làm phần mềm bài bản: hỏi ý, lập kế hoạch, viết test, rồi mới code
BMad Method
bmad-code-org / BMAD-METHOD
Bộ quy trình và AI agent giúp biến ý tưởng thành phần mềm có kế hoạch rõ ràng với công cụ code AI
Matt Pocock Skills
mattpocock / skills
Bộ skill nhỏ gọn giúp trợ lý AI viết code hỏi kỹ yêu cầu, viết test trước và giữ code gọn gàng