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

github/spec-kit: chuẩn hoá quy trình phát triển bằng AI — hướng dẫn cài đặt và dùng

12 phút đọcCập nhật

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 →

github/spec-kit: chuẩn hoá quy trình phát triển bằng AI — hướng dẫn cài đặt và dùng

Tóm tắt nhanh

Spec Kit là toolkit mã nguồn mở cho coding agent, cung cấp quy trình, mẫu tài liệu và kết quả được ghi lại cho phát triển phần mềm. Bạn có thể dùng nó để xây tính năng theo đặc tả, sửa lỗi hoặc đánh giá ý tưởng. Cài đặt khá gọn nếu máy đã có Python 3.11+, uv và một coding agent được hỗ trợ.

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 sinh mã ngay. Công cụ cung cấp quy trình, mẫu tài liệu và các bước kiểm tra để đi từ ý tưởng đến đặc tả, kế hoạch, nhiệm vụ và mã chạy được.

Repo phù hợp với lập trình viên mới, nhóm phát triển muốn thống nhất cách làm, hoặc người dùng GitHub Copilot và coding agent khác. Điểm đáng giá nhất là bạn có thể ghi lại lý do xây dựng, cách triển khai và kết quả kiểm tra trong các tài liệu của dự án. Repo hiện có khoảng 149611 sao và 13444 fork, dùng giấy phép MIT.

CLI

github/spec-kit

Toolkit giúp coding agent làm việc theo quy trình có cấu trúc: viết đặc tả, lập kế hoạch, sửa lỗi và đánh giá ý tưởng.

★ 150kPythonMIT
Xem repo trên GitHub

I.github/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 mô tả cần xây gì và vì sao trước khi lập kế hoạch kỹ thuật. Coding agent tiếp tục chuyển đặc tả thành kế hoạch, danh sách nhiệm vụ, mã nguồn và bước hội tụ. Cách này hữu ích khi yêu cầu có nhiều chi tiết hoặc cần để người khác xem lại trước khi viết mã.

Quy trình tối thiểu gồm tạo constitution một lần cho dự án, sau đó lặp các bước specify, plan, tasks, implement và converge cho từng tính năng. Kết quả không chỉ là mã nguồn mà còn có các tài liệu giải thích phạm vi và quyết định triển khai.

B.Sửa lỗi có đánh giá nguyên nhân

Bạn không cần chạy toàn bộ quy trình phát triển tính năng để sửa một lỗi. Extension bug-fixing cho phép đánh giá nguyên nhân, giới hạn phạm vi sửa, thực hiện thay đổi và kiểm tra lại triệu chứng ban đầu.

Báo cáo được lưu trong thư mục .specify/bugs/<slug>/. Kết quả cuối cùng có thể là verified, partial hoặc failed; chỉ verified mới xác nhận lỗi đã được sửa thành công.

C.Đánh giá ý tưởng trước khi đầu tư

Extension assessment giúp biến một ý tưởng chưa rõ thành quyết định có căn cứ. Quy trình thu thập thông tin, làm rõ vấn đề, định hình phương án và kết luận go, needs-clarification hoặc kill.

Đây là lựa chọn thực tế cho nhóm sản phẩm muốn kiểm tra một ý tưởng trước khi giao việc xây dựng. Báo cáo nằm trong .specify/assessments/<slug>/, nên nhóm có thể xem lại các giả định và điểm chưa chắc chắn.

D.Kết nối nhiều coding agent

Spec Kit có cơ chế integration để kết nối hoặc chuyển đổi giữa các coding agent. README dùng GitHub Copilot làm ví dụ và lưu ý rằng agent khác cần cú pháp gọi tương đương.

Điều này giúp quy trình và tài liệu dự án không bị gắn cứng vào một agent duy nhất. Tuy vậy, tên integration và cú pháp cụ thể của agent khác cần xem trong tài liệu integration của repo.

E.Mở rộng bằng extension, preset và workflow

Extension có thể thêm một lệnh, quality gate, quy trình hoàn chỉnh hoặc kết nối với công cụ bên ngoài. Preset cho phép điều chỉnh template, câu lệnh, thuật ngữ hoặc phương pháp làm việc.

