v1.3.11
首頁 GitHub

Skill 系統

最後更新


Skill 是可載入的 markdown 指令包，能將 agent 切換至特定執行模式（例如 commit message 生成、code review、README 生成）。

Skill 格式


Skill 是一個帶有 YAML frontmatter 作為 metadata 的 markdown 檔案：
  1. ***
  2. name: code-reviewer
  3. description: Deep code review covering quality, security, and architecture
  4. version: 1.0.0
  5. ***
  7. You are now a strict code reviewer...

Frontmatter 的 name 是觸發關鍵字。skill 啟用時內文以 run_skill 的 tool result 送達；v1.1.0 起不再附加進 system prompt。

Skill 位置


掃描器會走訪十個目錄（~/.copilot/skills 與 ~/.agents/skills 於 v1.2.0 加入），因此為其他 agent 撰寫的 skill 無需轉換即可載入：
路徑來源標籤
<cwd>/.skillslocal
<cwd>/.claude/skillsclaude
~/.config/agenvoy/skills/.systemsystem（內建，由 make build 從 extensions/skills/ 刷新）
~/.config/agenvoy/skills/.system_designsystem（以 /skill → system 安裝的選用 skill，v1.0.17 起）
~/.config/agenvoy/skillsuser（v1.0.22 之前為 agenvoy）
~/.claude/skillsclaude
~/.codex/skillscodex
~/.opencode/skillsopencode
~/.copilot/skillscopilot
~/.agents/skillsagents

~/.openai/skills 與其 openai 來源標籤移除於 v1.2.1；這些 skill 請改放到 ~/.agents/skills 或其他會被掃描的目錄。
每個 skill 是一個包含 SKILL.md 以及可選腳本 / 範本的目錄。來源標籤會顯示在 TUI 斜線選單的 skill 旁，一眼看出 /code-reviewer 來自本專案、Agenvoy 自身儲存，還是其他 agent 的設定。
v1.2.0 起 skill 清單不再放在 system prompt，改由每輪放在使用者輸入之前的 context 訊息帶入（描述截至 256 字元），system prompt 的 ## Skills 區塊只保留固定的啟用規則。run_skill 則按需載入內容。
外部來源 claude、codex、copilot、opencode、agents 自 v1.2.0 起可個別關閉：TUI /skill → source（多選，取消勾選即略過）、dashboard 的 Skills 頁，或 POST /v1/config/skill_source。清單存成 config.json 的 skill_source_disabled，掃描時略過這些目錄；關閉 claude 也會略過 <cwd>/.claude/skills。

內建與可安裝的 skill


內建 skill 為 extension-install、extension-upload、scheduler-skill-creator 與 skill-creator。v1.0.17 將 code-reviewer、commit-generate、readme-generate、version-generate 與 search-suitable-public-api 移出內建。除 search-suitable-public-api 外，這些 skill 加上 wiki-generate 與（v1.0.21 起）go-test-generate、seo-optimize 都能在 TUI 以 /skill → system（v1.0.22 之前為 /skills）安裝：這是一個多選清單，勾選的項目會從 github.com/agenvoy/skill-<name> 以淺層 clone 到 ~/.config/agenvoy/skills/.system_design/，已存在但取消勾選的項目則會被刪除，完成後 scanner 會重新掃描。與 .system 相同，這些目錄無法透過 DELETE /v1/skill 刪除。

Always-allow 清單


Skill 可被標為 always-allow，使其 tool call 跳過 confirm gate：TUI /skill → permission，僅限全域範圍（v1.0.22 取代 /allow-skill；/dangerous 指令更早已移除），或 POST /v1/allowlist 帶 {skill: {name, scope, work_dir}} 區塊（scope=global|project）。全域項目位於 ~/.config/agenvoy/allow_skill，專案項目位於 <專案>/.agenvoy/allow_skill，載入時取聯集。always-allow 的 skill 套用 auto 規則，因此只在工作目錄為 $HOME 底下的子目錄（不是 $HOME 本身，也非禁止或敏感路徑）時才略過確認；工作目錄外的寫入、不可逆指令與需要密碼的確認仍會詢問。
EN