Kiểm tra Hệ thống (/para-audit)
Hệ thống Audit là “hệ miễn dịch” của một PARA Workspace. Khi các dự án phát triển và nhiều Agent cùng tương tác với hệ thống tệp, sự sai lệch cấu trúc (file rác, thư mục đặt sai chỗ, hoặc thiếu metadata) là điều không thể tránh khỏi.
Workflow /para-audit là một bộ Macro Assessor (Giám sát vĩ mô) chuyên dụng được thiết kế để phát hiện và báo cáo những sự bất nhất này.
Audit sẽ kiểm tra những gì?
Khi bạn chạy /para-audit, Agent sẽ thực hiện các bước kiểm tra sau:
| Tầng | Nội dung kiểm tra | Quy tắc (Invariant) |
|---|---|---|
| Gốc (Root) | Không được có file lẻ nằm ngoài các file hệ thống cốt lõi. | I1 |
| Phân vùng | Xác minh sự tồn tại của Projects/, Areas/, Resources/, và Archive/. | I8 |
| Dự án | Kiểm tra file project.md và backlog.md đang hoạt động. | I4, I2 |
| Thư viện | Đối chiếu các workflow/rule đã cài đặt với file catalog.yml gốc. | H9 |
📑 Báo cáo Audit (Audit Report)
Sau khi quét, hệ thống sẽ tạo một bản báo cáo theo ngày tại: Areas/Workspace/audits/audit-report-YYYY-MM-DD.md.
Báo cáo này bao gồm:
- Tính toàn vẹn cấu trúc: Các quy tắc (Invariants) nào đạt hoặc không đạt.
- Sai lệch phát hiện: Danh sách các file rác hoặc dự án ngưng hoạt động.
- Kế hoạch khắc phục: Các hành động gợi ý (vd: dùng
/para-rule standardizehoặc lưu trữ thủ công).
🚀 Cách thực hiện
Đơn giản chỉ cần yêu cầu Agent của bạn:
“Chạy kiểm tra workspace” hoặc ”@[/para-audit]”
Chúng tôi khuyến nghị chạy audit một lần mỗi tuần hoặc sau khi có những thay đổi lớn về cấu trúc.