Bỏ qua tới nội dung
Ông T.vn

spec-kit: viết đặc tả trước, để AI code theo — hướng dẫn cài đặt và dùng

10 phút đọcCập nhật
spec-kit: viết đặc tả trước, để AI code theo — hướng dẫn cài đặt và dùng

Tóm tắt nhanh

Spec Kit là bộ công cụ mã nguồn mở của GitHub, gồm một CLI Python tên specify-cli và các mẫu quy trình cho trợ lý lập trình AI như GitHub Copilot. Nó giúp bạn viết đặc tả trước rồi mới để AI lên kế hoạch và code, thay vì gõ yêu cầu rời rạc. Cài đặt khá đơn giản: cần Python 3.11+, uv và một trợ lý AI, chỉ ba lệnh là có dự án mẫu.

Spec Kit là bộ công cụ mã nguồn mở của GitHub, giúp trợ lý lập trình AI (như GitHub Copilot) làm việc theo quy trình có cấu trúc thay vì trả lời theo cảm hứng từng câu. Bạn cài một công cụ dòng lệnh tên specify, tạo dự án, rồi ra lệnh cho AI qua các câu lệnh có sẵn như /speckit-specify, /speckit-plan, /speckit-implement.

Vấn đề nó giải quyết rất quen thuộc. Bạn nhờ AI làm một tính năng, nó làm được một nửa, rồi bạn nhắc đi nhắc lại, kết quả lệch dần so với ý ban đầu. Spec Kit đổi cách làm: bạn viết rõ cần xây gì và vì sao (đặc tả), sau đó mới đến kế hoạch, danh sách việc, và code. Mọi bước đều để lại tài liệu, nên bạn xem lại được AI đã hiểu gì.

Ai nên dùng? Lập trình viên mới, người làm sản phẩm, hoặc người văn phòng biết dùng terminal cơ bản và đã có một trợ lý lập trình AI. Điểm đáng giá nhất: ngoài quy trình xây tính năng, repo còn có quy trình sửa lỗi và quy trình đánh giá ý tưởng (không cần code). Repo hiện có khoảng 149.500 sao và 13.400 fork, giấy phép MIT.

CLI

github/spec-kit

Bộ công cụ mã nguồn mở của GitHub giúp trợ lý lập trình AI làm việc theo quy trình rõ ràng: đặc tả, kế hoạch, task, code, sửa lỗi, đánh giá ý tưởng.

★ 150kPythonMIT
Xem repo trên GitHub

I.Spec Kit làm được gì

Spec Kit không phải một ứng dụng chạy riêng. Nó là bộ khung để AI của bạn làm việc có trật tự. Các phần chính:

A.Ba quy trình dựng sẵn

  • Spec-Driven Development (SDD): đi từ đặc tả, qua kế hoạch và task, đến code, rồi bước hội tụ (converge) để kiểm tra kết quả khớp đặc tả. Có sẵn trong lõi.
  • Sửa lỗi (bug fixing): đánh giá nguyên nhân, sửa, rồi kiểm chứng triệu chứng ban đầu đã hết. Đây là extension cài thêm khi cần.
  • Đánh giá ý tưởng (idea assessment): thu thập bằng chứng để quyết định ý tưởng có đáng làm không, với kết luận go, cần làm rõ, hoặc dừng. Không cần có code. Cũng là extension cài thêm.

Ba quy trình này độc lập, bạn không bắt buộc đi hết từ đầu đến cuối.

B.Chuyển đổi giữa nhiều trợ lý AI

Cơ chế Integration cho phép kết nối hoặc đổi qua lại giữa các trợ lý lập trình. Ví dụ trong README dùng GitHub Copilot. Nếu bạn dùng trợ lý khác, README chỉ sang trang danh sách integration để lấy đúng khoá và cú pháp gọi lệnh.

C.Tuỳ biến theo cách làm của nhóm

Bạn có thể điều chỉnh bằng Preset (đổi mẫu, thuật ngữ, quy chuẩn của tổ chức), Extension (thêm lệnh, cổng kiểm soát chất lượng, kết nối công cụ ngoài), Workflow (tự động hoá chuỗi lệnh) và Bundle (đóng gói một bộ cài đặt cho cả nhóm). Nguyên tắc README đưa ra: bắt đầu từ thay đổi nhỏ nhất đủ dùng, không cần thay cả quy trình.

