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:interview-docs

Viết tài liệu bằng phỏng vấn

Biến vision, quyết định và ngôn từ của chính user thành README, ADR, principles, strategy, review hoặc framework bền vững qua phỏng vấn có hướng dẫn.

01

Chọn chế độ

02

Hỏi khi mơ hồ

03

Đọc tài liệu gần đó

04

Phỏng vấn từ user

Nguyên tắc 01

Tài liệu phải giữ kiến thức, gu và quyết định của user.

Nguyên tắc 02

Hỏi trước khi xếp hạng, sắp thứ tự hoặc ưu tiên nội dung user đưa.

Nguyên tắc 03

Dùng ak-brainstorm khi cần AI đề xuất và ak-docs khi tài liệu phải suy từ code.

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ọn chế độ Chọn vision mode cho vision dự án, hướng README và quyết định ADR; chọn structured-doc mode cho một tài liệu do user làm chủ như principles, strategy, review hoặc framework.
  2. 2 Hỏi khi mơ hồ Nếu cả hai mode đều phù hợp, hỏi một câu ngắn trước khi viết.
02

Xử lý

Agent / skill thực thi

  1. 3 Đọc tài liệu gần đó Ở vision mode, đọc README.md và docs/adr trước; ở structured mode, đọc tài liệu gần đó và chỉ tạo skeleton tối thiểu một lần.
  2. 4 Phỏng vấn từ user Hỏi năm câu đa dạng ở vision mode, hoặc đúng một câu mở cụ thể mỗi lượt ở structured-doc mode.
03

Kiểm chứng

Gate, review, xác thực

  1. 5 Patch sau mỗi câu trả lời Sau mỗi câu trả lời, đọc lại tài liệu hoặc section bị ảnh hưởng và patch lời của user trước khi hỏi tiếp.
  2. 6 Giữ đúng quyết định Giữ README cho vision và ghi quyết định kiến trúc đã được duyệt vào ADR ngắn đánh số với Status, Context, Decision và Consequences.
04

Đóng

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

  1. 7 Tôn trọng danh sách chưa xếp hạng Xem danh sách user đưa là chưa có thứ tự cho đến khi user duyệt rõ rank, sequence hoặc priority.
  2. 8 Dừng suy đoán Không bịa nội dung, ghi đè tài liệu có sẵn, thêm section suy đoán hoặc dùng ADR để ra quyết định kiến trúc chưa được duyệt.

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:interview-docs <vision | document-path | topic>

Đối số

<vision | document-path | topic> Bắt buộc

Đích phỏng vấn

Gợi ý intent cho cuộc phỏng vấn: nêu vision mode, đường dẫn tài liệu hoặc topic, kèm audience, scope, section được bảo vệ và lúc cần dừng. Đây không phải parser cố định và không cho phép Skill tự bịa quyết định.

/ak:interview-docs ./docs/product-principles.md "Interview me to capture five product principles in my wording."

Đừ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 đưa năm ý; tự xếp theo quan trọng.

Cách làm đúng

Danh sách của user là chưa có thứ tự nếu họ chưa duyệt rank hoặc priority.

Lối tắt dễ mắc

Code cho thấy kiến trúc; viết ADR luôn.

Cách làm đúng

ADR chỉ ghi quyết định user đã đưa ra rõ ràng.

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

Phỏng vấn vision Khuyến nghị 
/ak:interview-docs vision for README direction and first ADRs
Dùng khi:
Khi câu trả lời của user cần trở thành vision dự án, hướng README và các quyết định được ghi nhận.
Kết quả:
Đọc README.md và docs/adr trước, hỏi năm câu đa dạng, rồi patch wording của user vào README hoặc ADR đánh số sau mỗi câu trả lời.
Mảng vision tập trung 
/ak:interview-docs vision focused on product principles
Dùng khi:
Khi cuộc phỏng vấn cần bám vào một mảng trọng tâm được yêu cầu thay vì quét rộng toàn bộ vision dự án.
Kết quả:
Dùng vision mode với trọng tâm đã yêu cầu, điều chỉnh cụm câu hỏi và tách nội dung README khỏi các quyết định ADR rõ ràng.
Tài liệu có cấu trúc 
/ak:interview-docs docs/principles.md
Dùng khi:
Khi cần xây một tài liệu bền vững do user làm chủ bằng phỏng vấn từng câu một.
Kết quả:
Đọc tài liệu gần đó, tạo skeleton tối thiểu một lần, hỏi đúng một câu mở cụ thể, rồi đọc lại và patch section đích.
Ghi nhận quyết định 
/ak:interview-docs ADR for the deployment approach
Dùng khi:
Khi một quyết định kiến trúc đã được user duyệt cần được ghi lại mà không để assistant tự quyết kiến trúc.
Kết quả:
Xác nhận quyết định từ câu trả lời của user và chỉ ghi nội dung đã duyệt vào ADR ngắn có Status, Context, Decision và Consequences.

Phạm vi xử lý

  • Phỏng vấn để viết tài liệu
  • Cập nhật vision README
  • Ghi ADR
  • Tài liệu principles và strategy
  • Giữ wording của user

Artifact tạo ra

Đầu ra interview-docs

Mẫu đường dẫn

README, ADR hoặc tài liệu đích được cập nhật bằng wording từ user và chỉ quyết định rõ ràng.

Quy trình tiếp tục từng câu trả lời cho đến khi user kết thúc phỏng vấn.

Tiếp theo