Spec Kit vs. Superpowers: So Sánh Toàn Diện và Hướng Dẫn Thực Hành Kết Hợp Cả Hai Trong Lập Trình AI

Trong kỷ nguyên bùng nổ của Trí tuệ Nhân tạo, việc phát triển các ứng dụng AI, đặc biệt là các tác nhân lập trình (AI coding agents), đã trở thành một lĩnh vực trọng tâm. Tuy nhiên, một vấn đề cố hữu mà nhiều nhà phát triển gặp phải là sự thiếu cấu trúc trong quá trình phát triển này. Các agent AI mạnh mẽ nhưng thường hoạt động một cách rời rạc, dẫn đến khó khăn trong việc quản lý, mở rộng và duy trì.

Bài viết này sẽ đi sâu vào so sánh hai trong số những framework có ảnh hưởng lớn nhất nhằm giải quyết vấn đề trên: Spec Kit của GitHub và Superpowers của Jesse Vincent. Cả hai đều cung cấp các giải pháp để tạo ra mã AI có cấu trúc, hướng tác nhân, nhưng với những triết lý và phương pháp tiếp cận khác biệt rõ rệt. Chúng ta sẽ cùng xem xét từng framework một cách chi tiết, từ triết lý cốt lõi đến kiến trúc, quy trình làm việc và khả năng tương thích. Đặc biệt, bài viết còn cung cấp một hướng dẫn thực tế từng bước về cách kết hợp sức mạnh của cả hai framework này để tối ưu hóa quy trình phát triển AI của bạn.

Giới thiệu chung: Spec Kit và Superpowers là gì?

Để hiểu rõ hơn về cách hai framework này hoạt động, hãy cùng điểm qua định nghĩa cơ bản của chúng:

• github/spec-kit — Đây là bộ công cụ của GitHub dành cho Phát triển hướng đặc tả (Spec-Driven Development – SDD). Mục tiêu của Spec Kit là biến các đặc tả thành mã có thể thực thi được, đảm bảo tính nhất quán và dễ quản lý từ yêu cầu đến sản phẩm cuối cùng.
• obra/superpowers — Được phát triển bởi Jesse Vincent, đây là một khung kỹ năng hướng tác nhân (agentic skills framework), thúc đẩy một quy trình phát triển có kỷ luật dựa trên các agent. Superpowers tập trung vào việc tạo ra các agent có khả năng thực hiện các nhiệm vụ phức tạp một cách tự chủ và có cấu trúc.

Mặc dù cùng giải quyết vấn đề “agent lập trình AI mạnh mẽ nhưng thiếu cấu trúc”, Spec Kit xem đặc tả là nguồn chân lý, trong khi Superpowers coi quy trình phát triển là nguồn chân lý. Sự khác biệt cơ bản này định hình toàn bộ cách thức hoạt động và những lợi ích mà mỗi framework mang lại.

TL;DR: Tóm tắt nhanh về Spec Kit và Superpowers

Dưới đây là bảng tóm tắt nhanh các điểm chính của hai framework để bạn dễ dàng nắm bắt:

Triết lý cốt lõi đằng sau mỗi framework

Spec Kit: “Đặc tả là nguồn chân lý”

Spec Kit đảo ngược quy trình truyền thống: thay vì viết mã theo một đặc tả lỏng lẻo, đặc tả trực tiếp tạo ra bản cài đặt. Các thay đổi xảy ra ở lớp đặc tả trước; mã được tạo lại để phù hợp. Trích dẫn README: “các đặc tả trở nên có thể thực thi, trực tiếp tạo ra các cài đặt hoạt động thay vì chỉ hướng dẫn chúng.”

Các nguyên tắc nền tảng:

• Ý định trước hết — cái gì & tại sao trước khi làm thế nào
• Đặc tả phong phú, có rào chắn với các nguyên tắc tổ chức
• Tinh chỉnh đa bước thay vì tạo một lần
• Quy trình làm việc bản địa AI tận dụng khả năng của mô hình tiên tiến

