Chuyển đến nội dung chính
Hướng dẫn AI

Sắp xếp và kiểm tra kỹ năng tác tử cục bộ bằng Skill Cabinet

Hướng dẫn này chỉ cách chạy Skill Cabinet với Node.js, duyệt các kỹ năng được phát hiện trong những thư mục công cụ tác tử được hỗ trợ, kiểm tra nội dung và frontmatter của chúng cũng như quản lý an toàn. Hướng dẫn cũng đề cập đến phím tắt, tùy chọn cấu hình, giao diện và quy trình phát triển.

Sắp xếp và kiểm tra kỹ năng tác tử cục bộ bằng Skill Cabinet

Skill Cabinet là gì?

Skill Cabinet là danh mục cục bộ dành cho các kỹ năng của tác tử được cài đặt trên máy tính của bạn. Ứng dụng quét các thư mục cấp người dùng như .agents, .claude, .codex và .cursor, bao gồm cả các plugin Cursor. Ứng dụng cũng kiểm tra các thư mục ~/.* /skills khớp với mẫu.

Ứng dụng hiển thị các kỹ năng được phát hiện trong giao diện dựa trên trình duyệt. Bạn có thể tìm kiếm danh mục, xem nội dung và YAML frontmatter của từng kỹ năng, mở các tệp bổ sung trong thư mục của kỹ năng và xóa các kỹ năng không cần thiết khỏi ổ đĩa.

Skill Cabinet chỉ liên kết với 127.0.0.1, vì vậy máy chủ chỉ khả dụng thông qua máy cục bộ của bạn thay vì một giao diện mạng công khai.

Tính năng chính

  • Tự động phát hiện: Quét các thư mục công cụ tác tử cấp người dùng và thư mục kỹ năng được hỗ trợ.
  • Lọc: Thu hẹp danh mục theo thư mục.
  • Tìm kiếm: Tìm các tên, mô tả, đường dẫn hoặc frontmatter phù hợp.
  • Kiểm tra kỹ năng: Hiển thị nội dung kỹ năng ở dạng đã kết xuất hoặc dạng nguồn.
  • Truy cập siêu dữ liệu: Hiển thị YAML frontmatter liên kết với một kỹ năng.
  • Duyệt thư mục: Cho phép đọc các tệp bổ sung được lưu cùng với kỹ năng.
  • Xóa kỹ năng: Xóa một kỹ năng hoặc nhiều kỹ năng đã đánh dấu cùng lúc.
  • Chủ đề: Cung cấp các giao diện có thể chọn qua menu Theme, với Carbon làm mặc định.
  • Điều hướng bằng bàn phím: Hỗ trợ phím tắt để di chuyển, tìm kiếm, đánh dấu và xóa.

Yêu cầu

Skill Cabinet yêu cầu Node.js 20 trở lên. Xác nhận phiên bản Node.js đã cài đặt trước khi bắt đầu:

node --version

Nếu phiên bản chính được hiển thị thấp hơn 20, hãy nâng cấp Node.js rồi chạy lại lệnh.

Chạy Skill Cabinet

Khởi động gói npm

Cách nhanh nhất để khởi chạy ứng dụng là dùng npx:

npx skill-cabinet

Lệnh này khởi động một máy chủ cục bộ trên 127.0.0.1, sử dụng cổng 3781 theo mặc định và mở giao diện trong trình duyệt.

Chạy trực tiếp từ kho GitHub

Bạn có thể chạy phiên bản trong kho thay vì gói npm:

npx github:subsy/skill-cabinet

Ngăn trình duyệt tự động mở

Đặt SKILL_CABINET_NO_OPEN khi bạn muốn khởi động máy chủ mà không thay thế hoặc mở một tab trình duyệt:

SKILL_CABINET_NO_OPEN=1 npx skill-cabinet

Sau khi ứng dụng khởi động, hãy mở địa chỉ cục bộ được ứng dụng hiển thị khi bạn sẵn sàng.

Chọn cổng khác

Đặt biến môi trường PORT để sử dụng cổng khác 3781:

PORT=4000 npx skill-cabinet

Trong ví dụ này, Skill Cabinet chạy trên 127.0.0.1:4000.

Duyệt và tìm kiếm kỹ năng

  1. Khởi động Skill Cabinet bằng npx skill-cabinet.
  2. Chờ giao diện cục bộ mở trong trình duyệt.
  3. Sử dụng bộ lọc thư mục để tập trung vào các kỹ năng từ một vị trí được hỗ trợ cụ thể.
  4. Sử dụng tính năng tìm kiếm để khớp với tên, mô tả, đường dẫn hoặc frontmatter của kỹ năng.
  5. Chọn một kết quả để kiểm tra nội dung.

Tìm kiếm rất hữu ích khi bạn chỉ nhớ một phần mô tả, đường dẫn thư mục hoặc một giá trị được lưu trong siêu dữ liệu YAML.

