Siêu năng lực

Superpowers là một phương pháp phát triển phần mềm hoàn chỉnh dành cho tác nhân mã hóa của bạn, được xây dựng dựa trên một tập hợp các kỹ năng tổng hợp và một số hướng dẫn ban đầu để đảm bảo rằng tác nhân của bạn sử dụng chúng.

Mục lục

• Nó hoạt động như thế nào
• Dịch vụ thương mại
• Bắt đầu
  • Claude Code
  • phản trọng lực
  • Ứng dụng Codex
  • Codex CLI
  • Cursor
  • Devin CLI
  • Nhà máy Droid
  • Gemini CLI
  • GitHub Copilot CLI
  • Grok Bản dựng CLI
  • Mã Kimi
  • Mã mở
  • Pi
  • Đại lý Hermes
• Quy trình làm việc cơ bản
• cộng đồng
• Có gì bên trong
• Triết học
• Đóng góp
• Đang cập nhật
• Giấy phép
• Đo từ xa đồng hành trực quan

Nó hoạt động như thế nào

Nó bắt đầu từ thời điểm bạn kích hoạt tác nhân mã hóa của mình. Ngay khi nó thấy rằng bạn đang xây dựng một cái gì đó, nó không chỉ cần nhảy vào cố gắng viết mã. Thay vào đó, nó lùi lại và hỏi bạn thực sự đang cố gắng làm gì.

Sau khi đưa ra một thông số nào đó trong cuộc trò chuyện, nó sẽ hiển thị thông số đó cho bạn theo từng đoạn đủ ngắn để thực sự đọc và hiểu.

Sau khi bạn đã ký vào thiết kế, người đại diện của bạn sẽ đưa ra một kế hoạch triển khai đủ rõ ràng để một kỹ sư cấp dưới nhiệt tình, có gu thẩm mỹ kém, không có khả năng phán xét, không có bối cảnh dự án và không thích thử nghiệm để làm theo. Nó nhấn mạnh TDD màu đỏ/xanh lục thực sự, YAGNI (Bạn sẽ không cần nó) và DRY.

Tiếp theo, khi bạn nói "đi", nó sẽ khởi chạy một phát triển theo hướng đại lý phụ quy trình, yêu cầu các đại lý thực hiện từng nhiệm vụ kỹ thuật, kiểm tra và xem xét công việc của họ và tiếp tục chuyển tiếp. Không có gì lạ khi đại diện của bạn làm việc tự chủ trong vài giờ mỗi lần mà không đi chệch khỏi kế hoạch bạn đã đặt ra.

Còn nhiều thứ nữa nhưng đó là cốt lõi của hệ thống. Và vì các kỹ năng được kích hoạt tự động nên bạn không cần phải làm gì đặc biệt. Tác nhân mã hóa của bạn chỉ có Siêu năng lực.

Dịch vụ thương mại

Nếu bạn đang sử dụng Siêu năng lực trong doanh nghiệp và có thể hưởng lợi từ hỗ trợ thương mại, công cụ bổ sung hoặc chi tiêu được quản lý, vui lòng liên hệ với chúng tôi theo địa chỉ [email protected].

Cài đặt

Việc lắp đặt khác nhau tùy theo dây nịt. Nếu bạn sử dụng nhiều hơn một, hãy cài đặt Siêu năng lực riêng cho từng cái.

Claude Code

Siêu năng lực có sẵn thông qua thị trường plugin Claude chính thức

Thị trường chính thức

• Cài đặt plugin từ thị trường chính thức của Anthropic:

  /plugin install superpowers@claude-plugins-official
  

Thị trường siêu năng lực

Thị trường Siêu năng lực cung cấp Siêu năng lực và một số plugin liên quan khác cho Claude Code.

• Đăng ký thị trường:

  /plugin marketplace add obra/superpowers-marketplace
  

• Cài đặt plugin từ thị trường này:

  /plugin install superpowers@superpowers-marketplace
  

