⚠️ Lưu trữ: Prompt này được viết cho kiến trúc v4.0. Kiến trúc hiện tại là v5.0 (Context Loading, 21 tuần).
PROMPT: Đánh giá Tiến độ & Hoàn thành Tuần [N]
Loại: Deep research + audit + execute (chạy 1 lần cho mỗi tuần)
Target: Agent có quyền đọc/ghi file, chạy lệnh
Phiên bản: 1.0
Ngày tạo: 25/09/2026
Mục đích
Prompt này thực hiện 4 giai đoạn để đánh giá và hoàn thành công việc AI trong 1 tuần:
- Kiểm kê: Scan workspace, liệt kê file đã tồn tại vs file thiếu
- Chấm điểm: Đánh giá chất lượng file đã có (nội dung, format, completeness)
- Lập kế hoạch: Xác định gap → lên danh sách việc cần bổ sung/nâng cấp
- Thực thi: Tạo file thiếu + sửa file chưa đạt chất lượng
Cách sử dụng
Chạy prompt 18_DANH_GIA_TIEN_DO cho Tuần [N].
Quy trình Chi tiết
Giai đoạn 1: Kiểm kê Deliverable
Bước 1.1: Đọc docs/research/plans/W[N]/_AI_PROMPTS.md để lấy danh sách TẤT CẢ file output dự kiến.
Bước 1.2: Scan workspace kiểm tra từng file:
# Cho mỗi file output trong _AI_PROMPTS.md, kiểm tra:
Test-Path "[path]" # Tồn tại?
(Get-Item "[path]").Length # Kích thước?
Bước 1.3: Tạo bảng kiểm kê:
| # | File Dự kiến | Tồn tại? | Size (KB) | Task ID |
|---|---|---|---|---|
| 1 | docs/project/project_charter.md | ✅/❌ | X.X | W1-D01-T01-AI |
Giai đoạn 2: Chấm điểm Chất lượng
Với mỗi file ĐÃ TỒN TẠI, đọc nội dung và chấm theo 5 tiêu chí:
| # | Tiêu chí | Câu hỏi | Điểm |
|---|---|---|---|
| 1 | Completeness | File có đủ các phần yêu cầu trong DoD không? | 0-25 |
| 2 | Accuracy | Nội dung chính xác, không bịa dữ liệu? | 0-25 |
| 3 | Format | Đúng format (YAML valid, CSV đủ cột, MD có heading)? | 0-20 |
| 4 | Terminology | Dùng đúng thuật ngữ GLOSSARY (thẻ tri thức, cờ đỏ...)? | 0-15 |
| 5 | Linkage | Có link đúng đến file liên quan, relative path? | 0-15 |
Tổng: /100 điểm
| Điểm | Đánh giá | Hành động |
|---|---|---|
| 85-100 | ✅ Đạt chuẩn | Giữ nguyên |
| 60-84 | 🟡 Cần nâng cấp | Bổ sung phần thiếu |
| 0-59 | 🔴 Cần làm lại | Viết lại từ đầu |
Giai đoạn 3: Lập Kế hoạch Bổ sung
Tạo danh sách action items:
## Kế hoạch Bổ sung
| # | Hành động | Loại | File liên quan | Ưu tiên |
|---|---|---|---|---|
| 1 | Tạo mới | CREATE | [path] | CAO |
| 2 | Nâng cấp | UPGRADE | [path] | TRUNG BÌNH |
| 3 | Sửa format | FIX | [path] | THẤP |
Giai đoạn 4: Thực thi
Thực hiện TỪNG action item trong kế hoạch. Với mỗi item:
Nếu CREATE (file thiếu):
- Đọc prompt tương ứng trong _AI_PROMPTS.md
- Thực thi theo đúng bước
- Tạo file output
- Verify DoD
Nếu UPGRADE (file chưa đạt):
- Đọc file hiện tại
- Xác định phần thiếu/yếu
- Bổ sung/sửa đổi
- Verify DoD
Nếu FIX (lỗi format/terminology):
- Sửa trực tiếp trong file
- Verify lại
Ràng buộc
- Đọc
AGENTS.mdTRƯỚC khi thực thi - Thuật ngữ chuẩn: NCS, GVHD, CVYK, thẻ tri thức, cờ đỏ, bộ lọc an toàn
- Relative path cho mọi link nội bộ
- Y khoa = status DRAFT cho đến khi CVYK duyệt
- Không chẩn đoán, không kê đơn, không khuyên bỏ thuốc
- Luôn trích dẫn nguồn cho thông tin y khoa
Output
Tạo file tổng kết: docs/research/plans/W[N]/_W[N]_PROGRESS_REPORT.md
# Báo cáo Tiến độ — Tuần [N]
> **Ngày đánh giá:** [DD/MM/YYYY]
> **Tổng deliverable:** [X] | **Đã có:** [Y] | **Mới tạo:** [Z] | **Nâng cấp:** [W]
> **Điểm chất lượng TB:** [XX]/100
## Bảng Kiểm kê (Giai đoạn 1)
[bảng]
## Bảng Chấm điểm (Giai đoạn 2)
[bảng]
## Kế hoạch Bổ sung (Giai đoạn 3)
[bảng]
## Thực thi (Giai đoạn 4)
| # | Action | Kết quả | File | Verify |
|---|---|---|---|---|
| 1 | CREATE | ✅ Done | [path] | DoD passed |
Chạy prompt này cho mỗi tuần để đảm bảo AI hoàn thành hết việc trước khi NCS bắt đầu review.