caveman

Tổng quan về caveman skill

caveman làm gì

caveman là một kiểu phản hồi siêu cô đọng cho AI assistants. Nó cắt bỏ phần đệm, lời xã giao, mạo từ, các cách nói dè dặt yếu và lối diễn đạt dài dòng, đồng thời vẫn giữ độ chính xác kỹ thuật, code, lỗi được trích dẫn và các khái niệm có tên riêng. Phù hợp nhất với: người dùng muốn câu trả lời kỹ thuật giàu thông tin, dùng ít token hơn, dễ quét nhanh hơn, hoặc muốn duy trì “chế độ ngắn gọn” xuyên suốt cuộc trò chuyện.

Việc chính của caveman skill: làm đầu ra của assistant ngắn hơn mà không biến nội dung thành mơ hồ. Skill upstream nhắm tới mức giảm khoảng 75% token bằng cách thay đổi hình dạng câu trả lời, không phải bằng cách bỏ bớt nội dung quan trọng.

Người dùng và workflow phù hợp nhất

Dùng caveman khi bạn đã hiểu domain và muốn câu trả lời đi thẳng vào vấn đề: ghi chú code review, các phương án triển khai, giả thuyết debug, nhắc nhanh CLI, tóm tắt tradeoff kiến trúc, hoặc cập nhật trạng thái dạng gọn. Nó đặc biệt hữu ích trong các phiên Claude dài, nơi phong cách assistant bình thường dễ trượt lại về văn phong lịch sự, giải thích quá nhiều.

caveman skill này cũng hữu ích cho Rewriting: dán đoạn văn dài và yêu cầu nén theo kiểu caveman, đồng thời giữ nguyên commands, API names, error messages và code blocks.

Điểm khác biệt của caveman skill này

Ngoài SKILL.md cốt lõi, repo này có thêm tooling kiểm chứng thực tế:

• scripts/caveman_compressor.py áp dụng nén theo rule-based mà không cần LLM calls.
• scripts/caveman_lint.py kiểm tra filler, hedging, pleasantries và verbose phrases bị cấm.
• scripts/token_savings_estimator.py ước tính token và chi phí tiết kiệm được.
• references/when_caveman_backfires.md ghi lại các trường hợp nên tạm dừng nén.

Phần hỗ trợ này khiến caveman skill dễ cài và dễ dùng hơn một prompt kiểu “be concise” đơn giản, vì nó định nghĩa persistence, cách xử lý ngoại lệ và các bước kiểm tra đầu ra có thể đo được.

Cách dùng caveman skill

Cài caveman và các file nên đọc trước

Cài bằng:

npx skills add alirezarezvani/claude-skills --skill caveman

Sau đó kiểm tra thư mục skill:

engineering/caveman/skills/caveman

Đọc theo thứ tự này:

1. SKILL.md — activation phrases, persistence rule, compression style.
2. references/compression_principles.md — phần nào nên cắt, phần nào bắt buộc giữ.
3. references/when_caveman_backfires.md — ngoại lệ về an toàn và độ rõ ràng.
4. references/companion_tooling.md — cách dùng script và workflow kiểm chứng.
5. scripts/caveman_lint.py — các nhóm từ vựng bị cấm cụ thể.

Thứ tự này giúp bạn hiểu cả hành vi lẫn ranh giới của skill trước khi dựa vào nó trong các cuộc trò chuyện production.

Cách gọi caveman trong thực tế

Kích hoạt tự nhiên bằng các câu như:

• “Use caveman.”
• “Caveman mode.”
• “Be brief, less tokens.”
• “Rewrite this in caveman style.”
• /caveman

Hành vi quan trọng: sau khi được kích hoạt, caveman tiếp tục áp dụng qua các lượt trả lời cho đến khi bạn nói “stop caveman” hoặc “normal mode.” Điều này rất hợp cho cả một phiên debug, nhưng cũng có rủi ro nếu bạn quên nó đang bật trước khi yêu cầu các hướng dẫn cần nhiều sắc thái.

Ví dụ prompt mạnh:

Use caveman. Review this migration plan. Keep SQL, table names, and rollback commands exact. Compress commentary. If any step is destructive, drop caveman for that warning only.

Vì sao tốt hơn: prompt nói rõ skill phải giữ nguyên những gì và thừa nhận ngoại lệ tự động về độ rõ ràng.

Input giúp caveman cho đầu ra tốt hơn

Hãy đưa cho caveman các rule rõ ràng về phần cần giữ nguyên. Nó nén ngôn ngữ, không nén yêu cầu. Các input hữu ích gồm:

• Định dạng mục tiêu: bullets, diff notes, checklist, commit message, incident summary.
• Mục bắt buộc giữ nguyên: code blocks, stack traces, API names, legal text, quoted errors.
• Đối tượng đọc: senior engineer, PM, on-call responder, beginner.
• Mức rủi ro: safe summary hay irreversible action.

Prompt yếu:

