Spec Kit: Chấm dứt vibe code. Build app chất, predictable.

TL;DR

Spec Kit là một toolkit mã nguồn mở từ GitHub, giúp bạn xây dựng phần mềm chất lượng cao nhanh hơn bằng cách chuyển từ “code-driven” sang “spec-driven development”. Thay vì cứ “vibe code” từ đầu, bạn sẽ dùng các “specification” (đặc tả) để AI tự động tạo ra code, giảm thiểu lỗi và tăng tốc độ.

Nói đơn giản: Như có một kiến trúc sư AI luôn túc trực, biến bản vẽ (spec) của bạn thành nhà (code) mà hông cần bạn tự tay xây từng viên gạch.

Tổng quan

Spec Kit là một bộ công cụ mã nguồn mở do GitHub phát triển, tập trung vào mô hình “Spec-Driven Development”. Khác với cách làm truyền thống xem code là cốt lõi và spec chỉ là tài liệu tham khảo, Spec Kit “lật ngược tình thế”: các specifications trở thành những bản thiết kế có thể thực thi được, trực tiếp tạo ra code hoạt động thay vì chỉ hướng dẫn dev.

Nó hoạt động thông qua một CLI (Command Line Interface) tên là specify, cho phép bạn khởi tạo project, định nghĩa nguyên tắc, mô tả tính năng, lên kế hoạch kỹ thuật, chia nhỏ task và cuối cùng là thực thi toàn bộ quá trình, tất cả đều được AI agents hỗ trợ.

Spec Kit hỗ trợ rất nhiều AI agents phổ biến như Claude Code, GitHub Copilot, Gemini CLI, Cursor, Qoder CLI… Điều này có nghĩa là bạn có thể tận dụng sức mạnh của các AI này để tự động hóa nhiều bước trong quy trình phát triển phần mềm, từ việc tạo cấu trúc dự án đến viết code chi tiết.

Cộng đồng Spec Kit cũng rất năng động, với nhiều extensions (mở rộng), presets (cấu hình sẵn) và walkthroughs (hướng dẫn chi tiết) do cộng đồng đóng góp, giúp bạn tùy biến và áp dụng Spec Kit vào nhiều kịch bản khác nhau.

Xài vào việc gì?

Bạn đang “vibe code” mà code cứ sai lên sai xuống, hoặc scope cứ phình to? Chạy specify init rồi dùng /speckit.constitution để định hình nguyên tắc, /speckit.specify để mô tả rõ “cái gì” và “tại sao” cần build. Thay vì cứ ngồi code theo cảm hứng rồi sửa đi sửa lại, bạn có một bản thiết kế rõ ràng, AI sẽ giúp bạn bám sát nó, giảm thiểu lỗi và những tính năng thừa.

Muốn scale đội ngũ dev nhưng hông muốn tăng headcount? Spec Kit giúp tự động hóa nhiều bước lặp lại trong quy trình phát triển. Với AI agents hỗ trợ các lệnh /speckit.plan, /speckit.tasks, /speckit.implement, bạn có thể đẩy nhanh tốc độ hoàn thành feature, giúp team hiện tại làm được nhiều việc hơn mà hông cần tuyển thêm người.

Cần đảm bảo chất lượng code và tuân thủ kiến trúc, tiêu chuẩn từ đầu? Dùng /speckit.constitution để thiết lập các nguyên tắc về chất lượng code, testing, UX, hiệu năng. AI agent sẽ được “huấn luyện” để tuân thủ các nguyên tắc này trong suốt quá trình generate code, giúp bạn duy trì sự nhất quán và chất lượng cao cho dự án.

Đang muốn tích hợp AI vào workflow dev hiện tại nhưng chưa biết bắt đầu từ đâu? Spec Kit hỗ trợ một danh sách dài các AI agents từ GitHub Copilot, Claude Code, Gemini CLI đến các công cụ khác. Bạn chỉ cần cài CLI, chọn AI agent mình đang xài, và bắt đầu dùng các slash command để AI hỗ trợ từng bước trong quy trình phát triển.

Các điểm chính

• Spec-Driven Development thay đổi cuộc chơi: Cách làm cũ xem code là vua, spec chỉ là phụ trợ đã lỗi thời. Spec Kit biến spec thành “code sống”, trực tiếp tạo ra sản phẩm.
  • So What? Điều này có nghĩa là bạn tập trung vào “cái gì” và “tại sao” thay vì “làm như thế nào”, giúp đội ngũ dev có cái nhìn tổng thể hơn và giảm bớt gánh nặng code tay.
• Hạn chế “vibe coding” và tăng tính dự đoán: Thay vì code theo cảm hứng, Spec Kit cung cấp một quy trình có cấu trúc, từ định nghĩa nguyên tắc đến triển khai.
  • So What? Giúp giảm rủi ro dự án, tăng tính dự đoán về thời gian và chất lượng. Hông còn cảnh code xong mới biết sai hướng.
