Agent Skill song ngữ để kiến tạo, dịch, biên tập, humanize và kiểm định diễn ngôn học thuật tiếng Việt và tiếng Anh. Skill tổ chức nội dung từ tuyên bố, bằng chứng và mục đích tu từ, sau đó hiện thực hóa thành văn bản trong ngôn ngữ đích.
Tuyên bố và bằng chứng có trước câu chữ; toàn vẹn ngữ nghĩa có trước độ trôi chảy.
Một văn bản trang trọng chưa chắc là văn bản học thuật tốt. Lỗi nghiêm trọng
thường nằm dưới bề mặt ngôn ngữ: khẳng định mạnh hơn bằng chứng, đổi tương quan
thành nhân quả, nhập kết quả với diễn giải, thuật ngữ trôi nghĩa, hoặc bê nguyên
cú pháp tiếng Anh và tên trường dữ liệu vào bài báo. Skill xử lý các lỗi đó bằng
một quy trình bảy bước có thể kiểm tra, và đánh dấu needs_source cho mọi nội
dung chưa có căn cứ thay vì viết trơn qua.
Cài đặt bằng trình quản lý Skills:
npx skills add mxuanvan02/academic-prose -g --allKhi tích hợp thủ công, đặt repository tại vị trí môi trường có thể khám phá và
đăng ký SKILL.md làm hợp đồng định tuyến chính. agents/openai.yaml cung cấp
metadata giao diện cho môi trường tương thích.
Skill được định tuyến theo mục đích học thuật của nội dung, không theo loại tệp
hay định dạng đầu ra. Nó tự kích hoạt cho bài báo, luận văn, báo cáo, đề cương,
slide khoa học, bài giảng, học liệu, nội dung đánh giá, dịch Anh - Việt và kiểm
định bản thảo. SKILL.md khai báo tín hiệu định tuyến chung; cú pháp gọi phụ
thuộc vào môi trường.
Viết phần Thảo luận bằng tiếng Việt từ các kết quả dưới đây. Lập sổ tuyên bố -
bằng chứng, đánh dấu nội dung cần nguồn, sau đó viết và phản biện đối nghịch.
Dịch phần tóm tắt này sang tiếng Việt học thuật. Giữ nguyên mức độ khẳng định,
số liệu, trích dẫn và thuật ngữ; trả kèm bảng thuật ngữ và kiểm toán.
Biên tập phần Kết quả theo chuẩn tiếng Việt học thuật. Phát hiện tuyên bố vượt
bằng chứng, nhiễu cú pháp tiếng Anh và thuật ngữ trôi nghĩa. Không bổ sung dữ kiện.
Bảy nhóm cách sử dụng được công bố đều có kịch bản mô phỏng tương ứng, nên mỗi tuyên bố trong tài liệu này đều gắn với một phép kiểm tra chạy được:
| Nhóm | Kịch bản |
|---|---|
| Viết từ bằng chứng | usage-discussion-from-evidence |
| Lập luận trước khi viết | usage-argument-outline |
| Dịch Anh - Việt | usage-en-vi-translation |
| Biên tập bản thảo tiếng Việt | usage-vietnamese-revision |
| Slide báo cáo khoa học | usage-research-slides |
| Bài giảng và học liệu | usage-university-lesson |
| Bàn giao dịch PDF | usage-pdf-handoff |
Ví dụ đầy đủ cho từng nhóm: evals/usage-claim-cases.json.
Ví dụ cho từng năng lực: evals/capability-examples.json.
Mười ba thao tác dùng chung một động cơ kiến tạo diễn ngôn. Chi tiết định tuyến
và điều kiện áp dụng: references/capability-matrix.md.
| Năng lực | Sản phẩm chính |
|---|---|
conceptualize |
Hồ sơ tu từ và cấu trúc tuyên bố sơ bộ |
outline |
Dàn ý có chức năng và quan hệ phụ thuộc |
argue |
Bản đồ tuyên bố - bằng chứng - bảo chứng |
synthesize |
Tổng hợp theo chủ đề, điểm hội tụ và bất đồng |
draft |
Văn bản học thuật hoàn chỉnh ở ngôn ngữ đích |
develop |
Lập luận đầy đủ hơn, không thêm dữ kiện giả |
compress |
Bản ngắn hơn, giữ phạm vi và điều kiện thiết yếu |
expand |
Bản mở rộng và danh sách phần còn thiếu nguồn |
paraphrase |
Diễn đạt lại với ngữ nghĩa ổn định |
revise |
Bản sửa kèm kiểm toán thay đổi |
audit |
Phát hiện theo mức độ và quyết định cổng |
humanize |
Văn bản đã làm sạch, nhật ký pattern và cổng kiểm định |
translate |
Bản dịch, bảng thuật ngữ và kiểm toán |
Sản phẩm được đánh giá trên bảy chiều theo thang 0-5: SEM toàn vẹn tuyên bố và
bằng chứng, TERM thuật ngữ, STANCE lập trường khoa học, LOGIC lập luận,
LANG độ tự nhiên của ngôn ngữ đích, VOICE mức độ không còn dấu vết máy móc,
và CONS tính nhất quán. Cổng diễn ngôn cấp đoạn bổ sung thẩm định thủ công cho
đoạn xoay quanh phần việc còn thiếu, dồn caveat, danh sách nhiệm vụ nghiên cứu và
câu quá tải mệnh đề; các ngưỡng chỉ tạo ứng viên, không tự kết luận chất lượng.
Quyết định pass yêu cầu mọi chiều đạt ít nhất 4/5 và không có lỗi chặn. Điểm
trung bình cao không bù được lỗi đảo nghĩa, mất phủ định, nâng tương quan thành
nhân quả, sai số liệu, hỏng trích dẫn, đổi phạm vi, bịa bằng chứng, hay văn
phong nội bộ/tự thuật. Văn phong đó bị cấm ở cả tiếng Việt và tiếng Anh: câu nói
về bản thảo, dự án, log kiểm tra, đường dẫn máy, placeholder hoặc cuộc hội thoại
soạn thảo không được xuất hiện trong văn bản công bố. Cơ chế kiểm định:
references/internal-register-gate.md.
Hai quyết định còn lại là revise và human_review. Thang điểm và điều kiện chặn:
references/quality-rubric.md.
academic-prose/
├── SKILL.md # Hợp đồng và bộ định tuyến chính
├── agents/openai.yaml # Bộ điều hợp giao diện tùy chọn
├── references/ # Tài liệu chuẩn ngôn ngữ, quy trình, thuật ngữ và phân loại lỗi
├── schemas/ # Lược đồ JSON cho hiện vật trung gian
├── evals/ # Tình huống tổng hợp cho viết, dịch, humanize và usage
├── scripts/ # Validator, scanner register nội bộ và mô phỏng
└── tests/ # Kiểm thử kho mã và lược đồ
python3 scripts/validate_skill.py # cổng kiểm định đầy đủ
python3 -m unittest discover -s tests -v # kiểm thử kho mã
python3 scripts/test_internal_register_scan.py # cổng văn phong nội bộ, song ngữ
python3 scripts/test_academic_discourse_scan.py # cổng diễn ngôn cấp đoạn, song ngữ + DOCX
python3 scripts/run_usage_simulations.py # riêng mô phỏng usage
python3 scripts/run_capability_examples.py # riêng ví dụ năng lựcTrình kiểm định gọi lại cả hai trình mô phỏng và bộ test scanner register nội bộ, nên một ví dụ hỏng hoặc một lớp tiếng Anh/tiếng Việt bị sót sẽ làm cổng đỏ. Mỗi phép kiểm tra được đột biến có chủ đích để chứng minh nó biết thất bại; một phép kiểm tra không bao giờ đỏ thì không phải là bằng chứng.
Đây là kiểm định hợp đồng bằng dữ liệu tổng hợp. Kết quả xác nhận độ bao phủ của các bất biến đã khai báo; chất lượng đầu ra thực tế còn phụ thuộc vào mô hình, dữ liệu đầu vào, công cụ điều phối và việc thẩm định của con người.
Khi đóng góp một quy tắc mới, hãy nêu rõ ngành, thể loại, ngữ cảnh, lý do, ví dụ đúng, phản ví dụ và phạm vi áp dụng.
| Nguồn | Nội dung được tham khảo |
|---|---|
| Agent Skills | Chuẩn đóng gói và tích hợp dựa trên SKILL.md, gồm quy ước để môi trường tương thích khám phá và sử dụng skill |
| Vercel Skills | Trình quản lý Skills và cú pháp cài đặt npx skills add được dùng trong hướng dẫn cài đặt |
| VI-Translate | Quy trình bàn giao dịch PDF, bảo toàn thành phần và tái dựng tài liệu trong lớp phối hợp PDF |
| Humanizer | 35 pattern nhận diện văn phong do máy tạo, được chuyển thành lớp humanize có guardrail học thuật và hỗ trợ tiếng Việt |