Kits, Skills, Agents và Hooks

Kit là đơn vị bạn cài đặt. Skills, Agents và Hooks là những cách khác nhau để workflow trong Kit hoạt động bên trong một runtime được hỗ trợ.

Kit

Kit là gói có phiên bản dành cho một nhóm công việc. Kit tập hợp Skills, Agents, Hooks, rules và các tệp hỗ trợ được thiết kế để phối hợp với nhau. Cài một Kit sẽ chuyển đổi nội dung được hỗ trợ cho runtime; việc đó không tự chạy mọi thành phần hay cấp quyền truy cập không giới hạn cho chúng.

Hãy chọn Kit theo loại công việc bạn muốn thực hiện. Nếu chỉ cần một phần, trình cài đặt có thể bao gồm hoặc loại trừ các Skills đã chọn trong khi vẫn giữ những tệp đi kèm mà các Skills đó cần.

Một Kit được cấu thành như thế nào

Một Kit dành cho người dùng được phân giải từ nội dung core dùng chung và nội dung riêng của Kit đó. Core là đầu vào nội bộ cho quá trình cấu thành, không phải sản phẩm riêng để bạn liệt kê hay cài đặt.

flowchart TB
  accTitle: Cấu trúc của một Kit dành cho người dùng
  accDescr: Một Kit dành cho người dùng kết hợp core dùng chung nội bộ với nội dung riêng của Kit. Gói sau khi phân giải chứa Skills, Agents, Hooks và các artifact hỗ trợ.
  kit["Kit dành cho người dùng"] --> core["Core dùng chung (nội bộ)"]
  kit --> specific["Nội dung riêng của Kit"]
  core --> resolved["Các thành phần đã phân giải"]
  specific --> resolved
  resolved --> skills["Skills"]
  resolved --> agents["Agents"]
  resolved --> hooks["Hooks"]
  resolved --> support["Artifact hỗ trợ"]

Skill

Skill là workflow có thể tái sử dụng cho một outcome cụ thể. Thông thường, bạn chủ động gọi Skill rồi cung cấp mục tiêu hoặc input. Skill có thể chứa quy trình theo thứ tự, điểm quyết định, tài liệu tham khảo, script hoặc output mong đợi.

Hãy bắt đầu bằng Skill khi bạn có thể gọi tên outcome, chẳng hạn làm rõ ý tưởng, lập kế hoạch thay đổi, triển khai công việc đã duyệt hoặc điều tra lỗi. Runtime quyết định cách khám phá và gọi các Skills đã cài.

Agent

Agent là vai trò chuyên biệt dành cho công việc cần tập trung hoặc cô lập task. Một Skill có thể giao một phần workflow cho Agent, hoặc runtime có thể cho phép bạn chọn Agent trực tiếp.

Agent không tự động có thẩm quyền cao hơn Skill. Agent hoạt động với công cụ và quyền do runtime cấp; output của nó quay lại workflow gọi hoặc người dùng để review.

Hook

Hook gắn automation vào lifecycle event được runtime hỗ trợ, chẳng hạn cuối một lượt làm việc hoặc task của subagent. Hook có thể đồng bộ trạng thái workflow, chạy kiểm tra hoặc cung cấp phản hồi mà không cần một lần gọi thủ công riêng.

Hook không phải là ranh giới bảo mật. Mô hình event khác nhau giữa các runtime, vì vậy adapter có thể chuyển đổi Hook, bỏ qua event không được hỗ trợ kèm cảnh báo hoặc chạy Hook tại một ranh giới khác mà runtime hỗ trợ. Chỉ có tệp Hook không chứng minh rằng runtime đã đăng ký hoặc thực thi nó.

Cách các thành phần phối hợp

Sau khi cài đặt, bạn gọi Skill cho một outcome, giao phần việc cần tập trung cho Agent khi hữu ích, để các Hook được hỗ trợ phản ứng tại ranh giới lifecycle và review artifact được tạo ra.

Thông thường, bạn không cần tự chọn Agent hay kích hoạt Hook. Hãy bắt đầu từ Kit khi chọn một nhóm công việc rộng; bắt đầu từ Skill khi đã biết outcome. Kiểm tra Runtime adapter trước khi cho rằng một thành phần hoạt động giống nhau trong mọi assistant.