AI Skill MartKhám phá skillLệnhChương trìnhHọcSkill là gì?
 
← Về danh sách

Trình tạo Adapter Agent cho Paperclip

Skill hướng dẫn thiết kế và đăng ký package adapter AI agent đáp ứng đủ ba bề mặt server, UI và CLI trong monorepo Paperclip.

Lập trìnhNâng cao★ 112,322⑂ 18,624Điểm AI 8/10Cập nhật lần cuối: 8 thg 11, 2026

Làm được gì

  • Mô tả cấu trúc thư mục và quy ước bốn export của một package adapter nối lớp điều phối Paperclip với runtime agent cụ thể (Claude Code, Codex CLI, tiến trình tùy biến, endpoint HTTP).
  • Đưa ra hợp đồng thực thi AdapterExecutionContext → AdapterExecutionResult, cách viết sessionCodec và hàm testEnvironment trả về chẩn đoán pass/warn/fail kèm ví dụ mã.
  • Cung cấp checklist đăng ký adapter vào ba registry (server/UI/CLI), bảng biến môi trường PAPERCLIP_* và bảng helper trong server-utils.
  • Hướng dẫn khôi phục phiên (kiểm tra cwd, retry khi "unknown session"), cách nạp skill sạch (tmpdir + --add-dir) và nguyên tắc bảo mật (coi output agent là không đáng tin, bí mật chỉ truyền qua env).

Dành cho ai

  • Lập trình viên backend/fullstack đóng góp cho repo Paperclip hoặc vận hành bản fork nội bộ.
  • Kỹ sư nền tảng cần tích hợp một CLI agent hay API agent mới vào Paperclip.
  • Người tìm tài liệu tham khảo về kiến trúc adapter cho hệ điều phối đa agent.

Ví dụ sử dụng

  1. "Thêm adapter cho Gemini CLI" → tạo packages/adapters/gemini-local/, viết type/label/models/agentConfigurationDoc và đăng ký ở cả ba registry.
  2. "Sửa lỗi phiên của claude_local bị resume nhầm sang dự án khác" → áp dụng guard so khớp cwd và pattern retry với clearSession: true.
  3. "Bổ sung chẩn đoán cho nút Test environment" → viết server/test.ts kiểm tra cwd, lệnh, URL và tính trạng thái cuối theo chính sách error/warn/info.

· · · 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/paperclipai/paperclip/HEAD/.agents/skills/create-agent-adapter/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)
  1. Tải tệp ZIP bằng nút bên dưới.
  2. Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
  3. Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.
↓ Tải ZIP
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 AI Skill Mart.
Copy thư mục .agents/skills/create-agent-adapter từ repo GitHub paperclipai/paperclip vào ~/.claude/skills/create-agent-adapter/ 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/paperclipai/paperclip.git /tmp/paperclip && mkdir -p ~/.claude/skills && cp -r /tmp/paperclip/.agents/skills/create-agent-adapter ~/.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.

  1. Mở terminal và vào thư mục làm việc của bạn.
  2. Tải repo: git clone https://github.com/paperclipai/paperclip.git
  3. Tạo thư mục skill: mkdir -p ~/.claude/skills
  4. Sao chép skill: cp -r paperclip/.agents/skills/create-agent-adapter ~/.claude/skills/
  5. Khởi động lại Claude Code và kiểm tra create-agent-adapter xuất hiện trong danh sách skill.
  6. Chỉ nên dùng bên trong monorepo Paperclip; hãy yêu cầu kiểu "tạo package adapter mới" để skill được kích hoạt.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT