Kỹ năng Viết Chuyên Nghiệp

Mục đích

Hỗ trợ soạn thảo, biên tập và chuẩn hóa các văn bản hành chính, báo cáo, và nội du ng truyền thông bằng tiếng Việt chuyên nghiệp, loại bỏ các lỗi văn phong do dịch m áy.

Phạm vi Ứng dụng

• Viết báo cáo quản trị, email công việc.

• Soạn thảo tài liệu kỹ thuật, hướng dẫn sử dụng.

• Biên tập lại nội dung thô (draft) thành văn bản hoàn chỉnh.

Bộ Nguyên tắc Cốt lõi

1. Sự trong sáng của Tiếng Việt: Ưu tiên từ thuần Việt, hạn chế lạm dụng từ Há n Việt hoặc chèn tiếng Anh không cần thiết.

2. Cấu trúc mạch lạc: Câu văn gãy gọn, chủ ngữ vị ngữ rõ ràng. Tránh câu ghép quá dài gây khó hiểu.

3. Văn phong phù hợp: Linh hoạt điều chỉnh xưng hô và thái độ tùy theo đối tượ ng độc giả (Trang trọng với cấp trên, cởi mở với đồng nghiệp).

Quy trình Thực hiện Chuẩn

1. Phân tích: Xác định rõ mục đích bài viết và đối tượng độc giả.

2. Dàn ý: Lập cấu trúc logic trước khi viết chi tiết.

3. Soạn thảo: Viết nội dung tập trung vào giá trị thông tin.

4. Hiệu đính: Rà soát và tinh chỉnh từ ngữ theo Bộ Nguyên tắc.

## **3.3.4 Cơ chế Kích hoạt Thông minh (Progressive Disclosure)** 

Để đảm bảo hiệu năng xử lý, Agent không cần phải “học” toàn bộ hàng trăm Skill cùng lúc. Hệ thống sử dụng cơ chế **Tiết lộ Dần dần (Progressive Disclosure)** : 

1. **Nhận diện (Discovery):** Khi hoạt động bình thường, Agent chỉ nắm giữ danh sách tên các Skill và phần mô tả ngắn gọn (trong header YAML). 

2. **Kích hoạt (Activation):** Khi người dùng đưa ra yêu cầu (ví dụ: “Viết báo cáo”), Agent đối chiếu yêu cầu với các mô tả Skill. Nếu thấy phù hợp (ví dụ: khớp với <mark>`viet-chuyen-nghiep`</mark> ), Agent sẽ tự động nạp nội dung chi tiết của Skill đó vào bộ nhớ ngữ cảnh. 

3. **Thực thi (Execution):** Agent áp dụng các nguyên tắc trong <mark>`SKILL.md`</mark> để xử lý tác vụ hiện tại. 

Cơ chế này giúp hệ thống duy trì sự gọn nhẹ nhưng vẫn sẵn sàng mở rộng năng lực không giới hạn. 

## **3.3.5 Ứng dụng Thực tế - Đóng gói Tri thức Chuyên gia** 

Skill là phương tiện hiệu quả nhất để **số hóa tri thức ngầm (tacit knowledge)** của doanh nghiệp. 

Thay vì phụ thuộc vào một nhân sự chủ chốt (ví dụ: Kế toán trưởng là người duy nhất biết cách xử lý file Excel phức tạp), doanh nghiệp có thể yêu cầu chuyên gia mô tả lại phương pháp tư duy và cách làm việc của họ. Sau đó, thông tin này được đóng gói thành Skill (ví dụ: <mark>`xu-ly-excel-nang-cao` )</mark> . 

Gói Skill này sẽ bao gồm: 

- **SKILL.md:** Mô tả tư duy phân tích (nhìn cột nào, lọc điều kiện gì). 