Kiểm tra một kỹ năng

Sau khi chọn một kỹ năng, bạn có thể đọc nội dung của kỹ năng ở dạng đã kết xuất hoặc dạng nguồn. Sử dụng chế độ đã kết xuất để đọc thuận tiện và chế độ nguồn khi cần kiểm tra văn bản bên dưới.

Bạn cũng có thể kiểm tra YAML frontmatter của kỹ năng và đọc các tệp bổ sung chứa trong thư mục của kỹ năng. Kết hợp lại, các chế độ xem này giúp bạn hiểu kỹ năng chứa gì và được cài đặt ở đâu trước khi thực hiện thay đổi.

Xóa kỹ năng cẩn thận

Skill Cabinet có thể xóa một kỹ năng riêng lẻ hoặc nhiều kỹ năng đã đánh dấu cùng lúc. Việc xóa sẽ loại bỏ toàn bộ thư mục kỹ năng khỏi ổ đĩa.

Cảnh báo: Không thể hoàn tác. Hãy xem kỹ các kỹ năng và đường dẫn đã chọn trước khi xóa.

Các kỹ năng Cursor tích hợp sẵn và bản sao được lưu trong bộ nhớ đệm plugin có thể xuất hiện lại vào lần tiếp theo công cụ liên quan cập nhật. Vì vậy, việc xóa các bản sao đó có thể không mang tính vĩnh viễn.

Sử dụng phím tắt

Các lệnh bàn phím giúp xử lý danh mục lớn nhanh hơn:

  • j chuyển đến mục tiếp theo.
  • k chuyển đến mục trước đó.
  • / kích hoạt tìm kiếm.
  • x đánh dấu một mục.
  • d xóa các mục kỹ năng đã chọn hoặc đã đánh dấu.

Một quy trình thực tế là nhấn / để tìm kiếm, điều hướng qua các kết quả bằng j và k, đánh dấu các mục liên quan bằng x và chỉ xóa sau khi đã xác minh mọi đường dẫn.

Thay đổi chủ đề giao diện

Mở menu Theme để chuyển đổi giữa các giao diện hiện có. Carbon được chọn theo mặc định. Việc thay đổi chủ đề chỉ ảnh hưởng đến giao diện, không thay đổi các kỹ năng được phát hiện hoặc tệp của chúng.

Phát triển Skill Cabinet cục bộ

Để làm việc với mã nguồn, hãy sao chép kho lưu trữ và cài đặt các phần phụ thuộc:

git clone git@github.com:subsy/skill-cabinet.git
cd skill-cabinet
npm install
npm run dev

Sau đó mở http://127.0.0.1:5173 trong trình duyệt.

Chạy bản dựng production

Xây dựng ứng dụng và khởi động ở chế độ production bằng:

npm run build
npm start

Các cộng tác viên của kho nên tham khảo CONTRIBUTING.md để xem hướng dẫn đóng góp cho dự án.

Mẹo nâng cao

  • Kiểm tra trước khi xóa: Kiểm tra đường dẫn, nguồn, frontmatter và các tệp bổ sung để chắc chắn bạn đã chọn đúng thư mục.
  • Kết hợp bộ lọc và tìm kiếm: Trước tiên, chọn một ngăn kéo, sau đó tìm kiếm trong danh mục đã thu hẹp theo tên, mô tả, đường dẫn hoặc siêu dữ liệu.
  • Đánh dấu để dọn dẹp hàng loạt: Đánh dấu nhiều mục bằng x, nhưng hãy kiểm tra toàn bộ danh sách trước khi nhấn d.
  • Giữ nguyên trạng thái trình duyệt hiện tại: Sử dụng SKILL_CABINET_NO_OPEN=1 khi bạn không muốn giao diện tự động mở lúc khởi động.
  • Tránh xung đột cổng: Khởi động ứng dụng với giá trị PORT khác nếu cổng 3781 đã được sử dụng.
  • Dự kiến các skill được quản lý sẽ xuất hiện lại: Các bản sao Cursor builtin và plugin-cache có thể được khôi phục bởi những bản cập nhật công cụ sau này.

Kết luận

Skill Cabinet cung cấp một giao diện cục bộ chuyên biệt để khám phá và xem xét các skill của agent nằm rải rác trong nhiều thư mục công cụ. Với siêu dữ liệu có thể tìm kiếm, chế độ xem nguồn và bản kết xuất, chức năng kiểm tra thư mục, giao diện chủ đề, điều khiển bằng bàn phím và xóa hàng loạt, công cụ này giúp đơn giản hóa việc quản lý skill cục bộ. Vì thao tác xóa là vĩnh viễn, hãy sử dụng các công cụ kiểm tra để xác minh từng skill trước khi xóa.

Skill Cabinet được phát hành theo Giấy phép MIT.