Kỹ năng viết tài liệu hướng dẫn (Guideline Writing)
Skill giúp viết và rà soát chính các file hướng dẫn (CLAUDE.md, guide trong .claude/, plan file) sao cho ngắn gọn và mang tính bắt buộc rõ ràng.
Nội dung · Viết láchTrung cấp★ 142⑂ 24Điểm AI 8/10Cập nhật lần cuối: 13 thg 9, 2026
Nó làm được gì
- Phân loại mọi câu trong tài liệu thành quy tắc thực thi hoặc phần dẫn nhập/lịch sử, và đẩy phần lịch sử ra file log riêng.
- Buộc mỗi quy tắc nằm ở đúng một tầng hiệu lực MUST / SHOULD / MAY, loại bỏ cách viết nửa vời kiểu "nên hầu như luôn luôn".
- Áp dụng self-check 5 bước chống phình to (ưu tiên nhập vào mục có sẵn, không copy bảng của tài liệu khác, ≥50 dòng thay đổi thì rà soát lại) và 4 cờ đỏ.
- Cung cấp quy trình blind review: người rà soát không biết ý định tác giả, phân loại từng hunk là substantive hay invariant, báo lỗi theo mẫu chuẩn kèm mức độ nghiêm trọng.
- Bảng 15 antipattern kèm cách phát hiện và cách sửa.
Phù hợp với ai
- Người thường xuyên viết/sửa CLAUDE.md, hướng dẫn cho agent, runbook, policy nội bộ.
- Nhóm gặp tình trạng tài liệu ngày càng dài mà không ai tuân theo.
- Ai cần tiêu chuẩn review thống nhất cho bộ quy tắc AI dùng chung.
Ví dụ sử dụng
- Nén một đoạn kể "vì sao chúng tôi gộp hook vào dispatch.py" thành một dòng quy tắc, phần câu chuyện chuyển sang log.
- Sửa "thường thì nên chạy linter trước khi bàn giao" thành quy tắc MUST có điều kiện kiểm chứng rõ ràng.
- Thay vì tạo mục mới cho một yêu cầu nhỏ, chỉ thêm một dòng vào bảng đã có và liên kết chéo.
· · · 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/alfadur7/llm-wiki-newsroom/HEAD/.claude/skills/guideline-writing/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 .claude/skills/guideline-writing từ repo GitHub alfadur7/llm-wiki-newsroom vào ~/.claude/skills/guideline-writing/ 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/alfadur7/llm-wiki-newsroom /tmp/llm-wiki-newsroom && mkdir -p ~/.claude/skills && cp -r /tmp/llm-wiki-newsroom/.claude/skills/guideline-writing ~/.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.
- Clone repo:
git clone https://github.com/alfadur7/llm-wiki-newsroom /tmp/llm-wiki-newsroom - Tạo thư mục skill:
mkdir -p ~/.claude/skills - Copy skill:
cp -r /tmp/llm-wiki-newsroom/.claude/skills/guideline-writing ~/.claude/skills/ - Kiểm tra trong
~/.claude/skills/guideline-writing/cóSKILL.md,criteria.json,checks.py. - Khởi động lại Claude Code và thử: "Rà soát CLAUDE.md của tôi theo tiêu chí guideline-writing".
- Các đường dẫn như
log.md,tools/lint.py,.claude/agents/editor-in-chief.mdthuộc repo gốc — hãy đổi lại cho khớp dự án của bạn hoặc yêu cầu bỏ qua.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT