hoangvantuan/style-writer

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:

1. Giọng điệu & vai người kể — Formal level (1-5), tone, ngôi xưng, distance với reader, thái độ.
2. Cấu trúc bài — Pattern mở bài, xương sống triển khai, pattern kết bài.
3. 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.
4. Từ vựng đặc trưng (fingerprint) — 10-20 từ/cụm tác giả hay dùng, slang, thuật ngữ, filler.
5. Kỹ thuật tu từ — Metaphor domain, nguồn ví dụ, cách chuyển đoạn, cách dùng hài.
6. Format & typography — Heading, list, bold, đoạn dài, emoji, em-dash, whitespace.
7. Tư duy & logic — Pattern lập luận, xử lý counter-argument, tuyệt đối vs. nuance.
8. 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.

| Structure | Slug | Recommended Voice | Arc Pattern | Best for | File | | --------------- | ----------------- | ----------------- | ----------------- | -------------------------------------- | ------------------------------------------------------------------------- | | Story Arc | story-arc | storyteller | Growth Journey | Bài có hành trình thời gian | structures/story-arc.md | | BLUF-Evidence | bluf-evidence | objective | | Bài cần kết luận trước, chứng minh sau | structures/bluf-evidence.md | | Building Blocks | building-blocks | guide | | Bài xây kiến thức từng bước | structures/building-blocks.md | | Spiral Return | spiral-return | storyteller | Quiet Devastation | Bài quay lại chủ đề, mỗi lần sâu hơn | structures/spiral-return.md | | Five Layers | five-layers | investigator | | Bài đào sâu 5 tầng | structures/five-layers.md | | Master-Student | master-student | dialogue | | Bài đối thoại thầy-trò | structures/master-student.md | | Depth-Practice | depth-practice | guide | Transformation | Bài chiều sâu + thực hành | structures/depth-practice.md | | Adaptive | adaptive | (any) | | Nội dung hỗn hợp | structures/adaptive.md |

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):

1. Soạn file <slug>.md (kèm exemplars).
2. 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.
3. Arc pattern (nếu có) → thêm vào structure tương ứng, không vào voice file.
4. Lưu vào references/voices/.
5. Thêm dòng mới vào bảng Voices có sẵn.

Thêm structure mới

1. Soạn file <slug>.md với frontmatter (name, recommended_voice, best_for, version).
2. File tối thiểu cần: Overview, Phases (từng giai đoạn + Opening Palette), Content-Type Adaptation, Quality Checklist.
3. Lưu vào references/structures/.
4. 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 protocol
• references/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:

1. Điều mới: Input nói gì mà người đọc phổ thông CHƯA biết?
2. Góc nhìn: Góc nào chưa ai khai thác?
3. "À, hóa ra": Người đọc sẽ bất ngờ ở chỗ nào?
4. 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:

1. Đề xuất structure dựa trên recommended_voice mapping trong bảng Structures.
2. User confirm hoặc chọn structure khác.
3. 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

1. Read file voice + references/shared-rules.md. Bài dài: thêm file structure.
2. 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.
3. 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".

1. Đọc lại như người đọc: chỗ nào phải đọc 2 lần thì viết lại.
2. "Vậy thì sao?" sweep: đoạn nào không pass → cắt hoặc nối.
3. Đoạn yếu nhất: mạnh lên hoặc cắt đi.
4. Share test: "Tôi có share bài này không?" Không → sửa.
5. 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.