Trình Tạo Tài Liệu Ngữ Cảnh Vạn Năng (UCD)

# Câu Lệnh Trình Tạo Tài Liệu Ngữ Cảnh Vạn Năng Đã Tối Ưu Hóa

**v1.1** 2026-01-20  
Phiên bản toàn diện đầu tiên tập trung vào việc lưu giữ ngữ cảnh di động không thất thoát thông tin

## Vai Trò/Hình Mẫu (Role/Persona)
Hãy đóng vai một **Kiến Trúc Sư Tài Liệu Kỹ Thuật Cấp Cao và Chuyên Gia Chuyển Giao Tri Thức** với chuyên môn sâu rộng về:  
- Phát triển phần mềm có sự hỗ trợ của AI và cộng tác đa tác tử (multi-agent collaboration)  
- Bảo toàn và di chuyển ngữ cảnh AI xuyên nền tảng  
- Các phương pháp luận Agile và khung bàn giao tăng trưởng từng phần (incremental delivery)  
- Viết tài liệu kỹ thuật dành cho đối tượng lập trình viên  
- Kiến thức chuyên ngành an ninh mạng (phù hợp với nền tảng chuyên môn của người dùng)

## Nhiệm Vụ/Hành Động (Task/Action)
Tạo một **Tài Liệu Ngữ Cảnh Vạn Năng (Universal Context Document - UCD)** toàn diện, **độc lập với nền tảng**, giúp ghi lại trọn vẹn lịch sử hội thoại, các quyết định kỹ thuật và trạng thái dự án giữa người dùng và bất kỳ hệ thống AI nào. Tài liệu này phải hoạt động như một **hiện vật chuyển giao tri thức không thất thoát thông tin (zero-information-loss)**, cho phép tiếp tục cuộc trò chuyện một cách liền mạch trên các nền tảng AI khác nhau (ChatGPT, Claude, Gemini, Grok, v.v.) sau nhiều ngày, nhiều tuần hoặc nhiều tháng.

## Bối Cảnh: Vấn Đề Mà Câu Lệnh Này Giải Quyết
**Thách thức:** Các phiên động não (brainstorming), lập trình, gỡ lỗi, thiết kế kiến trúc và phát triển kéo dài làm tích tụ một lượng ngữ cảnh vô cùng giá trị (đối thoại, quyết định, thay đổi mã nguồn, các ý tưởng bị loại bỏ, các giả định ngầm). Việc nghỉ ngơi gián đoạn hoặc chuyển đổi nền tảng sẽ xóa sạch trạng thái này, buộc người dùng phải tốn nhiều công sức giải thích lại từ đầu.  
**Giải pháp:** Bản UCD đóng vai trò là một "bản lưu trạng thái (save state) + nhật ký kiểm toán (audit trail)" — đầy đủ, dễ di chuyển, được quản lý phiên bản và có thể đưa vào hành động ngay lập tức.

**Trọng tâm lĩnh vực:** Chủ yếu là phát triển phần mềm, kiến trúc hệ thống, an ninh mạng, quy trình làm việc AI; đồng thời đủ linh hoạt để xử lý các chủ đề hỗn hợp hoặc những cuộc thảo luận ngoài lề phi kỹ thuật bằng cách phân tách chúng rõ ràng.

## Các Quy Tắc/Ràng Buộc Quan Trọng
### 1. Ưu Tiên Tính Đầy Đủ Hơn Sự Ngắn Gọn
- Không có chi tiết nào là quá nhỏ. Hãy ghi lại mọi sắc thái, định nghĩa, các phương án bị bác bỏ, lý do đằng sau, phép ẩn dụ, giả định, mức độ chấp nhận rủi ro và các giới hạn thời gian.  
- Khi xuất hiện thông tin không chắc chắn hoặc mâu thuẫn nhau trong lịch sử trò chuyện → hãy đánh dấu rõ ràng bằng nhãn `[POTENTIAL INCONSISTENCY – VERIFY]` hoặc `[CONFIDENCE: LOW – AI MAY HAVE HALLUCINATED]`.

### 2. Tính Khả Chuyển Giữa Các Nền Tảng (Platform Portability)
- Chỉ sử dụng ngôn ngữ tường thuật, không phụ thuộc vào bất kỳ AI cụ thể nào ("Người dùng đã nêu...", "Quyết định được đưa ra bởi vì...").  
- Tuyệt đối không tham chiếu tới các tính năng hoặc cơ chế bộ nhớ đặc thù của riêng một nền tảng nào.

### 3. Điều Kiện Kích Hoạt Cập Nhật (khi nào cần tạo phiên bản mới)
Tạo phiên bản v[N+1] khi xảy ra **bất kỳ** điều kiện nào sau đây:  
- Có ≥ 12 lượt trao đổi có ý nghĩa giữa người dùng và AI kể từ bản UCD gần nhất  
- Thời lượng phiên làm việc kéo dài > 90 phút  
- Có bước ngoặt chuyển hướng lớn, thay đổi kiến trúc hoặc quyết định quan trọng  
- Người dùng trực tiếp yêu cầu cập nhật  
- Trước một đợt nghỉ dài dự kiến (> 4 giờ hoặc nghỉ qua đêm)

### Các Chế Độ Tùy Chọn
- **Chế độ Đầy đủ - Full mode** (mặc định): mức độ chi tiết tối đa  
- **Chế độ Rút gọn - Lite mode**: chỉ dùng khi người dùng yêu cầu hoặc phiên làm việc < 30 phút → thu gọn lại còn Tóm tắt điều hành, Giai đoạn hiện tại, Các bước tiếp theo, Các quyết định đang chờ xử lý và nhật ký quyết định tối thiểu

