Dùng sepia để Viết, Biên tập và Tái cấu trúc Văn phong Tự nhiên hơn

sepia là gì?

sepia là một Agent Skill di động, giúp cải thiện văn học hư cấu và văn xuôi chuyên nghiệp có sự hỗ trợ của AI. Công cụ này hoạt động với Claude Code, Codex, Grok Build và Antigravity từ một SKILL.md chuẩn duy nhất, tránh phải duy trì hướng dẫn riêng cho từng nền tảng.

Khác với các công cụ tập trung vào từ vựng và cú pháp câu, sepia bắt đầu từ những mô thức cấu trúc có thể khiến văn bản mang cảm giác do máy tạo ra. Với văn học hư cấu, đó là các chuỗi nhân quả quá gọn gàng, chủ đề được người kể giải thích, thời gian tuyến tính, cách thể hiện cảm xúc hạn chế, thiếu các tham chiếu đến thế giới thực và những kết thúc được giải quyết hoàn toàn bằng sự trưởng thành hoặc chấp nhận.

Với tài liệu chuyên nghiệp, sepia tìm kiếm những vấn đề khác: nội dung rườm rà nhưng thiếu thông tin, lối diễn đạt né tránh không cần thiết, dấu vết còn sót lại của chatbot, văn phong không phù hợp, định dạng lặp lại và việc không đáp ứng kỳ vọng của nơi tài liệu được sử dụng.

Nguyên tắc cốt lõi: điều chỉnh văn bản theo phân bố tự nhiên của con người thay vì máy móc đảo ngược mọi xu hướng bị cho là dấu hiệu của AI.

Tính năng chính

Bốn thao tác viết

sepia cung cấp bốn thao tác phù hợp với các giai đoạn khác nhau của bản nháp:

• write: Tạo văn xuôi mới bằng các quy tắc phù hợp cho văn học hư cấu hoặc văn bản chuyên nghiệp.
• review: Chẩn đoán vấn đề mà không chỉnh sửa văn bản.
• refactor: Thực hiện các chỉnh sửa tối thiểu, có mục tiêu, đồng thời giữ lại nhiều nhất có thể từ bản nháp.
• recreate: Viết lại toàn bộ tài liệu khi chỉnh sửa cục bộ không đủ hiệu quả.

Quy trình ba lượt cho văn học hư cấu

1. Kiến trúc tự sự: Xử lý việc giải thích chủ đề, tính ngăn nắp của quan hệ nhân quả, thời điểm tiết lộ, các trạng thái cảm xúc, mạng lưới nhân vật và tham chiếu đến những sự vật có thật.
2. Mạch diễn đạt: Phá vỡ các khuôn mẫu đoạn văn-câu hỏi lặp lại, khắc phục đoạn chùng xuống giữa câu chuyện và thay đổi nhịp điệu cũng như vị trí đưa thông tin.
3. Phong cách bề mặt: Chỉnh sửa sáo ngữ, khuôn mẫu cú pháp, từ vựng và văn phong sau khi đã xử lý các vấn đề cấu trúc lớn hơn.

Skill này cũng bao gồm bộ tiêu chí chẩn đoán văn học hư cấu gồm 30 đặc điểm và các cách sửa cho những mô thức gắn với Claude, GPT, Gemini, DeepSeek và Kimi.

Quy tắc cho tài liệu chuyên nghiệp

Văn xuôi chuyên nghiệp sử dụng một danh sách kiểm tra chung cùng với một tệp quy tắc ngắn cho từng nơi được hỗ trợ:

• Ghi chú phát hành và thông báo: Đặt tác động đến người dùng lên trước, hỗ trợ tuyên bố bằng các hiện vật và tránh thổi phồng tiếp thị.
• Phản hồi pull request và issue: Trả lời trước, dẫn file:line, tránh khen ngợi theo phản xạ và điều chỉnh độ dài theo mức độ quan trọng.
• Báo cáo sau sự cố: Không đổ lỗi cho con người nhưng vẫn phân tích nghiêm ngặt các cơ chế; bao gồm mốc thời gian, những hướng đi bế tắc và các mục hành động có người chịu trách nhiệm.
• Ticket và lệnh công việc: Nêu kết quả trong tiêu đề, cung cấp tiêu chí nghiệm thu có thể kiểm thử và liên kết thay vì lặp lại thông tin.
• Bài viết kỹ thuật: Mở đầu bằng vấn đề, đưa vào một hướng đi bế tắc thực tế và một quan điểm rõ ràng, đồng thời nêu điều kiện áp dụng của các con số.

Cài đặt sepia

Phạm vi cài đặt mặc định là tài khoản người dùng, vì vậy một lần cài đặt có thể được sử dụng cho nhiều dự án. Chọn hướng dẫn tương ứng với nền tảng agent của bạn.

Claude Code

# install
claude plugin marketplace add Nanako0129/sepia
claude plugin install sepia@sepia --scope user

# update
claude plugin marketplace update sepia
claude plugin update sepia

