Tiếp nhận và kiểm tra đầu vào
AI kiểm kê file nguồn, đọc hướng dẫn trong workspace và chỉ hỏi những trường bắt buộc chưa có.
Từ nội dung thô đến bản HTML, PDF và đường dẫn Lark. Mỗi bước nêu rõ đầu vào, việc AI thực hiện, điểm BOD cần duyệt và đầu ra phải nhận được.
Không cần viết thành tài liệu hoàn chỉnh. BOD chỉ cần cung cấp phần đang có; AI phải hỏi lại những trường bắt buộc còn thiếu trước khi bắt đầu dựng nội dung.
| Thông tin | Mức độ | Cách cung cấp | Ví dụ đạt |
|---|---|---|---|
| Chủ đề và mục đích | Bắt buộc | Viết 1 đến 3 câu | Đào tạo quản lý cửa hàng xử lý phản hồi tiêu cực theo cùng một chuẩn. |
| Người học | Bắt buộc | Vai trò, mức kinh nghiệm và bối cảnh dùng | Quản lý cửa hàng mới nhận nhiệm vụ, đọc trên điện thoại trước ca làm. |
| Kết quả học tập | Bắt buộc | 3 đến 5 hành vi có thể quan sát | Phân loại đúng tình huống, chọn kịch bản phản hồi và biết lúc nào cần báo cấp trên. |
| Nguồn sự thật | Bắt buộc | File, thư mục hoặc đường dẫn Lark | SOP hiện hành, chính sách, ví dụ thật và biểu mẫu đang dùng. |
| Điều không được thay đổi | Bắt buộc | Số liệu, quy định, thuật ngữ và cảnh báo | Giữ nguyên mức phê duyệt và tên vai trò theo SOP. |
| Hình thức học | Nếu có | Đọc trước, workshop hoặc tài liệu tra cứu | Tài liệu tự học 15 phút kèm checklist tại quầy. |
| Người duyệt và hạn | Bắt buộc | Tên vai trò, hạn cần bản cuối | COO duyệt nội dung, HR duyệt cách diễn đạt, cần trước 17:00 ngày 08/08/2026. |
| Đích xuất bản | Nếu xuất Lark | Thư mục, người nhận và quyền | Thư mục Đào tạo vận hành, toàn bộ quản lý chỉ có quyền xem. |
Codex hoặc Claude Code thực hiện phần đọc, soạn và kết xuất. BOD chịu trách nhiệm xác nhận mục tiêu, tính đúng của nội dung và phạm vi chia sẻ.
AI kiểm kê file nguồn, đọc hướng dẫn trong workspace và chỉ hỏi những trường bắt buộc chưa có.
AI chuyển đầu vào thành brief ngắn, gồm người học, mục tiêu, phạm vi, cấu trúc, nguồn và tiêu chí đạt.
Chỉ thực hiện sau khi BOD trả lời “Đã duyệt brief”. AI dùng template đào tạo, dẫn nguồn nội bộ và không điền dữ liệu chưa được xác nhận.
BOD kiểm tra quy định, ví dụ, thứ tự thao tác và hành động mà người học phải thực hiện sau khi đọc.
AI chạy script xuất PDF, mở bản thật ở màn hình máy tính và điện thoại, sau đó sửa lỗi cắt trang, tràn chữ hoặc độ tương phản.
Sau khi BOD xác nhận người nhận và quyền, AI đưa PDF lên đúng thư mục, kiểm tra đường dẫn và báo lại danh sách đầu ra.
Có thể dán nguyên khối. Điền phần trong ngoặc vuông nếu đã có thông tin; nếu để trống, AI phải hỏi lại trước khi dựng tài liệu.
Bạn đang làm việc trong workspace Medicar. Hãy thực hiện trọn quy trình tạo tài liệu đào tạo nội bộ bằng các file và công cụ có sẵn trong workspace. ĐẦU VÀO TÔI CUNG CẤP - Chủ đề và mục đích: [điền hoặc để trống] - Người học và bối cảnh sử dụng: [điền hoặc để trống] - 3 đến 5 kết quả học tập mong đợi: [điền hoặc để trống] - File, thư mục hoặc link nguồn: [điền hoặc để trống] - Số liệu, quy định và thuật ngữ không được thay đổi: [điền hoặc để trống] - Hình thức học và thời lượng dự kiến: [điền hoặc để trống] - Người duyệt và hạn hoàn thành: [điền hoặc để trống] - Thư mục Lark, người nhận và quyền: [điền hoặc để trống nếu chưa xuất bản] QUY TRÌNH BẮT BUỘC 1. Đọc hướng dẫn trong workspace, sau đó kiểm kê toàn bộ file nguồn liên quan. Không sửa file nguồn. 2. Nếu thiếu đầu vào bắt buộc, hãy hỏi tôi một nhóm câu hỏi ngắn, ưu tiên câu hỏi ảnh hưởng trực tiếp đến mục tiêu học tập. Không bắt đầu dựng bản chính khi chưa đủ thông tin. 3. Lập brief gồm: mục đích, người học, hành vi sau đào tạo, phạm vi, cấu trúc đề xuất, nguồn sự thật, nội dung không được thay đổi, tiêu chí nghiệm thu và điểm còn chưa chắc chắn. 4. Dừng lại và chờ tôi trả lời chính xác “Đã duyệt brief”. 5. Sau khi được duyệt, dùng bod-medicar/templates/dao-tao.html và nhận diện trong bod-medicar/brand để tạo file bod-medicar/examples/[ten-khong-dau].html. 6. Nội dung phải có: mục tiêu học tập, phần kiến thức hoặc SOP theo thứ tự, ví dụ sát công việc, lỗi thường gặp, checklist tự kiểm tra, bài tập hoặc hành động sau học và nguồn tham chiếu. 7. Chỉ dùng thông tin có trong nguồn hoặc đã được tôi xác nhận. Đánh dấu [CẦN XÁC NHẬN] tại mọi điểm chưa đủ bằng chứng. Không tự tạo số liệu, quy định, trích dẫn hoặc tình huống được trình bày như sự thật. 8. Rà soát tiếng Việt, khả năng đọc trên điện thoại, độ tương phản, dấu đầu dòng, tiêu đề nhiều dòng và bản in A4. 9. Báo lại đường dẫn file, tóm tắt cấu trúc, danh sách điểm [CẦN XÁC NHẬN] và checklist nghiệm thu. Dừng để tôi duyệt nội dung trước khi xuất PDF hoặc đưa lên Lark. ĐỊNH DẠNG PHẢN HỒI Ở MỖI ĐIỂM DỪNG - Đã đọc những nguồn nào - Đang thiếu hoặc mâu thuẫn điều gì - Đầu ra vừa tạo - Tôi cần xác nhận chính xác điều gì Bắt đầu bằng việc kiểm kê nguồn và kiểm tra đầu vào. Chưa tạo bản HTML chính ở lượt đầu.
Đã duyệt brief. Hãy tạo bản HTML theo đúng brief và quy trình đã thống nhất. Chưa xuất PDF và chưa đưa lên Lark. Khi xong, báo đường dẫn file, các nguồn đã dùng, điểm cần xác nhận và checklist nghiệm thu.
Hãy sửa bản HTML theo phản hồi dưới đây. PHẢN HỒI - Phần cần sửa: [tiêu đề hoặc đoạn] - Vấn đề hiện tại: [sai, thiếu hoặc khó áp dụng ở đâu] - Nội dung mong muốn: [ghi rõ] - Nguồn xác nhận: [file, trang hoặc người xác nhận] Giữ nguyên các phần còn lại. Sau khi sửa, rà soát lại toàn bộ hiển thị và báo rõ file nào đã thay đổi cùng checklist đã chạy. Chưa xuất bản lên Lark.
Chỉ dùng khi bản HTML đã được người có thẩm quyền xác nhận và danh sách người nhận đã chốt.
Đã duyệt nội dung bản HTML [đường dẫn file]. Hãy thực hiện bước xuất bản theo loại “dao-tao”. YÊU CẦU 1. Chạy kiểm tra cú pháp và mở bản HTML ở kích thước máy tính cùng điện thoại. 2. Xuất PDF bằng bod-medicar/scripts/html-to-pdf.sh. 3. Mở bản PDF thật để kiểm tra cắt trang, tràn chữ, bảng, dấu tiếng Việt và độ tương phản. Nếu sửa, phải kết xuất và kiểm tra lại. 4. Trước khi đưa lên Lark, xác nhận lại với tôi thư mục đích, người nhận và quyền nếu ba thông tin này chưa rõ. 5. Khi đã rõ, dùng bod-medicar/scripts/publish.sh với loại dao-tao để đưa file lên Lark. 6. Không mở rộng quyền ngoài danh sách đã duyệt. BÀN GIAO - Đường dẫn file HTML - Đường dẫn file PDF - Đường dẫn Lark - Thư mục đích và phạm vi quyền đã áp dụng - Kết quả kiểm tra trên máy tính, điện thoại và bản PDF - Bất kỳ bước nào chưa thực hiện được cùng lý do cụ thể
cd bod-medicar ./scripts/publish.sh examples/[ten-khong-dau].html dao-tao
Người phụ trách đối chiếu danh sách này trước khi chia sẻ cho nhân sự.