Cải thiện cách viết của Claude với Claude Style Patch

Claude Style Patch làm gì

Claude Style Patch là một bộ hướng dẫn viết có thể đưa trực tiếp vào CLAUDE.md. Bộ hướng dẫn này được thiết kế để giảm lối văn dày đặc, cô đọng và một số thói quen phong cách thường lặp lại trong các thế hệ Claude gần đây. Bản vá không chỉ áp dụng cho câu trả lời trò chuyện mà còn cho tài liệu được tạo, sản phẩm bàn giao, prompt và chú thích mã.

Dự án được hoàn thiện qua quá trình sử dụng lặp lại với Claude Code và Claude.ai trên nhiều thế hệ Opus và Fable. Thay vì yêu cầu Claude viết rõ ràng hơn theo cách chung chung, bản vá đưa ra các quy tắc cụ thể: xác định một thói quen không mong muốn và nêu cách sửa thói quen đó.

Tính năng chính

• Cấu hình dùng ngay: Thêm một tệp vào CLAUDE.md cấp toàn cục hoặc cấp dự án.
• Quy tắc viết cụ thể: Mỗi quy tắc gọi tên một thói quen, minh họa thói quen đó và đưa ra chiến lược viết lại.
• Phạm vi áp dụng rộng: Hướng dẫn áp dụng cho hội thoại thông thường, tài liệu, sản phẩm bàn giao, prompt cho agent và chú thích mã.
• Triển khai linh hoạt: Sử dụng trong Claude Code, Claude Projects hoặc một system prompt khác.
• Giấy phép phạm vi công cộng: Bản vá sử dụng CC0, vì vậy bạn có thể sao chép, sửa đổi, fork hoặc trích xuất từng phần mà không cần ghi công.

Những thói quen viết được nhắm đến

Bản vá tập trung vào một số xu hướng trong văn phong mặc định của Claude:

• Thông báo một ý trước khi thực sự trình bày ý đó.
• Dùng dấu hai chấm để nửa đầu câu gắn nhãn cho nửa sau.
• Mở đầu đoạn văn bằng các mảnh câu không có động từ.
• Xếp chồng các cụm từ cô đọng đến mức câu trở nên khó đọc.

Những kiểu diễn đạt này có thể trở nên rõ rệt hơn khi cuộc trò chuyện dài hơn hoặc trừu tượng hơn. Bản vá cố gắng duy trì lối văn trực tiếp, dễ đọc trong những điều kiện đó.

Cài đặt bản vá trên toàn cục

Đối với Claude Code, hãy nối tệp STYLE.md từ xa vào cấu hình toàn cục:

curl -sL https://raw.githubusercontent.com/andrewroxby/claude-style-patch/main/STYLE.md >> ~/.claude/CLAUDE.md

Toán tử >> nối các hướng dẫn đã tải xuống thay vì thay thế tệp hiện có. Chỉ chạy lệnh này khi bạn muốn thêm bản vá, vì chạy lại sẽ nối thêm một bản sao khác.

Sau khi được cài đặt trên toàn cục, các hướng dẫn về phong cách sẽ trở thành một phần trong cấu hình Claude Code của bạn trên các dự án sử dụng CLAUDE.md toàn cục.

Cài đặt cho một dự án

Nếu muốn thử bản vá hoặc chỉ áp dụng bản vá cho một repository cụ thể, hãy nối bản vá vào CLAUDE.md riêng của dự án:

cd path/to/your/project
curl -sL https://raw.githubusercontent.com/andrewroxby/claude-style-patch/main/STYLE.md >> CLAUDE.md

Cài đặt ở cấp dự án hữu ích khi một repository cần văn phong cụ thể nhưng bạn không muốn thay đổi hành vi của Claude trong mọi phiên Claude Code.

Sử dụng bên ngoài Claude Code

Bản vá là văn bản hướng dẫn thuần túy, nên không phụ thuộc vào plugin hay runtime đặc biệt. Để sử dụng với Claude Project, hãy sao chép nội dung của STYLE.md vào phần hướng dẫn tùy chỉnh của dự án. Bạn cũng có thể dán nội dung đó vào system prompt trong một môi trường khác.

1. Mở tệp STYLE.md của repository.
2. Sao chép toàn bộ nội dung.
3. Mở trình chỉnh sửa hướng dẫn tùy chỉnh hoặc system prompt của môi trường bạn đang dùng.
4. Dán các hướng dẫn và lưu cấu hình.

