Hướng dẫn kiến trúc repo Claude Code
Skill quy ước dành riêng cho codebase Claude Code CLI: bản đồ thư mục, mẫu định nghĩa tool/command và quy tắc đặt tên.
Lập trìnhNâng cao★ 3,351⑂ 3,673Điểm AI 5/10Cập nhật lần cuối: 29 thg 8, 2026
Skill này làm gì
Nạp cho Claude toàn bộ hiểu biết về cấu trúc nội bộ của Claude Code CLI (TypeScript, Bun, React + Ink).
- Bảng mô tả vai trò của hơn 30 thư mục trong
src/(tools/,commands/,components/,coordinator/,memdir/...) - Trình tự khởi động:
main.tsx→entrypoints/init.ts→cli.tsx→ chế độ MCP/SDK - Mẫu code định nghĩa tool bằng
buildTool()và ba loại command: PromptCommand, LocalCommand, LocalJSXCommand - Quy ước về hệ thống quyền (default/plan/bypassPermissions/auto, mẫu wildcard
Bash(git *)), feature flagbun:bundle, validate bằng Zod, lazy import - Bảng quy tắc đặt tên cho file, component, type, hook, constant
Phù hợp với ai
- Lập trình viên trực tiếp sửa/mở rộng source Claude Code CLI hoặc bản fork
- Người muốn tham khảo một kiến trúc thực tế cho ứng dụng terminal dùng Ink + Bun
- Người học cách tổ chức registry cho agent tool và slash command
Lưu ý: các file
src/được nhắc tới không kèm trong skill. Không có codebase đó thì đây chủ yếu là tài liệu đọc tham khảo.
Ví dụ sử dụng
- "Thêm slash command
/changelog" → tạo file trongsrc/commands/theo mẫu PromptCommand kèmallowedTools, rồi đăng ký ởsrc/commands.ts. - "Viết một tool xóa file" → sinh skeleton
buildTool()cócheckPermissions(),isReadOnly(), táchUI.tsxvàprompt.ts. - "Ẩn tính năng thử nghiệm an toàn" → bọc bằng
feature('...')từbun:bundleđể bị loại bỏ khi build.
· · · 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/codeaashu/claude-code/HEAD/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 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ề 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:
cp /tmp/cc-skill/Skill.md ~/.claude/skills/claude-code-skill/SKILL.md(bắt buộc đặt tênSKILL.md) - Khởi động lại Claude Code và kiểm tra bằng
/skills. - Chạy Claude Code trong thư mục codebase mục tiêu rồi yêu cầu ví dụ: "thêm tool mới theo đúng quy ước định nghĩa tool của repo này".
Xem mã nguồn trên GitHub ↗Giấy phép: NOASSERTION