# Training:conductor

> Conductor: quản lý pipeline xây dựng training từ init đến review. Entry point chính.

- Skill: `hoangvantuan/training-conductor` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add hoangvantuan/training-conductor`
- Raw SKILL.md: https://api.skillmd.com/api/skills/hoangvantuan/training-conductor/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: hoangvantuan (https://skillmd.com/u/hoangvantuan)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/hoangvantuan/training-conductor

---


# 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:
>
> 1. **Init**: Xác định mục tiêu, đối tượng, metric thành công
> 2. **Research**: Trích xuất nội dung từ tài liệu nguồn (sách, video, URL, notes)
> 3. **Analyze**: Tách thành modules độc lập, xếp thứ tự học
> 4. **Plan**: Thiết kế từng module (tỉ lệ lý thuyết/thực hành, deliverable)
> 5. **Build**: Sinh toàn bộ nội dung (bài đọc, bài tập, case study, đánh giá)
> 6. **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

