VividKit Crystal clear AI coding
EN
Chọn Thiết Lập Bắt Đầu với AgentKit Tiếp Tục với ClaudeKit Chuyển từ ClaudeKit sang AgentKit Gỡ hẳn ClaudeKit AgentKit Là Gì? AgentKit Hoạt Động Như Thế Nào? Kit, Skill, Agent & Hook AgentKit Hỗ Trợ Runtime AgentKit Ứng Dụng AgentKit Desktop Cấu Hình AgentKit Tra Cứu CLI ak Bảng Skills AgentKit Statusline AgentKit Cập Nhật CLI ak & Kits Cài lại clean AgentKit Xử Lý Sự Cố AgentKit Giới Thiệu ClaudeKit Hướng Dẫn ClaudeKit CLI Tìm Lệnh Phù Hợp Bảng Lệnh Nhanh Quy Trình Mẫu Tham Chiếu CLI Claude Mechanics Permission Modes ClaudeKit Hooks Coexistence ClaudeKit x Codex CK → Tool coding khác Cách ClaudeKit Hoạt Động Inside ClaudeKit UI Review Gate Tìm Unknowns Của Bạn Khôi Phục Session Sửa Lỗi Từ Log Thiết Kế UI/UX Chuyển Đổi Tài Khoản Cấu Hình IDE Remote Control Codex App Khuyến Mãi Ủng Hộ VividKit
AgentKit · CLI & Kits self-update ≠ update

Cập Nhật CLI ak & Kits

Phân biệt lệnh AgentKit: chỉ nâng CLI ak, làm mới Kit, hoặc nhắm đúng một kit.

So sánh

Lệnh nào làm gì?

Lệnh Cập nhật gì Không làm gì Khi nào dùng
ak self-update CLI ak (và Desktop nếu bạn bật) Không làm mới skill/hook trong project Chỉ muốn CLI ak mới hơn
ak update Hỏi từng bước: CLI ak → kit trên máy → kit project Bỏ qua bước nào thì không đụng phần đó Sau bản release: muốn làm mới theo hướng dẫn từng bước
ak update --global Chỉ kit cài sẵn trên máy (mọi runtime, hoặc lọc --target) Không đụng file trong project Làm mới kit “toàn máy”, không mở repo
ak update [project-dir] Chỉ file do AgentKit cài trong project đó Không làm mới kit global trên máy Cập nhật kit trong một repo
ak update --kits <name> Chỉ kit tên đó (trong project, hoặc kèm --global) Không đụng kit khác Chỉ engineer / marketing / …
ak kit refresh <kit> Ép làm mới lại một kit đã cài; gỡ file generate cũ thừa Không hỏi 3 bước như ak update; không nâng CLI ak Một kit lệch / cần force refresh

1 · CLI

Chỉ nâng CLI ak: ak self-update

Dùng khi bạn chỉ muốn CLI ak mới hơn (hoặc stage Desktop). Không làm mới skills/hooks trong project.

shell 
# Check only — no install
ak self-update --check

# Apply signed CLI update
ak self-update --yes

# Beta channel shorthand
ak self-update --beta --yes

# Require matching CLI + Desktop artifacts for this platform
ak self-update --include-desktop --yes

# Opt in / out Desktop auto-update (writes config.yaml updates.*)
ak self-update --enable-auto-update
ak self-update --disable-auto-update

2 · Kits

Làm mới nội dung Kit: ak update

Chỉ sửa file do AgentKit cài (không đụng file bạn tự tạo). Không thêm --yes thì thường chỉ xem trước; thêm --yes mới ghi thật.

Cập nhật theo từng bước (hỏi lần lượt)

Gõ ak update trong terminal (có màn hình tương tác). CLI hỏi lần lượt: nâng CLI ak → kit trên máy → kit trong project. Mỗi bước bạn Yes/No. Muốn “đồng ý hết” thì thêm --yes.

  • ak update → hỏi từng bước
  • ak update --yes → đồng ý tất cả bước

Chỉ một chỗ / một kit (bỏ qua wizard dài)

Thêm cờ để nói rõ “chỉ chỗ này”, không đi hết 3 bước wizard. --global = kit cài trên máy; đường dẫn project = một repo; --kits = chỉ kit tên đó.

  • ak update --global --yes → chỉ kit trên máy
  • ak update ./myproj --yes → chỉ một project
  • ak update --kits engineer --yes → chỉ kit engineer

Ba bước khi gõ ak update (terminal tương tác)

  1. 1

    1. CLI ak

    Hỏi có nâng cấp CLI ak không. Mặc định là No; gõ Yes hoặc dùng --yes để đồng ý cả wizard.

  2. 2

    2. Kit trên máy (global)

    Làm mới kit cài sẵn cho user/máy. File bạn đã sửa tay thường được giữ.

  3. 3

    3. Kit trong project

    Làm mới kit trong thư mục project hiện tại. File AgentKit “còn nguyên” được cập nhật; file bạn đã sửa thì bỏ qua trừ khi thêm --force.

Chỉ kits global (toàn máy)

shell 
# Preview user/global kit refreshes
ak update --global

# Apply
ak update --global --yes

# One kit, global
ak update -g --kits engineer --yes

# One or more runtimes only
ak update --global --target codex --yes
ak update --global --target claude-code,codex --yes

Trên máy (global): file bạn đã sửa tay thường được giữ — --force cũng không tự ghi đè kiểu project. Install Claude Code chỉ dạng user-plugin được báo ra, không tự refresh âm thầm; nếu cần thì dùng ak kit refresh … --global --switch-to-plugin.

Chỉ kits trong project

shell 
# Preview current directory project
ak update ./myproj
# or from inside the project:
ak update

# Preview one kit
ak update --kits engineer

# Apply (required for scripted / non-TTY)
ak update --kits engineer --yes

# Overwrite user-modified AK-owned files too
ak update --kits engineer --force --yes

# Show unified diffs in preview
ak update --show-diff

# Scripted envelope
ak update --kits engineer --yes --json --no-interactive

Channel / beta

shell 
# shorthand --channel beta
ak update --beta --yes
ak update --channel stable --yes
# --beta conflicts with --channel stable

3 · One kit

Chỉ một kit (force re-emit): ak kit refresh

Khác ak update --kits: refresh re-emit kit với force, gỡ agent/rules/hooks/commands generated đã biến mất khỏi source.

shell 
# Project-native Claude Code (remote default)
ak kit refresh engineer --yes

# Project plugin delivery
ak kit refresh engineer --switch-to-plugin --yes

# Global paid install
ak kit refresh engineer --global --yes

# Specific runtime
ak kit refresh engineer --target codex --yes

# Local kit source (dev)
ak kit refresh engineer --local --kits-dir ./kits --yes

Dùng khi audit báo plugin drift, sau khi kit đổi export, hoặc khi cần “viết lại” output của đúng một kit. Snapshot mặc định (trừ --no-backup).

Thực hành

Chọn nhanh

Chỉ muốn CLI ak mới

ak self-update --check ak self-update --yes

Sau release, làm mới “hết” (CLI + kits)

ak update --yes (đồng ý hết các bước hỏi)

Chỉ kits cài global trên máy

ak update --global --yes

Không nâng CLI ak — dùng ak self-update nếu cần.

Chỉ repo hiện tại / một kit

ak update --kits engineer --yes hoặc ak kit refresh engineer --yes

Liên quan