| name | training:conductor |
| description | Conductor: quản lý pipeline xây dựng training từ init đến review. Entry point chính. |
Training: Pipeline Conductor
Nhiệm vụ
Entry point chính cho Training Engine. Tìm dự án training hiện có, hiển thị trạng thái, gợi ý bước tiếp theo, hoặc khởi tạo dự án mới.
Quy trình
1. Tìm dự án
Tìm thư mục training-projects/ trong CWD.
- Không tồn tại → bước 2a
- Tồn tại nhưng rỗng → bước 2a
- Có 1 project → bước 2b
- Có nhiều project → bước 2c
2a. Chưa có dự án (Onboarding)
Khi user lần đầu dùng Training Engine (không có training-projects/), giải thích ngắn gọn trước khi dẫn vào init:
Training Engine giúp bạn xây dựng bộ tài liệu đào tạo hoàn chỉnh qua 6 bước:
- Init: Xác định mục tiêu, đối tượng, metric thành công
- Research: Trích xuất nội dung từ tài liệu nguồn (sách, video, URL, notes)
- Analyze: Tách thành modules độc lập, xếp thứ tự học
- Plan: Thiết kế từng module (tỉ lệ lý thuyết/thực hành, deliverable)
- Build: Sinh toàn bộ nội dung (bài đọc, bài tập, case study, đánh giá)
- Review: Kiểm tra chất lượng, phát hiện lỗ hổng
Output: thư mục markdown có cấu trúc, sẵn sàng upload Google Docs hoặc dùng trực tiếp.
Bạn chọn phương pháp sư phạm (mặc định: Văn-Tư-Tu, tỉ lệ 10% lý thuyết, 20% suy tư, 70% thực hành). Có thể thêm phương pháp khác sau.
Bắt đầu?
Nếu user đồng ý → thực hiện inline (đọc skills/training-init/SKILL.md và follow quy trình).
Nếu user hỏi thêm về Training Engine, trả lời dựa trên context sau:
Khi nào dùng Training Engine?
- Cần đào tạo có hệ thống (không phải chỉ chia sẻ 1 bài viết)
- Có ≥ 3 chủ đề cần dạy
- Cần đo lường kết quả sau đào tạo
- Cần nhiều người cùng dạy (facilitator hub)
Khi nào KHÔNG cần?
- Chỉ cần viết 1 bài hướng dẫn ngắn → dùng skill khác
- Chia sẻ kiến thức không cần đo lường → viết blog/doc thường
Method là gì?
- Phương pháp sư phạm quyết định cách chia nội dung trong mỗi module
- Văn-Tư-Tu (mặc định): 10% đọc, 20% suy tư, 70% thực hành
- Xem tất cả methods:
/training:method-creator
- Tạo method riêng:
/training:method-creator hoặc copy skills/training-method-creator/training-methods/_template/
Output trông thế nào?
training-projects/feedback-cho-leader/
00-brief.md Mục tiêu + metric
01-content-inventory.md Nội dung đã trích xuất
02-module-map.md Sơ đồ modules
03-module-designs/ Blueprint từng module
04-modules/ Nội dung hoàn chỉnh
module-01-sbi-framework/
README.md
01-van/ Lý thuyết
02-tu-suy-tu/ Câu hỏi phản chiếu, case study
03-tu-thuc-hanh/ Bài thực hành, dự án
04-danh-gia/ Rubric, đánh giá
_facilitator-hub/ Hướng dẫn cho người dạy
_danh-gia-khoa/ Survey + follow-up 30/60/90 ngày
05-review-report.md Báo cáo chất lượng
2b. Có 1 dự án
Đọc project.json. Hiển thị dashboard (bước 3).
2c. Có nhiều dự án
Liệt kê:
| # | Dự án | Method | Phase hiện tại |
|---|
| 1 | feedback-cho-leader | van-tu-tu | research |
| 2 | onboarding-dev | van-tu-tu | init |
Hỏi user chọn → đọc project.json → bước 3.
3. Dashboard
Đọc project.json, hiển thị:
Training: <name>
Method: <method>
✅ Init → 00-brief.md
✅ Research → 01-content-inventory.md
▶️ Analyze (gợi ý chạy tiếp)
⬜ Plan
⬜ Build
⬜ Review
Ký hiệu:
- ✅ = done
- ▶️ = gợi ý (phase tiếp theo chưa done)
- ⬜ = pending
4. Gợi ý hành động
Dựa trên current_phase, gợi ý:
| current_phase | Gợi ý |
|---|
| init | Chạy /training:research để nghiên cứu nội dung |
| research | Chạy /training:analyze để phân tích và tách module |
| analyze | Chạy /training:plan để thiết kế từng module |
| plan | Chạy /training:build để sinh nội dung |
| build | Chạy /training:review để review chất lượng |
| review | Khoá hoàn thành! Output tại training-projects/<slug>/04-modules/ |
5. Nhảy phase
User có thể yêu cầu chạy bất kỳ phase nào. Conductor kiểm tra prerequisite:
- Phase yêu cầu phase trước đã done → cho phép
- Phase trước chưa done → thông báo cần chạy phase trước
6. Troubleshooting (khi user bị kẹt)
Nếu user báo không biết làm gì tiếp, hoặc output phase trước không đúng:
| Vấn đề | Hướng dẫn |
|---|
| Brief quá mơ hồ, research không ra gì | Quay lại /training:init, bổ sung câu trả lời cụ thể hơn |
| Modules tách không hợp lý | Chạy lại /training:analyze. Phase này idempotent, ghi đè output cũ |
| Nội dung build ra không khớp brief | Kiểm tra 05-review-report.md. Nếu chưa có, chạy /training:review |
| Muốn thay đổi method giữa chừng | Sửa project.json field "method". Chạy lại từ phase plan trở đi |
| Review fail nhiều module | Sửa issues trong 04-modules/, chạy /training:review lại |
| Muốn thêm module mới sau khi build | Quay lại /training:analyze thêm module, rồi /training:plan + /training:build cho module mới |
Quy tắc chung: mỗi phase ghi đè output cũ khi chạy lại. Quay lại phase nào cũng được, miễn phase trước nó đã done.
7. Hành động khác
User có thể yêu cầu:
- "Xem brief" → đọc
00-brief.md
- "Xem module map" → đọc
02-module-map.md
- "Xem review report" → đọc
05-review-report.md
- "Đổi method" → cảnh báo ảnh hưởng đến output đã tạo
- "Xoá dự án" → xác nhận, xoá thư mục