phản trọng lực

Cài đặt Superpowers làm plugin từ kho lưu trữ này:

agy plugin install https://github.com/obra/superpowers

AntiGravity chạy hook bắt đầu phiên của plugin, vì vậy Siêu năng lực sẽ hoạt động ngay từ tin nhắn đầu tiên. Cài đặt lại bằng lệnh tương tự để cập nhật.

Ứng dụng Codex

Siêu năng lực có sẵn thông qua thị trường plugin Codex chính thức.

• Trong ứng dụng Codex, nhấp vào Plugin ở thanh bên.
• Bạn nên xem Superpowers trong phần Mã hóa.
• Bấm vào + bên cạnh Siêu năng lực và làm theo lời nhắc.

Codex CLI

Siêu năng lực có sẵn thông qua thị trường plugin Codex chính thức.

• Mở giao diện tìm kiếm plugin:

  /plugins
  

• Tìm kiếm siêu năng lực:

  superpowers
  

• chọn Install Plugin.

Cursor

• Trong trò chuyện Đại lý Cursor, cài đặt từ thị trường:

  /add-plugin superpowers
  

• Hoặc tìm kiếm "siêu năng lực" trên thị trường plugin.

Devin CLI

• Cài đặt plugin từ kho lưu trữ này:

  devin plugins install obra/superpowers
  

• Cập nhật lên phiên bản mới nhất với:

  devin plugins update superpowers
  

Nhà máy Droid

• Đăng ký thị trường:

  droid plugin marketplace add https://github.com/obra/superpowers
  

• Cài đặt plugin:

  droid plugin install superpowers@superpowers
  

Gemini CLI

• Cài đặt tiện ích mở rộng:

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

• Cập nhật sau:

  gemini extensions update superpowers
  

GitHub Copilot CLI

• Đăng ký thị trường:

  copilot plugin marketplace add obra/superpowers-marketplace
  

• Cài đặt plugin:

  copilot plugin install superpowers@superpowers-marketplace
  

Grok Bản dựng CLI

Siêu năng lực có sẵn thông qua thị trường plugin Grok chính thức.

• Cài đặt plugin từ thị trường chính thức của xAI:

  grok plugin install superpowers@xai-official --trust
  

• Hoặc mở thị trường trong TUI, tìm kiếm Siêu năng lực và cài đặt nó:

  /marketplace
  

Mã Kimi

Siêu năng lực có sẵn trên thị trường plugin của Kimi Code.

• Mở trình quản lý plugin của Kimi Code:

  /plugins
  

• đi đến Marketplace > Superpowers và cài đặt nó.

• Hoặc cài đặt trực tiếp từ kho lưu trữ này:

  /plugins install https://github.com/obra/superpowers
  

• Tài liệu chi tiết: docs/README.kimi.md

Mã mở

OpenCode sử dụng cài đặt plugin riêng; cài đặt Siêu năng lực riêng biệt ngay cả khi bạn đã sử dụng nó trong một dây nịt khác.

• Nói với OpenCode:

  Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md
  

• Tài liệu chi tiết: docs/README.opencode.md

Pi

Cài đặt Siêu năng lực dưới dạng gói Pi từ kho lưu trữ này:

pi install git:github.com/obra/superpowers

Để phát triển cục bộ, hãy chạy Pi với thanh toán này được tải dưới dạng gói tạm thời:

pi -e /path/to/superpowers

Gói Pi tải các kỹ năng Siêu năng lực và một phần mở rộng nhỏ đưa vào using-superpowers bootstrap khi khởi động phiên và lặp lại sau khi nén. Pi có kỹ năng bản địa nên không có khả năng tương thích Skill công cụ là cần thiết. Các công cụ danh sách nhiệm vụ và đại lý phụ vẫn là các gói đồng hành Pi tùy chọn.

Đại lý Hermes

Cài đặt Superpowers dưới dạng plugin Hermes từ kho lưu trữ này:

