Tổng Quan Các Lệnh

ClaudeKit cung cấp một bộ lệnh slash toàn diện để tăng tốc quy trình phát triển của bạn. Mỗi lệnh được thiết kế cho các tác vụ cụ thể và tự động điều phối các agent phù hợp.

Các Nhóm Lệnh

Phát Triển Cốt Lõi (Core)

  • /bootstrap - Khởi tạo dự án mới với phát triển hướng đặc tả (spec-driven development)
  • /cook - Phát triển tính năng mới
  • /plan - Tạo kế hoạch triển khai
  • /brainstorm - Khám phá tính khả thi của tính năng
  • /ask - Đặt câu hỏi về codebase
  • /watzup - Xem trạng thái dự án và các thay đổi gần đây
  • /scout - Tìm kiếm tệp tin trong toàn bộ codebase lớn
  • /test - Chạy bộ thử nghiệm và nhận kết quả
  • /debug - Điều tra và chẩn đoán lỗi

Sửa Lỗi (Bug Fixing)

  • /fix - Sửa lỗi thông minh (tự động chọn phương pháp fast/hard)
  • /fix
     - Sửa lỗi nhỏ nhanh chóng
  • /fix
     - Sửa lỗi phức tạp với phân tích kỹ lưỡng
  • /fix
     - Sửa lỗi GitHub Actions CI
  • /fix
     - Phân tích và sửa lỗi từ logs
  • /fix
     - Sửa lỗi tests thất bại
  • /fix
     - Sửa lỗi UI/UX
  • /fix
     - Sửa lỗi TypeScript type

Tài Liệu (Documentation)

  • /docs
     - Khởi tạo tài liệu dự án
  • /docs
     - Cập nhật tài liệu dự án
  • /docs
     - Tóm tắt tài liệu dự án

Thao Tác Git

  • /git
     - Stage và commit các thay đổi
  • /git
     - Stage, commit và push
  • /git
     - Tạo pull request

Lập Kế Hoạch (Planning)

  • /plan
     - Phân tích lỗi CI và tạo kế hoạch sửa chữa
  • /plan
     - Tạo kế hoạch với 2 phương án tiếp cận
  • /plan
     - Tạo kế hoạch tối ưu hóa chuyển đổi

Thiết Kế & UI

  • /design
     - Tạo thiết kế 3D với Three.js
  • /design
     - Trích xuất thiết kế từ ảnh chụp màn hình
  • /design
     - Tạo thiết kế nhanh chóng
  • /design
     - Tạo thiết kế hoàn thiện và tinh chỉnh
  • /design
     - Chuyển ảnh chụp màn hình thành mã nguồn
  • /design
     - Chuyển video thành mã nguồn

Nội Dung & Marketing

  • /content
     - Nội dung tối ưu hóa chuyển đổi
  • /content
     - Cải thiện nội dung hiện có
  • /content
     - Tạo nội dung nhanh chóng
  • /content
     - Nội dung chất lượng cao kèm nghiên cứu

Tích Hợp (Integrations)

  • /integrate
     - Tích hợp thanh toán Polar.sh
  • /integrate
     - Tích hợp thanh toán SePay.vn (Việt Nam)

Nhật Ký (Journaling)

  • /journal - Viết nhật ký phát triển

Tham Khảo Nhanh

Các Lệnh Thường Dùng

# Phát triển tính năng
/plan [mô tả tính năng]      # Lập kế hoạch tính năng
/cook [mô tả tính năng]      # Triển khai tính năng

# Sửa lỗi
/fix:fast [lỗi đơn giản]     # Sửa nhanh
/fix:hard [lỗi phức tạp]     # Điều tra kỹ lưỡng + sửa lỗi
/fix:ci [url-github-ci]      # Sửa lỗi CI thất bại

# Tài liệu
/docs:init                   # Thiết lập lần đầu
/docs:update                 # Sau khi thay đổi mã nguồn

# Quy trình Git
/git:cm                      # Commit thay đổi
/git:cp                      # Commit và push
/git:pr [nhánh-đích]         # Tạo pull request

# Trạng thái dự án
/watzup                      # Trạng thái hiện tại như thế nào?
/ask [câu hỏi]               # Hỏi về codebase

Cú Pháp Lệnh

Cú Pháp Cơ Bản

/lệnh [tham-số-bắt-buộc] [tham-số-tùy-chọn]

Ví Dụ

# Không tham số
/test
/watzup
/docs:init

# Tham số bắt buộc
/cook [thêm xác thực người dùng]
/debug [nút đăng nhập không hoạt động]
/ask [quy trình điều hướng hoạt động như thế nào?]

