Hướng dẫn
Hướng dẫn AgentKit v3
Chuỗi hướng dẫn AgentKit v3 theo thứ tự, từ cài đặt đến khi ship tính năng đầu tiên cùng AI coding agent.
- Bước 1AgentKit v3 có gì mới? Không phải bản "thêm tính năng", mà là bản đổi móng nhàNgày 29/10/2026, tag v3.0.0 lên GitHub với 101 asset: kit cho 8 runtime, ak CLI cho macOS/Linux/Windows (amd64 và arm64) kèm SBOM, app desktop ak-gui, checksums.txt và release-provenance.json. Release note dài như cái sớ, khoảng 300 gạch đầu dòng feature với fix 😂9 phút đọc
- Bước 2Update lên v3, rollback, auto-update và gỡ rối: làm sao để không toangTui có một nguyên tắc khi làm tool cho dev: cái gì phá được thì phải có đường lui. Bài này đi đúng thứ tự tui khuyên anh em làm: chụp lại hiện trạng, update, kiểm tra, rồi mới tính chuyện bật auto-update. Lỡ có gì thì cuộn xuống phần rollback.6 phút đọc
- Bước 3License và chính sách cập nhật mới: mua rồi là của bạn, nói rõ một lần cho xongCâu tui bị hỏi nhiều nhất từ hồi công bố v3: "Anh ơi, v3 có bắt trả tiền lại không? Kit em mua có bị khoá không?"8 phút đọc
- Bước 4Cài kit cho nhiều runtime, project hay global: bảng chứng nhận thật, không tô hồng"AgentKit chạy được trên Cursor không anh?" Câu trả lời trung thực là: cài được, nhưng chưa đạt chứng nhận. Bài này cho bạn cái bảng mà tui dùng nội bộ để quyết định runtime nào "chín" tới đâu, rồi chỉ cách cài cho từng trường hợp.5 phút đọc
- Bước 5Quản lý skill và SkillX: tự chế kit riêng mà không sợ update đè mấtBài này dài nhất bộ, vì nó chứa phần tui hào hứng nhất của v3: skill của bạn là tài sản của bạn. Bạn tự viết, tự sửa, mang qua máy khác, chia sẻ cho team, mà lần update kit sau không đè mất.7 phút đọc
- Bước 6AgentKit Vault: cất API key cho đàng hoàng, đừng để agent đọc `.env` nữaThú thật đi: máy bạn đang có bao nhiêu file .env chứa API key thật? Tui từng đếm máy tui, ra con số làm tui hơi... ngại 😅6 phút đọc
- Bước 7Hooks và quyền riêng tư: agent bị chặn đọc gì, và vì sao chặn chưa phải là đủHook là mấy đoạn code chạy trước hoặc sau mỗi hành động của agent: trước khi đọc file, trước khi chạy lệnh shell, lúc mở session, lúc nén context... AgentKit dùng hook để làm hai việc: nhắc agent làm việc có kỷ luật và chặn agent đụng vào thứ nhạy cảm.4 phút đọc
- Bước 8Decision Layer: System One, Jev, Clef và chuyện cho AI "ra quyết định có kiểu"Trước khi vào bài, tui phải đính chính một chuyện: "Decision Layer" chưa phải là tên một tính năng trong AgentKit. Bạn sẽ không tìm thấy chữ này trong ak, trong docs hay trên site. Đây là cách tui gọi chung một hướng đi đang thử nghiệm: dùng model nhỏ, chuyên ra phán đoán có cấu trúc để giúp agent…4 phút đọc
- Bước 9Cài AgentKit trên cloud và CI: Claude Routine, GitHub Actions và mấy cái bẫyNói trước cho rõ: tài liệu chính thức của AgentKit hiện chưa có trang riêng cho cloud/CI. Bài này là cách tui và team đang làm, ghép từ những cờ và hành vi có thật trong ak 3.0.0. Phần nào là công thức của tui, tui ghi rõ.5 phút đọc
- Bước 10Hệ sinh thái AgentKit: Vault, Render, CloudHarness, SkillX, TOSE là gì và dùng khi nàoAgentKit là cái lõi. Xung quanh nó có mấy sản phẩm nhỏ hơn, mỗi cái giải đúng một bài toán mà tui gặp khi làm việc với agent hằng ngày. Bài này là tấm bản đồ: mỗi món là gì, trạng thái tới đâu, nối với ak bằng cách nào, và khi nào bạn thật sự cần nó.6 phút đọc
- Bước 11Trở thành Contributor và kiếm tiền cùng AgentKit: chương trình là gì, được gì, chưa rõ gìAgentKit lớn lên nhờ những người dùng nó mỗi ngày rồi quay lại báo bug, gửi PR, viết skill, giới thiệu cho bạn bè. Tui muốn những người đó được ghi nhận bằng thứ có thật: tiền và quyền lợi, chứ không chỉ một dòng cảm ơn trong release note.5 phút đọc
- Bước 12Chọn workflow theo model: khi nào brainstorm, khi nào advise, khi nào bỏ luôn bước planMấy bữa nay trên Discord, tui chia sẻ workflow mới của tui với Opus 5.5: không cần plan → clear → cook nữa. Vậy là anh em hỏi dồn liền 😂 "Vậy /ak-brainstorm để chỗ nào?", "Dùng /ak-advise thay brainstorm hay dùng chung?", "Có cần worktree cho mỗi session không?".7 phút đọc
- Bước 13`/ak-orchestrate` và `/ak-atoz`: giao việc xuyên đêm cho một đội agent, sáng dậy chỉ việc review PRTừ ngày xài Opus 5.5 trong Claude Code (desktop app), cách làm việc của tui đổi hẳn. Tui không còn ngồi chat với một agent rồi đợi nó làm từng việc. Giờ tui mở một main session làm "nhạc trưởng", nó chia việc ra nhiều sub-session chạy song song, mỗi cái một worktree, một branch, một PR. Tui chỉ…10 phút đọc
- Bước 14Cloud Harness MCP: cho ChatGPT mở repo, sửa code, chạy test, mở PR (và những chỗ phải dè chừng)Ý tưởng khởi đầu của tui khá lười: ChatGPT chat về code thì giỏi, nhưng nó không có tay chân. Còn Codex thì có tay chân mà quota có hạn. Vậy sao không cho ChatGPT một bộ tay chân riêng qua MCP? Model suy nghĩ trong ChatGPT, còn đọc file, sửa code, chạy lệnh, Git thì diễn ra ở một harness bên…4 phút đọc
- Bước 15`/ak-test`: bớt test cho có, test đúng chỗ, chạy theo blast radiusAI giờ được train để làm ra thứ ổn định hơn, nên tụi nó viết test rất nhiều. Tốt, cho tới khi có vài nghìn cái test và bill CI nhảy tưng tưng, mà app gãy vẫn cứ gãy. Trong đống đó có cả "test hiển nhiên" (tautological test, kiểu true == true): test để làm chứng cho thứ nó vừa viết, chứ không chứng…5 phút đọc
- Bước 16AK Render: đừng bắt AI viết hàng trăm dòng HTML chỉ để trình bày một báo cáoBảo AI "làm cho tui cái báo cáo", nó hì hục viết HTML, CSS, JavaScript, responsive, dark mode, biểu đồ... ra cả trăm KB. Lần sau yêu cầu báo cáo tương tự, nó lại viết gần như từ đầu. Dùng một model đắt tiền để làm việc mà trình biên dịch làm tốt hơn, nghe hổng hợp lý.6 phút đọc
- Bước 17Biến cloud thành nơi làm việc: VPS, Orca, OMP và nhãn `ai-handle` để agent tự nhận issueDạo này tui ít khi phải gõ prompt. Không phải tui lười hơn, mà vì công việc không còn bắt đầu bằng việc tui mở terminal. Khách báo lỗi, hệ thống tạo issue có ngữ cảnh, agent trên VPS nhận việc, chạy test, mở PR, báo về Discord. Tui chỉ duyệt kết quả.6 phút đọc
- Bước 18Software factory: đừng chỉ build phần mềm, hãy nghĩ tới việc build nhà máyMỗi lần có buzzword mới, tui đều có cảm giác "ủa, hoá ra cái mình làm bấy lâu có tên hả?". Prompt engineering, context engineering, harness engineering, rồi tuần này là software factory. Nghe hoành tráng như quảng cáo làm giàu tự động, nhưng lần này có cái đáng đào.8 phút đọc
- Bước 19Cách tui làm anime bằng Opus 5.5: năm giai đoạn, và vì sao QA subagents quan trọng hơn modelTui bắt Opus 5.5 làm anime từ một câu prompt chay, rồi đẩy nó qua năm giai đoạn để ra series FRONTIER (tập 01 đã đăng YouTube, tập 02 lúc viết bài gốc còn đang render). Bài này rút ra phần dùng lại được. Bài này không phải cam kết "ai cũng làm ra anime xịn bằng một lệnh".6 phút đọc
- Bước 20Personal kit và `/ak-dogfood`: tự chỉnh skill mà update không đè mấtAi xài kit lâu cũng gặp cảnh này: skill ak-plan chạy ổn, nhưng team bạn có một quy ước riêng mà nó cứ quên. Bạn mở SKILL.md ra sửa, chạy ngon lành. Tuần sau ak update, bản sửa bay màu 😂9 phút đọc
- Bước 21AK Vault: cất secret cho agent xài mà agent không thấyNói trước cho công bằng: vault không phải thuốc tiên. Nó giải quyết đúng một bài toán, là agent dùng được key mà không cầm được key. Nó không cứu được bạn khi bạn tự dán key vô khung chat, và cũng không cứu được một chương trình đã nhận key rồi đem đi đâu đó. Mấy giới hạn này tui ghi rõ ở mục 9.24 phút đọc