技能系統

技能（Skill）是給 Agent 使用的能力包：一個以 SKILL.md 為核心的目錄，裡面裝著操作說明、指令碼和參考資料。Agent 執行任務時按需讀取這些內容，就能做一件原本不會做的事，例如產生一份帶目錄和頁首的 Word 文件。

技能是什麼

每個技能是一個目錄，最少包含一份 SKILL.md：frontmatter 裡寫 name 和 description，內文是給 Agent 看的操作說明。目錄裡還可以帶附件（指令碼、參考文件、設定範本），並宣告依賴與 MCP 伺服器。

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

# 使用说明

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

技能採用漸進式揭露：Agent 平時只看到每個技能的名稱與描述，判斷當前任務用得上某個技能時，才讀入完整內文與附件。這樣即使安裝了很多技能，也不會把所有內容都塞進每次對話。

系統技能與使用者安裝技能

平台預裝的通用系統技能主要有兩類：Office 文件產生（docx / xlsx / pptx / pdf）和開發類技能（前端、全端、iOS、Android、Flutter、React Native 等）。在控制台的「技能管理」頁可以看到完整清單，點開任何一個技能都能查看它的版本、附件和 SKILL.md 全文。

Office 文件產生

這組系統技能讓 Agent 步驟直接產出辦公文件檔案，而不只是 Markdown 文字：

典型用法：日報 workflow 裡的 Agent 步驟用 xlsx 技能產出一份帶格式的週報表格，隨執行產物一起下載，或直接送達 Slack / 郵件。產物還能發布為公開連結，見產物公開分享。

技能市集：安裝與版本

控制台的「ClawHub 技能市集」頁連接 ClawHub 註冊中心。依關鍵字搜尋，查看每個技能的版本、作者、下載量和更新時間，點安裝即可為自己的帳號裝上。

# 搜索市场
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>"

• 技能帶版本號。已安裝的技能在「技能管理」頁點「檢查更新」，升級會重新下載最新版本
• 只有從市集安裝的技能走升級流程；ZIP 匯入的技能沒有升級來源，重新匯入一次即可
• 解除安裝只解除你自己帳號的安裝，不影響安裝了同一技能的其他使用者
• 也可以直接上傳 ZIP 匯入自己寫的技能：包內必須有一份 SKILL.md，且 name 和 description 欄位有效；解壓後總大小不超過 100MB

依使用者啟用 / 停用

「技能管理」頁裡每個技能都有獨立開關。啟用 / 停用狀態記錄在你自己的帳號下：你把某個系統技能停用後，它對你的 Agent 不再可見，其他使用者不受影響。別的使用者私有安裝的技能，你既看不到也不會被載入。

Agent 作用域：限制某個 Agent 能用哪些技能

帳號級開關之外，還可以在 Agent 設定裡給單個 Agent 劃定更小的技能範圍。常用欄位：

• Skills 子系統開關 —— 關掉後這個 Agent 完全不使用技能
• 白名單模式 —— 開啟後只有白名單裡的技能能被這個 Agent 偵測到，內建技能會自動加入白名單
• 停用列表 —— 黑名單，白名單模式關閉時依然生效
• 每次請求最大技能數 —— 限制單次請求裡注入的技能數量
• 自動搜尋下載 —— 預設關閉；開啟後 Agent 發現本地缺少能力時會自動去 ClawHub 搜尋並下載新技能，會引入外部下載行為，企業情境慎用

執行時平台把 Agent 設定和你的使用者級狀態合併成最終生效的技能範圍：你在「技能管理」頁停用的技能，對這次執行裡的所有 Agent 都不可用。

執行時設定

有的技能需要先填參數或憑證才能運作，例如第三方服務的 API token。帶設定範本的技能會在卡片上顯示「已設定 / 待設定」，點「設定 Skill」依欄位填寫即可。

• 敏感欄位（token、密碼、私鑰等）儲存後以遮罩顯示，不回顯明文；保持遮罩送出則沿用舊值
• 自己安裝的技能自己就能設定；系統技能的執行時設定只有管理員可以修改

常用端點

相關頁面

• Agent 配置詳解
• 內建模組庫
• 產物公開分享