- 1. Sơ đồ brief 5 khối → Gửi → Diff → Lưu
- 2. Bảng thuật ngữ
- 3. Các bước tuần tự
- 4. Giải thích tính năng liên quan
- Khối “Phạm vi” - vũ khí chống AI lan man
- Khối “Kiểm tra” - buộc AI báo cáo
- Hồ sơ dự án vs Prompt & Skills
- 5. So sánh 3 công cụ
- 6. Làm được / không làm được
- 7. Bảo mật khi viết prompt
- 8. Bảng sự cố
- 9. Lời khuyên
- 10. Checklist & bài tiếp theo

DINHDANH Creator · Bài K01 · Cấp độ: Kỹ thuật
trong Creator
Viết brief có cấu trúc để AI sửa đúng file, đúng phạm vi - không “làm mới cả site” khi bạn chỉ muốn đổi một nút.
Mục tiêu bài học: Viết prompt 5 khối; chọn đúng mode Chat|Coder|Debug|Giao diện|Kiến trúc; đính kèm ảnh/tài liệu và Hồ sơ dự án đúng chỗ.
Thời lượng đọc: khoảng 16 phút.
Điều kiện trước: Đã đọc B01 (chat cơ bản), B05 (chọn mode), T11 (token & Prompt & Skills).
Bài trước: B05 - Chọn mode AI cho từng loại việc.
Bài tiếp theo: K02 - Làm việc an toàn: Clone → Diff → Lưu.
Nhãn UI chính:
1. Sơ đồ brief 5 khối → Gửi → Diff → Lưu
2. Bảng thuật ngữ
| Thuật ngữ | Nghĩa | Nơi UI |
|---|---|---|
| Brief / prompt | Yêu cầu có cấu trúc gửi AI | Ô Yêu cầu AI...(Shift + Enter xuống hàng) |
| Mode | Kiểu làm việc AI tập trung vào việc gì | Dropdown: Chat · Coder · Debug · Giao diện · Kiến trúc |
| Phạm vi hẹp | Giới hạn file/section AI được phép sửa | Viết trong nội dung prompt (không có nút riêng) |
| Hồ sơ dự án | Brand tokens: màu, font, mission - inject vào mọi prompt | Nút cạnh khung chat |
| Prompt & Skills | Hồ sơ tone/kỹ năng bổ sung cho AI | Tab trong modal Hồ sơ dự án |
| Diff | So sánh dòng Thêm (+) / Xóa (−) trước khi chấp nhận | Panel So sánh thay đổi: |
3. Các bước tuần tự
- Bước 1 - Chọn mode: sửa chữ/layout → Giao diện; lỗi JS/console → Debug; data/API/Storage → Coder hoặc Kiến trúc; hỏi đáp nhẹ → Chat.
- Bước 2 - Bật ngữ cảnh: mở Hồ sơ dự án; nếu dự án dài, bật hồ sơ ở tab Prompt & Skills (xem T11 về token).
- Bước 3 - Viết brief 5 khối vào ô Yêu cầu AI...(Shift + Enter xuống hàng): Mục tiêu · Phạm vi (“CHỈ sửa…”, “KHÔNG đụng…”) · File/route đích · Ràng buộc (màu, mobile, dùng appifio_client) · Kiểm tra (“liệt kê file đã đổi”).
- Bước 4 - Đính kèm: bấm Tải ảnh (mockup) hoặc Tải tài liệu (PDF spec) nếu mô tả bằng chữ khó đủ.
- Bước 5 - Gửi: nhấn Gửi; đợi AI trả file. Nếu sai hướng, gửi tiếp trong cùng cuộc hoặc Mới để reset ngữ cảnh.
- Bước 6 - Duyệt Diff: mở So sánh thay đổi: → chấp nhận ✓ / từ chối ✗ từng file → hoặc Áp dụng thay đổi / Đóng.
- Bước 7 - Preview & Lưu: chuyển preview sang Thay đổi (so với Hiện tại) → khi OK → Lưu thay đổi.
4. Giải thích tính năng liên quan
Khối “Phạm vi” - vũ khí chống AI lan man
Luôn viết rõ “CHỈ sửa index.html section hero” hoặc “KHÔNG đổi routes/backend”. Creator có Diff nhưng phòng bệnh tốt hơn chữa - prompt hẹp giảm vòng reject.
Khối “Kiểm tra” - buộc AI báo cáo
Câu “Sau khi sửa, liệt kê file đã đổi và giải thích ngắn” giúp bạn so khớp với panel Diff - phát hiện sớm khi AI đụng file lạ.
Hồ sơ dự án vs Prompt & Skills
Hồ sơ dự án = design token & brand. Prompt & Skills = tone viết + quy tắc kỹ thuật (ví dụ “luôn dùng appifio_client”). Cả hai inject context - càng dài càng tốn token (T11).
5. So sánh 3 công cụ
| Công cụ | Prompt workflow | Khác biệt Creator |
|---|---|---|
| ChatGPT / Claude web | Chat tự do, copy code thủ công | Creator ghi thẳng file + Diff reject + preview Thay đổi |
| Lovable / v0 | Một prompt lớn, ít kiểm soát phạm vi | 5 mode + brief phạm vi + Hồ sơ dự án giữ nhất quán |
| Cursor IDE | @file mention, dev-focused | Creator có Inspector + Canvas + CMS manifest - không cần biết Git |
6. Làm được / không làm được
Làm được
- Hướng AI sửa đúng 1 section/file bằng brief phạm vi.
- Giữ brand xuyên suốt qua Hồ sơ dự án + Prompt & Skills.
- Gửi mockup qua Tải ảnh để AI bám layout thật.
Không làm được / hạn chế
- Prompt mơ hồ vẫn có thể khiến AI đụng nhiều file - Diff không thay thế brief tốt.
- Context dài (hồ sơ + chat dài) tốn token - có thể cắt ngắn (T11).
- AI không “nhớ” giữa các cuộc Mới - phải nhắc lại phạm vi.
7. Bảo mật khi viết prompt
- Không dán API key, secret, mật khẩu admin vào ô Yêu cầu AI... - dùng tab Backend Secrets.
- Tài liệu đính kèm (Tải tài liệu) được AI đọc - tránh file chứa PII khách hàng không cần thiết.
- Review Diff trước Lưu thay đổi nếu prompt có thể khiến AI thêm endpoint lộ dữ liệu.
8. Bảng sự cố
| Sự cố | Xử lý |
|---|---|
| AI sửa cả site dù yêu cầu nhỏ | Thêm khối Phạm vi “CHỈ sửa…”; ✗ reject file thừa trong Diff; Clone trước (K02). |
| AI quên dùng Storage/API có sẵn | Mode Coder + nhắc appifio_client (T02); thêm vào Prompt & Skills. |
| AI đổi màu/font trái Hồ sơ dự án | Cập nhật Hồ sơ dự án; prompt “bám token Primary/Secondary”. |
| Diff quá nhiều dòng, không đọc hết | Thu hẹp prompt; dùng ✗ từ chối file; gửi lại yêu cầu nhỏ hơn. |
9. Lời khuyên
- Một prompt = một việc. Việc lớn chia: Kiến trúc lên kế hoạch → Coder/Giao diện triển khai.
- Luôn có dòng “KHÔNG đụng …” - hiệu quả hơn mô tả dài phần cần sửa.
- Sau mỗi Gửi, xem preview Thay đổi trước prompt tiếp - tránh sửa chồng lỗi.
- Lưu mẫu brief 5 khối trong Prompt & Skills cho các task lặp lại (form, hero, footer).
10. Checklist & bài tiếp theo
- 5 khối brief là gì? Bạn viết được khối Phạm vi cho task “đổi màu nút CTA”?
- Mode nào cho: lỗi console · đổi CSS mobile · thêm route mới?
- Khác biệt Hồ sơ dự án vs Prompt & Skills?
- Sau Gửi, bạn kiểm tra ở đâu trước khi Lưu thay đổi?
- Bạn có biết ✓/✗ trong So sánh thay đổi: dùng thế nào?
Bài tiếp theo
K02 - Làm việc an toàn: Clone → sửa → Diff → Lưu
Áp dụng brief K01 trong quy trình có checkpoint - không sợ AI phá layout live.
Điều hướng nội bộ (cùng ngôn ngữ)
DINHDANH Creator · K01 · Prompt engineering