Superpowers: “Quy trình làm việc là nguồn chân lý”

Superpowers ngăn cản các agent nhảy ngay vào việc viết mã. Nó thực thi một trình tự có kỷ luật: khám phá → xác thực thiết kế → lập kế hoạch → triển khai → đánh giá → hoàn thành. Từ README: “Ngay khi nó thấy bạn đang xây dựng một cái gì đó, nó không chỉ nhảy vào cố gắng viết mã.”

Bốn nguyên tắc cốt lõi:

• Phát triển hướng kiểm thử (Test-Driven Development – TDD) — kiểm thử đi trước mọi mã
• Hệ thống hóa thay vì tùy tiện — quy trình thay thế việc đoán mò
• Giảm độ phức tạp — sự đơn giản là mục tiêu chính
• Bằng chứng thay vì tuyên bố — xác minh trước khi tuyên bố thành công

Điểm khác biệt về triết lý

• Spec Kit là tập trung vào artifact. Đặc tả tồn tại, phát triển và là hợp đồng.
• Superpowers là tập trung vào quy trình. Quy trình tồn tại; artifact là bất cứ thứ gì quy trình tạo ra.

Quy trình làm việc và mô hình tư duy

Quy trình 7 bước của Spec Kit

Spec Kit cung cấp một quy trình tuyến tính, có cấu trúc để dẫn dắt quá trình phát triển:

1. /speckit.constitution — Thiết lập các nguyên tắc quản lý dự án.
2. /speckit.specify — Xác định các yêu cầu và user stories.
3. /speckit.clarify — Làm rõ các yêu cầu chưa được đặc tả đầy đủ.
4. /speckit.plan — Tạo các kế hoạch triển khai kỹ thuật.
5. Xác thực kế hoạch về tính đầy đủ.
6. /speckit.tasks — Tạo ra các phân tích nhiệm vụ có thể thực thi.
7. /speckit.implement — Thực thi các nhiệm vụ để xây dựng tính năng.

Spec Kit hỗ trợ ba chế độ: 0-to-1 (dự án mới), Creative Exploration (triển khai song song trên các stack khác nhau), Iterative Enhancement (cải tiến dự án hiện có).

7 giai đoạn quy trình của Superpowers

Superpowers thúc đẩy một quy trình làm việc có trạng thái và hướng thực thi, với các giai đoạn rõ ràng:

1. Động não (Brainstorming) — Đặt câu hỏi Socratic để tinh chỉnh ý tưởng.
2. Sử dụng Git Worktrees — Các nhánh cô lập với các baseline kiểm thử đã được xác minh.
3. Viết kế hoạch (Writing Plans) — Phân chia công việc thành các nhiệm vụ 2-5 phút với các đặc tả chính xác.
4. Phát triển hướng Subagent (Subagent-Driven Development) — Subagent mới cho mỗi nhiệm vụ, quy trình đánh giá hai giai đoạn.
5. Phát triển hướng kiểm thử (Test-Driven Development – TDD) — Quy tắc nghiêm ngặt RED-GREEN-REFACTOR.
6. Yêu cầu đánh giá mã (Requesting Code Review) — Danh sách kiểm tra trước đánh giá, theo dõi dựa trên mức độ nghiêm trọng.
7. Hoàn thành nhánh phát triển (Finishing Development Branches) — Quyết định hợp nhất/tạo PR + dọn dẹp.

Sự tương phản chính

• Quy trình làm việc của Spec Kit là tuyến tính và tạo tài liệu: mỗi lệnh tạo ra một artifact (constitution, spec, plan, tasks).
• Quy trình làm việc của Superpowers là có trạng thái và tạo thực thi: mỗi giai đoạn thao tác với mã, kiểm thử, nhánh và trạng thái subagent.

Kiến trúc và đơn vị chính

Spec Kit: Lệnh slash và template

Spec Kit hoạt động dựa trên sáu lệnh slash tường minh, do người dùng gọi. Mỗi lệnh là một template tạo ra một artifact có cấu trúc, được lưu trữ dưới thư mục .specify/.