Workflow dùng để tự động hoá prompt, command, gate và tác vụ shell. Bạn có thể dùng overlay để chỉnh một workflow đã cài mà không cần fork. Bundle cho phép đóng gói extension, preset, workflow và workflow step thành một bộ thiết lập có thể dùng lại cho vai trò hoặc nhóm.

F.Dùng catalog riêng hoặc làm việc trong môi trường hạn chế

Spec Kit hỗ trợ catalog cộng đồng và catalog được tổ chức tự quản lý. Bạn có thể tìm extension, preset, workflow hoặc bundle bằng các lệnh specify ... search tương ứng.

Repo cũng có tài liệu cho catalog riêng, xác thực, nguồn cục bộ và môi trường offline hoặc sau firewall. README cảnh báo rằng danh sách catalog không phải kiểm toán hay chứng nhận. Bạn nên xem mã nguồn của thành phần cộng đồng trước khi cài hoặc chạy.

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

Bạn cần các thành phần sau:

  • Python phiên bản 3.11 trở lên.
  • uv, công cụ được README yêu cầu để cài Specify CLI.
  • Một coding agent được Spec Kit hỗ trợ.
  • Máy chạy Linux, macOS hoặc Windows.

Ví dụ trong README dùng GitHub Copilot. README không yêu cầu API key, GPU, cơ sở dữ liệu hay phần cứng đặc biệt nào. README cũng không đưa ra chi tiết chi phí của coding agent hoặc các dịch vụ bên ngoài.

Repo có file pyproject.toml khai báo gói Python tên specify-cli. Nếu bạn muốn xem thêm thông tin cài đặt, bản phát hành cố định, installer khác, CI hoặc xử lý sự cố, hãy xem tài liệu Installation trong repo. README không chép lệnh cài uv, nên cần cài uv theo tài liệu chính thức tương ứng trước.

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

  1. Chuẩn bị môi trườngCài Python 3.11+, uv và một coding agent được hỗ trợ
  2. Cài Specify CLICài gói specify-cli bằng uv
  3. Tạo dự ánKhởi tạo dự án mẫu với integration của GitHub Copilot
  4. Mở coding agentChạy agent trong thư mục dự án
  5. Chọn quy trìnhDùng các skill trong khung chat của agent và xem lại từng kết quả

A.Chuẩn bị terminal và công cụ nền

Mở Terminal, PowerShell hoặc ứng dụng dòng lệnh trên máy. Bạn cần bảo đảm Python đạt phiên bản 3.11 trở lên, đã cài uv và có coding agent được hỗ trợ.

README chỉ nói cần uv và dẫn tới tài liệu cài đặt uv; không ghi một lệnh cài uv cụ thể. Vì vậy, không nên tự đoán tên gói hoặc cờ lệnh. Nếu uv chưa được nhận diện, hãy cài theo tài liệu uv rồi mở lại terminal.

B.Cài Specify CLI

Chạy đúng lệnh sau:

Terminal
uv tool install specify-cli

Lệnh này cài gói Python specify-cli bằng uv dưới dạng công cụ dòng lệnh. Nếu terminal báo không tìm thấy uv, vấn đề nằm ở bước chuẩn bị môi trường, không phải ở tên gói.

README không nói cần tạo virtual environment thủ công cho lệnh này. Bạn cũng không cần tự thêm API key vì tài liệu không yêu cầu biến môi trường nào trong quy trình cài đặt mẫu.

C.Tạo dự án Spec Kit

Trong terminal, chạy:

Terminal
specify init my-project --integration copilot
cd my-project

Lệnh đầu khởi tạo dự án tên my-project và chọn integration copilot. Lệnh thứ hai chuyển terminal vào thư mục dự án vừa tạo.

Bạn có thể đổi my-project thành tên thư mục muốn dùng. Nếu terminal đang ở thư mục không có quyền ghi, hãy chuyển sang nơi bạn có thể tạo dự án rồi chạy lại. README không yêu cầu clone repo trước khi dùng CLI; quy trình mẫu bắt đầu bằng lệnh specify init.