Make this shorter.

Prompt tốt hơn:

Caveman for Rewriting. Compress this support reply to half length. Preserve exact error text, URLs, CLI commands, and refund policy wording. Remove pleasantries and hedging.

Dùng companion scripts

Các script chỉ dùng Python stdlib và có thể chạy trực tiếp từ thư mục skill.

Nén văn bản:

python scripts/caveman_compressor.py --file input.txt

Lint một phản hồi:

python scripts/caveman_lint.py --file response.txt --output json

Ước tính mức tiết kiệm:

python scripts/token_savings_estimator.py --file input.txt --price-per-mtok 3.00

Các tool này hữu ích khi bạn muốn nén lặp lại được bên ngoài chat, hoặc muốn xác minh rằng một phản hồi AI thật sự tuân thủ rule của caveman thay vì chỉ “ngắn” hơn.

FAQ về caveman skill

caveman chỉ là một kiểu viết cho vui thôi sao?

Không. Giọng “smart caveman” là cơ chế để nén: dùng fragment, bỏ mạo từ, chọn từ đồng nghĩa ngắn, dùng mũi tên cho quan hệ nhân quả và giảm social tokens. Skill này không nhằm biến nội dung kỹ thuật thành thô sơ. Thuật ngữ kỹ thuật chính xác vẫn được giữ nguyên.

Khi nào không nên dùng caveman?

Tránh dùng hoặc tạm dừng caveman với cảnh báo bảo mật, xác nhận không thể đảo ngược, nội dung pháp lý/y tế rủi ro cao, hoặc chuỗi nhiều bước mà câu quá ngắn có thể khiến người đọc hiểu sai thứ tự. Chính tài liệu backfire của repo cũng nêu destructive operations và clarification requests là các vùng ngoại lệ.

Mẫu tốt:

Use caveman, except write full warnings for destructive commands.

caveman tốt hơn “be concise” ở điểm nào?

“Be concise” quá mơ hồ và thường xuống cấp sau vài lượt. caveman skill định nghĩa cách kích hoạt bền vững, rule cắt bỏ cụ thể, pattern viết tắt, cách bảo toàn code và các trường hợp ngoại lệ. Linter đi kèm cũng cho bạn cách kiểm tra mức tuân thủ, thay vì tin vào tự đánh giá của model.

caveman có thân thiện với người mới không?

Có thể, nhưng chỉ khi người mới yêu cầu ngoại lệ để giữ độ rõ ràng. caveman thuần có thể loại bỏ phần nối ý giải thích mà người mới cần. Khi học, dùng:

Use caveman for summary bullets, but explain new concepts normally first.

Cách này vẫn tiết kiệm token mà không biến nội dung lạ thành các mảnh câu khó hiểu.

Cách cải thiện caveman skill

Giúp caveman giữ đúng phần quan trọng

Kết quả tốt nhất đến từ việc nêu rõ những gì không được nén. Hãy yêu cầu assistant giữ nguyên các phần sau:

• Code blocks and inline code
• Error messages
• Security warnings
• Ordered procedures
• API, package, class, table, and field names
• Legal, pricing, or policy wording

Nén nên loại bỏ phần thừa xung quanh nội dung cốt lõi, không được làm biến dạng chính nội dung đó.

Các lỗi thường gặp cần theo dõi

Chú ý bốn vấn đề:

1. Nén quá mức: câu trả lời trở nên mơ hồ.
2. Nén chưa đủ: assistant vẫn dùng pleasantries và filler.
3. Nén không an toàn: cảnh báo hoặc bước phá hủy trở nên quá cụt.
4. Hỏng định dạng: code, commands hoặc quotes bị thay đổi.

Dùng scripts/caveman_lint.py để phát hiện nén chưa đủ. Dùng human review cho độ mơ hồ và an toàn, vì linter không phải lúc nào cũng biết việc thiếu ngữ cảnh có làm đổi nghĩa hay không.

Lặp lại sau đầu ra đầu tiên

Sau đầu ra caveman đầu tiên, hãy tinh chỉnh bằng chỉ dẫn có mục tiêu thay vì yêu cầu retry chung chung:

• “More compressed, keep all command flags.”
• “Restore full sentence for warning only.”
• “Use numbered steps; order matters.”
• “Remove hedging unless evidence-backed.”
• “Keep acronyms expanded on first use.”

Cách này giúp việc dùng caveman có kiểm soát: gọn ở nơi an toàn, rõ ở nơi cần thiết.

Mở rộng caveman theo chuẩn của team

Nếu dùng caveman trong team, hãy thêm rule nội bộ bên cạnh skill: các viết tắt được chấp thuận, domain bị cấm dùng caveman, định dạng đầu ra ưu tiên và ví dụ về mức nén chấp nhận được. Chạy compressor và token estimator trên tài liệu thật của team trước khi áp dụng để biết mức tiết kiệm có đáng với tradeoff về khả năng đọc hay không.