.specify/
├── memory/         # Constitution và quản trị
├── specs/          # Đặc tả tính năng theo ID
├── scripts/        # Các script tự động hóa hỗ trợ
├── extensions/     # Các tiện ích mở rộng tùy chỉnh
├── presets/        # Tùy chỉnh quy trình làm việc
└── templates/      # Các template lệnh

Superpowers: Kỹ năng, agent và plugin

Superpowers có hơn 14 kỹ năng có thể kết hợp, được tổ chức theo danh mục:

• Kiểm thử: test-driven-development
• Gỡ lỗi: systematic-debugging, verification-before-completion
• Hợp tác: brainstorming, writing-plans, executing-plans, dispatching-parallel-agents, requesting-code-review, receiving-code-review, using-git-worktrees, finishing-a-development-branch, subagent-driven-development
• Meta: writing-skills, using-superpowers

agents/        # Định nghĩa agent
skills/        # Triển khai kỹ năng (tự động kích hoạt)
commands/      # Định nghĩa lệnh CLI
.claude-plugin/, .codex-plugin/, .cursor-plugin/   # Cấu hình cho từng host

Mô hình kích hoạt – sự khác biệt sâu sắc nhất

• Spec Kit: con người gõ /speckit.plan. Rõ ràng, có tính xác định.
• Superpowers: kỹ năng tự động kích hoạt khi mô tả của nó phù hợp với tình huống. Agent không quyết định động não; kỹ năng động não kích hoạt vì người dùng đề cập đến một ý tưởng mơ hồ.

Điều này làm cho Spec Kit giống như một CLI bạn điều khiển, còn Superpowers giống như một hệ điều hành mà agent sinh sống.

Khả năng tương thích Agent / Công cụ

Khả năng tích hợp với các agent và công cụ AI khác là một yếu tố quan trọng. Dưới đây là bảng so sánh:

Spec Kit có phạm vi rộng hơn (hơn 30 agent), được chọn tại thời điểm cài đặt thông qua cờ `–integration`. Superpowers đi sâu hơn với từng host, với các gói plugin hạng nhất được tùy chỉnh cho từng hệ sinh thái.

Cài đặt và phân phối

Spec Kit

Spec Kit được cài đặt thông qua trình quản lý gói Python:

uv tool install specify-cli --from git+https://github.com/github/spec-kit.git@vX.Y.Z

• Yêu cầu Python 3.11+, Git, uv hoặc pipx.
• Hỗ trợ đa nền tảng (Linux/macOS/Windows).
• Chỉ phân phối từ GitHub — các gói PyPI có cùng tên không phải là chính thức.

Superpowers

Superpowers được phân phối thông qua các marketplace plugin hoặc luồng cài đặt riêng của từng agent:

• Claude plugin marketplace: /plugin install superpowers@claude-plugins-official
• Đăng ký marketplace Superpowers.
• Luồng cài đặt riêng cho từng agent như Codex, Cursor, OpenCode, Copilot CLI, Gemini CLI.

Tóm lại, Spec Kit là một CLI duy nhất bạn cài đặt một lần và cấu hình cho từng dự án. Superpowers là một plugin bạn cài đặt cho từng host agent, với hệ thống plugin của host quản lý các bản cập nhật.

Tùy chỉnh và khả năng mở rộng

Spec Kit

• Extensions (Tiện ích mở rộng) — thêm các khả năng mới (đồng bộ Jira, đánh giá sau triển khai, v.v.).
• Presets (Cài đặt trước) — tùy chỉnh các quy trình làm việc hiện có (định dạng tuân thủ, bản địa hóa thuật ngữ).
• Hơn 100 tiện ích mở rộng do cộng đồng đóng góp thuộc các danh mục docs, code, process, integration, visibility.

Superpowers

