Bỏ qua đến nội dung chính

Sharing skills

TL;DR

  • Kỹ năng trở nên giá trị hơn khi được chia sẻ và tiêu chuẩn hóa, giúp tạo ra trải nghiệm nhất quán và nâng cao hiệu quả làm việc trong toàn tổ chức.
  • Có ba phương pháp chính để chia sẻ kỹ năng: qua kho lưu trữ dự án cho đội nhóm, thông qua plugin để phân phối đa dự án, hoặc dưới dạng triển khai cấp doanh nghiệp cho các tiêu chuẩn bắt buộc.
  • Các tác nhân phụ (sub-agents) không tự động kế thừa kỹ năng và cần được cấu hình rõ ràng bằng cách liệt kê chúng trong định nghĩa tác nhân phụ tùy chỉnh, đặc biệt là các tác nhân AI tích hợp không thể truy cập kỹ năng.

Điểm chính

  • Chia sẻ qua Kho lưu trữ: Để chia sẻ kỹ năng trong nội bộ dự án hoặc nhóm, hãy commit chúng vào thư mục include/skills trong repository của bạn, đảm bảo chúng tự động được tải khi clone hoặc pull.
  • Phân phối qua Plugin: Đối với kỹ năng có thể tái sử dụng rộng rãi hơn giữa các nhóm và dự án, đóng gói chúng thành plugin bằng cách tạo thư mục skills trong dự án plugin và phân phối qua chợ ứng dụng.
  • Triển khai cấp Doanh nghiệp: Quản trị viên có thể triển khai kỹ năng trên toàn tổ chức thông qua cài đặt quản lý; những kỹ năng này có ưu tiên cao nhất, ghi đè lên các kỹ năng cá nhân, dự án hoặc plugin có cùng tên để đảm bảo tuân thủ.
  • Tác nhân phụ và Kỹ năng: Các tác nhân AI tích hợp (như explorer, plan, verify) không thể truy cập kỹ năng. Chỉ các tác nhân phụ tùy chỉnh mới có thể sử dụng chúng khi được cấu hình rõ ràng.
  • Cấu hình Kỹ năng cho Tác nhân phụ: Để thêm kỹ năng cho tác nhân phụ tùy chỉnh, tạo hoặc chỉnh sửa tệp agent.mmd (hoặc agent.md) trong include/agents và liệt kê các kỹ năng cần thiết trong trường skills.
  • Tải Kỹ năng cho Tác nhân phụ: Kỹ năng cho tác nhân phụ được tải khi tác nhân phụ khởi động, không phải theo yêu cầu. Do đó, chỉ liệt kê những kỹ năng luôn phù hợp với mục đích của tác nhân để tối ưu hiệu suất.
  • Tối ưu hóa Kỹ năng cho Tác nhân phụ: Điều chỉnh bộ kỹ năng cho từng tác nhân phụ chuyên biệt (ví dụ: người đánh giá giao diện người dùng so với người đánh giá logic nghiệp vụ) để thực thi các tiêu chuẩn cụ thể trong công việc được ủy quyền mà không cần dựa vào lời nhắc.

Từ vựng

  • Kỹ năng — Skill
  • Kho lưu trữ — Repository
  • Nhóm — Team
  • Tác nhân phụ — Sub-agent
  • Tác nhân AI — AI Agent
  • Plugin — Plugin
  • Claude Code — Claude Code
  • chợ ứng dụng — app marketplace
  • override (ghi đè) — override
  • lời nhắc — prompt

Nội dung chi tiết

Tầm quan trọng của việc chia sẻ Kỹ năng

Kỹ năng trở nên giá trị hơn khi được chia sẻ. Một Kỹ năng đánh giá PR mà chỉ bạn sử dụng đã là hữu ích. Nhưng cùng một Kỹ năng đó được chia sẻ trong toàn bộ Nhóm của bạn sẽ tiêu chuẩn hóa quy trình đánh giá mã và mang lại trải nghiệm nhất quán trong toàn tổ chức, điều này tốt hơn nhiều. Sau đây là các cách bạn có thể chia sẻ Kỹ năng của mình.

Chia sẻ Kỹ năng qua Kho lưu trữ

Phương pháp chia sẻ đơn giản nhất là commit Kỹ năng vào repository của bạn. Hãy đặt chúng trong include/skills. Bất kỳ ai clone một repository sẽ tự động có được những Kỹ năng này. Không cần cài đặt thêm, đó chính là những gì bạn đang làm. Khi bạn push các bản cập nhật, mọi người sẽ nhận được chúng trong lần pull tiếp theo. Điều này hoạt động tốt cho các tiêu chuẩn lập trình của Nhóm, quy trình làm việc cụ thể theo dự án và Kỹ năng tham chiếu đến cấu trúc codebase của bạn.

