Khởi động nhanh

Quy trình tập trung này cài Engineer Kit ở chế độ native vào project hiện tại và bắt đầu một tác vụ phần mềm trong Claude Code hoặc Codex.

Trước khi bắt đầu

Hoàn thành Cài đặt và Làm quen, hoặc xác minh ba trạng thái bắt buộc ngay bây giờ:

ak --version
ak whoami
ak licenses

ak whoami phải hiển thị đúng tài khoản, còn Engineer Kit phải xuất hiện trong ak licenses. Runtime đã chọn cũng phải được cài và đăng nhập. Các phép kiểm tra này không in secret đã lưu của bạn. Kết quả chưa xác thực từ ak whoami vẫn trả exit code 0, vì vậy hãy kiểm tra trạng thái hiển thị thay vì chỉ dựa vào exit code.

Cài và chạy

ak kit init engineer --target claude-code

ak kit init engineer --target codex

/ak:cook Add a health-check endpoint

$ak:cook Add a health-check endpoint

Kết quả mong đợi

Trợ lý nhận diện ak:cook, đọc tác vụ cùng context project hiện tại và bắt đầu workflow của skill. Hãy review scope đề xuất và mọi thay đổi tệp như với công việc lập trình khác. Quickstart hoàn tất khi skill đã khởi chạy thành công; kết quả của tác vụ mẫu phụ thuộc vào project của bạn.

Nếu skill không được nhận diện

1. Xác nhận phần tóm tắt cài đặt ghi engineer và đúng target bạn muốn.
2. Xác nhận bạn đang ở đúng project, scope và delivery mode đã dùng khi cài, đồng thời tập Skill đã chọn có ak:cook.
3. Xác nhận phiên bản và release channel của CLI cùng Kit đúng như bạn dự định.
4. Mở phiên trợ lý mới trong cùng project.
5. Chạy ak doctor --exit-on-fail và xử lý mọi kiểm tra runtime hoặc Kit được báo.
6. Nếu có xung đột quyền sở hữu khi cài, hãy dừng và kiểm tra; đừng lập tức thử lại với --force.

Nếu thao tác được quản lý đã in backup ID, hãy giữ ID tới khi xác minh xong project. Kiểm tra thông tin và xem trước điểm khôi phục bằng ak backups show <backup-id> cùng ak recover <backup-id> --dry-run; xem Phần khôi phục trong Làm quen để biết lệnh áp dụng và giới hạn restore.

Giữ CLI và Kit luôn cập nhật

Binary, nội dung thuộc quyền sở hữu AgentKit trong project và Kit đã cài vào runtime là ba lớp riêng biệt. ak self-update thay đổi binary CLI; lệnh này không làm mới file trong .claude, .codex hoặc đích runtime khác. ak update xử lý nội dung project thuộc quyền sở hữu AgentKit, còn ak kit refresh phát lại một tuyến cài Kit theo target, scope, delivery mode và tập Skill đã ghi nhận.

Dùng Cập nhật AgentKit và Kit để chọn đúng lớp bạn muốn thay đổi. Nếu file vẫn không đổi, hãy kiểm tra tuyến cài và bằng chứng quyền sở hữu trước khi cài lại hoặc xóa nội dung runtime.

Tiếp tục

• Làm quen giải thích chi tiết hơn về phương thức xác thực, setup, scope và khôi phục.
• Cài đặt kit trình bày việc chọn skill và refresh.
• Tham chiếu CLI chứa các cờ và hành vi lệnh chính xác của bản phát hành.