• Skills (Kỹ năng) là đơn vị mở rộng cơ bản — tự viết SKILL.md của riêng bạn với mô tả sẽ kích hoạt trong tình huống của bạn.
• Kỹ năng meta writing-skills dạy agent cách tạo kỹ năng mới.
• using-superpowers tài liệu hóa cách các kỹ năng kết hợp.

So sánh mô hình mở rộng

• Mô hình mở rộng của Spec Kit là hướng danh mục — bạn duyệt và áp dụng các thành phần có sẵn.
• Mô hình mở rộng của Superpowers là hướng tác giả — framework chủ động hỗ trợ bạn viết kỹ năng tiếp theo.

Khi nào mỗi framework phát huy tối đa hiệu quả?

Spec Kit tỏa sáng khi…

• Bạn cần khả năng truy xuất nguồn gốc từ yêu cầu đến mã (kiểm toán, tuân thủ, các ngành công nghiệp được quy định).
• Một quản lý sản phẩm / người không phải kỹ sư sở hữu đặc tả và các kỹ sư sử dụng nó.
• Bạn muốn hoán đổi các stack: tạo lại cùng một đặc tả thành Go, Python, TypeScript.
• Tổ chức của bạn đã quen với việc sử dụng PRD (Product Requirements Document), RFC (Request for Comments) và tài liệu thiết kế.
• Bạn cần quản trị cấp doanh nghiệp với các ràng buộc cấp constitution.

Superpowers tỏa sáng khi…

• Bạn muốn agent chạy tự chủ trong nhiều giờ mà không bị chệch hướng.
• Bạn muốn TDD nghiêm ngặt được tích hợp vào hành vi của agent, không chỉ là hy vọng.
• Bạn đang điều phối các subagent song song và cần các mẫu đánh giá tích hợp.
• Bạn cần hoàn thành dựa trên bằng chứng — agent phải chứng minh nó hoạt động, không phải chỉ tuyên bố.
• Bạn đang hoạt động ở biên giới của quyền tự chủ agent và muốn các rào chắn theo mặc định.

Đánh đổi và hạn chế

Spec Kit

• Chi phí ban đầu cao hơn — viết constitution và đặc tả trước khi có bất kỳ mã nào có vẻ chậm đối với các tác vụ nhỏ.
• Ít phù hợp hơn cho việc thử nghiệm khám phá — quy trình làm việc giả định bạn đã biết đại khái mình muốn gì.
• Rủi ro sai lệch đặc tả — nếu nhóm chỉnh sửa mã mà không cập nhật đặc tả, “nguồn chân lý duy nhất” sẽ bị xói mòn.
• Nặng về tài liệu — tạo ra nhiều artifact markdown cần được bảo trì.

Superpowers

• Có tính chủ quan — quy trình làm việc giả định bạn muốn TDD, worktrees, điều phối subagent; nếu không, ma sát sẽ cao.
• Ngưỡng phức tạp — ngay cả các tác vụ nhỏ cũng phải chịu một số chi phí thủ tục.
• Đường cong học tập — hơn 14 kỹ năng và một kho từ vựng meta (subagent-driven-development, verification-before-completion) cần thời gian để tiếp thu.
• Tự động kích hoạt có thể gây bất ngờ — một kỹ năng kích hoạt bất ngờ có thể làm chệch hướng một phiên nếu mô tả lỏng lẻo.

Giải pháp: Cách chúng có thể cùng tồn tại và phát huy sức mạnh tổng hợp

Điều quan trọng cần nhấn mạnh là hai framework này không loại trừ lẫn nhau. Một nhóm hoàn toàn có thể:

• Sử dụng Spec Kit cho cái gì — constitution, spec, plan, tasks được commit vào repo như các artifact bền vững.
• Sử dụng Superpowers cho cách thức — một khi các nhiệm vụ tồn tại, các kỹ năng TDD, worktree, subagent và đánh giá của Superpowers sẽ thực thi chúng.

