Communitygithub.com

zehuichan/vibe-harness

在編寫或修改模型導向的工具定義(名稱、描述、參數架構或系統提示區段)時,以及設計技能、上下文載入或多步驟代理工作流程時使用,以讓資訊易於發現並有效運用上下文。

vibe-harness 是什麼?

此技能旨在優化 AI 代理(如 Claude Code、Cursor 或 Codex)在處理任務時的「模型體驗」。它提供了一套設計原則,指導開發者如何建構工具定義、技能和代理指令,使得模型能夠高效地發現所需資訊、安全執行操作,並將寶貴的上下文資源集中用於核心任務。技能核心概念包括:從最小上下文開始、明確標記可延遲載入的資源、保持關鍵限制可見、偏好有界輸出、利用局部性提供鄰近上下文,以及評估節省上下文是否真正降低總工作量。此外,它也為工具定義、技能和代理指令提供了具體的指引,例如:刪除明顯的限制、描述行為而非實作、將參數規則放在參數上、每項事實只說一次等。最終目的是讓模型的每個動作都精準、高效,減少不必要的查詢與錯誤。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/zehuichan/vibe-harness/tree/HEAD/skills/agent-experience

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

模型體驗

設計模型所見的內容,使其能找到所需資訊、安全行動,並將上下文專注於任務本身。這是指南,而非檢查清單。

  • 從最小上下文開始: 先暴露目的、可用操作和限制條件;在需要時才載入詳細指令。
  • 明確標記可發現性: 每個延遲載入的資源都需要清晰的描述和可靠的擷取方式。
  • 保持關鍵限制可見: 權限、破壞性效果和必要的驗證應在相關操作前出現。
  • 偏好有界輸出: 回傳簡潔的結果,附帶用於擷取細節的識別碼或路徑;避免傾倒整個日誌或文件。
  • 善用局部性: 在操作的結果中包含適量的、可能需要的鄰近上下文。例如,在回覆討論串時附帶前幾則訊息。明確標記遺漏和截斷處,並提供擷取更多內容的方式。
  • 評估總工作量: 節省上下文只有在不導致更多搜尋、重複讀取或錯誤時才有用。

工具定義

  • 刪除明顯的限制。 省略模型可從呼叫結果中學習到的規則,例如缺少檔案導致讀取失敗,或傳送失敗表示未送達。
  • 描述行為,而非實作。 說明工具做什麼以及回傳什麼;省略內部機制、模型在結果中看到的輸出標記,以及強制執行細節。
  • 將參數規則放在參數上。 預設值、範圍、配對以及何時設定的規則應屬於該參數的描述或架構;隨配置而變化的描述通常表示變化的部分應屬於參數。
  • 每項事實只說一次。 不要在工具的系統提示區段中重複工具定義,不要在參數描述中重複工具描述,也不要在一個工具中重複另一個工具的規則。
  • 衡量變更。 在變更工具定義前後,比較第一次對話的提示 Token 數量。

技能與代理指令

  • 描述即觸發條件。 技能的描述應以使用者或任務會使用的詞彙說明何時使用它;技能主體則說明如何執行。
  • 保持入口檔案簡短,並連結細節。 將工作流程和護欄放在技能檔案中;將校準範例和長篇參考資料轉移到按需求載入的檔案中,並從入口檔案直接連結。
  • 明確說明範圍限制。 「這是指南,而非檢查清單」或「報告發現結果,不進行編輯」會改變模型應用工作流程的方式。
  • 指向事實來源。 指令應連結所屬文件,而不是重新陳述,以避免內容偏移。

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

相關技能