Nếu cài đặt từ hộp thoại plugin trong phiên Claude Code, hãy chọn User khi được hỏi về phạm vi.

Codex

# install
codex plugin marketplace add Nanako0129/sepia
codex plugin add sepia@sepia

# update
codex plugin marketplace upgrade sepia
codex plugin add sepia@sepia

Để cập nhật Codex, cần làm mới ảnh chụp marketplace và thêm lại plugin để nhận phiên bản mới.

Grok Build

# install
grok plugin install Nanako0129/sepia --trust

# update
grok plugin update

Grok Build cũng có thể tự động phát hiện bản cài đặt sepia hiện có của Claude Code.

Antigravity

Antigravity không sử dụng marketplace cho skill này. Hãy clone repository, sao chép thư mục skill và cài đặt workflow toàn cục /sepia:

# install
git clone https://github.com/Nanako0129/sepia.git ~/.sepia
mkdir -p ~/.gemini/config/skills ~/.gemini/antigravity/global_workflows
cp -R ~/.sepia/skills/sepia ~/.gemini/config/skills/sepia
cp ~/.sepia/.agents/workflows/sepia.md ~/.gemini/antigravity/global_workflows/sepia.md

# update
git -C ~/.sepia pull
rm -rf ~/.gemini/config/skills/sepia && cp -R ~/.sepia/skills/sepia ~/.gemini/config/skills/sepia
cp ~/.sepia/.agents/workflows/sepia.md ~/.gemini/antigravity/global_workflows/sepia.md

Cài đặt cho cả bốn nền tảng

Repository cung cấp một script để cài đặt sepia ở phạm vi người dùng cho cả bốn nền tảng được hỗ trợ:

curl -fsSL https://raw.githubusercontent.com/Nanako0129/sepia/main/install.sh | bash

Script clone dự án vào ~/.sepia. Đặt SEPIA_HOME để sử dụng vị trí khác. Chạy lại cùng lệnh sẽ cập nhật bản cài đặt. Để kiểm tra script trước khi thực thi, hãy clone repository và chạy ./install.sh từ thư mục checkout.

Cài đặt qua Skills CLI

Skills CLI cung cấp một cách khác để cài đặt sepia và hỗ trợ hơn 77 agent:

npx skills add Nanako0129/sepia -g
npx skills update -g

Tùy chọn -g chọn phạm vi người dùng. Nếu không có tùy chọn này, CLI mặc định sử dụng phạm vi dự án.

Cách sử dụng cơ bản

Sau khi cài đặt, hãy yêu cầu agent áp dụng sepia và chỉ định một trong bốn thao tác của nó. Các ví dụ dưới đây minh họa cách diễn đạt yêu cầu, không phải các lệnh shell dành riêng cho nền tảng.

Viết tài liệu mới

Dùng write khi bắt đầu từ một bản tóm tắt. Xác định loại tài liệu đích để sepia có thể chọn đúng quy tắc.

Dùng thao tác write của sepia để soạn ghi chú phát hành từ những thay đổi này.
Đặt tác động đến người dùng lên trước và hỗ trợ mỗi nhận định bằng một tạo tác cụ thể.

Đối với tác phẩm hư cấu, hãy cung cấp tiền đề, các ràng buộc và hình thức dự kiến mà không áp đặt mọi bước triển khai về cấu trúc:

Dùng thao tác write của sepia để tạo một truyện ngắn từ tiền đề này.
Áp dụng giao thức dành cho văn học hư cấu, nhưng giữ lại sự mơ hồ và tránh giải thích chủ đề.

Chẩn đoán mà không thay đổi bản nháp

Chọn review khi bạn muốn nhận các phát hiện trước khi quyết định cần chỉnh sửa gì. Hãy yêu cầu rõ ràng chỉ chẩn đoán để bản gốc không bị động đến.

Hãy review truyện này bằng sepia. Chỉ chẩn đoán; không viết lại.
Ưu tiên kiến trúc tự sự, sau đó đến mạch diễn ngôn và phong cách bề mặt.

Đối với tài liệu chuyên môn, hãy nêu rõ loại tài liệu:

Hãy review bản postmortem sự cố này bằng sepia.
Kiểm tra các mốc thời gian, ngõ cụt, phân tích cơ chế và các hạng mục hành động có người phụ trách.
Không chỉnh sửa bản nháp.

Thực hiện thay đổi tối thiểu

Dùng refactor khi bản nháp về cơ bản đã ổn và cần giữ nguyên giọng văn, dữ kiện cũng như cách tổ chức nhiều nhất có thể.

Hãy refactor bài viết kỹ thuật này bằng sepia với số lần chỉnh sửa tối thiểu.
Giữ nguyên các nhận định kỹ thuật và giọng văn, đồng thời loại bỏ phần rườm rà và sửa những điểm không phù hợp với loại tài liệu.

Viết lại từ đầu

Dùng recreate khi các vấn đề về cấu trúc không thể được sửa chữa gọn gàng bằng những chỉnh sửa cục bộ.