Các artifact mà Spec Kit tạo ra (ví dụ: .specify/specs/<id>/tasks.md) chính xác là loại kế hoạch mà kỹ năng executing-plans của Superpowers được thiết kế để tiêu thụ. Hai hệ thống này nhắm mục tiêu vào các lớp khác nhau của cùng một vấn đề, tạo nên một sự kết hợp mạnh mẽ.

Hướng dẫn thực hành tốt nhất để kết hợp cả hai

Mô hình tư duy cốt lõi

Mô hình tư duy trong một câu: Spec Kit lập kế hoạch CÁI GÌ cần xây dựng. Superpowers kiểm soát CÁCH THỨC nó được xây dựng.

Spec Kit cung cấp cho bạn các artifact bền vững, dễ đọc bởi con người (constitution → spec → plan → tasks). Superpowers nhận các nhiệm vụ đó và thực thi chúng với TDD, worktrees, subagents và đánh giá được tích hợp sẵn. Bạn chuyển giao tại danh sách nhiệm vụ.

Cài đặt một lần (cho mỗi máy + mỗi repo)

Trên máy của bạn:

1. Cài đặt Spec Kit:

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

2. Cài đặt Superpowers trong host agent của bạn. Đối với Claude Code:

   
   /plugin install superpowers@claude-plugins-official
       

Trong repo của bạn (một lần):

1. Khởi tạo Spec Kit với agent của bạn: specify init --integration claude-code (hoặc bất kỳ agent nào bạn sử dụng).
2. Chạy /speckit.constitution một lần để đặt các quy tắc toàn dự án. Thêm một dòng duy nhất để kết nối hai hệ thống:
   

   “Việc triển khai bất kỳ danh sách nhiệm vụ nào PHẢI tuân theo quy trình làm việc của Superpowers: worktree → TDD (red-green-refactor) → thực thi hướng subagent → đánh giá mã → hoàn thành nhánh.”

3. Commit .specify/ vào repo. Thêm .claude/ (hoặc thư mục plugin của host của bạn) theo chính sách của nhóm bạn.

Đó là toàn bộ quá trình cài đặt. Từ đây trở đi, mỗi tính năng sẽ tuân theo cùng một vòng lặp.

Quy trình theo từng tính năng (quy trình bạn thực sự sử dụng)

Chạy các bước này theo thứ tự. Mỗi bước là một lệnh duy nhất hoặc một prompt ngắn gọn.

Vậy là xong. Spec Kit phụ trách các bước 2–5. Superpowers phụ trách các bước 1, 6–9. Quá trình chuyển giao xảy ra tại tasks.md.

Hai quy tắc không hiển nhiên giúp sự kết hợp này hiệu quả

Quy tắc 1 — Đừng bỏ qua /speckit.tasks, ngay cả khi bạn bị cám dỗ.
Kỹ năng executing-plans của Superpowers được thiết kế để tiêu thụ các nhiệm vụ nhỏ (2-5 phút). Lệnh /speckit.tasks của Spec Kit tạo ra chính xác hình dạng đó. Bỏ qua nó sẽ buộc Superpowers phải chia nhỏ công việc tại thời điểm thực thi, điều này chậm hơn và chất lượng thấp hơn.

Quy tắc 2 — Đừng để Superpowers lập kế hoạch lại những gì Spec Kit đã lập kế hoạch.
Khi bạn bắt đầu bước 7, hãy nói rõ ràng: “Kế hoạch đã có trong specs/<id>/tasks.md. Đừng lập kế hoạch lại — hãy thực thi.” Nếu không, kỹ năng writing-plans của Superpowers có thể tự động kích hoạt và trùng lặp công việc.

Mẫu prompt một dòng cho việc chuyển giao thực thi

Dán dòng này khi bạn đã sẵn sàng chuyển từ Spec Kit (lập kế hoạch) sang Superpowers (thực thi):

Execute specs/<feature-id>/tasks.md using the Superpowers workflow:
create a worktree, follow strict TDD per task, dispatch one subagent per
task, run code review at the end, then finish the branch. Do not re-plan —
the task list is the contract.

