技能

技能設定變數

技能可以宣告的具名設定值,用於安全設定和重複使用。

概念專屬圖版技能設定變數hx-graph-context-concept-skill-config-variables正在載入視覺預覽…
以原始尺寸檢視

技能設定變數

這是什麼

技能可在 metadata.hermes.config 宣告的具名設定值,便於安全設定與重複使用。

白話解釋

一張寫著「鹽適量」的食譜卡片並不是無故含糊:它先說明要調整的變數,再把確切用量留給實際下廚的人,讓同一份食譜既能用在小公寓廚房,也能用在餐廳。技能設定變數也是如此:SKILL.md 只命名所需的值,不把內容寫死,因此同一份技能檔案無論在筆記型電腦或租用伺服器上都能正確運作。

為什麼重要

與其把 API 端點、預設頻道或功能開關直接寫死在 SKILL.md,技能可以把它們宣告為依部署環境而異的具名設定變數。agent/skill_utils.py 會在探索時擷取這些宣告,因此同一份技能不必改檔案,就能在 VPS 與本機桌面環境間移植。設定變數也支撐漸進式揭露,因為某個變數可以決定技能中的整段選用內容是否適用。

運作方式

技能在 YAML frontmatter 的 metadata.hermes.config 下宣告設定變數;每項可包含 key、說明、選用的預設值與選用的設定提示。agent/skill_utils.pyextract_skill_config_vars 會在探索時讀取這些宣告,resolve_skill_config_values 則從 config.yamlskills.config.<key> 查找目前值;若未設定就使用宣告的預設值,並展開路徑型內容中的 ~${VAR}discover_all_skill_config_vars 會掃描所有已啟用且符合平台的技能,彙整成單一清單,讓設定工具一次提示整個技能集合所需的變數。

具體範例

照片封存技能在 frontmattermetadata.hermes.config 宣告 photos.archive_path,預設為 ~/Pictures/archive。桌面環境執行設定時發現尚未指定,便提示使用者填入 ~/Documents/photo-archive;同一份技能部署到 VPS 時則把該值設為 /srv/photos。兩邊都不必修改 SKILL.md,Hermes 每次載入技能時會從各自的 config.yaml 解析值,輸出「已解析封存路徑」與該環境的正確路徑。

如何連結

「技能設定變數」屬於「技能」系列。最直接相關的概念包括:「技能生命週期」、「漸進式揭露」、「代理執行環境」、「個人作業系統」。這些連結描述教學關係,不取代來源證據。

來源證據

  • agent/skill_utils.py#<file> — 結構性來源;只確認來源檔關聯,不單獨證明特定呼叫順序。

工作流程

  • 目前尚無第一輪工作流程對應;此概念仍透過文章與來源證據出現在知識庫圖譜中。

相關文章

  • 目前沒有文章以足夠頻率直接提及此概念名稱或別名,尚未達到提及探勘門檻。

相關筆記