Hệ Thống kỹ thuật

Một kỹ năng là gói khả năng cho Agent: một thư mục được xây dựng chung quanh tập tin SKL.md, chứa hướng dẫn, văn lệnh và tài liệu tham chiếu. Một Agent đọc chúng theo yêu cầu trong khi đang thực hiện một nhiệm vụ, cho phép nó làm một cái gì đó mà không thể tạo ra một tài liệu từ với một bảng nội dung và tiêu đề.

Kĩ Năng là gì

Mỗi kỹ năng là một thư mục chứa ít nhất một SKL.md: mặt trước chứa tên và mô tả, và cơ thể là hướng dẫn mà Agent đọc. Thư mục cũng có thể bao gồm các tập tin đính kèm (các văn bản, tài liệu tham khảo, mẫu cấu hình) và tuyên bố quan hệ phụ thuộc và máy phục vụ MCP.

---
name: weekly-report-style
description: 生成周报 Excel 时统一使用团队的配色与表头规范
---

# 使用说明

正文写给 Agent 看：什么时候用这个技能、
按什么步骤做、附带的脚本和参考文件怎么用。

Kĩ năng sử dụng sự tiết lộ dần dần: thường Agent chỉ thấy tên và mô tả của mỗi kĩ năng, và đọc trong toàn bộ cơ thể và sự gắn bó chỉ khi nó quyết định một kỹ năng áp dụng cho nhiệm vụ hiện tại. Bằng cách đó, ngay cả với nhiều kỹ năng được lắp đặt, không phải mọi thứ đều được nạp vào mọi cuộc nói chuyện.

Kĩ Năng hệ thống và kỹ năng được cài đặt bởi người dùng

Kỹ năng hệ thống đã được cài đặt sẵn của nền tảng rơi vào hai loại chính: thế hệ tài liệu văn phòng (docx / xlsx / pptx / pdf) và kỹ năng phát triển (frontend, iOS, Andoter, Flutter, retter, và nhiều thứ khác). Trang Quản lý Kỹ năng trong bảng điều khiển hiển thị danh sách đầy đủ, và mở bất kỳ kỹ năng nào tiết lộ phiên bản, sự gắn bó và đầy đủ SKL.md.

Thế hệ tài liệu văn phòng

Nhóm kỹ năng hệ thống này cho phép Agent thực hiện tập tin tài liệu văn phòng trực tiếp, không chỉ đánh dấu xuống văn bản:

Một cách sử dụng thông thường: một Agent bước trong một dòng chảy làm việc hàng ngày sử dụng kỹ năng xlsx để sản xuất một bản báo cáo có định dạng hàng tuần, tải về với các hiện vật thực thi hoặc chuyển thẳng đến Slack hoặc email. Cấu trúc cũng có thể được xuất bản như liên kết công cộng; xemChia sẻ đồ hoạ công cộng.

Thị trường thành thạo: cài đặt và phiên bản

Thị trường Kĩ thuật ClawHub trang trong bảng điều khiển liên kết với nhà kho ClawHub. Tìm kiếm bằng từ khoá, xem phiên bản, tác giả, số lần tải về và cập nhật cuối cùng, và nhấn vào cài đặt để thêm nó vào tài khoản của bạn.

# 搜索市场
curl "https://braidrun.com/api/skills/market/search?query=testing&limit=10" \
  -H "Authorization: Bearer <token>"

# 安装（安装状态只记在你自己的账号下）
curl -X POST https://braidrun.com/api/skills/market/<slug>/install \
  -H "Authorization: Bearer <token>"

# 升级到最新版本
curl -X POST https://braidrun.com/api/skills/market/<slug>/upgrade \
  -H "Authorization: Bearer <token>"

• Kỹ năng mang số phiên bản. Để có kỹ năng đã cài đặt, hãy nhắp vào để kiểm tra xem cập nhật về trang « Quản lý Kỹ năng »; đang nâng cấp lại một phiên bản mới nhất
• Chỉ có những kĩ năng được cài đặt từ thị trường đi qua dòng nâng cấp; kỹ năng nhập từ ZIP không có nguồn nâng cấp - chỉ cần nhập lại
• Hủy cài đặt chỉ gỡ bỏ các kỹ năng ra khỏi tài khoản riêng của bạn và không ảnh hưởng đến những người dùng khác đã cài đặt cùng một kỹ năng
• Bạn cũng có thể tải lên một ZIP để nhập một kỹ năng mà bạn đã viết: gói này phải chứa một SKL.md với tên và trường mô tả hợp hợp lệ, và tổng kích cỡ không được phép vượt quá 100MB

BẬT/tắt cho mỗi người dùng

Mỗi kỹ năng của trang Quản lý Kỹ năng đều có điểm bật riêng. Tình trạng đã được bật/giải quyết được ghi lại trong tài khoản của bạn: một khi bạn tắt một kỹ năng hệ thống, nó không còn hiển thị cho các Agent của bạn, trong khi những người dùng khác không bị ảnh hưởng. Khả năng được cài đặt riêng của người dùng khác không hiển thị hay nạp cho bạn.

Phạm vi Agent: giới hạn kỹ năng mà một Agent có thể sử dụng

Bên ngoài các tài khoản để bật lên, bạn có thể xác định một phạm vi kỹ năng hẹp hơn cho một Agent duy nhất trong cấu hình của nó. Những lĩnh vực chung:

• Kĩ năng bật tắt nó đi và Agent này không sử dụng kỹ năng gì cả
• Chế độ cho phép - khi nào trên, chỉ cho phép danh sách kỹ năng có thể được phát hiện bởi Agent này, và các kỹ năng có sẵn được thêm vào danh sách cho phép tự động
• Tắt danh sách - một danh sách từ chối vẫn còn áp dụng khi chế độ cho phép sử dụng tắt
• Kỹ năng tối đa mỗi yêu cầu giới hạn bao nhiêu kỹ năng được đưa vào một yêu cầu duy nhất
• Tự động tìm kiếm và tải về - tắt theo mặc định; khi bật, Agent tự động tìm kiếm ClawHub và tải về các kỹ năng mới khi nó tìm thấy một khả năng bị mất ở địa phương. Điều này giới thiệu việc tải về bên ngoài, vì vậy sử dụng nó với thận trọng trong thiết lập kinh doanh

Vào thời gian thực hiện, nền tảng kết hợp các Agent cấu hình với cấp độ người dùng của bạn vào phạm vi kỹ năng hiệu quả: một kỹ năng mà bạn đã tắt trên trang Quản lý Kỹ năng không có sẵn cho mỗi Agent trong quá trình thực hiện.

Cấu hình thời gian chạy

Một số kỹ năng cần được điền trước khi làm việc, chẳng hạn như một vật tượng trưng cho bên thứ ba. Một kỹ năng với mẫu cấu hình hiển thị Cấu hình hoặc không được cấu hình trên thẻ của nó; nhấn Cấu hình khả năng và điền vào trường.

• Các trường nhạy (bị hạn chế, mật khẩu, phím riêng, v.v...) được che đậy sau khi lưu và không bao giờ được hiển thị bằng cách giả; phục vụ với mặt nạ không thay đổi giữ giá trị cũ
• Bạn có thể cấu hình kỹ năng đã tự cài đặt; chỉ quản trị có thể thay đổi cấu hình thời gian chạy của kỹ năng hệ thống

Điểm kết thúc chung

Các trang liên quan

• Hướng dẫn cấu hình Agent
• Thư viện mô- đun có sẵn
• Chia sẻ đồ hoạ công cộng