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

/ak:goal-warmup

Khóa mục tiêu trước khi chạy dài

Chuẩn bị trước cho /goal hoặc phiên tự động dài bằng Outcome Contract đã được duyệt, plan không lệch hợp đồng, review rủi ro drift và kết thúc Ready, Blocked hoặc Decision required mà không tự chạy.

01

Đọc mục tiêu

02

Scout nhẹ

03

Ước lượng rủi ro

04

Chặn hoặc cho fast path

Nguyên tắc 01

Khóa kết quả quan sát được trước khi tốn compute cho phiên chạy dài.

Nguyên tắc 02

Lộ blocker và điểm cần quyết định trước khi chạy, không đợi đến lúc đã drift.

Nguyên tắc 03

Giữ nguyên contract: mitigation được đổi cách làm, không đổi kết quả đã hứa.

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 Đọc mục tiêu Đọc goal trong dấu nháy và yêu cầu --fast nếu có, đồng thời xem goal và nội dung repo là dữ liệu không đáng tin.
  2. 2 Scout nhẹ Nếu goal liên quan repo, inspect vừa đủ bằng chứng để tránh đoán mò, đồng thời giữ preflight mặc định là không mutate.
  3. 3 Ước lượng rủi ro Phân loại local-only so với external dependency, credential, deploy, approval hoặc multi-service trước khi chọn mức assurance.
02

Xử lý

Agent / skill thực thi

  1. 4 Chặn hoặc cho fast path Nếu có --fast, chỉ cho phép sau khi đủ điều kiện và user chấp nhận reduced assurance; nếu không thì tiếp tục luồng đầy đủ.
  2. 5 Phỏng vấn hợp đồng Dùng câu hỏi kiểu advise hoặc diễn giải lại để tạo Outcome Contract: kết quả mong muốn, phạm vi, ngoài phạm vi, tín hiệu chấp nhận, ràng buộc, thay thế được phép và owner.
  3. 6 Xin duyệt Không lập kế hoạch cho đến khi ask_user trả approve/edit/abort cho contract; câu “trông ổn” tự do là chưa đủ.
03

Kiểm chứng

Gate, review, xác thực

  1. 7 Lập plan theo hợp đồng Gọi hoặc mô phỏng ak:plan với contract đã duyệt như ràng buộc cứng và có bảng traceability bắt buộc.
  2. 8 Review nguy cơ lệch Phân loại finding thành mitigation-within-contract, preflight-required, blocker hoặc outcome-change-request trước khi sửa plan.
  3. 9 Lập ma trận preflight Kiểm tra mọi phase và nhóm vấn đề thành phải có trước, nên quyết trước, hoặc có thể hoãn; ưu tiên unknown + blocking hơn Ready giả.
04

Đóng

Báo cáo, bàn giao, artifact

  1. 10 Xác nhận trạng thái cuối Xin xác nhận tóm tắt cuối trước khi Ready, rồi chỉ xuất handoff packet và scope guard; không bao giờ tự khởi động /goal.

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:goal-warmup "<goal>" [--fast]

Đối số

"<goal>" Bắt buộc

Goal cần chuẩn bị

Goal chạy dài bằng ngôn ngữ tự nhiên, gồm deliverable bắt buộc, phần loại trừ, tín hiệu chấp nhận, ràng buộc, thay thế được phép và dependency đã biết. Đây là input cho packet bàn giao, không phải quyền tự bắt đầu /goal.

/ak:goal-warmup "Migrate billing webhooks without payment regressions"

Option dùng chung

--fast

Kiểm tra nhanh

Yêu cầu nhánh review rút gọn chỉ cho việc nhỏ và local. Skill vẫn bắt buộc duyệt contract, lập plan, kiểm tra sẵn sàng, xác nhận cuối và không tự khởi chạy.

/ak:goal-warmup "Clean up stale internal docs links" --fast

Đừ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

Goal có vẻ đủ rõ; bắt đầu plan thôi.

Cách làm đúng

Chưa được plan trước khi Outcome Contract được duyệt rõ.

Lối tắt dễ mắc

Reviewer tìm thấy outcome tốt hơn; sửa plan luôn.

Cách làm đúng

Outcome-change-request nghĩa là cần quyết định, không được âm thầm đổi scope.

Lối tắt dễ mắc

Ready là plan trông ổn.

Cách làm đúng

Ready cần không còn blocker và user xác nhận tóm tắt cuối.

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ế.

Warmup đầy đủ Khuyến nghị 
/ak:goal-warmup "Migrate billing webhooks to the new provider without payment regressions"
Dùng khi:
Trước một long run nhiều phase tốn kém có dependency, credential và rủi ro regression.
Kết quả:
Phỏng vấn để có Outcome Contract được duyệt, lập plan kèm bảng traceability, phân loại finding trước khi sửa, preflight mọi phase, xin xác nhận cuối rồi xuất handoff Ready/Blocked/Decision mà không chạy execution.
Kiểm tra local nhanh 
/ak:goal-warmup "Clean up stale internal docs links" --fast
Dùng khi:
Khi việc có vẻ nhỏ, chỉ local, ít rủi ro nhưng vẫn cần khóa outcome trước long run.
Kết quả:
Kiểm tra eligibility của --fast và việc chấp nhận reduced assurance trước; nếu đủ điều kiện thì bỏ reviewer đối kháng tốn kém nhưng vẫn bắt buộc duyệt contract, traceability, consistency check nhẹ, preflight toàn plan, xác nhận cuối và không auto-start.
Readiness bị chặn 
/ak:goal-warmup "Prepare a production deploy run that requires staging credentials and release approval"
Dùng khi:
Trước long-run execution khi credential, approval hoặc prerequisite deploy có thể chặn readiness.
Kết quả:
Chỉ ghi nhận secret có hay không, giữ probe không mutate, đưa prerequisite chưa giải quyết vào preflight matrix và trả Blocked với action gỡ chặn cụ thể thay vì packet Ready sai.
Cần quyết định 
/ak:goal-warmup "Replace search infrastructure by Friday while preserving typo tolerance and all ranking behavior"
Dùng khi:
Khi outcome đã khóa có thể xung đột với deadline, tính khả thi hoặc finding review và trade-off không được âm thầm xử lý.
Kết quả:
Xem mọi trade-off đổi outcome hoặc locked scope không khả thi là Decision required, trình bày option và consequence cho user, đồng thời từ chối làm yếu acceptance signal hoặc âm thầm sửa contract.

Phạm vi xử lý

  • Outcome contract
  • Preflight trước phiên chạy dài
  • Review giữ nguyên hợp đồng
  • Packet bàn giao cho Codex /goal và Claude long-run

Artifact tạo ra

Kết quả goal-warmup

Mẫu đường dẫn

Trạng thái, tình trạng contract, path hoặc session của plan, số blocker, trạng thái fast path và bước kế tiếp.

Artifact cuối là packet bàn giao cho phiên chạy dài do user khởi động, không phải một lượt execution.

Skill liên quan

Tiếp theo