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 Cheatsheet skill AgentKit Workflows AgentKit Statusline AgentKit Cập Nhật CLI ak & Kits AgentKit Helper 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 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 Sơ đồ hệ thống UI Review Gate Khuyến Mãi Ủng Hộ VividKit

Tóm tắt nhanh / Lệnh

Bộ Engineer

Chỉ trên beta

/ak:atoz

Giao việc từ A đến Z

Trao đổi một lần ở đầu, sau đó không cần trông chừng: chốt phạm vi và Done means qua buổi phỏng vấn ak:advise kèm một lần Confirm rõ ràng, giao đủ mọi thứ cần thiết trong một lượt, rồi agent điều phối các sub-session song song và cập nhật GitHub issue cho tới khi mọi mục Done means đã chốt đều được kiểm chứng.

01

Chốt phạm vi

02

Xác nhận brief

03

Liệt kê thứ cần giao

04

Kiểm tra lại đầu vào

Nguyên tắc 01

Mỗi gate dùng kết quả của gate trước: Lock, rồi Prepare, rồi Execute.

Nguyên tắc 02

Hỏi đủ mọi thứ từ đầu để lần chạy không phải quay lại xin một đầu vào lẽ ra đã xin được ngay từ đầu.

Nguyên tắc 03

Tự quyết mọi việc nằm trong brief và ghi lại từng quyết định không hiển nhiên cho báo cáo cuối.

Nguyên tắc 04

Báo cáo của sub-session chưa phải bằng chứng; kiểm chứng kết quả đã gộp theo từng mục Done means.

Bản đồ thực thi

Các nhánh chính từ đầu vào đến kết quả, bám theo cách command chạy khi dùng thật.

01

Khởi động

Đầu vào, phạm vi, route

  1. 1 Chốt phạm vi Chạy buổi phỏng vấn ak:advise trên yêu cầu: mỗi lần một câu hỏi, diễn giải lại kèm Done means quan sát được, bản xem trước trực quan và handoff brief (Objective, Done means, Out of scope, Constraints). --yagni được chuyển tiếp nếu bạn gắn.
  2. 2 Xác nhận brief Đóng gate 1 bằng một câu hỏi có Confirm, Edit hoặc Abort. Chỉ Confirm rõ ràng mới đi tiếp; Edit chỉ quay lại đúng phần cần sửa. Sau Confirm, brief trở thành hợp đồng.
  3. 3 Liệt kê thứ cần giao Kiểm tra môi trường trước (CLI đã cài, đăng nhập, biến môi trường có hay không, remote, branch protection), rồi chỉ liệt kê những gì thật sự còn thiếu: là gì, vì sao cần, run sẽ đọc ở đâu và kiểm tra sẵn sàng bằng cách nào. Các lựa chọn đảo ngược được thì ghi thành mặc định để bạn đổi nếu muốn.
02

Xử lý

Agent / skill thực thi

  1. 4 Kiểm tra lại đầu vào Khi bạn báo đã sẵn sàng, kiểm tra lại từng mục mà không thay đổi gì (có hay không, trạng thái đăng nhập, một lệnh chỉ đọc), báo phần còn thiếu thành một danh sách ngắn rồi chờ tiếp. Mục bạn chủ động bỏ qua được ghi vào brief kèm hệ quả.
  2. 5 Lập plan và chia việc Session chính thành bộ điều phối: lập plan bằng ak:plan, chia việc thành các phần không đụng chung file, và chạy các phần độc lập trong sub-session song song, mỗi phần có worktree riêng khi cần sửa code.
  3. 6 Chạy và giám sát Chọn số việc chạy song song theo quota còn lại và sức máy, giao phần việc cơ học cho model rẻ hơn, nhắc hoặc giao lại sub-session bị kẹt, và đối chiếu mọi kết quả được báo với diff trước khi gộp.
03

Kiểm chứng