D.Danh mục cộng đồng và dùng nội bộ

Bạn tìm thành phần do cộng đồng làm bằng các lệnh như specify extension search, specify preset search, specify workflow search, specify bundle search. Tổ chức cũng có thể tự dựng danh mục riêng, và README nói có hỗ trợ làm việc offline hoặc sau tường lửa.

II.Cần chuẩn bị gì

Theo README, bạn cần:

  • Hệ điều hành: Linux, macOS hoặc Windows.
  • Python 3.11 trở lên (file pyproject.toml cũng yêu cầu >=3.11).
  • Công cụ uv (trình quản lý gói Python). README trỏ tới trang hướng dẫn cài uv riêng.
  • Một trợ lý lập trình AI được hỗ trợ. Ví dụ trong README là GitHub Copilot.

Tư liệu không nói về yêu cầu GPU, dung lượng ổ đĩa hay API key riêng cho Spec Kit. Chi phí hoặc tài khoản (nếu có) sẽ phụ thuộc vào trợ lý AI bạn chọn.

Spec Kit chỉ là bộ khung. Trợ lý AI bạn gắn vào mới là thứ đọc và sửa file trong dự án. Hãy thử trên một thư mục dự án riêng, đừng chạy ngay trên mã nguồn quan trọng chưa có bản sao lưu hay Git.

III.Cài đặt từng bước

  1. Kiểm tra Python và uvĐảm bảo có Python 3.11+ và đã cài uv
  2. Cài Specify CLIDùng uv để cài gói specify-cli
  3. Tạo dự ánChạy specify init với trợ lý AI bạn dùng
  4. Vào thư mục dự áncd vào thư mục vừa tạo
  5. Mở trợ lý AIKhởi chạy agent tại thư mục dự án, rồi gõ các lệnh /speckit-...

A.Kiểm tra Python và uv

Mở terminal (Windows: PowerShell hoặc Windows Terminal; macOS/Linux: Terminal). Kiểm tra phiên bản Python:

Terminal
python --version

