簡體 繁體 EN

WorkBuddy Skill 開發入門:從 SKILL.md 寫出一個能跑的技能

釋出於 2026-10-29 · 獨立第三方評測 · 轉載請註明出處

一個 Skill 的本體就是一個資料夾:核心是 SKILL.md 檔案(YAML 元資訊 + Markdown 正文),可選附帶指令碼與資源。 Agent 按 description 匹配任務意圖,命中後加載該技能執行。SKILL.md 是跨 Agent 的開放標準,Claude Code、OpenClaw 等工具同樣相容——寫一次,多處可用。

最小可用示例

建一個資料夾 excel-helper,裡面放 SKILL.md:

---
name: excel-helper
description: 處理 Excel 表格任務:合併多個工作簿、清洗資料、
  生成透視彙總。當用戶提到處理 Excel/表格/工作簿時使用。
---

# Excel 助手

## 步驟
1. 讀取使用者指定的表格檔案,先輸出列名和行數確認理解
2. 按任務要求處理(合併/清洗/透視)
3. 結果另存為新檔案,並報告改動摘要

## 注意
- 覆蓋原檔案前必須先備份
- 日期列統一轉為 YYYY-MM-DD

把它放入 WorkBuddy 的技能目錄(或通過匯入入口載入),新建會話後說”幫我把這三個表合併”,技能就該被觸發。

寫好 description 是 80% 的工作

Agent 靠 description 決定何時載入你的技能,寫法三原則:

  1. 寫”什麼時候用”,不是”這是什麼”——用使用者會說出口的任務動詞:“合併""轉換""抓取”
  2. 埋觸發詞:使用者任務裡出現的詞,description 裡也要有(Excel、表格、工作簿)
  3. 劃邊界:寫清不適用場景,避免誤觸發

進階結構:漸進式披露

複雜技能別把所有內容塞進 SKILL.md,標準支援分層載入:

excel-helper/
├── SKILL.md            # 主檔案:概要 + 核心流程(保持精簡)
├── reference/
│   └── api-details.md  # 詳細參考,SKILL.md 裡用連結引用
└── scripts/
    └── clean.py        # 可執行指令碼,SKILL.md 裡說明呼叫方式

Agent 先讀 SKILL.md,需要細節時再按引用深入,省上下文、提命中率。

上線前檢查清單

  • frontmatter 的 name 與資料夾名一致
  • description 含 3 個以上自然觸發詞
  • 破壞性操作(刪改/覆蓋)有確認或備份機制
  • 在新會話裡用 3 種不同說法測試觸發
  • 指令碼不要求敏感許可權(無關目錄、靜默聯網)

做好了?讓更多人用上

注:WorkBuddy 客戶端的技能目錄位置與開發者入口以官方文件為準;本站為獨立第三方站點。