Bắt Đầu Với Superpowers

Cài đặt một lần. Thay đổi cách AI của bạn hoạt động mãi mãi.

Superpowers Là Gì? (Kỹ Thuật)

Superpowers là một agentic skills framework — một bộ giao thức hành vi có cấu trúc mà bạn tải vào một AI coding agent. Framework này được tạo bởi Jesse Vincent, được biết đến nhiều nhất với tư cách là tác giả của Request Tracker, một trong những hệ thống theo dõi issue được triển khai rộng rãi nhất trong lịch sử.

Framework này định nghĩa cách một AI agent nên suy nghĩ và hành xử trong quá trình phát triển phần mềm — không chỉ là viết code gì, mà còn khi nào nên dừng lại và hỏi, cách lập kế hoạch, cách xác minh, và cách biết khi nào một việc thực sự hoàn thành.

Về mặt kỹ thuật, Superpowers là một tập hợp các skill (còn gọi là plugin hoặc rule, tùy thuộc vào nền tảng của bạn). Mỗi skill là một bộ hướng dẫn tập trung kích hoạt trong các điều kiện cụ thể. Khi bạn cài đặt Superpowers vào công cụ AI của mình, bạn đang cung cấp cho nó một bộ kỷ luật kỹ thuật phần mềm chuyên nghiệp được xây dựng dưới dạng giao thức có thể đọc được bởi máy.

Triết Lý Cốt Lõi

Superpowers được xây dựng dựa trên ba nguyên tắc xuyên suốt mọi skill:

1. TDD Trước (Test-Driven Development)

Không có code production nào được viết mà không có một failing test trước. Đây không phải là hướng dẫn — đây là quy tắc được thực thi. AI phải viết một test bị thất bại trước khi viết bất kỳ implementation nào. Nếu bạn cảm thấy muốn bỏ qua bước này, Superpowers yêu cầu rõ ràng bạn phải xóa bất kỳ code nào được viết mà không có test và bắt đầu lại.

Tại sao điều này quan trọng: Các test được viết sau code có xu hướng kiểm tra những gì code thực sự làm, không phải những gì nó nên làm. Các test được viết trước nắm bắt được ý định và phát hiện các giả định sớm.

