Spec Kit: Bộ Công Cụ AI Phát Triển Theo Đặc Tả

Tìm Hiểu Spec-Driven Development Với Spec Kit

Spec Kit là cách GitHub triển khai Spec-Driven Development, nơi đặc tả viết ra, chứ không phải code, mới là nguồn thông tin chính xác nhất, và phần triển khai được tạo lại từ đó thay vì được duy trì thủ công sau khi viết. Nó cài Specify CLI vào một dự án và cho AI coding agent của bạn một chuỗi lệnh slash command cố định, từ constitution cho tới implement, biến một đặc tả thành code chạy được theo từng bước.

Chuyển Từ Phát Triển Ưu Tiên Code Sang Ưu Tiên Đặc Tả

Phần lớn các team coi đặc tả là một tài liệu viết một lần, được duyệt xong rồi lặng lẽ bỏ qua ngay khi bắt đầu viết code, nên code trở thành sự thật còn đặc tả thì lỗi thời dần. Tiền đề của Spec Kit là thứ tự đó bị ngược. Thay vì một đặc tả chỉ để hướng dẫn con người, nó coi đặc tả là thứ thực sự được thực thi, với một AI coding agent tạo lại phần triển khai từ đó thay vì một developer dịch nó một lần rồi thôi. Sự khác biệt này rõ nhất khi yêu cầu hay tech stack của dự án thay đổi, vì khi đó đặc tả được cập nhật và code được tạo lại thay vì trôi dần khỏi một tài liệu chẳng ai đọc lại.

Các Lệnh Cốt Lõi Và Khả Năng Mở Rộng

• ✓Bảy lệnh slash command cốt lõi dẫn dắt quy trình làm việc: /speckit.constitution, /speckit.specify, /speckit.plan, /speckit.tasks, /speckit.taskstoissues, /speckit.implement, và /speckit.converge, mỗi lệnh gắn với một agent skill cùng tên.
• ✓Ba lệnh tuỳ chọn thêm các bước kiểm soát chất lượng. /speckit.clarify đánh dấu những phần đặc tả chưa rõ trước khi lập plan, /speckit.analyze kiểm tra tính nhất quán giữa các artifact sau khi tasks được tạo, còn /speckit.checklist tạo các checklist mà README gọi là 'unit tests for English'.
• ✓Extension bổ sung lệnh và template mới cho những gì quy trình core chưa có, cài bằng specify extension add và tìm bằng specify extension search.
• ✓Preset thay đổi cách các lệnh có sẵn hoạt động (định dạng đặc tả, thuật ngữ, chuẩn tổ chức) mà không thêm năng lực mới, cài bằng specify preset add.
• ✓Bundle đóng gói một bộ extension, preset, và quy trình theo vai trò cụ thể trong một file bundle.yml, cài trong một bước bằng specify bundle install.
• ✓Các override cấp dự án trong .specify/templates/overrides/ có độ ưu tiên cao hơn preset và extension, nên một dự án đơn lẻ có thể vá một template mà không cần tạo hẳn một preset.
• ✓Theo README, Spec Kit tích hợp với hơn 30 AI coding agent, gồm cả công cụ CLI và trợ lý tích hợp trong IDE; lệnh specify integration list cho biết phiên bản bạn đang cài hỗ trợ những gì.

Bắt Đầu Với Spec Kit

Spec Kit cần uv và Python 3.11 trở lên trước khi bạn đụng tới CLI. Cài Specify CLI bằng uv tool install specify-cli --from git+https://github.com/github/[email protected], thay vX.Y.Z bằng một tag phát hành thật lấy từ trang Releases của repo (giữ nguyên chữ v ở đầu). Gói này cũng có trên PyPI, nên uv tool install specify-cli cũng chạy được. Sau khi cài xong, specify init my-project --integration copilot tạo mới một dự án đã gắn sẵn với AI coding agent bạn chọn. Việc nâng cấp chạy qua specify self check (chỉ đọc, không sửa gì), specify self upgrade --dry-run (chỉ xem trước), và specify self upgrade (nâng cấp tại chỗ, tự nhận diện bạn dùng uv tool hay pipx); ghim một phiên bản cụ thể bằng specify self upgrade --tag vX.Y.Z[suffix]. Biến SPECIFY_UPGRADE_TIMEOUT_SECS giới hạn thời gian subprocess nâng cấp đó được phép chạy.

Quy Trình Làm Việc Spec-Driven Development

Quy trình làm việc chạy theo một thứ tự cố định sau khi bạn mở AI coding agent trong thư mục dự án. /speckit.constitution chạy đầu tiên và thiết lập các nguyên tắc quản trị dự án, những thứ như chất lượng code, chuẩn testing, tính nhất quán UX, và yêu cầu hiệu năng, mà các bước sau phải tôn trọng. /speckit.specify sau đó lấy một mô tả bằng ngôn ngữ tự nhiên về tính năng bạn muốn, tập trung vào ý định và lý do; chi tiết triển khai để sau. /speckit.plan thêm phần kỹ thuật: framework, thư viện, lựa chọn kiến trúc. /speckit.tasks biến plan đó thành một danh sách task cụ thể, còn /speckit.implement thực thi danh sách đó để dựng tính năng ra. /speckit.converge quay lại sau cùng, so sánh codebase với spec/plan/tasks và thêm phần việc còn thiếu thành task mới. Hầu hết agent expose các lệnh này dưới dạng slash command /speckit.*; một số integration dùng tiền tố $speckit-* thay vào đó khi chạy ở skills mode, theo README.

Các Cách Tiếp Cận Phát Triển Phần Mềm Có Hỗ Trợ AI

Câu Hỏi Thường Gặp

Trường Hợp Sử Dụng Tốt Nhất

• •Các dự án làm mới hoàn toàn, nơi bạn muốn viết đặc tả một lần rồi tạo lại phần triển khai thay vì tự bảo trì thủ công code mà AI agent viết ra từ một prompt dùng một lần.
• •Các team dùng chung một coding agent trên nhiều dự án, muốn một chuỗi constitution, specify, plan, tasks, implement chung thay vì mỗi người prompt một kiểu.
• •Công việc hiện đại hoá hệ thống cũ (brownfield), dùng giai đoạn 'Iterative Enhancement' và hướng dẫn Evolving Specs để tách việc cập nhật đặc tả khỏi việc nâng cấp tooling thường xuyên.
• •Các tổ chức cần đưa yêu cầu tuân thủ vào template đặc tả hoặc plan, thông qua một preset, mà không phải sửa tay các template core trên từng dự án.
• •Thử nhiều cách xây cùng một tính năng, vì README liệt kê 'Creative Exploration' (triển khai song song trên nhiều tech stack khác nhau) là một trong ba giai đoạn phát triển của nó.

Ai Nên Dùng — Và Ai Nên Bỏ Qua

Hãy thử Spec Kit nếu bạn đã dùng một AI coding agent hàng ngày và muốn một chuỗi lặp lại được (constitution, specify, plan, tasks, implement) thay vì prompt tuỳ hứng, đặc biệt nếu team bạn cần preset hoặc extension để áp chuẩn riêng. Bỏ qua nếu bạn chỉ cần gợi ý code nhanh ngay trong editor: Spec Kit thêm vào một CLI, một bộ template, và một chuỗi lệnh nhiều bước, tốn công hơn mức cần thiết cho những thay đổi nhỏ, một lần.

Repo liên quan