Superpowers: Framework Phát Triển Agentic
/superpowers
Superpowers là một skills framework buộc coding agent phải đi qua quy trình brainstorm - lập plan - TDD - review thay vì để agent nhảy thẳng vào viết code. Nên dùng nếu bạn chạy Claude Code, Cursor, Codex, hoặc một trong tám harness được hỗ trợ khác và muốn quy trình đó được áp dụng tự động cho mọi task. Bỏ qua nếu harness của bạn không nằm trong danh sách, hoặc bạn muốn giữ quy trình thoải mái hơn.
Superpowers Làm Gì Cho Coding Agent
Superpowers là một agentic skills framework: một thư viện skill kết hợp được với nhau, cộng thêm một bootstrap instruction khiến coding agent tự dùng chúng mà không cần được yêu cầu. Nó dẫn agent từ brainstorm một spec, qua một plan viết sẵn, vào TDD theo chu trình RED-GREEN-REFACTOR và một vòng code review hai giai đoạn trước khi merge. Mười một agent harness cài được framework này, gồm Claude Code, Cursor và Codex.
Các Skill Cốt Lõi và Tự Động Hóa Workflow
- ✓Các skill tự kích hoạt ngay sau khi cài — không cần slash command hay gọi thủ công để bắt đầu pipeline.
- ✓Skill test-driven-development áp chu trình RED-GREEN-REFACTOR và xóa mọi đoạn code viết trước khi có test tương ứng, chứ không chỉ nhắc nhở viết test.
- ✓subagent-driven-development dispatch một subagent mới cho mỗi task, kèm review hai giai đoạn — trước xét spec compliance, sau xét code quality — để một agent không tự chấm điểm bài của chính nó.
- ✓systematic-debugging chạy quy trình 4 phase tìm root cause, gồm các kỹ thuật root-cause-tracing và defense-in-depth, thay vì vá lỗi theo kiểu đoán mò.
- ✓using-git-worktrees tạo một branch tách biệt và xác nhận test baseline sạch trước khi bất kỳ dòng code implementation nào được viết.
- ✓writing-skills là một meta-skill để viết skill mới theo đúng format, dù các maintainer nói họ thường không nhận đóng góp skill mới từ bên ngoài.
Quy Trình Phát Triển Của Superpowers
Workflow chạy theo bảy skill nối tiếp nhau. brainstorming kích hoạt trước tiên, đặt câu hỏi và trình bày thiết kế theo từng đoạn dễ đọc để bạn duyệt. using-git-worktrees sau đó tạo một branch tách biệt và xác nhận test baseline sạch. writing-plans chia thiết kế đã duyệt thành các task 2-5 phút, mỗi task kèm đường dẫn file chính xác và code đầy đủ. Khi bạn nói "go", hoặc subagent-driven-development (subagent mới cho mỗi task, review hai giai đoạn) hoặc executing-plans (chạy theo batch kèm checkpoint do người xác nhận) sẽ thực hiện phần implementation dưới kỷ luật RED-GREEN-REFACTOR của test-driven-development. requesting-code-review kiểm tra từng task so với plan và chặn tiến độ nếu có vấn đề nghiêm trọng. finishing-a-development-branch chạy cuối cùng, xác nhận test và đưa ra lựa chọn merge, tạo PR, giữ nguyên hoặc bỏ branch.
Cài Đặt Superpowers Cho Agent Của Bạn
Cài đặt được tài liệu hóa rõ ràng và khác nhau tùy harness — nếu dùng nhiều hơn một agent, bạn phải cài Superpowers riêng cho từng cái. Với Claude Code, chạy `/plugin install superpowers@claude-plugins-official` từ marketplace chính thức, hoặc đăng ký `/plugin marketplace add obra/superpowers-marketplace` trước để dùng bản community marketplace. Cursor dùng `/add-plugin superpowers` trong Agent chat. Gemini CLI dùng `gemini extensions install https://github.com/obra/superpowers`. Codex CLI, Codex App, Factory Droid, GitHub Copilot CLI và Kimi Code đều cài qua lệnh plugin marketplace riêng của từng bên. Pi cài qua `pi install git:github.com/obra/superpowers`, hoặc load một checkout local bằng `pi -e /path/to/superpowers` khi phát triển. OpenCode yêu cầu fetch hướng dẫn cài từ một raw GitHub URL ngay trong agent.
Điểm mạnh
- ✓Workflow mang tính bắt buộc chứ không phải khuyến nghị: các skill tự kích hoạt, nên bước thiết kế và test không dễ bị bỏ qua giữa chừng như một guideline viết tay.
- ✓Việc ép TDD mang tính cơ chế — skill test-driven-development xóa code viết trước khi có test, chứ không chỉ là một ghi chú về style.
- ✓Review subagent hai giai đoạn (spec compliance rồi tới code quality) bắt lỗi theo từng task thay vì để dồn lại sau một phiên chạy tự động kéo dài nhiều giờ.
- ✓Bao phủ mười một agent harness khác nhau bằng một phương pháp duy nhất, nên một team dùng lẫn Claude Code, Cursor và Codex vẫn chuẩn hóa được cùng một quy trình.
- ✓Giấy phép MIT, miễn phí, kèm lựa chọn trả phí cho Prime Radiant nếu cần hỗ trợ enterprise và quản lý chi tiêu.
Những Điều Cần Lưu Ý Khi Dùng Superpowers
- △Phải cài đặt và cập nhật riêng cho từng harness bạn dùng — không có một lần cài duy nhất bao trùm cả Claude Code, Cursor và các harness còn lại.
- △Project thường không nhận đóng góp skill mới từ bên ngoài, và bất kỳ cập nhật skill nào được chấp nhận cũng phải chạy được trên cả mười một agent được hỗ trợ, khiến phạm vi thay đổi từ cộng đồng bị thu hẹp.
- △Không phải một công cụ độc lập — nó phụ thuộc hoàn toàn vào một trong mười một agent harness được hỗ trợ để chạy được.
- △Tính năng visual companion tùy chọn của skill brainstorming mặc định tải logo Prime Radiant từ website của họ, gửi kèm phiên bản Superpowers đang dùng; đây là cơ chế opt-out qua biến môi trường SUPERPOWERS_DISABLE_TELEMETRY, không phải opt-in.
- △Việc cập nhật, theo README, "phần nào phụ thuộc vào coding agent" — không có một lệnh duy nhất đảm bảo chạy được trên mọi harness.
Các Framework AI Agent Tương Tự
Câu Hỏi Thường Gặp Về Superpowers
Superpowers cài được vào mười một harness: Claude Code, Antigravity, Codex App, Codex CLI, Cursor, Factory Droid, Gemini CLI, GitHub Copilot CLI, Kimi Code, OpenCode và Pi, mỗi cái có bước cài riêng.
Skill test-driven-development chạy RED-GREEN-REFACTOR: viết một test fail, xem nó fail, viết code tối thiểu để pass, refactor rồi commit. Code viết trước khi có test sẽ bị xóa.
Theo README, Superpowers thường không nhận đóng góp skill mới từ bên ngoài, vì mọi cập nhật skill phải chạy được trên toàn bộ các coding agent được hỗ trợ.
Superpowers không thu thập dữ liệu project, prompt hay click. Tính năng visual companion tùy chọn mặc định tải logo từ website Prime Radiant và chỉ gửi phiên bản Superpowers, có thể tắt qua SUPERPOWERS_DISABLE_TELEMETRY.
Superpowers dùng giấy phép MIT, miễn phí cho enterprise. Prime Radiant, đội đứng sau project, cũng cung cấp hỗ trợ thương mại và quản lý chi tiêu có trả phí qua [email protected].
Superpowers được phát hành theo giấy phép MIT, theo file LICENSE trong repo obra/superpowers trên GitHub.
Vấn đề mà nó giải quyết
Coding agent nếu để tự do thường nhảy thẳng vào viết code, lướt qua bước test, và mất phương hướng trong những phiên chạy tự động dài mà không có checkpoint nào bắt phải review. Superpowers nhắm đúng vào kiểu lỗi này: một agent làm việc không giám sát trong vài giờ cần các cổng chặn brainstorm, lập plan, TDD và code review được gắn thẳng vào harness, chứ không thể trông chờ một system prompt lo hết.
Trường hợp sử dụng tốt nhất
- •Các phiên code tự động kéo dài: subagent-driven-development dispatch một subagent mới cho từng task 2-5 phút kèm review hai giai đoạn, đúng như README mô tả là để agent làm việc liên tục vài giờ mà không lệch khỏi plan.
- •Team muốn chuẩn hóa TDD trên nhiều AI coding tool khác nhau, cần cùng một kỷ luật RED-GREEN-REFACTOR được ép buộc thay vì trông chờ vào phán đoán riêng của từng agent.
- •Debug các regression do agent gây ra bằng quy trình 4 phase của systematic-debugging thay vì đoán mò.
- •Dev độc lập muốn có một bước thiết kế bắt buộc trước khi viết code, qua vòng review spec theo từng đoạn nhỏ của brainstorming.
Nên thử — và nên bỏ qua nếu
Thử Superpowers nếu bạn đã dùng Claude Code, Cursor, Codex, Gemini CLI, hoặc một trong các harness được hỗ trợ khác và muốn brainstorm, lập plan, TDD và review trở thành bắt buộc thay vì tùy chọn. Bỏ qua nếu harness của bạn không có trong danh sách, bạn không muốn phải cài và cập nhật riêng cho từng harness, hoặc bạn muốn đóng góp skill tùy biến ngược lại project — vì project thường không nhận.
Repo liên quan
Chưa chắc superpowers có hợp với bạn?
Để ChatGPT, Claude hoặc Perplexity tìm hiểu giúp — bấm bên dưới và xem AI nói gì về superpowers.