Áp dụng AgentKit (AK) trong team

Cập nhật: 05/10/2026 · AK CLI: 2.20.0-beta.4 · CK đang dùng: engineer v2.20.1-beta.14 Công ty có 1 tài khoản AK. Tech Lead đăng nhập, build sẵn bộ skill AK và đóng vào gói cập nhật team-claude-skills-update-261005.zip. Mọi người dùng bản build đó, không ai cần ak login.
Bộ CK vẫn là bộ chính. AK được bật theo từng project khi cần. Mọi máy chạy update.sh trước (xem Cài đặt Skills → mục 5) — bước này cài luôn lệnh ak đúng loại máy.

CK và AK chạy song song thế nào

Vì sao AK bật theo project, không cài cho mọi project: AK có 146 skill, nhiều cái trùng chức năng CK (/ak:cook ↔ /cook). Cài toàn máy thì phiên nào cũng nạp thêm 146 mô tả skill (tốn token) và dễ gọi nhầm bộ.

Bật AK cho 1 project

Script:
  • Chép 146 skill /ak:* vào <project>/.claude/skills/.
  • Thêm agent AK (researcher, planner, code-reviewer…) chỉ khi project chưa có — agent riêng của project giữ nguyên.
  • Không đụng ~/.claude, settings.json, hooks.
  • Ghi file AK vào .git/info/exclude → không hiện trong git status, không lỡ commit.
  • Cất bản cũ (nếu project có sẵn thư mục trùng tên) vào ~/.claude/backups/ak-project-*.
Mở claude trong project, gõ /ak: để thấy danh sách lệnh. Chạy lại lệnh trên = làm mới bản AK (giữ thư viện skill đã cài). Tắt và trả project về đúng như trước:

Lệnh không chạy trên máy team

Các lệnh ak khác dùng bình thường không cần đăng nhập: ak doctor, ak journal create, ak orchestrate ....

Tech Lead: ra bản AK mới cho team

  1. Trên máy có tài khoản công ty: ak self-update --beta --yes.
  2. Tạo thư mục trống, chạy ak kit install engineer --beta và ak kit install marketing --beta.
  3. Chép .claude/skills/ak-* và .claude/agents/*.md vào ak/skills, ak/agents của gói mới; tải binary 4 nền tảng theo URL + SHA256 trong https://agentkit.best/install.sh.
  4. Gửi gói qua Lark. Mọi người chạy update.sh rồi chạy lại enable-ak-in-project.sh cho project đang bật.

FAQ

Được. Gói có lệnh ak cho Mac chip Apple, Mac Intel, Linux x64 và Linux arm64 — update.sh tự chọn đúng bản.
Chưa có ~/.local/bin trong PATH. Thêm export PATH="$HOME/.local/bin:$PATH" vào ~/.zshrc (Mac) hoặc ~/.bashrc (Ubuntu), mở terminal mới.
Không. Đó là skill của team, vẫn chạy qua bộ CK — dùng song song bình thường.
Project: enable-ak-in-project.sh <project> --undo. CK hoặc lệnh ak: bash rollback.sh. Xem Khôi phục.