Sun* Agent Kit Tài liệu
Tất cả những gì bạn cần để bắt đầu và triển khai với AI agent.
Cài đặt
4 bước để bắt đầu:
# 1. Authenticate with GitHub (Sun* account required)
gh auth login
# 2. Install the CLI
npm install -g sun-agent-kit-cli
# 3. Initialize in your project
cd my-project
sk init
# 4. Verify installation
sk doctorYêu cầu: Node.js 18+ • GitHub CLI (gh) đã xác thực với tài khoản Sun* GitHub
Bắt đầu nhanh
Sau khi chạy sk init, bắt đầu xây dựng trong 3 bước:
# 1. Plan your feature
/sk:plan "Build a task management dashboard"
# 2. Implement it
/sk:cook
# 3. Ship it
/sk:code-review
/sk:shipUse Case
Các tình huống thực tế và luồng lệnh để xử lý chúng:
Bắt đầu dự án mới
Khởi tạo từ brief khách hàng — scaffold, lên kế hoạch, tạo docs trong dưới 1 giờ.
Xem hướng dẫn đầy đủ →Tiếp nhận dự án hiện có
Take over dự án brownfield — khám phá cấu trúc, tạo docs, xây knowledge graph.
Xem hướng dẫn đầy đủ →Sửa lỗi có hệ thống
Điều tra, chẩn đoán và sửa — từ patch nhanh đến phân tích nguyên nhân gốc rễ.
Xem hướng dẫn đầy đủ →Thêm tính năng mới
Chu kỳ phát triển đầy đủ — plan, implement, test, review, ship.
Xem hướng dẫn đầy đủ →Xây dựng REST API
API hoàn chỉnh với CRUD, auth middleware, validation, docs. Từ thiết kế đến deployment.
Xem hướng dẫn đầy đủ →Triển khai xác thực
Auth bảo mật — JWT, OAuth2, 2FA, xác minh email, rate limiting. Sẵn sàng production.
Xem hướng dẫn đầy đủ →Kiểm tra bảo mật
Phát hiện secrets, deps lỗ hổng, mẫu code OWASP. Tuân thủ bảo mật trước khi bàn giao.
Xem hướng dẫn đầy đủ →Review code
Review đối nghịch với phát hiện edge case trước khi bàn giao khách hàng.
Xem hướng dẫn đầy đủ →Tích hợp thanh toán
Stripe, Polar hoặc SePay — đăng ký, webhooks và tối ưu doanh thu.
Xem hướng dẫn đầy đủ →Tối ưu hiệu suất
Profiling, xác định bottleneck, triển khai caching và tối ưu truy vấn.
Xem hướng dẫn đầy đủ →Tái cấu trúc code
Giảm tech debt từng bước — scout, plan, refactor với safety net kiểm thử.
Xem hướng dẫn đầy đủ →Tạo tài liệu
Tự động tạo API docs, architecture docs, tài liệu bàn giao khách hàng.
Xem hướng dẫn đầy đủ →Tạo prototype nhanh
Đưa tài liệu khách hàng vào thư mục, brainstorm từ đó, scaffold và cook từng tính năng — prototype hoạt động trong vài giờ.
Xem hướng dẫn đầy đủ →Đề xuất upsale khách hàng
Tạo đề xuất upsale dựa trên bằng chứng từ audit codebase — không code, chỉ bằng chứng và tài liệu.
Xem hướng dẫn đầy đủ →Migrate dự án
Chuyển đổi tech stack mà không mất business logic — kiểm kê đầy đủ, cook theo module, parity test.
Xem hướng dẫn đầy đủ →Lệnh cơ bản
| Lệnh | Mô tả |
|---|---|
/sk:plan | Nghiên cứu, phân tích, tạo kế hoạch triển khai theo từng giai đoạn |
/sk:cook | Thực thi kế hoạch — điều phối implementer, tester, reviewer |
/sk:code-review | Review code đối nghịch với phát hiện edge case |
/sk:ship | Merge, test, commit, push và tạo PR |
/sk:fix | Debug lỗi, test failure, vấn đề CI/CD |
/sk:brainstorm | Khám phá các hướng tiếp cận trước khi lên kế hoạch |
/sk:scout | Tìm file liên quan đến một tính năng hoặc khái niệm |
/sk:docs | Cập nhật tài liệu dự án |
Tất cả lệnh dùng tiền tố /sk:. Chạy sk skills list để xem danh sách đầy đủ.
Quy trình
Vòng lặp phát triển cốt lõi:
Mỗi bước điều phối các subagent chuyên biệt. Plans được lưu vào thư mục plans/ với các phases, reports và nghiên cứu.
Mẹo hay
/sk:plan:hard— nghiên cứu chuyên sâu trước khi lên kế hoạch (tính năng phức tạp)/sk:cook --auto— tự động phê duyệt tất cả các bước (tác vụ đáng tin cậy)/sk:graphify ./src— xây dựng knowledge graph trước khi làm tính năng lớn
Agents
8 agent cốt lõi điều phối vòng đời phát triển:
| Agent | Mô tả |
|---|---|
planner | Phân tích kiến trúc, lên kế hoạch theo giai đoạn |
implementer | Triển khai code theo từng giai đoạn |
tester | Unit + integration test, độ phủ test |
reviewer | Chất lượng code, tuân thủ đặc tả |
debugger | Điều tra nguyên nhân gốc rễ |
researcher | Nghiên cứu kỹ thuật (song song) |
doc-writer | Cập nhật tài liệu |
git-manager | Thao tác git, commit |
Agent có thể tạo ra các agent khác — planner kích hoạt nhiều researcher song song, rồi chuyển tiếp cho implementer.