D.Mở coding agent trong thư mục dự án

Sau khi chạy cd my-project, hãy khởi động coding agent trong chính thư mục đó. README không đưa một lệnh khởi động cụ thể cho GitHub Copilot, nên không nên tự bịa thêm câu lệnh.

Điểm dễ nhầm là các skill dưới đây được chạy trong khung chat của coding agent, không phải trong terminal. Mỗi skill nên chạy một lần, sau đó bạn xem lại kết quả trước khi chuyển sang skill tiếp theo.

E.Chạy quy trình Spec-Driven Development

Đây là chuỗi lệnh mẫu trong chat của GitHub Copilot:

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 speckit-constitution tạo các nguyên tắc cho dự án. Lệnh speckit-specify mô tả tính năng cần xây. Lệnh speckit-plan đưa ra ràng buộc kỹ thuật. Hai lệnh tasks và implement lần lượt tạo nhiệm vụ và triển khai. Cuối cùng, converge kiểm tra mức độ hoàn thiện.

README yêu cầu lặp lại implement và converge cho đến khi kết quả hội tụ báo Converged. Nếu dùng agent khác, hãy tìm cú pháp gọi tương đương trong tài liệu integration; không mặc định rằng các slash command trên sẽ dùng nguyên trạng.

F.Cài thêm quy trình sửa lỗi hoặc đánh giá ý tưởng

Để cài extension sửa lỗi, chạy trong terminal và từ thư mục dự án:

Terminal
specify extension add bug

Để cài extension đánh giá ý tưởng, chạy:

Terminal
specify extension add assess

Hai lệnh trên cài thêm quy trình khi cần. Bạn không cần cài cả hai nếu chỉ muốn dùng Spec-Driven Development.

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

Có thể kiểm tra theo các dấu hiệu sau:

  • Lệnh uv tool install specify-cli chạy hoàn tất mà không báo lỗi cài đặt.
  • Lệnh specify init my-project --integration copilot tạo được thư mục dự án.
  • Lệnh cd my-project đưa terminal vào đúng thư mục mới tạo.
  • Coding agent mở trong thư mục dự án và nhận được các skill /speckit-....
  • Sau chuỗi SDD, bước hội tụ báo Converged.
  • Với quy trình sửa lỗi, báo cáo trong .specify/bugs/login-crash/ có verdict verified mới được xem là sửa thành công.
  • Với quy trình đánh giá ý tưởng, báo cáo trong .specify/assessments/offline-mode/ có quyết định go, needs-clarification hoặc kill.

Bạn nên xem lại kết quả sau từng skill. Spec Kit được thiết kế để người dùng kiểm tra các tài liệu trung gian, không phải bấm một lệnh duy nhất rồi chấp nhận toàn bộ mã mà agent tạo ra.

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

A.Chủ shop muốn làm công cụ quản lý ảnh sản phẩm

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. Sau khi mở coding agent trong thư mục dự án, có thể bắt đầu bằng prompt mẫu:

text
/speckit-specify Build a photo organizer with albums grouped by date and a tile preview of each album.

Sau đó dùng /speckit-plan để nêu công nghệ và cách lưu metadata, rồi chạy tasks, implement và converge. Kết quả mong đợi là đặc tả, kế hoạch, danh sách nhiệm vụ và các lần kiểm tra hội tụ được ghi lại trong dự án.

B.Nhân viên văn phòng muốn kiểm tra một ý tưởng nội bộ

Một nhóm muốn cho phép người dùng làm việc offline rồi đồng bộ khi kết nối lại. Có thể cài extension assessment và chạy lần lượt:

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

Kết quả nằm trong .specify/assessments/offline-mode/. Nhóm có thể quyết định go, yêu cầu làm rõ thêm với needs-clarification, hoặc dừng với kill thay vì vội giao việc phát triển.

C.Dev xử lý lỗi form đăng nhập

Khi nhập mật khẩu rỗng làm form đăng nhập bị crash, dev có thể cài extension bug rồi dùng:

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

