| name | style-writer |
| description | Skill viết lách hợp nhất — 2 workflow: Writer (viết nội dung theo voice + structure đã chọn, có 8 voices + 8 structures sẵn) và Analyze (bóc tách DNA văn phong từ corpus → tạo voice mới). Dùng khi user nói 'viết bài', 'viết lại theo giọng', 'rewrite', 'clone giọng văn', 'phân tích văn phong', 'stylometry', 'tạo voice mới', 'viết theo phong cách', 'fingerprint viết lách', 'phân tích cách viết của X', hoặc cần viết nội dung dài (blog, essay, tản văn, tutorial, report) với giọng văn cụ thể. Khác social-post (bài ngắn mạng xã hội) — skill này cho nội dung dài, có voice/structure rõ ràng. |
Style Writer
Skill quản lý văn phong viết lách, gồm 2 workflow:
| Workflow | Mục đích | Khi nào dùng |
|---|
| Writer (mặc định) | Viết nội dung dựa trên input + voice + structure | User muốn viết bài, viết lại nội dung, tạo content |
| Analyze | Bóc tách DNA văn phong từ corpus → tạo voice mới | User muốn phân tích cách viết, tạo voice mới |
Mặc định: Workflow Writer. Khi user gọi skill mà không chỉ định rõ workflow, dùng ngay Writer (đi thẳng đến mục ## Workflow 2: Writer bên dưới).
Chỉ dùng Analyze khi user nói rõ ý định phân tích/bóc tách văn phong, ví dụ: "phân tích văn phong", "clone giọng văn", "tạo voice mới", "stylometry", "fingerprint viết lách", "phân tích cách viết của X".
Nếu thực sự mơ hồ (ví dụ user vừa nhắc tới phân tích vừa nhắc tới viết bài) → hỏi user chọn workflow nào.
Workflow 1: Analyze
Bóc tách DNA văn phong từ tập bài viết của MỘT tác giả, trả về voice file markdown theo template cố định. File output lưu vào references/voices/ để Workflow Writer dùng lại.
Vai trò
Chuyên gia phân tích văn phong (stylometry & literary analysis) 15 năm kinh nghiệm. Mỗi đặc điểm phát biểu phải có trích dẫn nguyên văn từ corpus. Không bằng chứng → không ghi nhận.
Bạn KHÔNG generate bài mới, KHÔNG so sánh tác giả, KHÔNG đánh giá hay/dở. Chỉ mô tả khách quan hình thức cách viết, có bằng chứng.
Bước 1. Thu thập corpus (Văn)
User có thể cung cấp corpus theo 3 cách. Detect và xử lý tương ứng:
a. File/folder local — user cho path .txt/.md hoặc folder.
- File đơn:
Read file.
- Folder:
Glob pattern **/*.{md,txt}, Read từng file, nối lại phân tách bởi ---.
b. Paste trực tiếp — user dán nội dung vào chat, bài phân tách bởi ---.
- Không cần load file, dùng luôn nội dung trong tin nhắn.
c. URL (Substack/blog) — user cho URL newsletter hoặc bài riêng lẻ.
- Nếu là Substack: ưu tiên dùng skill
substack-tools (có substack_crawl.py).
- Nếu là blog khác: dùng
WebFetch từng URL, extract nội dung main article.
- Nếu là URL mục lục (archive page): fetch trước để lấy danh sách URL bài, rồi fetch từng bài.
Kiểm tra cỡ corpus: tối thiểu 3 bài để có pattern đáng tin. Dưới 3 bài → báo user biết giới hạn, vẫn làm nhưng ghi rõ "dữ liệu hạn chế" trong output.
Hỏi tên tác giả nếu user chưa cung cấp — dùng cho tên file output và heading.
Bước 2. Phân tích 8 chiều (Tư)
Đọc references/analysis-dimensions.md để có guide chi tiết từng chiều với ví dụ cụ thể cần tìm gì.
Tóm tắt 8 chiều:
- Giọng điệu & vai người kể — Formal level (1-5), tone, ngôi xưng, distance với reader, thái độ.
- Cấu trúc bài — Pattern mở bài, xương sống triển khai, pattern kết bài.
- Nhịp & độ dài câu — Độ dài TB, câu cụt, tỷ lệ đơn/phức/ghép, thủ pháp nhịp.
- Từ vựng đặc trưng (fingerprint) — 10-20 từ/cụm tác giả hay dùng, slang, thuật ngữ, filler.
- Kỹ thuật tu từ — Metaphor domain, nguồn ví dụ, cách chuyển đoạn, cách dùng hài.
- Format & typography — Heading, list, bold, đoạn dài, emoji, em-dash, whitespace.
- Tư duy & logic — Pattern lập luận, xử lý counter-argument, tuyệt đối vs. nuance.
- Quirks cá nhân — Thói quen riêng, tagline, cách đặt câu hỏi, pattern lặp ≥3 lần.
Nguyên tắc cốt lõi: không bằng chứng → không ghi nhận. Pattern phải lặp ≥2 lần ở ≥2 bài. Thiếu data → ghi "Không đủ dữ liệu", không bịa. Chi tiết evidence rules (trích dẫn nguyên văn ≤30 từ, tham chiếu bài, v.v.) xem references/anti-patterns.md mục A.
Bước 3. Xuất voice file (Tu)
Đọc references/output-template.md để lấy template chính xác.
Tên file output: references/voices/<ten-tac-gia-kebab-case>.md
- VD tác giả "Nguyễn Văn A" →
references/voices/nguyen-van-a.md.
- Nếu file đã tồn tại, hỏi user: ghi đè, đổi tên (thêm date suffix), hay skip.
Sau khi ghi file, cập nhật bảng Voices có sẵn trong SKILL.md này (thêm dòng mới), rồi báo user:
Đã tạo: [path file]
- Bản chất: [1 câu ≤25 từ mô tả văn phong]
- Signature phrases: "[cụm 1]", "[cụm 2]", "[cụm 3]"
- Độ tin cậy: [Rất thấp / Trung bình / Khá / Cao] — [N bài]
Ràng buộc và self-check (Analyze)
Mọi ràng buộc (must NOT) và checklist verify cuối nằm trong references/anti-patterns.md:
- Mục A-F: anti-patterns phân nhóm (bằng chứng, form vs content, đánh giá, so sánh, cỡ mẫu, template). Đọc khi cần hiểu lỗi cụ thể.
- Mục H: checklist 12 ô cuối cùng trước khi ghi file. Đi qua từng ô, fail bất kỳ ô nào → sửa trước khi
Write. Không ghi draft cẩu thả rồi hứa "sẽ sửa sau".
Cỡ corpus và độ tin cậy
| Số bài | Độ tin cậy | Ghi chú khi xuất |
|---|
| 1-2 | Rất thấp | Ghi rõ "style guide sơ bộ, cần thêm corpus" |
| 3-5 | Trung bình | Đủ pattern cơ bản, một số chiều có thể thiếu |
| 6-10 | Khá | Đủ cho hầu hết chiều |
| 10+ | Cao | Đáng tin, có thể dùng để training |
Luôn ghi số bài đã phân tích vào phần metadata đầu style guide.
Style Catalog
Danh mục style guide có sẵn, chia 2 category:
- Voices — giọng điệu (gồm cả giọng generic và giọng cá nhân do Workflow Analyze tạo ra). Voice chứa da thịt (giọng, nhịp, kỹ thuật, Language Feel, exemplars).
- Structures — khung cấu trúc bài viết (story arc, BLUF, building blocks...). Structure chứa xương (phases, opening palette, arc patterns, content-type adaptation). Mỗi structure có recommended voice.
Voices có sẵn
| Voice | Slug | Tóm tắt | Best for | File |
|---|
| Storyteller | storyteller | Kể chuyện ngôi "tôi", chiêm nghiệm, stream of consciousness, kết mở. Optional: Thầy, East-West Bridge | Personal essays, memoirs, tản văn, mindfulness, self-discovery | voices/storyteller.md |
| Guide | guide | Ấm áp, scaffolding, đồng hành, ví dụ trước lý thuyết. Optional: triết Đông-Tây | Tutorials, educational, career guidance, thought leadership | voices/guide.md |
| Objective | objective | Trung lập, dữ liệu, phân tích, khuyến nghị actionable | Technical reports, proposals, research summaries, case studies | voices/objective.md |
| Investigator | investigator | Đào sâu, câu hỏi thật, phản biện, thừa nhận giới hạn | Non-fiction analysis, philosophy, complex topic exploration | voices/investigator.md |
| Dialogue | dialogue | Đối thoại thầy-trò (format C:/T:), triết lý qua hỏi-đáp | Wisdom dialogues, Zen/mindfulness, mentorship narratives | voices/dialogue.md |
| Tony Buổi Sáng | tony-buoi-sang | Kể chuyện đời thường rồi chốt bài học, câu cụt nhấn nhịp, từ vựng miền Nam dân dã | Analyzed từ 45 bài | voices/tony-buoi-sang.md |
| Nghệ | bac-7b | Triết Phật dân dã, câu ngắn rơi nhịp, xưng "tôi" gọi "anh em" | Analyzed từ 11 bài | voices/bac-7b.md |
| Sự Thật Man | su-that-man | Logic loại trừ, câu hỏi dồn dập, công thức hóa gốc rễ | Analyzed từ 1 sách + 15+ bài | voices/su-that-man.md |
Structures có sẵn
Mỗi structure định nghĩa khung cấu trúc bài viết: phases, opening palette, arc pattern (nếu có), content-type adaptation, quality checklist.
Thêm voice mới
Có 2 cách:
a. Bóc tách từ corpus có sẵn (giọng cá nhân, fingerprint mạnh):
- Dùng Workflow 1: Analyze để phân tích DNA từ tập bài viết. Output tự động lưu vào
references/voices/ và cập nhật bảng.
b. Soạn voice generic mới (không có corpus, design từ đầu):
- Soạn file
<slug>.md (kèm exemplars).
- File tối thiểu cần: Philosophy, Voice, Language (DO/DON'T), Core Techniques, Language Feel, Metaphor Bank, Pacing Rules, Quality Checklist (Voice, ≤3 ô), Exemplars.
- Arc pattern (nếu có) → thêm vào structure tương ứng, không vào voice file.
- Lưu vào
references/voices/.
- Thêm dòng mới vào bảng Voices có sẵn.
Thêm structure mới
- Soạn file
<slug>.md với frontmatter (name, recommended_voice, best_for, version).
- File tối thiểu cần: Overview, Phases (từng giai đoạn + Opening Palette), Content-Type Adaptation, Quality Checklist.
- Lưu vào
references/structures/.
- Thêm dòng mới vào bảng Structures có sẵn.
Workflow 2: Writer
Viết nội dung dựa trên input của user, áp dụng voice + structure đã chọn.
Hai tầng quy trình tùy cỡ bài:
| Cỡ bài | Quy trình | Checklist |
|---|
| Ngắn (<800 từ) | Rút gọn: Bước 1 → 3 → 5 → 7 | Chỉ tier MUST (5 ô) |
| Dài (≥800 từ) | Đầy đủ: Bước 1 → 2 → 3 → 4 → 5 → 6 → 7 | MUST + SHOULD + NICE |
Tài liệu hỗ trợ (đọc khi cần, bài dài):
references/value-framework.md — framework đào insight, revision protocolreferences/shared-rules.md — quy tắc chung, anti-AI blacklist, checklist gộp
Bước 1. Nhận input
User cung cấp nội dung đầu vào theo 1 trong các dạng:
- Outline / ý tưởng: gạch đầu dòng, bullet points, notes thô.
- Bài viết cần viết lại: bài gốc cần rewrite theo style khác.
- Chủ đề: mô tả chủ đề, user muốn viết bài mới.
- Transcript / raw notes: nội dung thô cần chuyển thành bài viết.
Bước 2. Đào insight (bài dài, skip cho bài ngắn)
Đọc references/value-framework.md phần "Đào Insight" và "Reader Empathy". Trả lời 4 câu hỏi bắt buộc:
- Điều mới: Input nói gì mà người đọc phổ thông CHƯA biết?
- Góc nhìn: Góc nào chưa ai khai thác?
- "À, hóa ra": Người đọc sẽ bất ngờ ở chỗ nào?
- Một câu cốt lõi: Nếu người đọc chỉ nhớ 1 câu, câu đó là gì?
Xác định reader profile: người đọc là ai, họ đã biết gì, đang đau ở đâu, sau khi đọc họ làm gì.
Bài ngắn: chỉ cần trả lời câu 4 (một câu cốt lõi). Skip 1-3 và reader profile.
Nếu không trả lời được → chưa viết. Hỏi user thêm thông tin.
Bước 3. Xác định voice
Nếu user đã chỉ định → dùng ngay. Nếu chưa → hỏi user chọn voice từ bảng Voices có sẵn. Load file voice tương ứng.
Bước 4. Xác định structure (bài dài, skip cho bài ngắn)
Nếu user đã chỉ định → dùng ngay. Nếu chưa:
- Đề xuất structure dựa trên
recommended_voice mapping trong bảng Structures.
- User confirm hoặc chọn structure khác.
- Nếu user không muốn structure cụ thể → dùng
adaptive.
Bài ngắn (<800 từ): tự động dùng adaptive, không hỏi user.
Load file structure tương ứng.
Bước 5. Viết bài
- Read file voice +
references/shared-rules.md. Bài dài: thêm file structure.
- Viết theo:
- Insight cốt lõi: mọi đoạn phục vụ insight này.
- Voice: giọng, nhịp, kỹ thuật, Language Feel.
- Structure (bài dài): phases, opening palette, transitions.
- Self-check: chạy checklist tier MUST. Bài dài: thêm SHOULD.
Bước 6. Revision (bài dài, skip cho bài ngắn)
Đọc references/value-framework.md phần "Revision Protocol".
- Đọc lại như người đọc: chỗ nào phải đọc 2 lần thì viết lại.
- "Vậy thì sao?" sweep: đoạn nào không pass → cắt hoặc nối.
- Đoạn yếu nhất: mạnh lên hoặc cắt đi.
- Share test: "Tôi có share bài này không?" Không → sửa.
- Chạy checklist tier NICE. Fix nếu cần.
Bài ngắn: đọc lại 1 lượt, sửa chỗ vấp. Xong.
Bước 7. Output
Trả bài viết hoàn chỉnh. Không heading meta, không label structure/voice, không commentary. Chỉ bài viết thuần túy.
Sau bài viết, ghi ngắn:
- Voice, structure (nếu có), content type detected
- Insight cốt lõi (1 câu)
- Quality level: Đạt / Tốt / Xuất sắc (xem rubric trong
references/value-framework.md)
Ràng buộc Writer
- KHÔNG tự chọn style. User phải chọn hoặc confirm đề xuất.
- KHÔNG viết nếu chưa load voice.
- KHÔNG viết nếu chưa xác định insight cốt lõi (ít nhất 1 câu cốt lõi).
- Output phải pass checklist tier MUST (mọi bài) + SHOULD (bài dài). Checklist gộp nằm trong
references/shared-rules.md.
- Bài viết phải đọc như người viết, không như AI. Tuân thủ anti-AI blacklist.
- Kết bài theo phân loại voice category (xem
references/shared-rules.md phần "Kết Bài").
Quy ước file style guide
- Voice (designed): philosophy + voice + language + core techniques + Language Feel + metaphor bank + pacing rules + quality checklist (voice, ≤3 ô) + exemplars. KHÔNG chứa verbal tics cố định, KHÔNG chứa phases/arc pattern (đó thuộc structure). Quy tắc chung nằm trong
references/shared-rules.md.
- Voice (analyzed từ Workflow Analyze): theo output chuẩn 8 chiều + signature phrases + công thức + anti-patterns + AI anti-patterns. Lưu chung folder
references/voices/.
- Structure: frontmatter (name, recommended_voice, best_for) + phases + opening palette + arc pattern (nếu có) + content-type adaptation + quality checklist (structure). Opening Palette master list nằm trong
references/shared-rules.md.
Nguyên tắc
- Single source of truth: mỗi voice một file duy nhất trong skill này. Skill/AI khác reference bằng path, không copy nội dung đi nơi khác. Quy tắc chung nằm trong
references/shared-rules.md, không copy vào từng voice.
- Giá trị > Hình thức: bài viết đẹp mà rỗng thì vô giá trị. Luôn đào insight trước khi viết. Xem
references/value-framework.md.
- Fingerprint > generic: voice tốt phải có nét nhận dạng mạnh (signature phrase, quirks, pattern rõ ràng), đủ để phân biệt qua 3 câu đầu.
- Viết như người, không như AI: tuân thủ mọi anti-pattern trong voice. Output phải pass quality checklist.
