Xưởng viết tiếng Việt,
từ trang trắng đến bản giao

Chín hồ sơ thể loại

• blog bài chia sẻ, quan điểm, hướng dẫn, bài mạng xã hội dàiđủ 5 mục
• essay bài luận, bài thi, nghị luậnđủ 5 mục
• research nghiên cứu, báo cáo khoa họcđủ 5 mục
• journalism tin, bài báo, phóng sựđủ 5 mục
• novel truyện, tiểu thuyếtđủ 5 mục
• commentary chính luận, bảo vệ nền tảng tư tưởngchỉ §5
• thesis-proposal thuyết minh đề tàichỉ §5
• internship-report báo cáo thực tập, kiến tậpchỉ §5
• teaching-initiative sáng kiến của giáo viênchỉ §5

Bốn hồ sơ cuối là thể loại đặc thù Việt Nam, sinh ra từ việc giám định thật nên mới chỉ khai phần trục 5 cần. Muốn viết chúng thì dùng essay hoặc research và nói rõ phần chuẩn mực thể loại lấy từ hồ sơ nào.

Ba cổng cứng — qua được mới đi tiếp

claude plugin marketplace add ducnguyen221/agent-writing-studio
claude plugin install agent-writing-studio@agent-writing-studio

git clone https://github.com/ducnguyen221/agent-writing-studio
cd agent-writing-studio
python studio.py doctor      # kiểm máy, không sửa gì · macOS: python3.12

pip install underthesea python-docx pymupdf jsonschema pyyaml   # macOS: python3.12 -m pip install …

Nơi để dữ liệu của bạn

setx WRITING_STUDIO_DATA "$HOME\.writing"          # Windows
export WRITING_STUDIO_DATA="$HOME/.writing"      # macOS, trong ~/.zshrc

$WRITING_STUDIO_DATA/
  work/<slug>/        # thư mục từng ca chạy
  out/                # bản giao
  corpus/             # bài hiệu chuẩn có provenance
  writers/<slug>/     # tuỳ chọn: hồ sơ giọng, khi không có kho tri thức
  audiences/<slug>/   # tuỳ chọn: chân dung độc giả, như trên

Gọi bằng tiếng Việt bình thường

Nói rõ thể loại thì tốt; không nói thì agent sẽ hỏi.

Giao bản docx

Bản giao hoàn chỉnh cho người đọc mặc định là .docx, không phải .md: giảng viên và biên tập viên nhận bài bằng Word.

python shared/scripts/export_docx.py polished.md \
  --out "D:/thu-muc-cua-toi" --provenance polished.provenance.json

Quy cách mặc định là chuẩn văn bản Việt phổ thông: Times New Roman 13pt · giãn dòng 1,5 · lề trên và dưới 2cm, trái 3cm, phải 2cm · heading đậm cỡ 14–16. --out nhận thư mục hoặc đường dẫn .docx cụ thể; --provenance chép bản tự khai nguồn gốc sang cạnh file docx. Cần python-docx; bảng Markdown chưa được dựng thành bảng Word — bài có bảng thì dùng pandoc.

Bảng trên là bản chép cho người đọc. Nguồn thật là bảy file trong commands/ — lệnh list đọc thẳng từ đó, nên hai chỗ lệch nhau thì tin list.

Phép thử: studio viết một bài 100% bằng máy, rồi chính studio chấm mù

Một bài 994 từ do trục 2 viết trọn, không một chữ nào của người, và tự khai đúng như vậy. Trục 5 chấm mù bằng một mô hình khác, chỉ nhìn thấy bản văn:

Con số 4,4% tính trên 45 câu. Sau đó một lỗi nuốt câu ngắn đã được sửa và bài có 47 câu; tính lại là 2/47 = 4,3%. Con số gốc được giữ kèm ghi chú thay vì làm tròn cho đẹp.

Bốn luật không thương lượng

Agent

Trợ lý AI đọc được file trên máy bạn và chạy được lệnh, không chỉ trò chuyện.

Skill

Một thư mục có file SKILL.md nói cho agent biết khi nào dùng và làm theo trình tự nào.

Hồ sơ thể loại

File dữ liệu mô tả một thể loại theo 5 mục, tương ứng 5 trục; cả năm trục cùng đọc một nguồn.

S — điểm dấu hiệu

0–100, dấu hiệu toàn tài liệu mạnh đến đâu. Không phải xác suất do AI viết.

C — độ phủ

Phần trăm câu hợp lệ mang dấu hiệu đo được. Không phải “bao nhiêu phần trăm bài do AI viết”.

FLAG / NOTE

Nhãn câu khi đọc mù: nhiều dấu hiệu hội tụ / một dấu hiệu đơn lẻ.

Provenance

Bản tự khai nguồn gốc đi kèm bản giao: câu nào máy viết, đã qua biên tập máy hay chưa.

Đọc mù

Chấm khi chỉ nhìn thấy bản văn, chưa được xem bản tự khai — và phải khoá kết quả trước khi xem.

Phản chứng

Lời giải thích vô tội cho chính dấu hiệu vừa nêu; thiếu nó thì nhận định chưa hoàn chỉnh.

Thư mục ca

Một bài một thư mục, chứa toàn bộ sản phẩm trung gian của chuỗi Y1→Y5.