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.
Ctrl K
Tóm tắt nhanh / Lệnh
Bộ Marketing
/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 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 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
- 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.
- 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
- 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.
- 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
- 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.
- 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.
Đừ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
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 tầm nhìn dự án cho README và các ADR đầu tiên- Dùng khi:
- Khi vision và quyết định của user cần định hình README/ADR.
- Kết quả:
- Đọc docs hiện có, hỏi câu đa dạng và patch wording của user sau mỗi câu trả lời.
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 bằng phỏng vấn từng câu.
- Kết quả:
- Tạo skeleton tối thiểu nếu cần, hỏi đúng một câu mở và giữ edits.
Tài liệu nguyên tắc marketing
/ak:interview-docs viết tài liệu nguyên tắc marketing từ các quyết định của chúng tôi- Dùng khi:
- Tài liệu phải đến từ câu trả lời của user, không phải copy chiến lược bịa.
- Kết quả:
- Hỏi từng câu phỏng vấn rồi viết tài liệu nguyên tắc bằng ngôn từ của user, không bịa chiến lược.
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.