- **scripts/** : Các đoạn mã tự động hóa (VBA/Python) mà chuyên gia thường dùng. 

- **examples/** : Các mẫu báo cáo chuẩn để Agent tham chiếu. 

Khi đó, một nhân viên mới hoặc một Agent có thể sử dụng Skill này để thực hiện công việc với chất lượng tiệm cận với chuyên gia, đảm bảo sự liên tục và nhất quán trong vận hành doanh nghiệp. 

## **3.3.6 Kết luận** 

Việc xây dựng thư viện Skill chính là quá trình tích lũy và tài sản hóa năng lực trí tuệ của tổ chức. Một hệ thống Agent mạnh không phải là hệ thống có phần cứng đắt tiền, mà là hệ thống sở hữu bộ Skill phong phú và được tinh chỉnh kỹ lưỡng từ thực tế sản xuất. 



<!-- Start of picture text -->
Rule Design for Al Agents - Safety Guardrails<br>© Caines ACD ZA<br>|<br>Vine<br>Data Security System Integrity<br>cannot be crossed cannotbe crossed<br>boundaries that » i) boundaries<br><< Compliance ~~ Ethics YW], ,<br>GEMINI.md __ .agent/rules/<br>(global) (workspace)<br><!-- End of picture text -->

## **3.4.2 Định nghĩa về Rule** 

Rule là tập hợp các giới hạn và quy định bắt buộc mà Agent phải tuân thủ trong mọi tình huống. Nó trả lời cho câu hỏi: “Những điều gì KHÔNG ĐƯỢC PHÉP làm?” và “Những nguyên tắc nào PHẢI tuân thủ tuyệt đối?”. 

Trong hệ thống Antigravity, Rule được phân thành hai cấp độ quản lý: 

**Cơ chế ưu tiên: Workspace ghi đè Global** 

Như đã trình bày ở Chương 2.2, Antigravity áp dụng nguyên tắc: **Workspace** 

**luôn thắng Global** . Điều này cũng áp dụng cho Rule: 

- **Global Rule (GEMINI.md):** Đây là **cài đặt mặc định** của hệ thống, áp dụng khi Workspace không định nghĩa gì khác. 

- **Workspace Rule (.agent/rules/):** Đây là **cài đặt tùy chỉnh** cho dự án cụ thể, luôn được ưu tiên khi có xung đột với Global. 

Cơ chế này hoàn toàn hợp lý: Workspace đại diện cho ngữ cảnh cụ thể của dự án đang làm, còn Global chỉ là mặc định chung. 

**Khuyến nghị thiết kế: Tôn trọng nguyên tắc an toàn** 

Dù Workspace **có thể** ghi đè bất kỳ Global Rule nào, nhưng **<mark>nên</mark>** tuân thủ các 

nguyên tắc an toàn nền tảng. Cụ thể: 

- **<mark>Nên ghi đè:</mark>** Format hiển thị (ngày, số, tiền tệ), ngôn ngữ, quy ước đặt tên, văn phong. 

- **<mark>Không nên ghi đè:</mark>** Quy tắc bảo vệ dữ liệu gốc, bảo mật thông tin cá nhân, xác nhận trước khi xóa. 

**_<mark>Nguyên tắc vàng:</mark>_** _<mark>Global Rule thiết lập “sàn an toàn”, Workspace nên nâng cao tiêu chuẩn, không hạ thấp.</mark>_ 

## **Ví dụ Global Rule (GEMINI.md):** 

- Ngôn ngữ mặc định: Tiếng Việt 

- TUYỆT ĐỐI KHÔNG xóa dữ liệu gốc (Input) 

- TUYỆT ĐỐI KHÔNG chia sẻ PII ra ngoài workspace 

## **Ví dụ Workspace Rule (ke_toan.md):** 

- Định dạng số: Phân cách hàng nghìn bằng dấu chấm (.) 

- Format ngày: DD/MM/YYYY 

- Bắt buộc đối chiếu tổng phát sinh Nợ/Có 

## **3.4.3 Cơ chế Kích hoạt (Activation Modes)** 

Các file Rule trong thư mục <mark>`.agent/rules/`</mark> được thiết kế với tính năng thông minh: chúng không nhất thiết phải luôn bật. Mỗi Rule có thể được cấu hình để chỉ kích hoạt trong những tình huống nhất định để tiết kiệm tài nguyên hệ thống (Context window). 

Hệ thống hỗ trợ 4 chế độ kích hoạt: 

## **a. Chế độ Luôn bật (Always On)** 

Áp dụng cho các quy định chung của toàn dự án, luôn có hiệu lực trong mọi ngữ cảnh. 

- **Ví dụ:** Quy ước đặt tên file, chuẩn mã hóa (UTF-8). 

## **b. Chế độ Thủ công (Manual)** 

Chỉ kích hoạt khi người dùng yêu cầu đích danh thông qua cú pháp <mark>`@mention` .</mark> Phù hợp cho các vai trò chuyên gia hoặc công cụ ít dùng. 

   - **Ví dụ:** Rule <mark>`@dev_ops`</mark> chứa kiến thức về deployment server, chỉ nạp vào khi người dùng gõ lệnh liên quan đến deploy. 

- **c. Chế độ Tự động theo File (Glob Pattern)** 

Tự động kích hoạt khi Agent làm việc với các loại file cụ thể. Phù hợp cho các quy chuẩn kỹ thuật (Linter, Style guide). 

## – **Ví dụ:** 

   - Agent mở file <mark>`.py`</mark> -> Kích hoạt Rule chuẩn code Python (PEP8). 

   - Agent mở file <mark>`.sql`</mark> -> Kích hoạt Rule tối ưu hóa truy vấn Database. 

- **d. Chế độ AI Tự quyết (Model Decision)** 

Đây là chế độ linh hoạt nhất. Người dùng viết một mô tả ngắn gọn về tình huống sử dụng, và Agent sẽ tự đánh giá ngữ cảnh cuộc hội thoại để quyết định có kích hoạt Rule hay không. 

- **Ví dụ:** Rule <mark>`xu_ly_khung_hoang.md`</mark> có mô tả “Dùng khi người dùng tỏ thái độ không hài lòng”. Khi Agent phát hiện giọng điệu gay gắt từ người dùng, nó sẽ tự động kích hoạt Rule này để điều chỉnh thái độ phản hồi mềm mỏng hơn. 

## **3.4.4 Vai trò của Rule trong Quản trị Niềm tin** 

Trong giai đoạn đầu triển khai AI, tâm lý chung của người quản lý là sự lo ngại về tính an toàn và kiểm soát. Rule chính là giải pháp kỹ thuật để giải quyết nỗi lo này. 

Bằng cách thiết lập hệ thống Rule chặt chẽ, chúng ta chuyển từ trạng thái “tin tưởng mù quáng” sang trạng thái “tin tưởng có kiểm soát”. 

- Lo ngại mất dữ liệu -> Thiết lập Rule cấm xóa (Permissions). 

- Lo ngại sai lệch thông tin -> Thiết lập Rule về nguồn dữ liệu (Grounding). 

- Lo ngại văn phong máy móc -> Thiết lập Rule về giọng văn (Persona). 

Hãy bắt đầu việc xây dựng Agent bằng việc soạn thảo file <mark>`GEMINI.md`</mark> . Đó là nền móng vững chắc nhất để xây dựng một hệ thống AI phục vụ doanh nghiệp an toàn và hiệu quả.