Cần hiển thị 3.11 trở lên. Nếu máy báo không tìm thấy lệnh python, bạn có thể phải thử python3 hoặc cài lại Python. Về uv, README chưa ghi lệnh cài trong phần này mà chỉ dẫn tới trang uv của tài liệu dự án (trang chủ https://github.github.com/spec-kit/, mục Installation). Bạn làm theo đó nếu chưa có uv.

B.Cài Specify CLI

Lệnh này cài công cụ specify dưới dạng một tool độc lập do uv quản lý:

Terminal
uv tool install specify-cli

Tên gói là specify-cli, còn lệnh bạn gõ sau này là specify. Hai tên khác nhau, đừng nhầm.

C.Tạo dự án

Terminal
specify init my-project --integration copilot

Lệnh tạo thư mục my-project và cấu hình sẵn cho GitHub Copilot (--integration copilot). Nếu dùng trợ lý khác, bạn cần thay giá trị sau --integration bằng khoá tương ứng. README không liệt kê hết các khoá, nên hãy mở trang Integrations trong tài liệu dự án để xem.

D.Vào thư mục dự án

Terminal
cd my-project

Đây là chỗ người mới hay quên: các bước sau phải chạy ở đúng thư mục này, và trợ lý AI cũng phải được mở tại đây.

E.Mở trợ lý AI

Khởi chạy trợ lý lập trình AI của bạn trong thư mục dự án. Từ đây, các lệnh /speckit-... được gõ trong khung chat của trợ lý, không gõ vào terminal. README nhấn mạnh điều này rất rõ.

IV.Kiểm tra đã chạy được chưa

README không có lệnh kiểm tra phiên bản riêng, nên cách kiểm tra thực tế là từng bước:

  1. Sau specify init, thư mục my-project được tạo và không báo lỗi.
  2. Mở trợ lý AI trong thư mục đó, gõ thử lệnh đầu tiên của quy trình SDD và xem trợ lý có nhận ra lệnh không:
text
/speckit-constitution Create principles focused on code quality, testing, and maintainability.
  1. Nếu trợ lý trả lời và tạo ra nội dung nguyên tắc cho dự án, tức là cài đặt đã ổn. Nếu nó coi đây là câu chat bình thường hoặc báo không có lệnh, xem phần lỗi thường gặp bên dưới.

Với các extension, bạn xác nhận cài thành công khi lệnh specify extension add ... chạy xong không báo lỗi và các lệnh mới (như /speckit-bug-assess) dùng được trong trợ lý.

V.Dùng vào việc thật

Các tình huống dưới đây bám đúng các ví dụ trong README. Tên dự án và nội dung là minh hoạ.

A.Dev mới xây một ứng dụng từ đầu bằng SDD

Bạn là lập trình viên mới, muốn làm ứng dụng sắp xếp ảnh nhưng hay bị AI code lệch ý. Hãy chạy từng lệnh, xem kết quả rồi mới sang lệnh tiếp theo (README dặn chạy từng bước một). Trong chat của trợ lý:

text
/speckit-constitution Create principles focused on code quality, testing, and maintainability.
/speckit-specify Build a photo organizer with albums grouped by date and a tile preview of each album.
/speckit-plan Use Vite with vanilla JavaScript. Keep images local and store metadata in SQLite.
/speckit-tasks
/speckit-implement
/speckit-converge

Lệnh constitution chỉ cần làm một lần cho mỗi dự án. Các lệnh còn lại lặp lại với từng tính năng. Lặp implement rồi converge cho đến khi bước hội tụ báo Converged. Kết quả: bạn có đặc tả, kế hoạch, danh sách task và code, tất cả theo dấu vết rõ ràng.

Viết rõ cần gì trước, rồi mới để AI code — đỡ phải sửa đi sửa lại cả buổi.

Ông T

B.Sửa lỗi đăng nhập có kiểm chứng

Website của bạn bị sập form đăng nhập khi để trống mật khẩu. Trong terminal, ở thư mục dự án, cài extension sửa lỗi:

Terminal
specify extension add bug

Rồi trong chat của trợ lý:

text
/speckit-bug-assess "Submitting an empty password crashes the login form." slug=login-crash
/speckit-bug-fix slug=login-crash
/speckit-bug-test slug=login-crash

Báo cáo nằm ở thư mục .specify/bugs/login-crash/. Kết luận cuối là verified, partial hoặc failed. Chỉ verified mới xác nhận lỗi đã sửa xong thật. Cách này giúp bạn không tin lời AI nói "đã sửa" mà không có bằng chứng.

C.Chủ sản phẩm đánh giá ý tưởng trước khi bỏ tiền

Bạn là chủ một ứng dụng nhỏ và đang cân nhắc thêm chế độ làm việc offline. Chưa cần code gì cả. Cài extension đánh giá:

Terminal
specify extension add assess

Sau đó trong chat của trợ lý:

text
/speckit-assess-intake "Let users work offline and sync when they reconnect." slug=offline-mode
/speckit-assess-research slug=offline-mode
/speckit-assess-define slug=offline-mode
/speckit-assess-shape slug=offline-mode
/speckit-assess-decide slug=offline-mode

Các tài liệu nằm ở .specify/assessments/offline-mode/. Kết luận là go, needs-clarification hoặc kill. Nếu chưa rõ, bạn sửa trực tiếp các file Markdown có sẵn (tự sửa hoặc nhờ AI sửa) chứ không cần chạy lại toàn bộ. Nếu kết luận là go và muốn làm phần mềm, bạn đưa bản tóm tắt bàn giao trong decision.md vào /speckit-specify. Dừng lại có lý do ghi rõ cũng là một kết quả tốt.

D.Tổ chức muốn chuẩn hoá cách làm cho cả nhóm

Trưởng nhóm kỹ thuật muốn mọi dự án đều có yêu cầu truy vết quy định pháp lý trong kế hoạch. README gợi ý dùng Preset để điều chỉnh quy trình sẵn có, và Bundle để đóng gói một bộ cài đặt cho cả nhóm. Với thay đổi chỉ cho một dự án, dùng project-local override. Chi tiết cách viết preset và bundle nằm trong Customization guide của tài liệu dự án. README tóm tắt chứ không đưa lệnh cụ thể, nên bạn đọc hướng dẫn đó trước khi làm.

VI.Lỗi hay gặp và cách xử lý

A.Gõ lệnh /speckit-... vào terminal

Đây là lỗi dễ gặp nhất. Các lệnh này chỉ dùng trong khung chat của trợ lý AI, không phải trong terminal. Terminal chỉ dùng cho uv ... và specify .... Mở trợ lý trong thư mục dự án rồi gõ lại.

B.Terminal báo không thấy lệnh specify hoặc uv

Thường do uv chưa được cài, hoặc terminal chưa nạp lại đường dẫn sau khi cài. Đóng terminal, mở lại và thử lần nữa. Nếu vẫn lỗi, xem mục Installation và phần troubleshooting trong tài liệu dự án. Mình không có thông tin chi tiết hơn từ README.

C.Trợ lý không nhận lệnh /speckit-...

Hai nguyên nhân thường gặp: bạn mở trợ lý sai thư mục (không phải my-project), hoặc dùng cú pháp gọi lệnh của trợ lý khác. README nói ví dụ dùng cú pháp skills mặc định của GitHub Copilot. Với trợ lý khác, bạn xem trang cú pháp gọi lệnh tương ứng (command invocation) trong tài liệu.

D.Phiên bản Python quá cũ

Python dưới 3.11 sẽ không đáp ứng yêu cầu. Kiểm tra bằng python --version, cài bản mới hơn rồi thử lại.

E.Cài extension cộng đồng không rõ nguồn

Danh mục cộng đồng không phải là bản kiểm định hay bảo chứng. README khuyên bạn xem lại mã nguồn của thành phần cộng đồng trước khi cài hoặc chạy. Hãy làm vậy, nhất là khi dự án có dữ liệu nhạy cảm.

VII.Có nên dùng không

Điểm mạnh: Spec Kit cho bạn một quy trình rõ ràng để AI không làm lan man. Mọi bước để lại tài liệu, dễ xem lại và dễ trao đổi trong nhóm. Ngoài xây tính năng còn có sửa lỗi có kiểm chứng và đánh giá ý tưởng. Dự án mã nguồn mở (MIT), do GitHub làm, còn được cập nhật trong vài tháng gần đây, hỗ trợ Linux, macOS và Windows.

Giới hạn: bạn cần quen terminal và có sẵn một trợ lý lập trình AI. Quy trình chạy từng bước, xem từng kết quả, nên chậm hơn việc nhờ AI làm một lèo, và phù hợp hơn với tính năng có độ phức tạp vừa trở lên. Với một đoạn code nhỏ, viết tay hoặc hỏi trực tiếp AI có thể nhanh hơn. Tư liệu cũng chưa nói gì về chi phí hay cách xử lý dữ liệu, vì phần này phụ thuộc trợ lý AI bạn chọn.

Khi nào chọn cách khác: nếu bạn không dùng trợ lý lập trình nào, hoặc chỉ cần sửa nhanh vài dòng, bạn chưa cần Spec Kit. Còn nếu bạn hay làm tính năng mới với AI và muốn bớt cảnh làm lại, đây là công cụ đáng thử trên một dự án nhỏ trước.

4.6/5 · Ông T chấm

Chưa có độc giả chấm

Bài này có ích với bạn không?

Câu hỏi thường gặp

Spec Kit có miễn phí không?

Bản thân Spec Kit là mã nguồn mở theo giấy phép MIT. Tư liệu không nói gì về phí của trợ lý lập trình AI đi kèm, như GitHub Copilot. Khoản đó phụ thuộc vào trợ lý bạn chọn.

Spec Kit có chạy được trên Windows không?

Được. README ghi hỗ trợ Linux, macOS và Windows. Bạn cần Python 3.11 trở lên và uv.

Có cần GPU hay máy mạnh không?

Tư liệu không nhắc yêu cầu GPU hay cấu hình phần cứng. Spec Kit là công cụ dòng lệnh bằng Python cùng bộ mẫu quy trình. Phần xử lý AI do trợ lý lập trình bạn dùng đảm nhiệm.

Spec Kit dùng được với trợ lý AI nào?

Ví dụ trong README dùng GitHub Copilot, với tuỳ chọn --integration copilot. README cũng nói có các integration cho trợ lý khác và dẫn tới trang danh sách để lấy khoá cùng cú pháp gọi lệnh. Danh sách đầy đủ không có trong README.

Tôi phải dùng đủ cả quy trình SDD không?

Không. Spec-Driven Development, sửa lỗi và đánh giá ý tưởng là ba điểm bắt đầu độc lập, không phải các giai đoạn bắt buộc. Sửa lỗi và đánh giá ý tưởng là extension, bạn cài khi cần bằng specify extension add bug hoặc specify extension add assess.

Dùng trên dự án đã có sẵn code được không?

README có dẫn tới mục Existing projects trong tài liệu dành cho trường hợp bắt đầu từ code đã có. Nội dung chi tiết nằm ở trang đó, README chính chưa ghi lệnh cụ thể.

Extension cộng đồng có an toàn không?

README lưu ý danh mục cộng đồng không phải là bản kiểm định hay bảo chứng. Bạn nên tự xem mã nguồn trước khi cài hoặc chạy bất kỳ thành phần cộng đồng nào.

Chuyển nhanh tới mục

  1. I.Spec Kit làm được gì
    1. A.Ba quy trình dựng sẵn
    2. B.Chuyển đổi giữa nhiều trợ lý AI
    3. C.Tuỳ biến theo cách làm của nhóm
    4. D.Danh mục cộng đồng và dùng nội bộ
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Kiểm tra Python và uv
    2. B.Cài Specify CLI
    3. C.Tạo dự án
    4. D.Vào thư mục dự án
    5. E.Mở trợ lý AI
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Dev mới xây một ứng dụng từ đầu bằng SDD
    2. B.Sửa lỗi đăng nhập có kiểm chứng
    3. C.Chủ sản phẩm đánh giá ý tưởng trước khi bỏ tiền
    4. D.Tổ chức muốn chuẩn hoá cách làm cho cả nhóm
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Gõ lệnh /speckit-... vào terminal
    2. B.Terminal báo không thấy lệnh specify hoặc uv
    3. C.Trợ lý không nhận lệnh /speckit-...
    4. D.Phiên bản Python quá cũ
    5. E.Cài extension cộng đồng không rõ nguồn
  7. VII.Có nên dùng không

Repo & Skill · 13/11/2026 · 11 phút đọc

Garden Skills: bộ skill thiết kế web, tạo ảnh, làm video cho AI — hướng dẫn cài đặt và dùng

Garden Skills là bộ sưu tập Agent Skills (kỹ năng cho AI) của tác giả ConardLi, dùng được với Claude Code, Cursor, Codex và các AI coding agent khác. Mỗi skill dạy agent làm tốt một việc như thiết kế trang web, tạo ảnh, làm video bằng code, biến tài liệu thành bài viết đẹp. Cài không khó, nhưng README có nhiều cách cài nên bạn cần chọn một cách hợp với công cụ đang dùng.

Repo & Skill · 13/11/2026 · 15 phút đọc

thesysdev/openui: xây giao diện AI dạng streaming — hướng dẫn cài đặt và dùng

OpenUI là framework full-stack, độc lập framework, giúp mô hình AI sinh giao diện có cấu trúc và hiển thị dần khi dữ liệu streaming về. Bạn có thể dựng nhanh một ứng dụng chat bằng CLI hoặc cài từng gói cho React, Vue, Svelte, Angular và LangChain. Việc bắt đầu khá đơn giản nếu máy có đúng phiên bản Node; README chưa ghi đầy đủ lệnh chạy ứng dụng sau khi scaffold.

Repo & Skill · 13/11/2026 · 11 phút đọc

Ruflo: điều phối nhóm agent AI cho Claude Code và Codex — hướng dẫn cài đặt và dùng

Ruflo (trước đây là Claude Flow) là một agent harness: lớp công cụ bao quanh Claude Code và Codex, bổ sung nhiều agent chuyên biệt, bộ nhớ qua các phiên và khả năng chia việc cho nhóm agent. Cài bằng một lệnh `npx ruflo@latest init` trong thư mục dự án, cần Node 20 trở lên. Cài khá dễ, nhưng hệ thống rất rộng nên bạn nên bắt đầu từ một tác vụ nhỏ.