github/spec-kit: Chuẩn hóa quy trình phát triển với AI — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về github/spec-kit — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: 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
github/spec-kit là toolkit mã nguồn mở giúp coding agent làm việc theo quy trình có cấu trúc, nổi bật là Spec-Driven Development. Bạn có thể dùng nó để xây tính năng, sửa lỗi, đánh giá ý tưởng hoặc tự tạo quy trình riêng. Cài đặt khá gọn nếu máy có Python 3.11+, uv và một coding agent được hỗ trợ.
github/spec-kit là toolkit mã nguồn mở giúp coding agent làm việc theo quy trình có cấu trúc, thay vì chỉ nhận yêu cầu rồi tự viết code theo một mạch. Công cụ cung cấp mẫu tài liệu, lệnh và quy trình để biến ý tưởng thành đặc tả, kế hoạch, danh sách việc, code và kết quả kiểm chứng.
Repo phù hợp với lập trình viên, nhóm sản phẩm, người mới làm dự án phần mềm và doanh nghiệp muốn AI làm việc nhất quán hơn. Điểm đáng giá nhất là bạn có thể bắt đầu bằng quy trình có sẵn, sau đó tùy chỉnh mẫu, lệnh, tiêu chuẩn hoặc cả quy trình cho phù hợp với dự án.
Dự án hiện có khoảng 149611 sao và 13444 fork. Repo dùng Python, gói CLI có tên specify-cli, giấy phép MIT và vẫn còn được cập nhật.
github/spec-kit
Toolkit giúp coding agent làm việc theo quy trình có đặc tả, từ lên ý tưởng đến lập kế hoạch, viết code và kiểm chứng.
I.Spec Kit làm được gì
A.Xây tính năng theo đặc tả
Quy trình Spec-Driven Development giúp bạn nói rõ cần xây gì và vì sao trước khi yêu cầu agent viết code. Từ đặc tả, agent tiếp tục tạo kế hoạch, chia nhiệm vụ, triển khai rồi kiểm tra mức độ hoàn thành. Cách này hữu ích khi yêu cầu có nhiều chi tiết hoặc có nhiều người cùng làm.
Bạn có thể tạo một bản hiến chương cho dự án, sau đó lặp lại quy trình cho từng tính năng. Những nguyên tắc như chất lượng code, kiểm thử và khả năng bảo trì được đưa vào ngay từ đầu.
B.Đánh giá và sửa lỗi có ghi nhận
Với lỗi đã xảy ra, bạn không cần chạy toàn bộ quy trình phát triển tính năng. Extension bug fixing giúp đánh giá nguyên nhân, khoanh vùng cách sửa và kiểm tra xem triệu chứng ban đầu đã hết chưa.
Kết quả được lưu thành báo cáo trong dự án. Trạng thái cuối có thể là verified, partial hoặc failed. Chỉ verified mới xác nhận việc sửa lỗi thành công.
C.Đánh giá ý tưởng trước khi đầu tư
Extension idea assessment hỗ trợ thu thập bằng chứng, làm rõ vấn đề, định hình giải pháp và đưa ra quyết định. Kết quả có thể là go, needs-clarification hoặc kill.
Điều này phù hợp với chủ shop, nhóm sản phẩm hoặc doanh nghiệp đang có nhiều ý tưởng nhưng chưa biết ý tưởng nào đáng dành thời gian và ngân sách. Bạn có thể dừng một ý tưởng với lý do được ghi lại, thay vì bỏ công xây thử rồi mới phát hiện không phù hợp.
D.Tùy chỉnh theo tiêu chuẩn của đội nhóm
Spec Kit hỗ trợ preset để thay đổi mẫu, câu lệnh, thuật ngữ hoặc phương pháp. Bạn cũng có thể ghi đè một mẫu riêng trong từng dự án mà không cần thay đổi toàn bộ hệ thống.
Nếu quy trình có sẵn chưa đủ, bạn có thể thêm command qua extension, kết nối quy trình với coding agent qua integration, hoặc tự kết hợp các thành phần nhỏ thành quy trình riêng.
E.Tự động hóa các bước lặp lại
Workflow có thể tự động hóa prompt, command, quality gate và tác vụ shell. Workflow overlay cho phép sửa một workflow đã cài mà không cần fork. Workflow step cho phép bổ sung hành vi thực thi có thể dùng lại.
Với nhóm phát triển, bundle còn giúp đóng gói extension, preset, workflow và workflow step thành một bộ cài đặt dùng chung cho một vai trò hoặc cả đội.
F.Làm việc với nhiều coding agent và nguồn riêng
Spec Kit có integration để kết nối hoặc chuyển đổi giữa các coding agent được hỗ trợ. Công cụ cũng có catalog để tìm component cộng đồng, hoặc dùng catalog riêng đã được tổ chức kiểm duyệt.
Nếu cần làm việc offline hoặc sau tường lửa, tài liệu dự án có cơ chế cho local source và self-hosted catalog. Tuy vậy, README nhắc rằng component cộng đồng không phải là bản kiểm toán hay sự chứng thực. Bạn nên xem code nguồn trước khi cài hoặc chạy.
II.Cần chuẩn bị gì
- Hệ điều hành Linux, macOS hoặc Windows.
- Python phiên bản 3.11 trở lên.
uv.- Một coding agent được Spec Kit hỗ trợ. Ví dụ trong README dùng GitHub Copilot.
- Nếu dùng coding agent hoặc integration yêu cầu khóa truy cập riêng, bạn cần chuẩn bị theo hướng dẫn của integration đó. README được cung cấp không liệt kê cụ thể từng khóa hay biến môi trường.
README không yêu cầu GPU, cơ sở dữ liệu, Node.js hay phần cứng đặc biệt. README cũng không nói rõ giới hạn chi phí của coding agent, vì vậy chi phí có thể phụ thuộc vào dịch vụ agent và tài khoản bạn đang dùng.
III.Cài đặt từng bước
- Chuẩn bị môi trườngCài Python 3.11+, uv và một coding agent được hỗ trợ
- Cài Specify CLIDùng uv để cài gói specify-cli
- Tạo dự ánKhởi tạo dự án mới với integration copilot
- Mở dự ánChuyển terminal vào thư mục dự án
- Chạy quy trìnhMở coding agent và gửi từng skill trong cửa sổ chat
A.Chuẩn bị Python, uv và coding agent
Cài Python 3.11 trở lên trên Linux, macOS hoặc Windows. Sau đó cài uv theo tài liệu của uv và bảo đảm lệnh uv có thể chạy trong terminal.
README chỉ xác nhận cần Python 3.11+, uv và coding agent được hỗ trợ. README không đưa ra lệnh cài Python hoặc uv, nên bạn không nên tự đoán một lệnh duy nhất cho mọi hệ điều hành.
Trên Windows, hãy mở PowerShell hoặc terminal mà bạn thường dùng để chạy công cụ phát triển. Trên Linux và macOS, mở Terminal. Coding agent cần được cài và đăng nhập theo hướng dẫn riêng của agent đó.
B.Cài Specify CLI
Chạy lệnh sau trong terminal:
uv tool install specify-cliLệnh này cài gói Python specify-cli dưới dạng công cụ của uv. Nếu terminal báo không tìm thấy uv, hãy kiểm tra lại bước chuẩn bị môi trường. Nếu lệnh cài xong nhưng terminal chưa nhận lệnh specify, hãy mở một cửa sổ terminal mới để nạp lại PATH.
README không yêu cầu bạn tạo virtual environment thủ công cho lệnh này. Không tự đổi tên gói thành tên khác, vì tên được README ghi là specify-cli.
C.Tạo dự án mới với GitHub Copilot
Chạy:
specify init my-project --integration copilotLệnh này khởi tạo một dự án tên my-project và chọn integration copilot. Bạn có thể thay my-project bằng tên thư mục dự án của mình, nhưng nên dùng tên không có khoảng trắng để tránh lỗi khi gõ lệnh.
README đưa ví dụ với GitHub Copilot. Nếu bạn dùng coding agent khác, cần xem danh sách integration và cú pháp invocation tương ứng trong tài liệu dự án. Không nên tự thay copilot bằng một giá trị chưa được integration hỗ trợ.
D.Đi vào thư mục dự án
Sau khi khởi tạo, chạy:
cd my-projectTerminal phải đang đứng trong thư mục dự án trước khi bạn chạy các command của Spec Kit hoặc mở coding agent. Người mới thường mở agent ở thư mục cha, khiến agent không thấy các file và thư mục .specify được tạo trong dự án.
E.Mở coding agent và chạy quy trình
Khởi chạy coding agent khi terminal đang ở thư mục my-project. Với GitHub Copilot, gửi từng skill trong cửa sổ chat, mỗi lần một skill, rồi đọc kết quả trước khi sang bước tiếp theo.
Quy trình tối thiểu trong README là:
/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-convergeSkill được gửi trong chat của agent, không phải chạy trong terminal. Hãy xem kết quả của từng skill trước khi gửi skill tiếp theo. Lệnh speckit-constitution thường chỉ tạo một lần cho mỗi dự án; các bước còn lại có thể lặp lại cho từng tính năng.
F.Cài extension sửa lỗi hoặc đánh giá ý tưởng
Nếu dự án cần quy trình sửa lỗi, đứng trong thư mục dự án rồi chạy:
specify extension add bugSau đó gửi trong chat agent:
/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-crashNếu cần đánh giá một ý tưởng, chạy:
specify extension add assessTiếp theo gửi:
/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-modeCác lệnh specify extension add ... chạy trong terminal. Các dòng bắt đầu bằng /speckit- chạy trong chat của coding agent. Đây là điểm dễ nhầm nhất khi mới dùng.
Catalog cộng đồng không phải là bản kiểm toán hay sự chứng thực. Hãy xem code nguồn trước khi cài component. Với coding agent có tính phí, kiểm tra tài khoản và hạn mức riêng trước khi chạy nhiều prompt.
IV.Kiểm tra đã chạy được chưa
Sau bước cài đặt, dấu hiệu đầu tiên là lệnh uv tool install specify-cli hoàn tất mà không báo lỗi. Tiếp theo, specify init my-project --integration copilot phải tạo được thư mục dự án và bạn có thể chạy cd my-project.
Khi mở coding agent trong thư mục dự án, agent phải nhận được các skill của Spec Kit. Với quy trình phát triển tính năng, chạy tiếp đến speckit-converge. Kết quả mong đợi là báo cáo có trạng thái Converged.
Với quy trình sửa lỗi, hãy mở các báo cáo trong .specify/bugs/login-crash/. Chỉ verdict verified mới xác nhận lỗi đã được sửa và kiểm tra thành công.
Với quy trình đánh giá ý tưởng, xem các artifact trong .specify/assessments/offline-mode/ và quyết định cuối cùng. go, needs-clarification và kill đều là kết quả hợp lệ, không phải lỗi cài đặt.
V.Dùng vào việc thật
A.Chủ shop muốn xây công cụ quản lý album ảnh
Chủ shop có nhiều ảnh sản phẩm và muốn một ứng dụng sắp xếp album theo ngày, hiển thị ảnh dạng ô. Thay vì yêu cầu agent viết toàn bộ ứng dụng ngay, hãy dùng flow Spec-Driven Development.
Trong chat agent, gửi đặc tả mẫu:
/speckit-specify Build a photo organizer with albums grouped by date and a tile preview of each album.Sau đó gửi lệnh lập kế hoạch:
/speckit-plan Use Vite with vanilla JavaScript. Keep images local and store metadata in SQLite.Agent sẽ chuyển yêu cầu thành đặc tả và kế hoạch trước khi tạo task, triển khai rồi hội tụ kết quả. Lợi ích là chủ shop hoặc người phụ trách sản phẩm có thể đọc tài liệu để phát hiện thiếu sót trước khi code được viết.
B.Nhân viên văn phòng muốn đánh giá ý tưởng làm việc offline
Một nhóm muốn cho phép người dùng tiếp tục làm việc khi mất mạng rồi đồng bộ khi kết nối lại. Trước khi yêu cầu dev xây chức năng, hãy cài extension assessment và gửi lần lượt các lệnh intake, research, define, shape, decide.
Kết quả được lưu trong .specify/assessments/offline-mode/. Nhóm có thể xem bằng chứng, làm rõ điểm chưa biết và nhận quyết định go, needs-clarification hoặc kill. Cách này giúp tránh đầu tư vào một ý tưởng chưa đủ cơ sở.
C.Dev xử lý lỗi form đăng nhập
Khi gửi mật khẩu rỗng làm form đăng nhập bị crash, dev có thể cài extension bug rồi chạy:
/speckit-bug-assess "Submitting an empty password crashes the login form." slug=login-crashNếu đánh giá đã khoanh vùng được nguyên nhân, tiếp tục:
/speckit-bug-fix slug=login-crash
/speckit-bug-test slug=login-crashSau cùng, đọc báo cáo trong .specify/bugs/login-crash/. Chỉ coi công việc hoàn tất khi kết quả là verified; partial hoặc failed vẫn cần xử lý thêm.
D.Nhóm phát triển muốn thống nhất cách làm
Một đội có yêu cầu riêng về truy vết quy định, cách lập kế hoạch hoặc quality gate. Đội có thể dùng preset để điều chỉnh quy trình hiện có, project-local override cho một dự án riêng, hoặc extension để thêm command.
Nếu cần phân phối trọn bộ cho nhiều thành viên, đội có thể đóng gói extension, preset, workflow và workflow step thành bundle. Khi quy trình hiện tại đã gần phù hợp, nên bắt đầu bằng thay đổi nhỏ thay vì thay thế toàn bộ.
Đặc tả tốt biến cuộc trò chuyện với AI thành một quy trình có thể đọc, kiểm tra và lặp lại.
Ông T
VI.Lỗi hay gặp và cách xử lý
A.Terminal không nhận lệnh uv
Nguyên nhân thường là uv chưa được cài hoặc đường dẫn thực thi chưa có trong PATH. Hãy cài uv theo hướng dẫn phù hợp với hệ điều hành, sau đó mở terminal mới và chạy lại lệnh cài specify-cli.
B.Không nhận lệnh specify
Có thể lệnh cài công cụ chưa hoàn tất hoặc terminal đang dùng PATH cũ. Kiểm tra lại kết quả của uv tool install specify-cli, mở terminal mới và bảo đảm bạn đang dùng đúng môi trường đã cài uv.
C.Chạy skill /speckit-... trong terminal
Các skill như /speckit-specify, /speckit-plan và /speckit-implement phải chạy trong chat của coding agent, không phải trong terminal. Terminal chỉ dùng cho các lệnh như specify init và specify extension add bug.
D.Mở coding agent sai thư mục
Nếu agent được mở ở thư mục cha thay vì thư mục dự án, nó có thể không thấy file và artifact của Spec Kit. Hãy chạy cd my-project trước rồi mới khởi chạy agent.
E.Kết quả hội tụ hoặc kiểm thử chưa đạt
Với SDD, tiếp tục speckit-implement và speckit-converge cho đến khi báo cáo ghi Converged. Với bug fixing, kiểm tra verdict; partial và failed chưa phải xác nhận thành công. Đọc lại artifact và sửa theo báo cáo thay vì bỏ qua kết quả.
VII.Có nên dùng không
Nên dùng nếu bạn làm dự án có nhiều yêu cầu, muốn AI lập trình theo quy trình rõ ràng hoặc cần lưu lại lý do, kế hoạch và kết quả kiểm chứng. Repo cũng đáng cân nhắc cho đội nhóm muốn dùng chung preset, workflow và tiêu chuẩn phát triển.
Điểm mạnh là có nhiều entry point độc lập: xây tính năng, sửa lỗi, đánh giá ý tưởng hoặc tự tạo process. Cấu trúc extension, preset, workflow, bundle và catalog giúp công cụ có thể mở rộng theo tổ chức.
Giới hạn là bạn cần Python 3.11+, uv và một coding agent được hỗ trợ. README không nói cụ thể mọi integration, khóa truy cập, chi phí dịch vụ agent hoặc cách xử lý mọi môi trường. Quy trình nhiều bước cũng đòi hỏi bạn đọc và duyệt kết quả từng giai đoạn, nên không phù hợp nếu chỉ muốn một lệnh ngắn để tạo code ngay.
Nếu dự án nhỏ, yêu cầu đơn giản và bạn không cần tài liệu hóa quyết định, dùng trực tiếp coding agent có thể nhanh hơn. Nếu muốn kiểm soát quy trình, chất lượng và khả năng truy vết lâu dài, Spec Kit là lựa chọn đáng thử. Repo phát hành theo giấy phép MIT.
Câu hỏi thường gặp
Spec Kit có miễn phí không?
Repo phát hành theo giấy phép MIT. Tuy nhiên, README không nêu chi phí của coding agent hoặc các dịch vụ bên ngoài, nên chi phí sử dụng thực tế còn phụ thuộc vào tài khoản và công cụ agent bạn chọn.
Có cần GPU để chạy Spec Kit không?
README không yêu cầu GPU hay phần cứng đặc biệt. Tư liệu chỉ nêu cần Linux, macOS hoặc Windows, Python 3.11+, uv và một coding agent được hỗ trợ.
Spec Kit có chạy được trên Windows không?
Có. README liệt kê Windows cùng với Linux và macOS là các hệ điều hành được hỗ trợ.
Cần cài Node.js không?
README không liệt kê Node.js trong phần yêu cầu của Spec Kit. Một dự án cụ thể có thể chọn công nghệ riêng trong bước lập kế hoạch, nhưng đó là yêu cầu của dự án chứ không phải yêu cầu cài Spec Kit được nêu trong README.
Dữ liệu và source code có an toàn không?
README không đưa ra cam kết chung về việc dữ liệu được xử lý thế nào bởi coding agent. Bạn nên kiểm tra quyền truy cập và chính sách của agent đang dùng; với component cộng đồng, README khuyên xem code nguồn trước khi cài hoặc chạy.
Có dùng Spec Kit với coding agent khác GitHub Copilot được không?
Có. README nói Spec Kit có integration cho các coding agent khác và cung cấp cú pháp invocation tương ứng. Ví dụ cài đặt và skill trong README dùng GitHub Copilot, còn cú pháp agent khác cần xem tài liệu integration.
Có thể dùng Spec Kit cho dự án đã có code không?
Có. README có tài liệu riêng cho existing projects để bắt đầu với code đã có. Phần tư liệu được cung cấp không mô tả chi tiết từng lệnh của quy trình này.


