Hono API Scaffolder (Cloudflare Workers)
Sinh nhanh route, middleware, validation Zod và tài liệu endpoint cho API Hono chạy trên Cloudflare Workers.
Lập trìnhTrung cấp★ 1,018⑂ 102Điểm AI 9/10Cập nhật lần cuối: 2 thg 7, 2026
Làm được gì
Thêm một lớp API Hono có cấu trúc vào dự án Cloudflare Workers đã có sẵn.
- Tạo file route theo từng tài nguyên (
src/routes/users.ts,posts.ts...) - Middleware xác thực Bearer token, CORS, error handler trả JSON chuẩn
- Định nghĩa kiểu
Envcho binding D1, KV, R2 và secrets - Validate request body bằng
@hono/zod-validator - Mount toàn bộ route vào
src/index.tskèm health check - Sinh tài liệu
API_ENDPOINTS.md - Hướng dẫn RPC type-safe đầu-cuối với
hc(Hono Client)
Có bảng gợi ý cấu trúc theo quy mô dự án (dưới 10 / 10-30 / trên 30 endpoint).
Phù hợp với ai
- Lập trình viên backend/fullstack dùng Cloudflare Workers + Hono
- Người cần làm việc type-safe với D1, KV, R2
- Nhóm muốn tài liệu API luôn đồng bộ với code
- Ai vừa khởi tạo dự án bằng
cloudflare-worker-builderhoặcvite-flare-starter
Ví dụ sử dụng
- "Tạo CRUD API cho users và posts" → sinh file route riêng, schema Zod và mount vào index.ts.
- "Thêm middleware yêu cầu đăng nhập cho các route /api/admin" → tạo
requireAuthvà áp dụng. - "Viết tài liệu cho tất cả endpoint hiện có" → tạo
API_ENDPOINTS.mdvới method, auth, body và mã phản hồi.
· · · 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/jezweb/claude-skills/HEAD/plugins/cloudflare/skills/hono-api-scaffolder/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 plugins/cloudflare/skills/hono-api-scaffolder từ repo GitHub jezweb/claude-skills vào ~/.claude/skills/hono-api-scaffolder/ 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/jezweb/claude-skills.git /tmp/claude-skills && mkdir -p ~/.claude/skills && cp -r /tmp/claude-skills/plugins/cloudflare/skills/hono-api-scaffolder ~/.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à clone kho:
git clone https://github.com/jezweb/claude-skills.git - Tạo thư mục skill:
mkdir -p ~/.claude/skills - Sao chép skill:
cp -r claude-skills/plugins/cloudflare/skills/hono-api-scaffolder ~/.claude/skills/ - Kiểm tra các thư mục
assets/vàreferences/đã được sao chép đầy đủ. - Khởi động lại Claude Code, mở thư mục dự án Cloudflare Workers đã có và yêu cầu "scaffold Hono API routes".
- Cài dependency cho dự án:
pnpm add hono @hono/zod-validator zod
Xem mã nguồn trên GitHub ↗Giấy phép: MIT