Chất liệu nền của khoá

Luật

Khoá chưa có course_seed thì máy sinh không đụng tới. Không sinh, không xếp hàng, và màn hình admin không hiện gì ngoài ô nhập chất liệu nền.

Ngưỡng tối thiểu 80 ký tự. Đây không phải con số thiêng, nó chỉ đủ để chặn ô trống và những dòng kiểu "khoá dạy về marketing".

Vì sao chặn, thay vì cứ sinh rồi sửa sau

Máy sinh không báo lỗi khi thiếu ngữ cảnh. Nó vẫn cho ra chữ trôi chảy, đúng ngữ pháp, đúng cấu trúc, và chung chung tới mức khoá nào cũng dùng được, tức không khoá nào dùng được.

Đó không phải giả định: hai mươi khoá đã cùng nằm ở mức 0 với những outcome nghe rất hay mà rỗng, và không ai phát hiện ra cho tới khi đọc kỹ từng cái. Thà trống và nói rõ là đang chờ người, còn hơn đầy chữ mà không ai dùng được.

Chất liệu nền vẫn do người soạn viết

Chất liệu nền không phải nội dung giảng dạy, nó là ý đồ thiết kế: khoá này dạy ai, dạy cái gì, dựa trên kinh nghiệm hay tài liệu nào. Người viết nó là người soạn, qua giao diện.

Agent không được tự viết chất liệu nền cho một khoá. Luật này không bị gỡ cùng luật nội dung khoá học (03.09.2026), vì lý do của nó khác: nội dung là thứ viết được từ hiểu biết chung, còn chất liệu nền là quyết định của người soạn về khoá này dạy ai và dựa trên kinh nghiệm nào. Agent viết hộ quyết định đó thì khoá học không còn là của ai. Xem skill course-content.

Đường đi

Người soạn dán chất liệu nền  →  POST /ops/seed/:slug
                              →  CourseFoundationWorkflow chạy NGAY
                              →  hàng rào chủ đề → đích đến → chân dung người học

Thứ tự cứng, và đó là lý do có workflow riêng:

1. Hàng rào chủ đề trước, mọi lượt sinh sau đều bơm nó vào prompt.
2. Đích đến trước chân dung người học, "khoá này hợp với ai" chỉ trả lời được khi đã biết "học xong làm được gì".

Rải ba việc này ra cho máy điều phối như artefact thường thì thứ tự phụ thuộc vào lượt nào chạy trước, tức phụ thuộc vào may rủi. Và hỏng một là hỏng cả: sinh được đích đến mà trượt chân dung người học thì khoá nằm ở trạng thái nửa vời, rồi lượt sau lại bám vào cái nửa vời đó mà đi tiếp.

Chạy ngay chứ không xếp hàng đợi, vì người soạn vừa dán chất liệu vào và đang ngồi chờ, đó là lúc duy nhất họ còn đủ ngữ cảnh để đọc và nhận xét kết quả.

Khi sửa mã

• requireSeed(env, courseId) trong authoring.ts là cửa duy nhất. Thêm engine mức 1 mới thì gọi nó, và chèn seedBlock(seed) vào đầu prompt, trước mọi thứ khác, vì đó là phần duy nhất trong prompt đến từ con người.
• Lỗi thiếu seed phải mang lời chỉ dẫn, không phải not found. Người đọc lỗi phải biết ngay phải làm gì, không phải đi hỏi kỹ sư.
• Máy điều phối lọc theo course_seed trước khi xếp việc, không phải sau.

Tài liệu

Xem thêm: Hệ thống tự sinh và tự nâng chất lượng · Năm mức hoàn thiện · Sổ rủi ro