Phân phối Kỹ năng qua Plugin

Một cách khác để phân phối Kỹ năng của bạn là thông qua plugin. Hãy coi plugin là cách để mở rộng Claude Code với chức năng tùy chỉnh, nhưng được thiết kế để chia sẻ giữa các Nhóm và dự án. Trong dự án plugin của bạn, hãy tạo một thư mục có tên skills. Thư mục này sau đó sẽ tuân theo cấu trúc tệp tương tự như thư mục Claude trong dự án của chúng tôi, với tên của Kỹ năng và một tệp skill.md. Sau khi bạn phân phối plugin của mình lên một chợ ứng dụng, những người dùng khác có thể tải xuống vào Claude Code để tự sử dụng. Điều này phù hợp nhất nếu Kỹ năng của bạn có chức năng không quá cụ thể cho dự án và có thể được sử dụng bởi các thành viên cộng đồng.

Triển khai Kỹ năng cấp Doanh nghiệp

Quản trị viên có thể triển khai Kỹ năng toàn tổ chức thông qua cài đặt được quản lý. Kỹ năng cấp Doanh nghiệp có ưu tiên cao nhất. Như chúng ta đã thảo luận trước đây, chúng sẽ override (ghi đè) Kỹ năng cá nhân, dự án và plugin có cùng tên. Điều này dành cho các tiêu chuẩn bắt buộc, yêu cầu bảo mật, quy trình làm việc tuân thủ và các phương pháp lập trình phải nhất quán trong toàn tổ chức. Từ khóa: phải.

Kỹ năng và Tác nhân phụ

Đây là điều khiến mọi người ngạc nhiên: Tác nhân phụ không tự động thấy Kỹ năng của bạn. Đúng vậy, khi bạn ủy quyền một tác vụ cho một tác nhân phụ, nó bắt đầu với một ngữ cảnh mới, sạch. Tác nhân AI tích hợp như explorer, planverify hoàn toàn không thể truy cập Kỹ năng. Chỉ những tác nhân phụ tùy chỉnh mà bạn định nghĩa mới có thể sử dụng chúng, và chỉ khi bạn liệt kê chúng một cách rõ ràng.

Cấu hình Kỹ năng cho Tác nhân phụ tùy chỉnh

Để tạo một tác nhân phụ tùy chỉnh có Kỹ năng, hãy thêm một tệp agent.mmd vào include/agents. Trường skills liệt kê những Kỹ năng nào cần tải. Những Kỹ năng này được tải khi tác nhân phụ khởi động, không phải theo yêu cầu như trong cuộc hội thoại chính. Vì vậy, hãy xem xét điều đó. Đầu tiên, hãy đảm bảo các Kỹ năng tồn tại. Vâng, chúng tồn tại. Sau đó, tạo tác nhân phụ bằng cách sử dụng trình tạo tác nhân phụ của Claude Code. Nếu bạn đã có một tác nhân phụ mà bạn muốn thêm các Kỹ năng này vào, chỉ cần đi đến tệp agent.md hiện có. Sau đó, tạo trường skills và thêm Kỹ năng của bạn. Khi bạn ủy quyền cho tác nhân phụ, nó sẽ tải cả hai Kỹ năng và áp dụng chúng cho mọi đánh giá.

Tối ưu hóa việc sử dụng Kỹ năng cho Tác nhân phụ

Mô hình này hoạt động rất tốt khi bạn muốn ủy quyền tác vụ riêng biệt với chuyên môn cụ thể. Các tác nhân phụ khác nhau cần Kỹ năng khác nhau: người đánh giá giao diện người dùng (frontend) so với người đánh giá logic nghiệp vụ (backend). Bạn muốn thực thi các tiêu chuẩn trong công việc được ủy quyền mà không cần dựa vào lời nhắc. Chỉ liệt kê những Kỹ năng luôn phù hợp với mục đích của tác nhân phụ.

Tóm tắt các Phương pháp chia sẻ Kỹ năng

Chia sẻ Kỹ năng thông qua các thư mục dự án để Nhóm truy cập, plugin để phân phối đa kho lưu trữ, hoặc triển khai cấp doanh nghiệp cho các tiêu chuẩn toàn tổ chức. Tác nhân phụ không tự động kế thừa Kỹ năng, vì vậy hãy liệt kê chúng một cách rõ ràng trong trường skills của tác nhân phụ. Tác nhân AI tích hợp không thể truy cập Kỹ năng. Chỉ tác nhân phụ tùy chỉnh mới có thể làm điều đó trong thư mục include/agents của bạn. Kỹ năng được tải khi tác nhân phụ khởi động, vì vậy chỉ liệt kê những Kỹ năng luôn phù hợp với mục đích của nó.

Góp ý / Báo lỗiPhát hiện sai sót hoặc có ý tưởng cải thiện?