← Trang chủ

ĐÃ REVIEW & SẴN SÀNG CÀI ĐẶT

Spec Kit

github/spec-kit

Spec Kit là bộ công cụ mã nguồn mở của GitHub, buộc trợ lý lập trình AI (Claude Code, GitHub Copilot, Cursor, Gemini CLI, Codex và hơn 40 công cụ khác) làm theo quy trình: viết đặc tả, lập kế hoạch, chia việc, viết code rồi tự đối chiếu code với đặc tả. Có thêm tiện ích sửa lỗi và đánh giá ý tưởng. Miễn phí, giấy phép MIT.

TỪNG BƯỚC

Hướng dẫn cài đặt Spec Kit

Hướng dẫn từng bước nằm ngay trên trang này, viết cho người chưa từng cài phần mềm từ GitHub.

Cập nhật 21/11/2026
Ảnh xem trước của Spec Kit trên GitHub
Sao GitHub
150.949
Ngôn ngữ
Python
Hạng trending
#7
Đã thêm
21/11/2026

Cách cài đặt Spec Kit từng bước

Làm lần lượt từ trên xuống. Mỗi khung chữ xám là một lệnh: chép nguyên dòng, dán vào cửa sổ dòng lệnh rồi nhấn Enter.

Chưa từng dùng dòng lệnh? Đọc phần này trước (1 phút)

Dòng lệnh (Terminal) là một cửa sổ để gõ lệnh cho máy tính. Bạn không cần hiểu lệnh, chỉ cần chép đúng và dán vào.

  1. Windows: nhấn phím Windows, gõ "PowerShell", rồi nhấn Enter.
  2. macOS: nhấn Command + Space, gõ "Terminal", rồi nhấn Enter.
  3. Linux: nhấn Ctrl + Alt + T.
  4. Chép một lệnh trong hướng dẫn, bấm chuột phải vào cửa sổ vừa mở để dán (macOS: Command + V), rồi nhấn Enter.
  5. Chờ lệnh chạy xong (con trỏ nhấp nháy trở lại ở dòng mới) rồi mới làm lệnh tiếp theo.

Dòng bắt đầu bằng dấu # chỉ là ghi chú, không cần chép. Nếu hiện chữ đỏ báo lỗi, xem mục lỗi thường gặp ở cuối hướng dẫn.

1. Spec Kit là gì?

Spec Kit là bộ công cụ mã nguồn mở của chính GitHub, giúp trợ lý lập trình AI (Claude Code, GitHub Copilot, Cursor, Gemini CLI, Codex...) làm việc theo quy trình thay vì đoán ý bạn rồi viết code ngay. Cách làm chính của nó gọi là Spec-Driven Development (phát triển theo đặc tả): bạn mô tả cần làm gì và để làm gì trước, AI viết thành bản đặc tả (spec), rồi mới lập kế hoạch kỹ thuật, chia việc, viết code và tự đối chiếu code với đặc tả.

Spec Kit gồm hai phần: một chương trình dòng lệnh tên Specify (dùng để tạo dự án và cài các lệnh vào trợ lý AI) và bộ lệnh /speckit-... mà bạn gõ trong khung chat của trợ lý. Ngoài quy trình làm tính năng mới, còn có hai tiện ích kèm theo: sửa lỗi có kiểm chứng và đánh giá xem một ý tưởng có đáng làm không.

Dự án miễn phí, giấy phép MIT. Bản 1.0 ra ngày 21/8/2026; bản mới nhất lúc viết bài là v1.4.3, phát hành ngày 19/11/2026.

Nói thẳng: đây là công cụ cho người đang dùng AI để làm phần mềm. Spec Kit không có cửa sổ ứng dụng riêng, không tự viết code. Nó chạy bên trong một trợ lý lập trình AI mà bạn đã có.

Hợp với bạn nếu:

  • Bạn đã dùng một trợ lý lập trình AI và hay gặp cảnh nó hiểu sai yêu cầu, làm thiếu tính năng hoặc làm lan man.
  • Bạn muốn làm một ứng dụng nhỏ đến vừa mà có giấy tờ rõ ràng: đặc tả, kế hoạch, danh sách việc, để quay lại sửa sau vẫn hiểu.
  • Bạn làm nhóm, mỗi người dùng một trợ lý AI khác nhau nhưng muốn chung một quy trình.