# Tham số tùy chọn
/git:pr                          # PR vào nhánh mặc định
/git:pr [develop]                # PR vào nhánh develop
/git:pr [main] [feature-branch]  # PR từ nhánh feature vào main

# Nhiều tham số
/scout [các tệp xác thực] [3]    # Tìm tệp xác thực, dùng 3 agent

Quy Trình Làm Việc

Bắt Đầu Dự Án Mới

1. /bootstrap [mô tả dự án]
   # HOẶC
   ck new --kit engineer

2. # Tùy chỉnh yêu cầu thông qua Q&A

3. # Hệ thống tự động:
   - Nghiên cứu các thực hành tốt nhất (best practices)
   - Tạo kế hoạch triển khai
   - Triển khai các tính năng
   - Tạo các bài kiểm tra (tests)
   - Thiết lập tài liệu

Phát Triển Tính Năng

1. /plan [mô tả tính năng]
   # Tạo kế hoạch triển khai chi tiết

2. # Xem lại kế hoạch trong thư mục plans/

3. /cook [triển khai tính năng]
   # Triển khai dựa trên kế hoạch
   # Tạo các bài kiểm tra
   # Cập nhật tài liệu

4. /test
   # Kiểm tra lại việc triển khai

5. /git:cm
   # Commit với thông điệp chuẩn (conventional commit)

Sửa Lỗi

# Lỗi đơn giản (bạn đã biết cách sửa)
/fix:fast [lỗi đánh máy trong thông báo xác thực]

# Lỗi phức tạp (cần điều tra)
/fix:hard [người dùng không thể đăng nhập sau khi đặt lại mật khẩu]
# - Dùng scout để tìm các tệp liên quan
# - Phân tích mã nguồn và nhật ký (logs)
# - Nghiên cứu giải pháp
# - Tạo kế hoạch sửa lỗi
# - Triển khai sửa lỗi
# - Kiểm tra kỹ lưỡng

