語言EN繁
首頁
文件
主要功能 / Agent Skills

Agent Skills

Agent Skills 讓 Heddle 學會如何使用工具、工作流程與 domain practice，而不需要在每一輪對話塞入大量指令。

Skills 如何運作

一個 skill 是包含標準 SKILL.md 的資料夾。frontmatter 提供 Heddle 輕量 catalog metadata，例如 name 與 description；body 則放完整 instructions，只有在任務需要該 skill 時才讓 agent 讀取。

這是 progressive disclosure：agent 在 session 載入時只看見 catalog，但不會一開始就收到所有 skill 的完整內容。當某個 skill 變得相關時，Heddle 才會載入完整 SKILL.md 與必要 resources。

Skills 適合用在工具本身不足以表達使用方式的情境。browser automation tool 可以開頁、點擊元素，但 browser research skill 可以說明何時 snapshot、要收集哪些 evidence，以及哪些 action 需要額外注意。

Agent 會看到什麼

載入 skill 前

  • Skill name
  • SKILL.md frontmatter 裡的短 description
  • Source，例如 project、user 或 built-in
  • 方便 audit 的檔案路徑

載入 skill 後

  • 完整 SKILL.md instructions
  • Skill 明確要求 agent 讀取的 referenced resources
  • Workflow 需要時，skill folder 內附帶的 script 或 asset

Skills 放在哪裡

Heddle 會從標準 skill roots 探索 skills。Skill files 仍保留在那些資料夾；Heddle 只會在工作區 state directory 裡儲存 activation state。

.agents/skills/<skill-name>/SKILL.md     # Project skills
~/.agents/skills/<skill-name>/SKILL.md   # User skills
built-in skill roots                     # Skills packaged with Heddle

啟用與停用 skills

在 web control plane 的 settings page 中，可以檢視已找到的 skills、用名稱或描述搜尋，並針對目前工作區啟用或停用。
Terminal 使用者可以執行 /skills 列出已找到的 skills，執行 /skills enable <name> 啟用，或 /skills disable <name> 停用。
Activation 是 workspace-scoped。Heddle 會把 activation list 存在 .heddle/skills/activation.json，因此每個工作區可以選擇不同 skill set。
Built-in skills 會隨 Heddle code 發佈。User 與 project skills 仍放在 .agents/skills 或 ~/.agents/skills 這類 skill folders；Heddle 不會把內容複製到 state。

信任與責任

Skills 是會改變 agent 工作方式的 instructions 與本地 resources。請啟用你信任的 skills、review 它們的 SKILL.md，並優先用 project-owned skills 保存團隊慣例，讓程式碼庫裡的其他人也能看見。Heddle 會讓 activation 保持明確，但使用者仍需對自己安裝與啟用的 skills 負責。

SKILL.md 範例

---
name: browser-research
description: Research web pages with browser snapshots, evidence capture, and safe navigation.
---

# Browser Research

Use this skill when the user asks you to inspect websites, compare products, or gather current web evidence.

Start with a browser snapshot, cite the page state you observed, avoid checkout or account-changing actions, and ask for confirmation before leaving the allowed domain set.

相關文件