• Tích hợp sâu với AI Agents phổ biến: Spec Kit được thiết kế để hoạt động liền mạch với nhiều AI agents như GitHub Copilot, Claude Code, Gemini, v.v.
  • So What? Bạn có thể tận dụng tối đa sức mạnh của AI mà hông cần phải tự xây dựng các workflow phức tạp. Đây là một “competitive timing” để bắt đầu làm quen.
• Workflow phát triển có cấu trúc rõ ràng: Từ constitution (nguyên tắc), specify (đặc tả), plan (kế hoạch), tasks (tác vụ) đến implement (triển khai), mọi bước đều được định nghĩa.
  • So What? Giúp các dự án lớn dễ quản lý hơn, đặc biệt khi có nhiều người tham gia. Nó cũng là một cách hay để “onboard” dev mới vào dự án.
• Cộng đồng mở rộng và tùy biến cao: Spec Kit có một hệ sinh thái mạnh mẽ với nhiều extensions, presets và walkthroughs do cộng đồng đóng góp.
  • So What? Bạn hông bị giới hạn bởi các tính năng mặc định. Có thể tùy biến Spec Kit để phù hợp với quy trình làm việc, công nghệ, hoặc thậm chí là “văn hóa” của team mình (như preset “Pirate Speak” chẳng hạn).
• Tập trung vào “Predictable Outcomes”: Mục tiêu chính là xây dựng phần mềm chất lượng cao một cách nhanh chóng và có thể dự đoán được.
  • So What? Điều này trực tiếp ảnh hưởng đến “Value Ratio” – tiết kiệm thời gian, chi phí, và tăng ROI cho mỗi dự án.

Workflow gợi ý

Để bắt đầu một dự án mới với Spec Kit và AI agent, bạn có thể theo các bước sau:

1. Khởi tạo dự án và AI Agent: Cài đặt specify CLI, sau đó chạy specify init . --ai claude (hoặc AI agent bạn muốn) trong thư mục dự án.
2. Thiết lập nguyên tắc dự án: Dùng lệnh /speckit.constitution trong AI agent để định nghĩa các nguyên tắc cốt lõi về chất lượng, UX, hiệu năng cho dự án của bạn.
3. Đặc tả tính năng: Dùng /speckit.specify để mô tả chi tiết tính năng bạn muốn xây dựng, tập trung vào “cái gì” và “tại sao”.
4. Lên kế hoạch kỹ thuật: Dùng /speckit.plan để cung cấp thông tin về tech stack, kiến trúc, và các lựa chọn công nghệ.
5. Chia nhỏ task: Chạy /speckit.tasks để AI tự động phân tích kế hoạch và tạo ra danh sách các task cần làm.
6. Triển khai: Dùng /speckit.implement để AI thực thi các task và generate code theo kế hoạch và đặc tả.

Quick Start

1. Cài đặt Specify CLI: Mở terminal và chạy lệnh uv tool install specify-cli --from git+https://github.com/github/spec-kit.git@vX.Y.Z (nhớ thay vX.Y.Z bằng phiên bản mới nhất nha).
2. Khởi tạo project với AI: Trong thư mục dự án, chạy specify init . --ai github-copilot (hoặc AI agent bạn đang xài).
3. Thử các lệnh cơ bản: Mở AI agent của bạn và thử các lệnh như /speckit.constitution, /speckit.specify, /speckit.plan để xem cách nó hoạt động.

FAQ

Spec-Driven Development là gì? Nó là một phương pháp phát triển phần mềm mà ở đó, các bản đặc tả (specifications) hông chỉ là tài liệu hướng dẫn mà còn là nguồn chính để tự động tạo ra code hoạt động. Điều này giúp giảm “vibe coding” và tăng tính dự đoán của quá trình phát triển.

Spec Kit có hỗ trợ AI agent nào? Nó hỗ trợ rất nhiều AI agents phổ biến như GitHub Copilot, Claude Code, Gemini CLI, Cursor, Qoder CLI, Kiro CLI, Amp, Auggie CLI, CodeBuddy CLI, Forge, IBM Bob, Jules, Kilo Code, opencode, Pi Coding Agent, Qwen Code, Roo Code, SHAI (OVhcloud), Tabnine CLI, Mistral Vibe, Kimi Code, iFlow CLI và nhiều cái khác nữa.

Mình có thể tùy biến Spec Kit hông? Hoàn toàn được nha. Spec Kit có hệ thống extensions (mở rộng) và presets (cấu hình sẵn) cho phép bạn thay đổi cách nó hoạt động, từ việc thêm các bước workflow mới đến việc thay đổi ngôn ngữ đầu ra (như preset “Pirate Speak” đó).

Spec Kit có thay thế dev hông? Hông đâu. Spec Kit giúp tự động hóa các công việc lặp lại và đảm bảo tính nhất quán, cho phép dev tập trung vào những vấn đề phức tạp hơn, thiết kế kiến trúc, và đưa ra các quyết định chiến lược. Nó là một công cụ giúp dev làm việc hiệu quả hơn chứ hông phải thay thế.