Tóm tắt nhanh:
ak-interview-docsbiến tầm nhìn, quyết định và nguyên tắc trong đầu bạn thành tài liệu dự án, bằng chính câu chữ của bạn. Nó hỏi từng lượt và ghi ngay sau mỗi câu trả lời, không có skill tiếp theo cố định. Nó không đề xuất phương án (đó làak-brainstorm) và không đọc code để viết docs (đó làak-docs).
Công khai: mình là maintainer của AgentKit và có quan hệ affiliate: link AgentKit trong bài là link affiliate, mua qua link này bạn được giảm 30%.
Tóm tắt
Dùng khi bạn đã có tầm nhìn, quyết định hay nguyên tắc trong đầu nhưng chưa viết ra: README chưa nói dự án để làm gì, team vừa chốt một việc cần lưu lý do, hoặc bạn muốn viết bộ nguyên tắc, chiến lược từng phần một. Không cần khi bạn muốn AI đưa phương án (dùng ak-brainstorm) hay muốn tài liệu sinh từ code (dùng ak-docs).
flowchart LR
A["Ý trong đầu bạn"] --> B["ak-interview-docs"]
B --> C["README, file quyết định, tài liệu nguyên tắc"]
B --> D["Muốn AI đề xuất: ak-brainstorm"]
B --> E["Muốn viết từ code: ak-docs"]
C --> F["Dừng khi bạn kết thúc phỏng vấn"]Hai chế độ và hai quy tắc ghi:
| Khái niệm | Câu hỏi | Ví dụ |
|---|---|---|
| Chế độ tầm nhìn | Dự án này để làm gì, và bạn đã quyết những gì? | Viết lại phần định hướng trong README, ghi lại quyết định "chỉ hỗ trợ PostgreSQL". |
| Chế độ tài liệu có cấu trúc | Bạn muốn viết một tài liệu riêng nào? | Bộ nguyên tắc của team, chiến lược quý, khung đánh giá. |
| Ghi ngay sau mỗi câu trả lời | Lời bạn vừa nói nằm ở đâu trong tài liệu? | Bạn trả lời xong, nó đọc lại đoạn liên quan, chèn câu của bạn vào, rồi mới hỏi tiếp. |
| Chỉ ghi điều bạn đã chốt | Đây là quyết định hay mới là ý đang cân nhắc? | Bạn nói "có lẽ nên dùng Redis" thì nó không ghi thành quyết định. Bạn đưa 5 mục không đánh số thì nó không tự xếp thứ tự. |
Đối số là vision, đường dẫn tới tài liệu cần viết, hoặc một chủ đề. Yêu cầu khớp cả hai chế độ thì nó hỏi bạn một câu ngắn để chọn trước khi ghi gì.
Prompt mẫu cho phần định hướng trong README:
/ak-interview-docs vision
Dự án <tên dự án>. Tôi muốn README nói rõ dự án dành cho ai và không làm gì.
Hỏi tôi từng loạt ngắn, đừng tự viết ý thay tôi.Skill này không có cờ.
Phần dưới đây là bản chi tiết: luồng chạy, 5 tình huống kèm prompt, lịch sử thay đổi theo bản ak và các lỗi hay vấp. Bản chi tiết và trang trực quan dành cho subscriber. Agent của bạn cũng tìm được trong đó qua MCP của portal.
Mở khi tài khoản có quyền subscriber
Bài này dành cho subscriber
Khi tài khoản có quyền, toàn bộ bài, bản visual tương tác và lệnh gọi từ agent đều mở.
- Đăng nhập hoặc tạo tài khoản modernEngineerQuyền đọc gắn với email tài khoản.
- Chọn gói trên trang Bảng giáGói 1, 3 hoặc 12 tháng, trả bằng chuyển khoản VietQR. Quyền đọc mở khoảng một phút sau khi tiền về.
- Hoặc nhập mã Facebook subscriberNgười ủng hộ trang qua Facebook nhận mã kích hoạt qua tin nhắn mỗi tháng.
Đã là subscriber? Đăng nhập để đọc.
Dùng bài này trong agent của bạn
Lấy API keyChép đoạn dưới, dán vào Claude Code, Codex hay agent bạn đang dùng. Agent đọc bài rồi đối chiếu với repo đang mở.
Đọc bài "ak-interview-docs: phỏng vấn bạn, ghi lời bạn thành tài liệu" trên modernEngineer rồi áp dụng vào repo này.
1. Gọi tool content_get của MCP server modernengineer với locale "vi", slug "ak-interview-docs". Nếu chưa nối MCP server modernengineer, dừng lại và hướng dẫn tôi nối theo https://modernengineer.dev/vi/mcp.
2. Tóm tắt các bước chính của bài, chỉ ra bước nào áp dụng được cho repo này.
3. Đề xuất thay đổi cụ thể và hỏi tôi trước khi sửa file.Nối MCP cho Claude Code (một lần)
claude mcp add --transport http modernengineer \
https://api.modernengineer.dev/mcp \
--header "Authorization: Bearer <API key>"Đọc trọn bài qua MCP cần API key của tài khoản subscriber hoặc đã mua guide này. Không có quyền, agent sẽ chỉ đọc được phần mở đầu.
- Phiên bản
- v1.0.0
- Cập nhật
- 22/10/2026
- Giấy phép
- Bảo lưu mọi quyền
- Slug
- ak-interview-docs
