Bộ tối ưu CLAUDE.md theo Progressive Disclosure
Tái cấu trúc CLAUDE.md/AGENTS.md thành Level 1 (luôn nạp) và Level 2 (tài liệu tham chiếu) mà không mất bất kỳ thông tin nào.
Lập trìnhNâng cao★ 1,354⑂ 215Điểm AI 9/10Cập nhật lần cuối: 26 thg 8, 2026
Nó làm được gì
- Định nghĩa lại yêu cầu "CLAUDE.md dài quá, gọn lại đi": mục tiêu là dời vị trí thông tin, không phải giảm số dòng. Skill cấm dùng số dòng làm KPI hay thành tích.
- Quy trình 6 bước: sao lưu → đo điểm nóng (
/context, thống kê byte theo heading) → phân loại tín hiệu/phản tín hiệu → phân tầng → tạo file reference → kiểm chứng. - Bắt buộc di chuyển nguyên văn; có script kèm theo (
scripts/profile_claude_md.py,scripts/sink_sections.py) để hạ hàng loạt mục xuống Level 2 rồi tự kiểm tra thất thoát và tự rollback khi lỗi. - Có bảng chọn "vật mang": quy tắc nào nên ở CLAUDE.md, nào nên thành Skill, Hook chặn/tiêm, hay
.claude/rules/vớipaths:. - Cảnh báo 9 anti-pattern: con trỏ giả (trỏ tới file không có nội dung), tưởng
@importtiết kiệm context, vừa dời vừa nén, xóa rồi mới bịa lý do…
Dành cho ai
- Người có
~/.claude/CLAUDE.mdphình to khiến Claude thường xuyên bỏ qua quy tắc. - Nhóm dev muốn dọn CLAUDE.md/AGENTS.md dự án mà không đánh mất quy tắc quan trọng.
- Người dùng chung AGENTS.md với Codex và bị cắt nội dung do
project_doc_max_bytes.
Ví dụ sử dụng
- Bạn hỏi "file này có quá lớn không?" → skill trả lời bằng bảng byte theo từng mục và xử lý mục lớn nhất trước, không báo cáo kiểu "giảm 39%".
- Hạ 10 mục SOP từ file 160KB xuống
~/.claude/references/, sau đó kiểm tra chuỗi nguyên văn để chắc chắn 10/10 mục còn đủ. - Gặp quy tắc "phải chạy lint trước khi commit" → skill tra bảng và đề xuất chuyển thành Skill/Hook thay vì để lại văn xuôi, nhưng không tự xóa khi chưa có xác nhận.
· · · Hướng dẫn cài đặt · · ·
Dùng thử ngay, không cần cài
Dán đoạn dưới vào Claude là dùng được skill này mà không cần cài đặt.
Hãy đọc hướng dẫn trong tệp này và làm theo để giúp mình: https://raw.githubusercontent.com/daymade/claude-code-skills/HEAD/daymade-claude-code/claude-md-progressive-disclosurer/SKILL.md Mình muốn: (viết việc bạn cần ở đây)
Nếu Claude không mở được liên kết, hãy mở liên kết và copy nội dung vào rồi dán.
↓ Thấy hữu ích thì tải ZIP bên dưới và cài. Sau đó skill tự chạy, không phải dán lại mỗi lần.
Cài vào ứng dụng Claude (không cần terminal)
- Tải tệp ZIP bằng nút bên dưới.
- Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
- Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.
Cài vào Claude Code
Để Claude làm — dán câu dưới đây vào Claude Code
Hãy cài skill mình tìm thấy trên Claude Skill Mart. Copy thư mục daymade-claude-code/claude-md-progressive-disclosurer từ repo GitHub daymade/claude-code-skills vào ~/.claude/skills/claude-md-progressive-disclosurer/ của mình. Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.
Cài bằng lệnh thủ công
git clone https://github.com/daymade/claude-code-skills.git && mkdir -p ~/.claude/skills && cp -r claude-code-skills/daymade-claude-code/claude-md-progressive-disclosurer ~/.claude/skills/⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.
- Mở terminal và vào thư mục làm việc bạn muốn.
- Tải repo:
git clone https://github.com/daymade/claude-code-skills.git - Tạo thư mục skill:
mkdir -p ~/.claude/skills - Sao chép skill này:
cp -r claude-code-skills/daymade-claude-code/claude-md-progressive-disclosurer ~/.claude/skills/ - Kiểm tra đã có kèm
references/vàscripts/:ls ~/.claude/skills/claude-md-progressive-disclosurer - Đảm bảo có
python3(các bước kiểm chứng dùng nó):python3 --version - Khởi động lại Claude Code và yêu cầu: "Tối ưu CLAUDE.md của tôi theo progressive disclosure".
- Luôn xác nhận đã có bản sao lưu
CLAUDE.md.bak.<timestamp>trước khi cho phép sửa file.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT