Superpowers: đưa coding agent vào quy trình có kiểm soát

Superpowers là bộ kỹ năng và phương pháp cho coding agent: làm rõ yêu cầu, duyệt thiết kế, lập kế hoạch rồi mới triển khai. Dự án hỗ trợ nhiều harness như Claude Code, Codex, Cursor và Gemini CLI.

Bạn yêu cầu coding agent: “Làm tính năng đăng nhập”. Agent có thể bắt đầu tạo file và sửa luồng xác thực ngay — trước cả khi biết dự án đang phân quyền thế nào, người dùng cần kiểu đăng nhập nào, hay ràng buộc của hệ thống hiện có.

Đó là vấn đề của kiểu làm việc “chat rồi sinh code”: AI viết nhanh, nhưng không tự động hiểu đúng bài toán.

Superpowers là một framework kỹ năng và phương pháp phát triển phần mềm dành cho coding agent. Mục tiêu của dự án là đưa agent qua một quy trình rõ ràng hơn: làm rõ nhu cầu, chốt thiết kế, lập kế hoạch, rồi mới triển khai và kiểm tra.

Không phải model mới, mà là quy trình cho agent

Superpowers không thay thế các công cụ như Claude Code, Codex, Cursor hay Gemini CLI. Dự án được cài dưới dạng plugin hoặc extension vào các môi trường này — README gọi chúng là các harness.

Luồng cơ bản được mô tả như sau:

Brainstorming: agent đặt câu hỏi để hiểu điều bạn muốn xây dựng và lý do. Agent trình bày lại phần đã hiểu để bạn sửa hoặc xác nhận. Sau khi thiết kế được duyệt, agent lập kế hoạch triển khai. Khi bạn cho phép bắt đầu, agent thực hiện các đầu việc, kiểm tra và review theo kế hoạch.

Với thay đổi nhỏ, việc thống nhất có thể diễn ra ngay trong chat. Với dự án lớn hơn, agent có thể tạo tài liệu thiết kế trước khi lập kế hoạch.

README cũng cho biết Superpowers nhấn mạnh các nguyên tắc phát triển quen thuộc:

TDD red/green YAGNI (You Aren’t Gonna Need It) DRY

Điểm đáng chú ý không phải lời hứa “AI tự code hàng giờ”, mà là các điểm dừng để con người xem và duyệt yêu cầu, thiết kế, kế hoạch trước khi agent đi xa hơn.

Cài vào harness bạn đang dùng

Superpowers hỗ trợ nhiều coding harness, gồm Claude Code, Codex App, Codex CLI, Cursor, Gemini CLI, GitHub Copilot CLI, Devin CLI, Qwen Code, OpenCode, Pi, Muse và một số công cụ khác.

Bạn cần cài riêng Superpowers cho từng harness đang sử dụng.

Claude Code

Có thể cài từ marketplace chính thức:

bash /plugin install superpowers@claude-plugins-official

Hoặc thêm marketplace của Superpowers:

bash /plugin marketplace add obra/superpowers-marketplace

Sau đó cài plugin:

bash /plugin install superpowers@superpowers-marketplace

Codex CLI

Mở giao diện tìm plugin:

bash /plugins

Tìm superpowers, rồi chọn Install Plugin.

Cursor

Trong Cursor Agent chat, README ghi lệnh:

text /add-plugin superpowers

Gemini CLI

Cài extension từ repository:

bash gemini extensions install https://github.com/obra/superpowers

Cập nhật về sau:

bash gemini extensions update superpowers

Lưu ý: cài ở Claude Code không đồng nghĩa Superpowers tự xuất hiện trong Cursor, OpenCode hay harness khác.

Thử bằng một yêu cầu thật

README đưa ví dụ với Muse: sau khi cài plugin và khởi động một phiên mới, hãy gửi:

text Let's make a react todo list

Nếu cài đặt hoạt động, kỹ năng brainstorming sẽ tự kích hoạt trước khi code được viết.

Khi áp dụng vào công việc hằng ngày, hãy cho agent đủ bối cảnh thay vì chỉ yêu cầu “viết luôn”. Chẳng hạn:

text Tôi muốn thêm <tính năng> cho <sản phẩm>. Người dùng chính là <nhóm người dùng>. Luồng hiện tại: <mô tả ngắn>. Ràng buộc kỹ thuật: <stack, quy ước, hệ thống liên quan>.

Đừng viết code ngay. Hãy làm rõ yêu cầu, đề xuất thiết kế để tôi duyệt, rồi mới lập kế hoạch triển khai.

Một yêu cầu cụ thể hơn có thể là:

text Tôi muốn thêm chức năng xuất dữ liệu cho một trang nội bộ. Dữ liệu cần tuân theo quyền truy cập hiện có.

Đừng viết code ngay. Hãy nêu các câu hỏi còn thiếu, rồi đề xuất thiết kế ngắn để tôi duyệt.

Mục tiêu là chuyển câu hỏi từ “đoạn code này có chạy không?” sang một câu hỏi sớm hơn: “Agent có hiểu đúng bài toán không?”

Khi nào cách làm này hữu ích?

Superpowers phù hợp với những công việc cần nhiều quyết định kỹ thuật, chẳng hạn:

Thêm tính năng vào codebase đã có quy ước. Sửa lỗi cần tái hiện và kiểm thử. Làm MVP nhưng muốn kiểm soát phạm vi. Làm quen với dự án lạ, nơi agent cần hỏi thêm bối cảnh. Chia một công việc lớn thành kế hoạch và đầu việc cụ thể.

Theo README, sau khi thiết kế được phê duyệt và người dùng cho phép triển khai, hệ thống có thể dùng quy trình dựa trên subagent: các agent xử lý từng nhiệm vụ kỹ thuật, kiểm tra và review công việc trước khi tiếp tục.

Tự động không có nghĩa là không cần duyệt

README cho biết các kỹ năng có thể tự kích hoạt, nên người dùng không nhất thiết phải gọi từng skill thủ công. Nhưng việc tự động kích hoạt không thay thế quyết định của người dùng.

Một vài điểm nên kiểm tra trong quá trình làm việc:

Duyệt thiết kế trước khi cho triển khai. Xem kế hoạch có phù hợp với phạm vi yêu cầu hay không. Đọc các thay đổi và kiểm thử quan trọng. Dùng workspace hoặc branch riêng cho thay đổi đáng kể.

README cho biết workflow có bước using-git-worktrees sau khi thiết kế được duyệt. Bước này tạo một workspace cô lập trên branch mới.

Dự án cũng có lưu ý riêng cho Hermes Agent: công cụ này không có hook sau khi phiên làm việc bị nén ngữ cảnh. Vì vậy, ở một phiên rất dài, bootstrap có thể không còn hiệu lực; README khuyến nghị bắt đầu phiên mới nếu kỹ năng không còn tự kích hoạt.

Checklist để thử ngay

[ ] Chọn đúng harness và cài plugin cho chính harness đó. [ ] Bắt đầu bằng một việc nhỏ nhưng có yêu cầu cần làm rõ. [ ] Để agent hỏi và đề xuất thiết kế trước khi viết code. [ ] Duyệt kế hoạch trước khi cho agent triển khai. [ ] Kiểm tra thay đổi và kiểm thử trước khi merge. [ ] Cân nhắc dùng worktree hoặc branch riêng cho thay đổi lớn.

Superpowers không biến coding agent thành kỹ sư hoạt động độc lập hoàn toàn. Nhưng dự án đưa vào một nhịp làm việc thường bị bỏ qua khi dùng AI viết code: hiểu yêu cầu, giải thích phương án và chờ phê duyệt trước khi triển khai.