Trợ lý viết Convex Component
Hướng dẫn tạo Convex component tái sử dụng với defineComponent, schema riêng, lớp client wrapper có kiểu và cấu hình publish npm.
Lập trìnhNâng cao★ 405⑂ 32Điểm AI 8/10Cập nhật lần cuối: 28 thg 9, 2026
Làm được gì
- Đề xuất cấu trúc thư mục chuẩn cho component (
component/,client/,example/). - Cung cấp mã mẫu cho
convex.config.ts,schema.ts,public.tskèm quy tắc bắt buộc có validatorargsvàreturns. - Hướng dẫn đăng ký ở app cha bằng
app.use()và gọi quactx.runQuery/ctx.runMutation. - Nêu rõ giới hạn biên: không đọc bảng của app, không dùng
ctx.auth, không dùngprocess.env, không dùng.paginate(); callback đi qua function handle. - Bảng lỗi thường gặp kèm cách sửa, và phần publish npm nằm trong
references/publishing.md.
Phù hợp với ai
- Lập trình viên Convex muốn tách tính năng (counter, rate limit, audit log) thành package.
- Người chuẩn bị đóng góp component cho thư mục component của Convex.
- Nhóm cần dùng lại cùng một module backend ở nhiều ứng dụng.
Ví dụ sử dụng
- "Tách tính năng đếm thành một Convex component" → sinh schema, hàm public và class
Counteran toàn kiểu. - "Hàm không xuất hiện trong
components.counter" → kiểm tra thiếuapp.use(), chưa chạynpx convex dev, hoặc sai đường dẫn tham chiếu. - "Component cần biết người dùng đăng nhập" → xác thực ở app rồi truyền
userIddạng chuỗi vào component.
· · · 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/waynesutton/builder-skills/HEAD/skills/convex-component-authoring/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 skills/convex-component-authoring từ repo GitHub waynesutton/builder-skills vào ~/.claude/skills/waynesutton-convex-component-authoring/ 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/waynesutton/builder-skills.git /tmp/builder-skills && mkdir -p ~/.claude/skills && cp -r /tmp/builder-skills/skills/convex-component-authoring ~/.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à chuyển tới thư mục làm việc.
- Tải repo:
git clone https://github.com/waynesutton/builder-skills.git - Tạo thư mục skills:
mkdir -p ~/.claude/skills - Sao chép skill:
cp -r builder-skills/skills/convex-component-authoring ~/.claude/skills/ - Kiểm tra bằng
ls ~/.claude/skills/convex-component-authoringđể thấySKILL.mdvà thư mụcreferences/. - Khởi động lại Claude Code, rồi yêu cầu ví dụ: "Tạo giúp mình một Convex component".
- Đảm bảo dự án đã cài
convexvànpx convex devchạy được trước khi áp dụng.
Xem mã nguồn trên GitHub ↗Giấy phép: Apache-2.0