hermes plugins install obra/superpowers --enable

Khởi động lại mọi phiên Hermes đang hoạt động sau khi cài đặt. Lưu ý: Hermes không có hook sau nén, do đó, một phiên rất dài nén trong lượt đầu tiên sẽ mất bootstrap - hãy bắt đầu một phiên mới nếu các kỹ năng ngừng kích hoạt.

Quy trình làm việc cơ bản

1. động não - Kích hoạt trước khi viết mã. Tinh chỉnh các ý tưởng sơ bộ thông qua các câu hỏi, khám phá các lựa chọn thay thế, trình bày thiết kế theo từng phần để xác nhận. Lưu tài liệu thiết kế.

2. sử dụng-git-worktrees - Kích hoạt sau khi phê duyệt thiết kế. Tạo không gian làm việc riêng biệt trên nhánh mới, chạy thiết lập dự án, xác minh đường cơ sở thử nghiệm rõ ràng.

3. kế hoạch viết - Kích hoạt theo thiết kế đã được phê duyệt. Chia công việc thành các nhiệm vụ có kích thước nhỏ (mỗi nhiệm vụ 2-5 phút). Mọi tác vụ đều có đường dẫn tệp chính xác, mã hoàn chỉnh, các bước xác minh.

4. phát triển theo hướng đại lý phụ hoặc kế hoạch thực hiện - Kích hoạt theo kế hoạch. Gửi tác nhân phụ mới cho mỗi nhiệm vụ thông qua đánh giá hai giai đoạn (tuân thủ thông số kỹ thuật, sau đó là chất lượng mã) hoặc thực thi theo lô với các điểm kiểm tra của con người.

5. phát triển dựa trên thử nghiệm - Kích hoạt trong quá trình thực hiện. Thực thi REFACTOR ĐỎ-XANH: viết bài kiểm tra thất bại, xem nó thất bại, viết mã tối thiểu, xem nó vượt qua, cam kết. Xóa mã được viết trước khi kiểm tra.

6. yêu cầu-xem xét mã - Kích hoạt giữa các nhiệm vụ. Đánh giá so với kế hoạch, báo cáo các vấn đề theo mức độ nghiêm trọng. Các vấn đề quan trọng cản trở tiến trình.

7. hoàn thiện một nhánh phát triển - Kích hoạt khi nhiệm vụ hoàn thành. Xác minh các bài kiểm tra, đưa ra các tùy chọn (hợp nhất/PR/giữ/loại bỏ), dọn dẹp sơ đồ công việc.

Tác nhân kiểm tra các kỹ năng liên quan trước bất kỳ nhiệm vụ nào. Quy trình công việc bắt buộc, không phải đề xuất.

cộng đồng

Siêu năng lực được xây dựng bởi Jesse Vincent và những người còn lại ở Thủ tướng rạng rỡ.

• Bất hòa: Tham gia cùng chúng tôi để được cộng đồng hỗ trợ, đặt câu hỏi và chia sẻ những gì bạn đang xây dựng với Superpowers
• vấn đề: https://GitHub.com/obra/superpowers/issues
• Thông báo phát hành: Đăng ký để nhận thông báo về phiên bản mới

Có gì bên trong

Thư viện kỹ năng

Kiểm tra

• phát triển dựa trên thử nghiệm - Chu trình RED-GREEN-REFACTOR (bao gồm kiểm tra tham chiếu anti-pattern)

Gỡ lỗi

• gỡ lỗi hệ thống - Quy trình tìm nguyên nhân gốc gồm 4 giai đoạn (bao gồm các kỹ thuật truy tìm nguyên nhân gốc, bảo vệ chuyên sâu, chờ đợi dựa trên điều kiện)
• xác minh trước khi hoàn thành - Đảm bảo nó thực sự được sửa

Cộng tác

