AgentKit · Support
Xử Lý Sự Cố AgentKit
Checklist nhanh khi CLI ak, Desktop App hoặc runtime adapter của AgentKit không như kỳ vọng — không phải trang ClaudeKit.
CLI không tìm thấy
Xác nhận thư mục cài nằm trên PATH, mở terminal mới, rồi chạy ak --version.
Chẩn đoán nhanh
doctor
ak doctor --json
ak doctor --json --offlineLệnh gỡ
ak uninstall ≠ gỡ kit global
ak uninstall
Gỡ project do AgentKit quản lý. Cần AK project tại/trên cwd — không phải lệnh gỡ kit global.
ak kit uninstall <kit>
Gỡ nội dung kit AgentKit-owned theo scope/mode. Chi tiết flags + clean reinstall: cài lại clean .
Runtime
Skill không xuất hiện
- 1 Xác nhận Kit đã cài đúng runtime và đúng scope (project vs global).
- 2 Restart coding assistant hoặc mở session mới sau khi cài.
- 3 Dùng đúng cú pháp runtime (/ak:… vs $ak:…).
- 4 Đọc warning adapter: component có thể bị drop hoặc chỉ là supporting content.
Desktop
Desktop
- Verify SHA-256 trước khi mở; đừng tắt Gatekeeper toàn hệ thống.
- Session App license tách với CLI login.
- Desktop không chạy Skill — kiểm tra coding assistant nếu thiếu workflow.
Migrate