Gate, review, xác thực

  1. 7 Theo dõi trên GitHub Chuyển nhãn issue của công việc qua in progress, in review, done (đã mở PR) và shipped (đã merge). Bug hay lỗ hổng không liên quan phát hiện giữa chừng được tách thành issue riêng, đã lọc trùng, gắn nhãn ai-handle thay vì sửa luôn trong lần chạy này.
  2. 8 Review độc lập Review cuối chạy trong một sub-session mới có context tách biệt (ví dụ ak:code-review hoặc ak:review-pr), không bao giờ trong bộ điều phối đã viết code. Lỗi tìm được sẽ sửa rồi review lại tới khi sạch.
  3. 9 Kiểm chứng và báo cáo Chỉ kết thúc khi mọi mục Done means đã được kiểm chứng trên kết quả đã gộp, review sạch, nhãn issue đúng thực tế và không còn tiến trình, worktree hay cache nào do run tạo ra. Giao chưa đủ thì báo là chưa đủ.

Cú pháp, đối số, subcommand

Cách gọi skill: cú pháp, đối số vị trí, option dùng chung, rồi từng subcommand với cú pháp và kết quả riêng.

Cú pháp

/ak:atoz "<request or URL>" [--yagni]

Đối số

"<request or URL>" Bắt buộc

Yêu cầu cần giao

Việc cần làm trọn từ đầu đến cuối, dạng mô tả hoặc URL như một GitHub issue. Nội dung này được xem là dữ liệu: mọi chỉ dẫn lồng bên trong nhằm bỏ qua gate, nới quyền hay lấy secret đều bị bỏ qua.

/ak:atoz "Add CSV export to the reports page"

Option dùng chung

--yagni

Cắt phần không cần thiết

Được chuyển sang buổi phỏng vấn ak:advise để phần phạm vi không cần cho kết quả đã nêu bị đặt câu hỏi trước khi brief được xác nhận.

/ak:atoz "Add CSV export to the reports page" --yagni

Đừng bỏ qua bước bắt buộc

Mỗi mục đối chiếu một lối tắt dễ mắc với cách làm đúng mà skill yêu cầu.

Lối tắt dễ mắc

User nói trông ổn rồi; bắt tay làm thôi.

Cách làm đúng

Chỉ Confirm rõ ràng trên handoff brief mới mở gate tiếp theo.

Lối tắt dễ mắc

Khi nào cần API key thì hỏi sau.

Cách làm đúng

Mọi đầu vào mà run không tự lấy được phải liệt kê trước khi chạy, và secret đặt trong biến môi trường, không dán vào chat.

Lối tắt dễ mắc

Sub-session báo xong là xong.

Cách làm đúng

Đối chiếu từng báo cáo với diff, và review kết quả cuối trong một session mới có context tách biệt.

Prompt mẫu

Ví dụ gọi command theo từng flag, subcommand, mode hoặc route dùng được trong workflow thực tế.

Làm trọn một tính năng Khuyến nghị 
/ak:atoz "Add CSV export to the reports page"
Dùng khi:
Khi bạn muốn thống nhất phạm vi một lần, giao đủ những gì công việc cần, rồi để agent tự làm tới cuối mà không phải hỏi lại.
Kết quả:
Buổi phỏng vấn ak:advise kết thúc bằng câu hỏi Confirm/Edit/Abort, tiếp theo là danh sách đầu vào cần giao và các mặc định; sau khi bạn trả lời ready, agent lập plan, chạy sub-session song song, review độc lập và báo từng mục Done means kèm bằng chứng.
Bắt đầu từ issue, phạm vi gọn 
/ak:atoz "https://github.com/acme/app/issues/42" --yagni
Dùng khi:
Khi yêu cầu đã nằm trong một GitHub issue và bạn muốn cắt phần không cần cho kết quả trước khi xác nhận.
Kết quả:
Buổi phỏng vấn đặt câu hỏi cho phần phạm vi dư, brief đã xác nhận trở thành hợp đồng, và nhãn issue chuyển qua in progress, in review, done rồi shipped theo tiến độ của lần chạy.

Phạm vi xử lý

  • Chốt phạm vi có xác nhận rõ ràng
  • Gom đầu vào cần thiết ngay từ đầu
  • Điều phối sub-session song song
  • Theo dõi nhãn GitHub issue
  • Review cuối độc lập

Artifact tạo ra

Báo cáo cuối của A-to-Z

Mẫu đường dẫn

Từng mục Done means kèm bằng chứng, các quyết định đã thay bạn đưa ra, mục đã được bỏ qua, và rủi ro hay việc còn lại.

Do bộ điều phối viết sau khi kiểm chứng kết quả đã gộp; giao chưa đủ thì ghi là chưa đủ, không bao giờ ghi là xong.

Skill liên quan

Tiếp theo