Tệp nguồn có tại repository Claude Style Patch.

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

Sau khi cài đặt, hãy sử dụng Claude như bình thường. Bạn không cần gọi lệnh hoặc nhắc đến bản vá trong mỗi yêu cầu. Hãy yêu cầu đầu ra cần thiết, các hướng dẫn sẽ định hướng cách Claude trình bày đầu ra đó.

Ví dụ: Tạo tài liệu

Write a technical overview of this service for new engineers. Explain its architecture, request flow, dependencies, and operational risks.

Bản vá nhằm giúp tài liệu tạo ra dễ đọc hơn bằng cách hạn chế các thông báo mở đầu, cách mở đoạn bằng mảnh câu và cấu trúc câu quá cô đọng.

Ví dụ: Yêu cầu chú thích mã

Review this module and add comments where they clarify non-obvious behavior. Keep the comments concise and useful to future maintainers.

Vì đặc tả phong cách cũng bao quát chú thích mã, các quy tắc của bản vá có thể ảnh hưởng đến phần văn bản giải thích được viết bên trong tệp nguồn.

Ví dụ: Tạo prompt cho agent khác

Hew closely to the response style instructions. Write a detailed implementation prompt for another agent that will add authentication to this application.

Lời nhắc rõ ràng này đặc biệt hữu ích trước khi Claude tạo các prompt dài hoặc phần văn bản mới đáng kể.

Mẹo nâng cao

Củng cố quy tắc trước các tác vụ nhiều nội dung

Mức độ tuân thủ khá tốt nhưng không hoàn hảo và có thể suy giảm trong các cuộc trò chuyện dài. Đoạn mở đầu của bản vá yêu cầu Claude kiểm tra lại các quy tắc khi nội dung trở nên dày đặc, nhưng điều này không loại bỏ mọi sai lệch.

Trước một tác vụ viết phức tạp, hãy thêm lời nhắc sau:

Hew closely to the response style instructions.

Tác giả dự án cho biết câu này đặc biệt hiệu quả trước khi tạo văn bản dài hoặc prompt cho các agent khác.

Chủ động chọn phạm vi toàn cục hoặc cấp dự án

Sử dụng cấu hình toàn cục khi bạn luôn muốn áp dụng văn phong của bản vá trong Claude Code. Sử dụng CLAUDE.md cấp dự án khi các quy tắc chỉ nên áp dụng cho một codebase hoặc khi bạn muốn đánh giá kết quả trước khi áp dụng rộng rãi hơn.

Tính đến chi phí ngữ cảnh

Tệp kiểu dài khoảng 1.600 từ. Những hướng dẫn đó chiếm một phần ngữ cảnh khả dụng, vì vậy hãy tính đến chi phí này khi làm việc trong các môi trường bị giới hạn. Tác giả dự án cho biết sự cải thiện này xứng đáng với phần ngữ cảnh bổ sung trong cả các phiên Claude Code và Claude.ai.

Dự đoán sự khác biệt giữa các mô hình

README cho biết Fable dường như tuân thủ đặc tả nhất quán hơn Opus, đặc biệt trong các chuỗi trao đổi dài. Hãy xem bản vá như một hướng dẫn thay vì một sự đảm bảo, đồng thời củng cố nó khi cuộc trò chuyện trở nên dài hoặc trừu tượng.

Tùy chỉnh bản vá

Vì dự án được phát hành theo giấy phép CC0, bạn có thể sao chép, tạo nhánh, xóa quy tắc hoặc tái sử dụng các phần được chọn. Nhờ đó, bạn chỉ cần giữ lại những hướng dẫn phù hợp với phong cách viết và ngân sách ngữ cảnh ưa thích.

Kết luận

Claude Style Patch cung cấp một cách đơn giản để thay đổi văn phong của Claude thông qua các hướng dẫn rõ ràng, tập trung vào việc khắc phục. Hãy nối nó vào tệp CLAUDE.md ở cấp toàn cục hoặc cấp dự án, hoặc dán nó vào phần hướng dẫn tùy chỉnh hay lời nhắc hệ thống. Đối với các tác vụ viết dài và đòi hỏi cao, hãy củng cố cấu hình bằng cách yêu cầu Claude bám sát các hướng dẫn về phong cách phản hồi.