• động não - Cải tiến thiết kế Socrates
• kế hoạch viết - Kế hoạch thực hiện chi tiết
• kế hoạch thực hiện - Thực hiện hàng loạt với các điểm kiểm tra
• điều động-song song-đại lý - Quy trình làm việc của đại lý con đồng thời
• yêu cầu-xem xét mã - Danh sách kiểm tra trước khi xem xét
• nhận-mã-xem xét - Trả lời các phản hồi
• sử dụng-git-worktrees - Các nhánh phát triển song song
• hoàn thiện một nhánh phát triển - Quy trình quyết định hợp nhất/PR
• phát triển theo hướng đại lý phụ - Lặp lại nhanh với đánh giá hai giai đoạn (tuân thủ thông số kỹ thuật, sau đó là chất lượng mã)

Meta

• kỹ năng viết - Tạo các kỹ năng mới theo các phương pháp hay nhất (bao gồm phương pháp kiểm tra)
• sử dụng siêu năng lực - Giới thiệu hệ thống kỹ năng

Triết học

• Phát triển dựa trên thử nghiệm - Viết bài kiểm tra đầu tiên, luôn luôn
• Có hệ thống theo yêu cầu đặc biệt - Quá trình đoán
• Giảm độ phức tạp - Đơn giản là mục tiêu hàng đầu
• Bằng chứng về yêu cầu bồi thường - Xác minh trước khi tuyên bố thành công

Đọc thông báo phát hành ban đầu.

Đóng góp

Dưới đây là quy trình đóng góp chung cho Siêu năng lực. Hãy nhớ rằng chúng tôi thường không chấp nhận sự đóng góp của các kỹ năng mới và mọi cập nhật về kỹ năng đều phải hoạt động trên tất cả các tác nhân mã hóa mà chúng tôi hỗ trợ.

1. Ngã ba kho lưu trữ
2. Chuyển sang nhánh 'dev'
3. Tạo một nhánh cho công việc của bạn
4. Theo dõi writing-skills kỹ năng tạo và thử nghiệm các kỹ năng mới và sửa đổi
5. Gửi PR, đảm bảo điền vào mẫu yêu cầu kéo.

Các bài kiểm tra kỹ năng-hành vi sử dụng khai thác đánh giá diễn tập từ siêu năng lực-evals, nhân bản vào evals/ - xem evals/README.md để thiết lập. Các thử nghiệm cơ sở hạ tầng plugin trực tiếp tại tests/ và chạy qua liên quan run-*.sh hoặc npm test.

Xem skills/writing-skills/SKILL.md để có hướng dẫn đầy đủ.

Đang cập nhật

Các bản cập nhật siêu năng lực phần nào phụ thuộc vào tác nhân mã hóa nhưng thường tự động.

Giấy phép

Giấy phép MIT - xem tệp GIẤY PHÉP để biết chi tiết

Đo từ xa đồng hành trực quan

Vì các kỹ năng và plugin không cung cấp bất kỳ phản hồi nào cho người sáng tạo nên chúng tôi không biết có bao nhiêu người trong số các bạn đang sử dụng Siêu năng lực. Theo mặc định, logo Prime Radiant trên tính năng đồng hành trực quan tùy chọn của brainstorming được tải từ trang web của chúng tôi. Nó bao gồm phiên bản Siêu năng lực đang được sử dụng. Nó không bao gồm bất kỳ chi tiết nào về dự án, lời nhắc hoặc tác nhân mã hóa của bạn. Chúng tôi không thấy số nhấp chuột của bạn hoặc bất cứ điều gì về những gì bạn đang xây dựng. Điều này giúp chúng tôi biết sơ bộ về số lượng người đang sử dụng Siêu năng lực và phiên bản Siêu năng lực nào họ đang sử dụng. Đó là 100% tùy chọn. Để tắt tính năng này, hãy đặt biến môi trường SUPERPOWERS_DISABLE_TELEMETRY tới bất kỳ giá trị thực nào. Siêu năng lực cũng tôn vinh Claude Code DISABLE_TELEMETRY và CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC từ chối.