Khi nào nên giảm quy mô (đừng quá phức tạp hóa công việc nhỏ)

Đối với một sửa lỗi một dòng hoặc một lỗi chính tả, cả hai framework đều là quá mức cần thiết. Dưới đây là giới hạn kích thước hợp lý:

Các anti-pattern cần tránh

• ❌ Chạy /speckit.implement VÀ Superpowers. Chọn một cái để thực thi. /speckit.implement là trình thực thi riêng của Spec Kit; Superpowers thay thế nó cho sự kết hợp này.
• ❌ Chỉnh sửa mã mà không cập nhật đặc tả. Nếu thực tế khác với spec.md, dấu vết kiểm toán của bạn sẽ mất giá trị. Chạy lại /speckit.specify cho khu vực đã thay đổi.
• ❌ Để subagent đọc toàn bộ cây .specify/. Chỉ chuyển cho chúng nhiệm vụ cụ thể mà chúng đang thực thi — kỷ luật ngữ cảnh vẫn quan trọng.
• ❌ Bỏ qua constitution. Nếu không có nó, Superpowers và Spec Kit mỗi cái sẽ áp đặt các giá trị mặc định riêng của chúng và bạn sẽ cảm thấy ma sát.

Danh sách kiểm tra nhanh 60 giây trước khi bắt đầu bất kỳ tính năng nào

1. Có đặc tả không? Nếu không → /speckit.specify.
2. Các nhiệm vụ có nhỏ và có thứ tự không? Nếu không → /speckit.tasks.
3. Tôi có đang ở trên một worktree với các kiểm thử màu xanh không? Nếu không → kích hoạt using-git-worktrees.
4. Tôi đã nói với agent “đừng lập kế hoạch lại, hãy thực thi” chưa? Nếu không → nói ngay bây giờ.
5. Tôi sẽ tự mình xem xét diff PR trước khi hợp nhất chứ? Nếu không → dừng lại.

Nếu cả năm đều là có, bạn đang sử dụng combo này một cách chính xác.

Hướng dẫn quyết định nhanh chóng

Chọn Spec Kit nếu bạn…

• Muốn các đặc tả là các artifact bền vững, có thể đánh giá được.
• Cần khả năng di động giữa các stack (tái tạo cùng một đặc tả → ngôn ngữ khác).
• Làm việc trong một môi trường mà PRD/RFC đã là tiêu chuẩn.
• Đề cao khả năng tương thích agent rộng rãi (hơn 30 công cụ).
• Muốn một dự án được GitHub hỗ trợ, thân thiện với doanh nghiệp.

Chọn Superpowers nếu bạn…

• Muốn chính agent hoạt động giống như một kỹ sư cao cấp hơn.
• Cần TDD nghiêm ngặt, cách ly worktree, điều phối subagent sẵn có.
• Chạy các phiên tự chủ dài và cần các rào chắn.
• Ưu tiên các kỹ năng tự động kích hoạt hơn các lệnh do người dùng gọi.
• Muốn một hệ thống kỹ năng có thể viết, kết hợp mà bạn có thể tự mở rộng.

Chọn cả hai nếu bạn…

• Muốn lập kế hoạch hướng artifact + thực thi hướng quy trình làm việc.
• Sẵn sàng đầu tư vào thiết lập để có một quy trình tổng thể chặt chẽ hơn.

Tóm tắt tổng quan

Để kết thúc, dưới đây là bảng tóm tắt tổng quan các đặc điểm chính của Spec Kit và Superpowers:

Bài viết được tạo vào ngày 25 tháng 4 năm 2026. Cả hai dự án đang phát triển nhanh chóng — hãy xác minh các chi tiết cụ thể theo phiên bản so với README của chúng trước khi áp dụng.

Nếu bạn thấy bài viết này hữu ích, hãy để lại 👍 hoặc bình luận! Hoặc nếu bạn nghĩ bài viết này có thể giúp ích cho ai đó, đừng ngần ngại chia sẻ nhé! Cảm ơn bạn rất nhiều! 😃