Skill Tạo Báo Cáo
Skill Tạo Báo Cáo
Template pattern chính thức (strict vs flexible) cho Skill tạo báo cáo: input thay đổi mỗi lần (dữ liệu), output giữ ổn định (cấu trúc) — ứng dụng cụ thể của degrees of freedom (bài 32) và input/output contract (bài 34).
Nắm vững nguyên lý và khái niệm nền tảng trước khi đi vào công cụ thực tế.
Áp dụng quy trình từng bước, case study thực chiến và template mẫu có sẵn.
Kiểm tra checklist hoàn thành, né tránh các sai lầm kinh điển để vận hành bền vững.
Nắm vững các khái niệm nền tảng, cơ chế hoạt động và mô hình tư duy cốt lõi.
1. Mục tiêu học tập
Sau bài này, bạn có thể:
2. Khái niệm cốt lõi
“Template pattern” chính thức — 2 mức độ nghiêm ngặt:
Mức nghiêm ngặt (khi cần đúng 1 khuôn cố định, ví dụ báo cáo gửi cấp trên định kỳ):
## Report structure
ALWAYS use this exact template structure:
# [Analysis Title]
## Executive summary[One-paragraph overview of key findings]
## Key findings- Finding 1 with supporting data- Finding 2 with supporting data- Finding 3 with supporting data
## Recommendations1. Specific actionable recommendation2. Specific actionable recommendationMức linh hoạt (khi cần đúng khung chung nhưng cho phép tùy biến theo từng loại phân tích):
## Report structure
Here is a sensible default format, but use your best judgment based on theanalysis:
# [Analysis Title]
## Executive summary[Overview]
## Key findings[Adapt sections based on what you discover]
## Recommendations[Tailor to the specific context]Đây chính là ứng dụng cụ thể của “degrees of freedom” đã học ở bài 32 — báo cáo cho báo cáo tài chính định kỳ (rủi ro sai lệch cấu trúc gây khó đọc) nên dùng mức nghiêm ngặt; báo cáo phân tích khám phá (mỗi lần phát hiện khác nhau) nên dùng mức linh hoạt.
3. Tại sao nội dung này quan trọng
“Tạo báo cáo” là 1 trong những tác vụ lặp lại phổ biến nhất trong công việc — đúng ứng viên lý tưởng để đóng gói thành Skill (đạt cả 4 tiêu chí đã học ở bài 29: lặp lại thường xuyên, quy trình tương đối ổn định, hướng dẫn dài nếu giải thích lại mỗi lần, có thể mô tả rõ khi nào dùng). Đây cũng là bài học tốt về cách cân bằng “nhất quán” (đầu ra luôn đúng cấu trúc) với “linh hoạt” (nội dung mỗi lần khác nhau tùy dữ liệu đầu vào).
4. Cơ chế hoạt động
Không có gì khác biệt về cơ chế kỹ thuật so với các Skill đã học (bài 35, 37, 38) — điểm đặc thù của “Skill tạo báo cáo” nằm ở việc input (dữ liệu phân tích) thay đổi mỗi lần được gọi, nhưng output (cấu trúc báo cáo) cần giữ ổn định. Đây chính là điểm khác biệt so với Skill giọng văn (bài 37 — profile khá cố định) — Skill tạo báo cáo là ví dụ điển hình nhất cho khái niệm “input/output contract” đã học ở bài 34: input linh hoạt ($ARGUMENTS hoặc dữ liệu đính kèm), nhưng output theo đúng 1 hợp đồng cấu trúc cố định.
5. Mental model
Tiếp nối chuỗi ẩn dụ: nếu Skill phân tích tài liệu (bài 38) là quy trình đọc theo chuẩn, thì Skill tạo báo cáo là quy trình viết theo chuẩn — cùng nguyên lý (đóng gói quy trình lặp lại), khác chiều (đọc vào vs viết ra). 1 khuôn báo cáo tốt giống như 1 biểu mẫu in sẵn tiêu đề mục — bạn điền nội dung khác nhau mỗi lần, nhưng người đọc luôn biết chính xác tìm thông tin gì ở đâu.
Quy trình thực thi từng bước, case study cụ thể và bộ prompt/template áp dụng ngay.
6. Hướng dẫn từng bước
SKILL.md hoàn chỉnh, test với ít nhất 2 bộ dữ liệu khác nhau — xác nhận cấu trúc output giữ ổn định dù nội dung khác nhau.7. Ví dụ thực tế
Áp dụng mẫu strict template cho báo cáo tiến độ dự án hàng tuần:
---name: weekly-progress-reportdescription: Generates a weekly project progress report from status updates or task lists. Use when the user asks for a weekly report, status update, or progress summary.---
## Report structure
ALWAYS use this exact template:
# Weekly Progress Report — [Date range]
## Executive summary[1 paragraph — overall status: on track / at risk / delayed]
## Completed this week- [Item with brief context]
## In progress- [Item] — [% complete or status note]
## Blockers- [Blocker, if any — otherwise state "None"]
## Next week- [Planned item]Đây là ví dụ minh họa tự thiết kế, áp dụng đúng mẫu “strict template” chính thức cho 1 tình huống công việc thực tế.
8. Prompt/template/workflow
Báo cáo này...- Gửi định kỳ cho cùng 1 nhóm người đọc, cần dễ so sánh giữa các kỳ? → Mức NGHIÊM NGẶT (ALWAYS use this exact template)- Mỗi lần phân tích 1 khía cạnh khác nhau, cần linh hoạt theo phát hiện? → Mức LINH HOẠT (sensible default, dùng best judgment)9. Visual hoặc diagram cần thiết
10. Bài tập thực hành
- Chọn 1 loại báo cáo bạn thường tạo (hoặc dùng ví dụ báo cáo tiến độ ở mục 7).
- Áp dụng khung quyết định (mục 8) để chọn mức nghiêm ngặt phù hợp.
- Viết
SKILL.mdhoàn chỉnh theo đúng mẫu đã chọn. - Test với 2 bộ dữ liệu khác nhau — cấu trúc output có giữ nhất quán không?
Checklist kiểm tra mức độ sẵn sàng, nhận diện các bẫy sai lầm và nguyên tắc vàng vận hành.
11. Checklist
12. Lỗi thường gặp
15. Best practices
16. Nội dung nâng cao (không bắt buộc)
Có thể kết hợp Skill tạo báo cáo với Skill phân tích tài liệu (bài 38) theo chuỗi: Skill phân tích trích xuất dữ liệu thô từ tài liệu nguồn → Skill tạo báo cáo nhận dữ liệu đó làm input và định dạng thành báo cáo hoàn chỉnh. Đây là ví dụ cụ thể của việc “xếp chồng Skill” đã nhắc ở bài 34 mục 16 — 2 Skill độc lập, mỗi Skill đảm nhiệm đúng 1 vai trò (đọc/viết), phối hợp qua đúng 1 input/output contract rõ ràng.
⚠️ 13. Giới hạn & khi nào KHÔNG nên áp dụng
- Bài này không dạy kỹ năng phân tích/viết báo cáo tốt về nội dung — đó là phạm vi dự kiến của Level 5 (bài 42 “AI cho Writing”, bài 45 “AI cho Data Analysis”) khi được lập kế hoạch.
- Báo cáo chỉ tạo 1 lần, không lặp lại → không cần đóng gói Skill.
🔐 14. An toàn & quản trị (Safety/Governance)
Báo cáo thường tổng hợp dữ liệu từ nhiều nguồn (số liệu công ty, thông tin khách hàng, tiến độ dự án nội bộ) — áp dụng đúng nguyên tắc quản lý dữ liệu nhạy cảm đã học xuyên suốt dự án. Nếu Skill tạo báo cáo có bước tự động gửi đi (email, Slack), đây chính là trường hợp cần disable-model-invocation (bài 34) — không để Claude tự ý gửi báo cáo mà không xác nhận.
📚 17. Nguồn tham khảo
Skill authoring best practices, Anthropic — mẫu template pattern (strict/flexible), nguồn duy nhất và đủ cho toàn bộ khung lý thuyết bài này · Dẫn chiếu (không trích dẫn mới): bài 32 (degrees of freedom), bài 34 (input/output contract), bài 38 (feedback loop).