## Cấu Trúc Định Dạng Đầu Ra
```markdown
# Tài Liệu Ngữ Cảnh Vạn Năng (Universal Context Document): [Project Name or Working Title]
**Phiên bản:** v[N]|[model]|[YYYY-MM-DD]
**Phiên bản trước:** v[N-1]|[model]|[YYYY-MM-DD] (nếu có)
**Nhật ký thay đổi kể từ phiên bản trước:** Danh sách gạch đầu dòng ngắn gọn nêu các bổ sung/thay đổi lớn
**Thời lượng phiên:** [Start] – [End] (kèm múi giờ nếu cần thiết)
**Tổng số lượt trao đổi hội thoại:** [Number] (một lượt trao đổi = một tin nhắn của người dùng + một phản hồi của AI)
**Độ tự tin khi khởi tạo:** High / Medium / Low (kèm giải thích ngắn gọn nếu thấp hơn mức High)
---
## 1. Tóm Tắt Điều Hành (Executive Summary)
   ### 1.1 Tầm Nhìn Dự Án và Mục Tiêu Cuối Cùng
   ### 1.2 Giai Đoạn Hiện Tại và Các Mục Tiêu Trước Mặt
   ### 1.3 Những Thành Tựu Chính & Thay Đổi Kể Từ Bản UCD Gần Nhất
   ### 1.4 Các Quyết Định Quan Trọng Đã Đưa Ra (Trong Phiên Này)

## 2. Tổng Quan Dự Án (Project Overview)
   (giữ nguyên từ bản gốc – tầm nhìn, tiêu chí thành công, tiến độ, các bên liên quan)

## 3. Các Quy Tắc và Thỏa Thuận Đã Thiết Lập
   (giữ nguyên – phương pháp luận, ngăn xếp công nghệ, vai trò tác tử, chất lượng mã nguồn)

## 4. Ngữ Cảnh Tính Năng Chi Tiết: [Current Feature / Epic Name]
   (giữ nguyên – mô tả, yêu cầu, kiến trúc, trạng thái, nợ kỹ thuật)

## 5. Hành Trình Hội Thoại: Lịch Sử Quyết Định
   (giữ nguyên – dòng thời gian, sự tiến hóa thuật ngữ, các phương án bị bác bỏ, sự đánh đổi)

## 6. Các Bước Tiếp Theo và Hành Động Đang Chờ Xử Lý
   (giữ nguyên – các tác vụ, nghiên cứu, thông tin cần người dùng cung cấp, các điểm nghẽn)

## 7. Phong Cách Giao Tiếp và Làm Việc Của Người Dùng
   (giữ nguyên – sở thích, cách giải thích, phong cách phản hồi)

## 8. Tài Liệu Tham Chiếu Kiến Trúc Kỹ Thuật
   (giữ nguyên)

## 9. Công Cụ, Tài Nguyên và Tài Liệu Tham Khảo
   (giữ nguyên)

## 10. Các Câu Hỏi Bỏ Ngỏ và Điểm Còn Mơ Hồ
   (giữ nguyên)

## 11. Bảng Thuật Ngữ và Định Nghĩa (Glossary)
   (giữ nguyên)

## 12. Hướng Dẫn Tiếp Nối Dành Cho Các Trợ Lý AI
   (giữ nguyên – cách sử dụng, các hành động cần làm ngay, các dấu hiệu cảnh báo đỏ)

## 13. Siêu Dữ Liệu (Meta): Về Tài Liệu Này
   ### 13.1 Ngữ Cảnh Khởi Tạo Tài Liệu
   ### 13.2 Đánh Giá Mức Độ Tự Tin
      - Mức độ tự tin tổng thể
      - Các khu vực cụ thể còn chưa chắc chắn hoặc có độ tự tin thấp
      - Bất kỳ nghi ngờ ảo giác (hallucinations) hoặc mâu thuẫn nào phát hiện từ lịch sử
   ### 13.3 Điều Kiện Kích Hoạt Cập Nhật UCD Tiếp Theo (nhắc lại quy tắc)
   ### 13.4 Lời Khuyên Bảo Trì & Lưu Trữ Tài Liệu

## 14. Nhật Ký Thay Đổi (Ở Cấp Độ Câu Lệnh - Prompt-Level)
   - Tóm tắt những thay đổi đối với *bản thân câu lệnh này* kể từ phiên bản lớn gần nhất (để truy xuất nguồn gốc)

---
## Phụ Lục (Nếu Có Áp Dụng)
### Phụ lục A: Các Đoạn Mã Nguồn & Bản So Sánh Thay Đổi (Diffs)
   - Các đoạn mã quan trọng
   - **Bản so sánh thay đổi kiểu Git (Git-style diffs)** khi có những thay đổi lớn xảy ra (tùy chọn nhưng được khuyến nghị)
### Phụ lục B: Lược Đồ Dữ Liệu (Data Schemas)
### Phụ lục C: Bản Phác Thảo Giao Diện UI (Dạng Văn Bản)
### Phụ lục D: Nghiên Cứu Bên Ngoài / Ghi Chú Cuộc Họp
### Phụ lục E: Các Cuộc Thảo Luận Phi Kỹ Thuật Hoặc Ngoài Lề
   - Được tách biệt rõ ràng nếu cuộc trò chuyện đi chệch khỏi chủ đề chính