# Lỗi CI
/fix:ci [https://github.com/user/repo/actions/runs/123]
# - Đọc nhật ký CI
# - Xác định nguyên nhân thất bại
# - Triển khai sửa lỗi
# - Xác minh CI vượt qua

Cập Nhật Tài Liệu

# Sau khi triển khai các tính năng
/docs:update

# Khi hướng dẫn thành viên mới
/docs:summarize

# Khi bắt đầu với một codebase hiện có
/docs:init

Thực Hành Tốt Nhất

Sử Dụng Đúng Lệnh Cho Từng Tác Vụ

✅ Sử dụng đúng

# Sửa lỗi nhỏ
/fix:fast [lỗi đánh máy trên văn bản nút]

# Vấn đề phức tạp
/fix:hard [rò rỉ bộ nhớ trong kết nối websocket]

# Vấn đề UI kèm ảnh chụp màn hình
/fix:ui [screenshot.png] - nút bị lệch trên thiết bị di động

❌ Sử dụng sai

# Đừng dùng fast cho vấn đề phức tạp
/fix:fast [toàn bộ hệ thống xác thực bị hỏng]

# Đừng dùng hard cho việc sửa lỗi đơn giản
/fix:hard [lỗi đánh máy trong ghi chú]

Cung Cấp Mô Tả Rõ Ràng

✅ Rõ ràng

/plan [thêm xác thực OAuth2 với nhà cung cấp Google và GitHub]
/cook [triển khai làm mới mã JWT với thời gian hết hạn 15 phút]
/debug [API trả về lỗi 500 khi tạo người dùng với email trống]

❌ Mơ hồ

/plan [thêm xác thực]
/cook [làm cho nó hoạt động]
/debug [cái gì đó bị hỏng]

Kiểm Tra Trước Khi Commit

# 1. Triển khai
/cook [thêm giới hạn tốc độ - rate limiting]

# 2. Thử nghiệm
/test

# 3. Xem lại các thay đổi
git diff

# 4. Chỉ commit khi hài lòng
/git:cm

Sử Dụng Chuỗi Lệnh Cho Các Tác Vụ Phức Tạp

# 1. Hiểu codebase
/ask [xác thực hiện tại được triển khai như thế nào?]

# 2. Lập kế hoạch thay đổi
/plan [chuyển từ xác thực dựa trên session sang JWT]

# 3. Xem lại kế hoạch
cat plans/latest-plan.md

# 4. Triển khai
/cook [chuyển sang xác thực JWT]

# 5. Thử nghiệm
/test

# 6. Sửa nếu cần
/fix:test

# 7. Commit
/git:cm

Các Cờ Và Tùy Chọn

Một số lệnh hỗ trợ các cờ (flags):

/bootstrap

/bootstrap [mô tả dự án]              # Q&A tương tác
/bootstrap:auto [mô tả chi tiết]       # Hoàn toàn tự động

/git

/git:pr                      # PR vào nhánh mặc định (main)
/git:pr [develop]            # PR vào nhánh develop
/git:pr [main] [feature]     # PR từ nhánh feature vào main

/plan

/plan [tính năng]              # Một phương án tiếp cận
/plan:two [tính năng]          # Hai phương án tiếp cận khác nhau

Hiểu Kết Quả Đầu Ra Của Lệnh

Các lệnh cung cấp đầu ra có cấu trúc:

Các Lệnh Lập Kế Hoạch

planner Agent: Đang phân tích codebase...

Kết quả nghiên cứu:
- Đã xem lại các thực hành tốt nhất về OAuth2
- Đã xác định các mẫu xác thực hiện có
- Đã ghi nhận các cân nhắc về bảo mật

Kế hoạch triển khai đã được tạo:
📄 plans/oauth-implementation.md

Tóm tắt kế hoạch:
1. Cài đặt các phụ thuộc (passport, passport-google-oauth20)
2. Cấu hình các nhà cung cấp OAuth2
3. Triển khai các tuyến đường (routes) callback
4. Thêm quản lý session
5. Tạo các bài kiểm tra
6. Cập nhật tài liệu

Thời gian dự kiến: 2-3 giờ
Số tệp cần tạo mới: 5
Số tệp cần chỉnh sửa: 3

Tiếp theo: Xem lại kế hoạch, sau đó chạy /code

Các Lệnh Triển Khai

Code Agent: Đang triển khai từ kế hoạch...

Các phụ thuộc đã cài đặt:
✓ passport (0.6.0)
✓ passport-google-oauth20 (2.0.0)

Các tệp đã tạo:
✓ src/auth/oauth-config.js
✓ src/auth/google-strategy.js
✓ src/routes/auth-callback.js

Các bài kiểm tra đã tạo:
✓ tests/auth/oauth.test.js (15 tests)

Tài liệu đã được cập nhật:
✓ docs/api/authentication.md

Triển khai hoàn tất!

Tiếp theo: Chạy /test để xác minh

Các Lệnh Thử Nghiệm

tester Agent: Đang chạy bộ thử nghiệm...

Kết quả thử nghiệm:
✓ Unit tests: 45 passed
✓ Integration tests: 12 passed
✓ E2E tests: 8 passed

Độ bao phủ (Coverage): 87.3%

Tất cả các bài kiểm tra đã vượt qua!

Tiếp theo: Xem lại các thay đổi, sau đó chạy /git:cm

Xử Lý Sự Cố

Không Tìm Thấy Lệnh

Vấn đề: /lệnh không được nhận diện

Giải pháp:

  1. Xác minh bạn đang ở trong một dự án ClaudeKit (ls .claude/)
  2. Kiểm tra xem lệnh có tồn tại không (ls .claude/commands/)
  3. Chạy ck init để cập nhật các lệnh mới nhất
  4. Khởi động lại Claude Code

Lệnh Thất Bại

Vấn đề: Lệnh gặp lỗi trong quá trình thực thi

Giải pháp:

  1. Kiểm tra thông báo lỗi để biết vấn đề cụ thể
  2. Xác minh các điều kiện tiên quyết (API keys, phụ thuộc)
  3. Xem lại nhật ký của agent
  4. Thử lại lệnh với đầu vào đơn giản hơn
  5. Sử dụng /debug để điều tra

Kết Quả Không Như Mong Đợi

Vấn đề: Lệnh không thực hiện đúng những gì mong đợi

Giải pháp:

  1. Xem lại tài liệu của lệnh
  2. Kiểm tra xem đã sử dụng đúng lệnh cho tác vụ chưa
  3. Cung cấp mô tả cụ thể hơn
  4. Xem lại các kế hoạch đã tạo trước khi triển khai
  5. Sử dụng phản hồi để tinh chỉnh

Bước Tiếp Theo

Khám phá các nhóm lệnh cụ thể:

Hoặc tìm hiểu thêm về:

Điểm mấu chốt: Các lệnh ClaudeKit cung cấp một giao diện tự nhiên, trực quan cho việc điều phối agent mạnh mẽ, giúp các tác vụ phát triển phức tạp trở nên đơn giản và có thể lặp lại.