2. YAGNI (You Aren't Gonna Need It)

Chỉ xây dựng những gì được yêu cầu rõ ràng. Không có các abstraction suy đoán, không có "future-proofing", không có các tùy chọn cấu hình thêm "phòng khi cần". Mỗi phần thêm vào codebase đều có chi phí bảo trì. Superpowers giữ cho AI tập trung vào nhiệm vụ hiện tại.

3. Evidence Over Claims

Thấy một test pass là bằng chứng. Nói nó nên hoạt động là tuyên bố. Superpowers yêu cầu AI tạo ra output thực tế — kết quả test thực, output lệnh thực, file diff thực — trước khi khẳng định rằng bất cứ điều gì đã hoàn thành. "Nó nên hoạt động" không phải là một tuyên bố hoàn thành được chấp nhận.

Cài Đặt

Superpowers hoạt động trên nhiều nền tảng. Chọn công cụ của bạn:

Claude Code

/plugin install superpowers@claude-plugins-official

Cài đặt đầy đủ bộ skill Superpowers vào phiên Claude Code của bạn. Các skill kích hoạt tự động dựa trên context.

Cursor

/add-plugin superpowers

Sau khi thêm plugin, Cursor sẽ tải các định nghĩa skill. Bạn có thể cần khởi động lại phiên Cursor.

Gemini CLI

gemini extensions install superpowers

Làm theo các lời nhắc để ủy quyền extension. Tất cả các skill sẽ có sẵn trong phiên Gemini CLI tiếp theo của bạn.

Codex

Thêm Superpowers như một custom instruction set thông qua file cấu hình Codex. Tham khảo tài liệu chính thức Codex để biết đường dẫn cài đặt plugin.

OpenCode

opencode plugin add superpowers

Các skill tải tự động khi khởi động phiên.

Xác Minh Cài Đặt

Sau khi cài đặt, hãy hỏi AI agent của bạn:

"What Superpowers skills are available?"

Một bộ Superpowers được cài đặt đúng cách sẽ liệt kê các skill đang hoạt động. Bạn sẽ thấy các skill bao gồm brainstorming, writing-plans, executing-plans, test-driven-development, và các skill khác.

Nếu agent không nhận ra các skill, hãy chạy lại lệnh cài đặt và khởi động lại phiên.

Quy Trình Làm Việc 7 Bước Cốt Lõi

Sau khi cài đặt, Superpowers hướng dẫn quá trình phát triển qua một quy trình 7 bước có cấu trúc. Đây là tổng quan ngắn gọn — mỗi bước có chương riêng dành riêng.

Bước	Skill	Mô tả
1	BRAINSTORM	Khám phá không gian vấn đề
2	ISOLATE	Tạo môi trường làm việc an toàn
3	PLAN	Viết danh sách nhiệm vụ chi tiết
4	EXECUTE	Triển khai với subagent
5	TEST	TDD cycle: Red → Green → Done
6	REVIEW	Cổng kiểm tra chất lượng 2 giai đoạn
7	COMPLETE	Bàn giao đã được xác minh

Bước 1: Brainstorming

AI khám phá vấn đề cùng bạn trước khi chạm vào bất kỳ code nào. Nó đặt câu hỏi làm rõ từng câu một, trình bày 2–3 cách tiếp cận với các đánh đổi, và chờ sự phê duyệt của bạn. Một hard gate ngăn code được viết cho đến khi thiết kế được phê duyệt.

→ Được trình bày chi tiết trong Brainstorming & Design

Bước 2: Isolation

Công việc diễn ra trong một git worktree — một bản sao biệt lập của repository. Các thay đổi được chứa đựng cho đến khi chúng được merge một cách có chủ ý. Branch chính của bạn luôn an toàn.

→ Được đề cập như một phần của quy trình execution

Bước 3: Viết Kế Hoạch

Trước khi bắt đầu thực thi, một kế hoạch triển khai chi tiết được tạo ra. Mỗi nhiệm vụ trong kế hoạch là độc lập, với các đoạn code hoàn chỉnh, đường dẫn file chính xác, và các lệnh chính xác. Kế hoạch được xem xét và phê duyệt.

→ Được trình bày chi tiết trong Viết Kế Hoạch

Bước 4: Execution & Subagent

Các nhiệm vụ từ kế hoạch được giao cho các tiến trình subagent mới — các AI instance biệt lập không có bộ nhớ về các nhiệm vụ trước đó. Điều này ngăn lỗi từ một nhiệm vụ này làm ô nhiễm nhiệm vụ tiếp theo. Mỗi nhiệm vụ hoàn thành đều đi qua một quy trình review hai giai đoạn.

→ Được trình bày chi tiết trong Execution & Subagent

Bước 5: Test-Driven Development

Mỗi tính năng bắt đầu với một failing test. Chu kỳ RED-GREEN-REFACTOR được tuân theo chặt chẽ. Không có tính năng nào được đánh dấu là hoàn thành mà không chạy bộ test và thấy output thực tế đã pass.

→ Được trình bày chi tiết trong Test-Driven Development

Bước 6: Review

Một quy trình review hai giai đoạn kiểm tra cả sự tuân thủ spec (chúng ta có xây dựng những gì được yêu cầu không?) và chất lượng code (code có thể bảo trì và đúng không?). Hai mối quan tâm này được đánh giá riêng biệt.

→ Một phần của chương Execution & Subagent

Bước 7: Hoàn Thành

Sau khi tất cả các cổng xác minh vượt qua, agent trình bày một báo cáo hoàn thành sạch, giúp tạo một pull request, và đảm bảo công việc được tích hợp đúng cách. Không có gì là "xong" cho đến khi nó được chứng minh là xong.

→ Được đề cập trong tài liệu skill finishing-a-development-branch

Tham Khảo Nhanh: Các Lệnh Chính

Hành Động	Nói gì với AI của bạn
Bắt đầu một tính năng mới	"I want to add [feature]. Use the brainstorming skill."
Viết một kế hoạch	"We've agreed on the design. Write an implementation plan."
Thực thi một kế hoạch	"Execute this plan using subagents."
Chạy TDD	"Implement [feature] using test-driven development."
Review công việc	"Review this implementation before we complete."

Hướng dẫn này đi qua từng bước của quy trình làm việc một cách chi tiết. Các chương được thiết kế để đọc theo thứ tự trong lần đầu tiên, sau đó dùng làm tài liệu tham khảo.

Brainstorming & Design — Hard gate bảo vệ bạn khỏi code quá sớm
Viết Kế Hoạch — Cách biến thiết kế thành các nhiệm vụ có thể thực thi
Execution & Subagent — Chạy kế hoạch một cách an toàn với context isolation
Test-Driven Development — Iron law của việc bàn giao dựa trên bằng chứng

Nhớ rằng: Superpowers không phải về việc làm chậm lại. Nó là về việc dừng chu kỳ tốn kém của viết → phá vỡ → sửa → phá vỡ lại. Kỷ luật upfront tiết kiệm bội số thời gian về sau.