Cách này tạo quy trình riêng cho việc đánh giá nguyên nhân, sửa lỗi và kiểm tra. Dev cần xem thư mục .specify/bugs/login-crash/ và chỉ coi lỗi đã giải quyết khi verdict cuối là verified.

D.Nhóm kỹ thuật muốn thống nhất cách làm

Một nhóm có tiêu chuẩn kiểm thử, khả năng bảo trì hoặc yêu cầu quản trị riêng có thể bắt đầu bằng constitution. Sau đó nhóm có thể dùng preset để điều chỉnh template, thuật ngữ hoặc phương pháp.

Nếu cần tự động hoá nhiều command và kiểm tra, nhóm có thể xem workflow. Nếu cần chia sẻ một bộ thiết lập gồm extension, preset, workflow và workflow step, nhóm có thể đóng gói thành bundle. Đây là cách mở rộng dần, bắt đầu từ thay đổi nhỏ thay vì thay toàn bộ quy trình.

Hãy để coding agent tạo mã sau khi cả nhóm đã thống nhất đặc tả, kế hoạch và cách kiểm tra.

Ông T

Catalog cộng đồng không phải là kiểm toán hay chứng nhận. Hãy xem mã nguồn trước khi cài hoặc chạy extension, preset, workflow hay bundle. Không đưa key hoặc dữ liệu nhạy cảm vào prompt nếu chưa hiểu rõ cách integration xử lý chúng.

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

A.Terminal không nhận diện uv

Nguyên nhân thường là uv chưa được cài hoặc terminal chưa nhận đường dẫn mới. README chỉ yêu cầu có uv và không cung cấp lệnh cài cụ thể. Hãy cài theo tài liệu uv, mở lại terminal rồi chạy lại uv tool install specify-cli.

B.Python không đủ phiên bản

pyproject.toml yêu cầu Python >=3.11. Nếu máy dùng bản thấp hơn, hãy chuyển sang Python 3.11 trở lên trước khi cài. Không nên tự sửa điều kiện phiên bản trong repo vì có thể làm công cụ chạy không đúng.

C.Chạy slash command trong terminal

Các lệnh như /speckit-specify và /speckit-plan được chạy trong chat của coding agent, không phải terminal. Trong terminal chỉ chạy các lệnh CLI như specify init hoặc specify extension add bug.

D.Dùng cú pháp Copilot cho agent khác

README dùng GitHub Copilot làm ví dụ. Agent khác có cú pháp invocation tương đương nhưng không nhất thiết dùng nguyên các slash command. Hãy xem tài liệu integration và command invocation trước khi chạy.

E.Tin ngay vào thành phần trong catalog

Catalog giúp tìm extension, preset, workflow và bundle nhưng danh sách không phải chứng nhận an toàn. Hãy kiểm tra mã nguồn cộng đồng trước khi cài hoặc chạy. Với catalog riêng hoặc môi trường offline, đọc thêm tài liệu về nguồn cục bộ, catalog tự host và xác thực.

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

Spec Kit đáng dùng nếu bạn muốn coding agent làm việc có quy trình, có tài liệu trung gian và có bước kiểm tra. Nó bao phủ ba nhu cầu rõ ràng: xây tính năng theo đặc tả, sửa lỗi có xác minh và đánh giá ý tưởng trước khi đầu tư. Cơ chế extension, preset, workflow và bundle cũng phù hợp với nhóm muốn chuẩn hoá cách làm theo thời gian.

Việc cài đặt tương đối gọn: cần Python 3.11+, uv, một coding agent được hỗ trợ và một hệ điều hành Linux, macOS hoặc Windows. Giấy phép MIT cũng thuận lợi cho việc xem xét và sử dụng mã nguồn.

Giới hạn là README không mô tả chi tiết mọi integration, không đưa lệnh cài uv, không nêu yêu cầu API key, chi phí agent, GPU hoặc chính sách xử lý dữ liệu. Các quy trình mẫu cũng giả định bạn có coding agent để chạy skill trong chat. Nếu bạn chỉ cần một câu trả lời nhanh, một script nhỏ hoặc không muốn duy trì tài liệu đặc tả, quy trình này có thể nhiều bước hơn nhu cầu.

