Sử dụng CLI

Tổng quan các lệnh

aidk [command] [options]

Lệnh	Mô tả
aidk init	Khởi tạo cấu trúc AIDK trong dự án hiện tại
aidk add rule <name>	Thêm một rule mới
aidk add skill <name>	Thêm một skill mới
aidk add workflow <name>	Thêm một workflow mới
aidk update	Kiểm tra và cập nhật các thành phần từ registry
aidk --version	Xem phiên bản hiện tại
aidk --help	Hiển thị trợ giúp

aidk init

Khởi tạo cấu trúc AIDK trong thư mục hiện tại.

aidk init

Tùy chọn:

• --ide <cursor|antigravity> — Chỉ định IDE (mặc định: antigravity)
• --force — Ghi đè nếu cấu trúc đã tồn tại

Ví dụ:

# Khởi tạo cho Cursor IDE
aidk init --ide cursor

# Ghi đè cấu trúc cũ
aidk init --force

aidk add rule

Thêm một file rule mới vào .agent/rules/.

aidk add rule <name>

Ví dụ:

aidk add rule security
# Tạo: .agent/rules/security.md

aidk add skill

Thêm một skill mới vào .agent/skills/.

aidk add skill <name>

Ví dụ:

aidk add skill fastapi
# Tạo: .agent/skills/fastapi/SKILL.md

aidk add workflow

Thêm một workflow mới vào .agent/workflows/.

aidk add workflow <name>

Ví dụ:

aidk add workflow deploy
# Tạo: .agent/workflows/deploy.md

aidk update

Kiểm tra sự thay đổi của các thành phần đã cài đặt và khám phá các thành phần mới từ registry.

aidk update

Lệnh này sẽ thực hiện các bước sau:

1. Kiểm tra thay đổi: So sánh các file rules, skills, workflows hiện tại trong dự án của bạn với phiên bản mới nhất trong registry của AIDK.
2. Khám phá thành phần mới: Tự động tìm các thành phần (rules, skills, workflows) mới được thêm vào AIDK mà bạn chưa cài đặt.
3. Cập nhật có chọn lọc: Cung cấp giao diện tương tác để bạn chọn cập nhật tất cả hoặc chỉ chọn một số thành phần cụ thể.

Ví dụ:

# Kiểm tra và cập nhật toàn bộ dự án
aidk update

Xử lý lỗi phổ biến

Lỗi	Nguyên nhân	Giải pháp
Command not found: aidk	Chưa cài đặt hoặc PATH chưa đúng	Chạy npm install -g @caeruxlab/aidk
ENOENT: .agent already exists	Thư mục đã tồn tại	Dùng cờ --force
403 Forbidden	Lỗi xác thực npm registry	Kiểm tra .npmrc và token GitLab