技能

漸進式揭露

編寫技能讓代理只看到當前層級所需的細節。

概念專屬圖版漸進式揭露hx-graph-context-concept-progressive-disclosure正在載入視覺預覽…
以原始尺寸檢視

漸進式揭露

這是什麼

先讓代理看見精簡索引,只有任務確實需要時才載入完整技能或個別支援檔案。

白話解釋

博物館語音導覽只有在你對某幅畫按下「深入說明」時才播放詳細評論,而不是一走近就念完整篇策展文章。設計良好的技能也一樣:代理預設只看一行描述,工作真正需要時才載入完整指示,甚至只讀其中引用的某份支援檔案。

為什麼重要

結構良好的 SKILL.md 只向代理顯示目前操作需要的細節,而不是不論相關性都把整份程序塞進每輪對話。這能避免技能很多的工作階段被尚未用到的指示撐大,因為上下文建構本來就會消耗不少 token 預算。技能設定變數也常讓揭露更實用,一個變數便能等到需要時才開啟整個章節。

運作方式

skills_list()tools/skills_tool.py)一次只回傳整個技能庫每項技能的名稱、描述與分類;目前完整索引約 3,000 token,不會載入任一技能的完整指示。代理選定技能後,再以 skill_view(name) 把該技能的完整 SKILL.md 載入對話。若指示引用支援檔案,則用 skill_view(name, file_path=...) 只取得那一份。references/templates/scripts/assets/ 目錄(agent/skill_utils.py)刻意排除於頂層掃描,只有第三層明確請求才載入,不會預設常駐上下文。

具體範例

Hermes 安裝了 175 個技能,開始一輪時只看見約 3,000 token 的精簡索引。使用者要求以 Axolotl 微調模型後,代理呼叫 skill_view 載入該技能的完整 SKILL.md。該檔案再指向 references/ 中的長範例;只有工作真的需要那份範例時,Hermes 才做第二次更精準的載入。

如何連結

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

來源證據

  • agent/skill_utils.py#<file> — 結構性檔案對應;只確認來源檔關聯,不推論未列出的內部行為。

工作流程

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

相關文章

相關筆記