Hướng dẫn quy ước repo Claude Code
Skill tham chiếu cung cấp cho Claude toàn bộ kiến trúc, quy ước đặt tên và mẫu viết tool/command của codebase Claude Code CLI.
Lập trìnhNâng cao★ 3,213⑂ 3,644Điểm AI 6/10Cập nhật lần cuối: 22 thg 4, 2026
Làm được gì
Đây là skill dạng tài liệu tham chiếu, gói gọn kiến thức nền cần thiết khi làm việc với repo Claude Code CLI (TypeScript, ~1.900 file / hơn 512.000 dòng).
- Bảng mô tả vai trò của hơn 30 thư mục trong
src/(commands, tools, components, services, coordinator, memdir...) - Trình tự khởi tạo
main.tsx→entrypoints/init.ts→entrypoints/cli.tsxvà các file cốt lõi (QueryEngine.ts,Tool.ts,tools.ts) - Mẫu code định nghĩa tool bằng
buildTool()và ba loại command: PromptCommand / LocalCommand / LocalJSXCommand - Hệ thống quyền (default / plan / bypassPermissions / auto), quy tắc wildcard kiểu
Bash(git *)và cách hiện thựccheckPermissions() - Cấu trúc UI Ink + React, quản lý AppState, feature flag
bun:bundle, quy ước đặt tên/import, vị trí file cấu hình
Phù hợp với ai
- Lập trình viên trực tiếp sửa Claude Code CLI hoặc một CLI TypeScript lớn có cấu trúc tương tự
- Người muốn học một ví dụ kiến trúc thực tế của bộ Ink (React cho CLI) + Bun + Zod
- Người đang thiết kế agent tool, slash command, hệ thống phân quyền và cần mẫu tham khảo
Ví dụ sử dụng
- "Thêm slash command
/changelog" → Claude tạo file trongsrc/commands/theo mẫu PromptCommand, khai báoallowedToolsvà đăng ký vàocommands.ts. - "Viết một tool xoá file" → dùng template
buildTool, không bỏ sótcheckPermissions(),isReadOnly()và validate input bằng Zod. - "Ẩn tính năng thử nghiệm thế nào?" → giải thích cách gate bằng
feature('PROACTIVE')củabun:bundlehoặc biến môi trường.
· · · Hướng dẫn cài đặt · · ·
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 Skill.m từ repo GitHub codeaashu/claude-code vào ~/.claude/skills/claude-code-skill/ 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/codeaashu/claude-code.git /tmp/cc-skill && mkdir -p ~/.claude/skills/claude-code-skill && cp /tmp/cc-skill/Skill.md ~/.claude/skills/claude-code-skill/SKILL.md⚠ Đâ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 vào thư mục tạm:
git clone https://github.com/codeaashu/claude-code.git /tmp/cc-skill - Tạo thư mục skill:
mkdir -p ~/.claude/skills/claude-code-skill - Copy file skill:
cp /tmp/cc-skill/Skill.md ~/.claude/skills/claude-code-skill/SKILL.md - Kiểm tra khối
---ở đầu file cónamevàdescription(thiếu thì skill không được nạp). - Khởi động lại Claude Code và dùng
/skillsđể xem skill đã xuất hiện chưa. - Khi làm việc trong codebase đó, hãy yêu cầu kiểu "thêm tool mới theo quy ước của repo" để skill được tham chiếu.
Xem mã nguồn trên GitHub ↗Giấy phép: NOASSERTION