Chưa hợp nếu:

  • Bạn chưa dùng trợ lý lập trình AI nào. Hãy cài một công cụ như Claude Code hoặc GitHub Copilot trước.
  • Bạn chỉ sửa một dòng hay hỏi nhanh vài câu. Quy trình nhiều bước sẽ thấy thừa.
  • Bạn không muốn đọc lại những gì AI viết. Giá trị của Spec Kit nằm ở chỗ bạn duyệt từng bước.

2. Cần chuẩn bị gì?

  • Máy tính Windows, macOS hoặc Linux. Trên Windows chạy được trực tiếp bằng PowerShell, không cần WSL.
  • Python 3.11 trở lên (ngôn ngữ lập trình mà Specify được viết bằng nó). Tải ở https://www.python.org/downloads/ . Kiểm tra bằng lệnh python --version.
  • uv (công cụ cài chương trình Python của hãng Astral, nhanh và không làm rối Python sẵn có trên máy). Cách cài ở Bước 1.
  • Một trợ lý lập trình AI đã cài và đăng nhập được. Spec Kit có sẵn kết nối cho hơn 40 công cụ, trong đó có Claude Code, GitHub Copilot, Cursor, Gemini CLI, Codex CLI, Antigravity, opencode, Qwen Code, Kiro CLI, Trae và Zed. Tài khoản và chi phí là của công cụ đó.
  • Git (phần mềm lưu lịch sử thay đổi code, https://git-scm.com/downloads) là tùy chọn, chỉ cần khi bạn bật tiện ích git để mỗi tính năng có một nhánh riêng.

Lưu ý: Spec Kit không cần khóa API riêng. Mọi việc viết đặc tả và viết code đều do trợ lý AI của bạn làm, nên tốn lượt dùng hoặc token của trợ lý đó.

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

Bước 1: Cài uv

Windows (gõ trong PowerShell):

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Hoặc nếu máy có WinGet:

winget install --id=astral-sh.uv -e

macOS / Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Máy Mac có Homebrew cũng có thể dùng brew install uv.

Cài xong, đóng cửa sổ dòng lệnh và mở cửa sổ mới, rồi gõ:

uv --version

Thấy gì là đúng: một dòng bắt đầu bằng uv và số phiên bản, ví dụ uv 0.12.10.

Bước 2: Cài Specify CLI

uv tool install specify-cli

Lệnh này tải gói specify-cli chính thức từ PyPI (kho gói Python) và cài thành lệnh specify dùng được ở mọi thư mục. Kiểm tra:

specify version

Thấy gì là đúng: Specify in ra số phiên bản đang cài (bản mới nhất lúc viết bài là 1.4.3).

Trang hướng dẫn cài đặt chính thức khuyên dùng cách cài từ mã nguồn trên GitHub, ghim đúng một bản phát hành (ví dụ bản mới nhất lúc viết bài). Hai cách đều được hỗ trợ:

uv tool install specify-cli --from git+https://github.com/github/spec-kit.git@v1.4.3

Lưu ý: Nếu máy dùng pipx thay cho uv, lệnh tương đương là pipx install specify-cli. Hãy dùng một cách thôi, cài bằng hai công cụ sẽ ra hai bản specify đè nhau.

Bước 3: Tạo dự án mới và chọn trợ lý AI

Đi tới thư mục bạn muốn để dự án, rồi gõ lệnh ứng với trợ lý bạn dùng. Ví dụ với Claude Code:

specify init du-an-cua-toi --integration claude

Đổi chữ sau --integration cho đúng công cụ của bạn:

Trợ lý AIGiá trị --integration
Claude Codeclaude
GitHub Copilotcopilot
Cursorcursor-agent
Gemini CLIgemini
Codex CLIcodex
Antigravityagy
opencodeopencode
Qwen Codeqwen

Danh sách đầy đủ ở trang chính thức: https://github.github.io/spec-kit/integrations/index.html . Nếu bạn bỏ phần --integration, Specify sẽ hiện danh sách để bạn chọn bằng phím mũi tên.

Specify hỏi thêm "Choose script type (or press Enter)": cứ bấm Enter để nhận mặc định (Windows là ps tức PowerShell, macOS/Linux là sh tức Bash).

Thấy gì là đúng: một khung "Specify Project Setup" ghi tên dự án, hai dòng "Selected coding agent integration" và "Selected script type", sau đó dòng chữ xanh "Project ready.", một khung vàng "Agent Folder Security" khuyên bạn thêm thư mục của trợ lý AI vào .gitignore (để không lỡ đưa thông tin đăng nhập lên mạng), và khung "Next Steps" liệt kê các lệnh: constitution, specify, plan, tasks, implement, converge.

Đi vào thư mục vừa tạo:

cd du-an-cua-toi

Bước 4 (nếu đã có sẵn code): thêm Spec Kit vào dự án đang làm

Mở dòng lệnh ngay trong thư mục dự án, rồi gõ:

specify init --here --integration claude

Nếu thư mục đang có file, Specify hỏi "Template files will be merged with existing content and may overwrite existing files. Do you want to continue?" (file mẫu sẽ được trộn vào và có thể ghi đè file trùng tên). Hãy sao lưu hoặc commit code trước, rồi gõ y và Enter. Muốn bỏ qua câu hỏi này thì thêm --force:

specify init --here --force --integration claude

Thấy gì là đúng: giống Bước 3, kết thúc bằng "Project ready." Trong dự án có thêm thư mục .specify (nguyên tắc dự án, mẫu và script) và thư mục lệnh của trợ lý, ví dụ .claude/skills với Claude Code.

4. Dùng lần đầu

Mở trợ lý AI trong thư mục dự án (ví dụ gõ claude trong thư mục đó). Các lệnh dưới đây gõ vào khung chat của trợ lý, không gõ vào cửa sổ dòng lệnh. Làm từng lệnh một, đọc kết quả rồi mới sang lệnh sau.

Ví dụ làm thử một ứng dụng sắp xếp ảnh:

  1. Đặt nguyên tắc cho dự án (chỉ làm một lần):
/speckit-constitution Ưu tiên code dễ đọc, có kiểm thử, giao diện đơn giản.
  1. Mô tả cần làm gì, chưa nói công nghệ:
/speckit-specify Làm ứng dụng sắp xếp ảnh theo album, album nhóm theo ngày, xem ảnh dạng lưới ô vuông.
  1. Lập kế hoạch kỹ thuật, lúc này mới chọn công nghệ:
/speckit-plan Dùng Vite với JavaScript thuần. Ảnh để trên máy, thông tin album lưu bằng SQLite.
  1. Chia việc rồi làm:
/speckit-tasks
/speckit-implement
  1. Đối chiếu code với đặc tả:
/speckit-converge

Thấy gì là đúng: sau bước 2, trong thư mục specs/ có một thư mục cho tính năng mới với file spec.md. Bước 3 thêm plan.md, bước 4 thêm tasks.md (danh sách việc xếp theo thứ tự phụ thuộc) rồi AI bắt đầu viết code. Lệnh converge nếu còn thiếu sẽ thêm việc vào tasks.md; khi đó chạy lại /speckit-implement và /speckit-converge đến khi nó báo Converged.

Với việc quan trọng, chèn thêm ba bước kiểm tra: /speckit-clarify (AI hỏi lại tối đa 5 câu về chỗ chưa rõ, chạy trước plan), /speckit-checklist (tạo danh sách kiểm tra chất lượng yêu cầu) và /speckit-analyze (soát mâu thuẫn giữa spec, plan và tasks, chạy trước implement; lệnh này chỉ đọc, không sửa file).

Lưu ý: Cách gõ lệnh khác nhau tùy trợ lý. Claude Code, Copilot, Cursor, Antigravity dùng /speckit-specify; Codex dùng $speckit-specify; Gemini CLI dùng /speckit.specify. Khung "Next Steps" ở Bước 3 luôn in đúng cách gõ cho trợ lý bạn đã chọn.

5. Lỗi thường gặp và cách sửa

Dấu hiệuNguyên nhânCách sửa
uv hoặc specify báo "not recognized" / "command not found"Chưa cài, hoặc cửa sổ dòng lệnh mở từ trước khi cài nên chưa nhận đường dẫn mớiĐóng hết cửa sổ dòng lệnh, mở cửa sổ mới rồi gõ lại. Vẫn lỗi thì làm lại Bước 1 hoặc Bước 2
Khung đỏ "Agent Detection Error", ghi "... not found"Specify không tìm thấy chương trình của trợ lý AI bạn chọnCài trợ lý đó theo link Specify in ra. Nếu bạn dùng trợ lý ở máy khác hoặc trong IDE, thêm --ignore-agent-tools vào lệnh init
Khung đỏ "Directory Conflict"Thư mục cùng tên đã tồn tạiĐặt tên dự án khác, hoặc sao lưu rồi thêm --force để trộn vào thư mục cũ
"No such option: --integration"Đang dùng bản Specify quá cũCài lại bản mới: uv tool install --force specify-cli
Gõ /speckit-specify mà trợ lý không hiểuTrợ lý mở ở thư mục khác, hoặc mở từ trước khi chạy initThoát trợ lý, mở lại đúng trong thư mục dự án. Kiểm tra cách gõ lệnh của trợ lý ở mục 4
Cài lại mà specify version vẫn ra số cũMáy có hai bản cài bằng hai công cụ (uv và pipx)Gỡ một bản (mục 6), giữ một cách cài duy nhất

Nếu vẫn lỗi, chạy specify check để xem các công cụ Specify tìm thấy trên máy, rồi tra hoặc báo lỗi tại https://github.com/github/spec-kit/issues .

6. Gỡ cài đặt / cập nhật

Kiểm tra có bản mới không (chỉ đọc, không thay đổi gì):

specify self check

Cập nhật Specify:

specify self upgrade

Trên Windows, lệnh này không tự thay được chính nó; nó in ra một lệnh uv tool install ... --force để bạn chạy sau khi nó kết thúc. Cách thủ công cho mọi máy:

uv tool install --force specify-cli

Cập nhật các lệnh trong dự án (chạy trong thư mục dự án, đổi claude thành trợ lý của bạn):

specify integration upgrade claude

Các đặc tả bạn đã viết trong specs/ không bị đụng tới khi cập nhật.

Gỡ Specify khỏi máy:

uv tool uninstall specify-cli

Gỡ chương trình không xóa các file đã tạo trong dự án. Muốn bỏ Spec Kit khỏi một dự án, xóa thư mục .specify và các thư mục lệnh speckit trong thư mục của trợ lý (ví dụ trong .claude/skills).

7. Câu hỏi hay gặp

Có mất tiền không? Spec Kit miễn phí (MIT). Bạn chỉ trả chi phí của trợ lý AI đang dùng. Quy trình nhiều bước sẽ tốn lượt dùng hơn so với nhờ AI viết thẳng, đổi lại kết quả có kiểm tra.

Tôi không biết lập trình thì có dùng được không? Bạn viết được phần "cần làm gì" bằng lời thường, kể cả tiếng Việt. Nhưng các bước plan, tasks và kết quả code vẫn cần người đọc hiểu đôi chút để duyệt. Spec Kit hợp nhất với người đã quen dùng trợ lý lập trình AI.

Có phải cài lại cho từng dự án không? Lệnh specify chỉ cài một lần trên máy. Mỗi dự án chạy specify init một lần để thêm bộ lệnh.

Dùng nhiều trợ lý AI trong cùng dự án được không? Được. Trong dự án đã init, thêm trợ lý khác, ví dụ Gemini CLI, bằng specify integration install gemini, rồi đặt nó làm mặc định bằng specify integration use gemini. Một số trợ lý (như Antigravity) chưa được nhà phát triển xác nhận là cài chung an toàn; xem trang của từng trợ lý trước.

Ngoài làm tính năng mới còn làm gì? Có tiện ích sửa lỗi (specify extension add bug, rồi /speckit-bug-assess, /speckit-bug-fix, /speckit-bug-test) và tiện ích đánh giá ý tưởng (specify extension add assess), kết thúc bằng quyết định làm, cần làm rõ thêm, hoặc dừng.

GitHot tự viết và kiểm tra lại với tài liệu chính thức của dự án. Thấy bước nào sai hoặc khó hiểu, hãy nhắn cho GitHot qua các kênh ở cuối trang.

XEM TẠI SAO NÓ HOT

Xem review gốc

Quay lại video đã dẫn bạn đến đây.

Xem trên TikTok ↗

Không bỏ lỡ repo tiếp theo

Mỗi repo mới đều có video review kèm hướng dẫn cài đặt tại đây.

Theo dõi trên TikTok ↗

LỊCH SỬ

Đã lên GitHub Trending

  1. Ngày 4/11#7147.099