Tóm lại, hãy chọn Spec Kit khi vấn đề của bạn là thiếu cấu trúc và thiếu khả năng truy vết trong quá trình dùng AI để phát triển phần mềm. Hãy bắt đầu bằng một dự án nhỏ, chạy từng skill, xem lại từng kết quả và chỉ mở rộng sang extension hoặc workflow khi quy trình cơ bản đã phù hợp.

3.9/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?

Repo là mã nguồn mở và dùng giấy phép MIT. Tuy nhiên README không nêu chi phí của coding agent hoặc dịch vụ bên ngoài, nên chưa thể kết luận toàn bộ quy trình không phát sinh chi phí.

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

Có. README nêu các hệ điều hành được hỗ trợ gồm Linux, macOS và Windows. Bạn vẫn cần Python 3.11+, uv và một coding agent được hỗ trợ.

Có cần GPU hoặc API key không?

README không yêu cầu GPU hay API key trong quy trình cài đặt mẫu. Tài liệu chỉ yêu cầu Python 3.11+, uv và coding agent; yêu cầu riêng của agent khác chưa được nêu.

Có thể dùng Spec Kit với coding agent khác GitHub Copilot không?

Có khả năng, vì README có mục dành cho other agents và cơ chế integration. Tuy nhiên cú pháp gọi skill phải xem trong tài liệu integration tương ứng, không nên mặc định dùng nguyên slash command của Copilot.

Dữ liệu và code có an toàn không?

README không đưa ra cam kết chung về cách coding agent xử lý dữ liệu. Repo cảnh báo catalog cộng đồng không phải kiểm toán hay chứng nhận, vì vậy bạn nên xem mã nguồn trước khi cài hoặc chạy thành phần bên ngoài.

Spec Kit có bắt buộc dùng toàn bộ quy trình Spec-Driven Development không?

Không. README mô tả xây tính năng, sửa lỗi và đánh giá ý tưởng là các điểm bắt đầu độc lập. Bạn có thể cài extension bug hoặc assess khi cần, hoặc tự điều chỉnh quy trình bằng preset và extension.

Khác gì so với việc chỉ đưa prompt cho coding agent?

README mô tả Spec Kit là bộ quy trình, template và kết quả được ghi lại cho coding agent. Nó bổ sung các bước đặc tả, lập kế hoạch, tạo nhiệm vụ, kiểm tra hội tụ hoặc đánh giá nguyên nhân, nhưng README không đưa so sánh trực tiếp với công cụ cụ thể nào.

Chuyển nhanh tới mục

  1. I.github/spec-kit làm được gì
    1. A.Xây tính năng theo đặc tả
    2. B.Sửa lỗi có đánh giá nguyên nhân
    3. C.Đánh giá ý tưởng trước khi đầu tư
    4. D.Kết nối nhiều coding agent
    5. E.Mở rộng bằng extension, preset và workflow
    6. F.Dùng catalog riêng hoặc làm việc trong môi trường hạn chế
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Chuẩn bị terminal và công cụ nền
    2. B.Cài Specify CLI
    3. C.Tạo dự án Spec Kit
    4. D.Mở coding agent trong thư mục dự án
    5. E.Chạy quy trình Spec-Driven Development
    6. F.Cài thêm quy trình sửa lỗi hoặc đánh giá ý tưởng
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Chủ shop muốn làm công cụ quản lý ảnh sản phẩm
    2. B.Nhân viên văn phòng muốn kiểm tra một ý tưởng nội bộ
    3. C.Dev xử lý lỗi form đăng nhập
    4. D.Nhóm kỹ thuật muốn thống nhất cách làm
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Terminal không nhận diện uv
    2. B.Python không đủ phiên bản
    3. C.Chạy slash command trong terminal
    4. D.Dùng cú pháp Copilot cho agent khác
    5. E.Tin ngay vào thành phần trong catalog
  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ỏ.