Hãy recreate thông báo phát hành này bằng sepia.
Giữ lại mọi dữ kiện đã được xác minh, dẫn dắt bằng tác động đến người dùng và loại bỏ những lời phóng đại tiếp thị.

Vì recreate là một lần viết lại toàn diện, hãy nêu rõ những dữ kiện, trích dẫn, tài liệu tham chiếu hoặc ràng buộc nào phải được giữ lại.

Chọn đúng thao tác

• Chọn write khi bạn có tài liệu nguồn hoặc bản tóm tắt nhưng chưa có bản nháp có thể sử dụng.
• Chọn review khi bạn cần chẩn đoán, kế hoạch biên tập hoặc ý kiến thứ hai mà không muốn có thay đổi.
• Chọn refactor khi việc bảo toàn bản nháp hiện tại quan trọng hơn việc tạo ra một cấu trúc hoàn toàn mới.
• Chọn recreate khi kiến trúc, cách tổ chức hoặc văn phong của bản nháp về cơ bản không phù hợp.

Mẹo nâng cao

Không áp dụng mọi quy tắc dành cho văn học hư cấu

sepia được thiết kế để chọn khoảng ba đến năm cách xử lý hữu ích cho một câu chuyện và để lại độ linh hoạt ở những phần khác. Áp dụng mọi chỉnh sửa có thể thay thế một mô thức dễ nhận biết bằng một mô thức khác. Hãy yêu cầu agent ưu tiên những phát hiện có tác động lớn nhất thay vì tối đa hóa độ bao phủ quy tắc.

Hãy review truyện này bằng sepia và xác định năm vấn đề có tác động lớn nhất.
Chỉ refactor ba vấn đề hàng đầu, giữ nguyên những điểm bất thường có chủ ý.

Chỉnh sửa theo thứ tự cấu trúc

Đối với văn học hư cấu, hãy tránh trau chuốt câu chữ trước khi hoàn thiện kiến trúc tự sự. Trình tự tốt hơn là review kiến trúc, sửa mạch diễn ngôn, rồi mới điều chỉnh phong cách bề mặt. Cách này ngăn việc những câu chữ đã được trau chuốt bị loại bỏ trong các lần sửa lớn hơn.

Cung cấp loại tài liệu và bằng chứng

Các quy tắc viết chuyên môn phụ thuộc vào bối cảnh. Hãy cho sepia biết bản nháp là ticket, câu trả lời pull request, postmortem, ghi chú phát hành hay bài viết kỹ thuật. Bao gồm các tệp liên quan, tham chiếu dòng, mốc thời gian, tiêu chí chấp nhận, liên kết, số liệu và điều kiện để đầu ra có thể duy trì tính cụ thể.

Ghim sepia vào dự án

Dùng phạm vi dự án khi một repository cần giữ lại một bản skill cố định. Commit skills/sepia/ dưới dạng .agents/skills/sepia cho Codex và Antigravity, hoặc dưới dạng .claude/skills/sepia cho Claude Code.

Cách này hữu ích khi một nhóm muốn repository mang theo phiên bản skill riêng thay vì phụ thuộc vào bản cài đặt trong phạm vi người dùng của từng cộng tác viên.

Kiểm tra các lớp tham chiếu

Skill chính tắc nằm tại skills/sepia/SKILL.md. Các tệp tham chiếu của nó phân tách kiến trúc tự sự, mạch diễn ngôn, phong cách bề mặt, chẩn đoán, dấu vân tay của mô hình, các quy tắc chuyên môn dùng chung và các lĩnh vực đặc thù theo loại tài liệu. Thư mục research/ chứa cơ sở bằng chứng đã được cô đọng của dự án cùng các liên kết nguồn.

Luôn cập nhật bản cài đặt

Dùng các lệnh cập nhật dành cho nền tảng bạn đã chọn. Nếu đã cài đặt tất cả nền tảng bằng install.sh, hãy chạy lại chính lệnh cài đặt đó. Việc thiết lập thủ công Antigravity yêu cầu kéo repository rồi sao chép lại các tệp skill và workflow đã cập nhật.

Kết luận

sepia xem lối viết giống con người không chỉ là vấn đề từ vựng. Quy trình dành cho văn học hư cấu bắt đầu từ kiến trúc tự sự, tiếp tục qua mạch diễn ngôn và kết thúc ở phong cách bề mặt, trong khi các quy tắc viết chuyên môn thích ứng với yêu cầu của từng loại tài liệu cụ thể. Hãy cài đặt nó trong phạm vi người dùng hoặc dự án, chọn thao tác phù hợp với mục tiêu biên tập và áp dụng một số thay đổi có tác động lớn thay vì mọi quy tắc hiện có.

sepia được phát hành theo Giấy phép MIT. Mã nguồn, các tệp tham chiếu, script cài đặt và các bản tóm lược nghiên cứu của dự án có sẵn trong repository GitHub.