Biến quyết định của stakeholder thành tài liệu với ak:interview-docs

Dùng ak:interview-docs khi artifact lâu dài phải đến từ tri thức, gu và quyết định rõ ràng của một người. Skill đặt câu hỏi, chờ câu trả lời và patch các câu trả lời vào target khi phỏng vấn diễn ra; Skill không tự nghĩ nội dung còn thiếu hay suy ra quyết định từ code.

Chọn phỏng vấn khi người dùng là nguồn

Dùng ak:interview-docs khi

• Founder hoặc stakeholder cần diễn đạt project vision hay định hướng README.
• Quyết định kiến trúc đã duyệt cần một ADR ngắn.
• Bạn muốn viết principles, strategy, review hoặc framework qua từng câu hỏi tập trung.
• Brief tài liệu chưa đủ vì judgment quan trọng vẫn nằm ở một người.

Chọn workflow khác khi

• Tài liệu phải được suy ra từ bằng chứng repository. Dùng ak:docs.
• Bạn muốn assistant đề xuất và so sánh option. Dùng ak:brainstorm.
• Bạn cần tổng hợp finding từ transcript có sẵn thay vì phỏng vấn live có hướng dẫn. Hãy giao task tổng hợp có phạm vi đó cho workflow research hoặc writing phù hợp.

Chuẩn bị mode, target và quyền hạn

Chọn vision mode cho project vision, định hướng README và quyết định ADR. Chọn structured-doc mode cho một tài liệu do người dùng viết như principles, strategy, review hoặc framework. Nếu cả hai đều phù hợp, Skill hỏi một câu ngắn trước khi viết.

Nêu topic hoặc document path, người sẽ review và material riêng tư hay nhạy cảm phải loại trừ. Chạy trong project chứa tài liệu hiện có. Vision mode đọc README.md và docs/adr; structured-doc mode đọc tài liệu gần đó cùng section target.

Bắt đầu phỏng vấn

/ak:interview-docs ./docs/campaign-principles.md Phỏng vấn tôi để ghi lại nguyên tắc phê duyệt campaign claim. Giữ cách diễn đạt của tôi, mỗi lần hỏi một câu mở và không publish

/ak:interview-docs ./docs/campaign-principles.md Phỏng vấn tôi để ghi lại nguyên tắc phê duyệt campaign claim. Giữ cách diễn đạt của tôi, mỗi lần hỏi một câu mở và không publish

$ak:interview-docs ./docs/campaign-principles.md Phỏng vấn tôi để ghi lại nguyên tắc phê duyệt campaign claim. Giữ cách diễn đạt của tôi, mỗi lần hỏi một câu mở và không publish

Argument có thể là vision, document path hoặc topic. Đây không phải flag batch generation: workflow vẫn interactive và chờ câu trả lời của người dùng.

Hiểu hai giai đoạn phỏng vấn

Vision mode

1. Đọc README.md và thư mục docs/adr hiện có.
2. Hỏi một batch năm câu đa dạng trừ khi bạn yêu cầu số khác hoặc lĩnh vực hẹp.
3. Sau mỗi câu trả lời, đọc lại tài liệu bị ảnh hưởng và patch lời người dùng vào README.md hoặc ADR trước khi xử lý câu tiếp theo.
4. Giữ README.md tập trung vào vision. Đặt quyết định được duyệt rõ vào ADR đánh số ngắn với Status, Context, Decision và Consequences.
5. Tiếp tục tới khi người dùng kết thúc phỏng vấn.

Structured-doc mode

1. Đọc tài liệu gần đó và tạo một skeleton tối thiểu.
2. Hỏi đúng một câu cụ thể, mở rồi chờ.
3. Đọc lại target section và patch câu trả lời trước khi hỏi câu tiếp theo.
4. Giữ wording cùng edit của người dùng. Không overwrite tài liệu hiện có hay thêm section suy đoán.

Giữ quyền tác giả và phê duyệt ở người dùng

Đừng ghi secret, credential, personal data hoặc material phỏng vấn bảo mật vào tài liệu project. File edit local không cấp quyền publish, liên hệ participant, thay đổi tài khoản live hay chia sẻ tài liệu với provider bên ngoài.

Xác minh tài liệu và bằng chứng phỏng vấn

Kết quả hoàn tất nên cho thấy:

• mode và target document đã chọn;
• câu hỏi đã đặt cùng quyết định của người dùng được ghi trong session;
• diff tập trung giữ wording và edit hiện có của người dùng;
• không có rank, quyết định, bằng chứng hay section suy đoán được nghĩ ra; và
• câu hỏi chưa trả lời hoặc bước publish vẫn cần phê duyệt.

Output vision mode giới hạn ở định hướng README.md và ADR đánh số ngắn trong route docs/adr hiện có của project. Output structured-doc ở trong tài liệu đã nêu. Review diff sau mỗi câu trả lời quan trọng, không chỉ ở cuối.

Khắc phục và hiểu giới hạn

Skill không thể khôi phục intent bạn chưa nêu, tự xác minh quyết định của người dùng với bằng chứng bên ngoài hay bảo đảm tài liệu đã sẵn sàng publish. Tiếp tục với ak:docs khi artifact phỏng vấn cần được đối chiếu với bằng chứng project.

Xem Tổng quan Marketing Kit và Projects, artifacts và checkpoints.