前言¶
在 DSH 或類似宿主機裏跑多步智能體時，模型往往在首輪還能按 schema 構造參數，進入長會話或上下文被壓縮之後，就容易漏必填項、混用互斥字段，或照着上一輪調用照抄參數。單靠一次性加載的 skill 正文，很難保證「每一輪、每一次 call」都沿用同一套規則。
jerry-george-liang/dsh-tool-call-guidance（包名 @local/dsh-tool-call-guidance）把工具調用規劃寫成可移植的 skills，並在 DSH 側把主 skill 的短正文註冊爲常駐系統提示，讓選型與參數構造的約束在每輪對話中持續可見。本文基於該項目 GitHub README 與 package.json（v1.1.1）整理能力與安裝方式。
這是什麼¶
- 定位：爲「每次工具調用」提供簡練、持久的指引，以及可單獨攜帶的 skills 資源。
- 維護者：Jerry-George-Liang；分類爲工作流；社區插件，通過 GitHub Release 分發，未發佈到 npm，不代表官方認證。
- 解決的問題：降低錯誤工具名、殘缺或衝突參數、以及長會話中規則被遺忘的概率；覆蓋首次調用與後續步驟。
- 目錄頁：SkillHub 插件頁
- 源碼：GitHub 倉庫
核心功能¶
工具調用規劃規則（主 skill）¶
README 將核心行爲歸納爲五條，模型在發送每次調用前應：
- 按當前意圖選擇準確的工具和操作。
- 只傳必填項和有意使用的可選項；檢查類型、互斥、依賴及字段存在性。
- 發送前核對最終工具名、參數對象和當前作用域內的標識；先解決缺值與接口衝突。
- 每次重查；會話權限、工具契約、作用域或相關狀態變化時更新依據。按新意圖重建參數，不復制舊調用。
- 根據真實結果推進；診斷後再重試，異步啓動後收集完成結果。
補充約定：無用字段省略；保留有意使用的 false/0；不填空值湊參數。
持續生效方式¶
插件通過 DSH 的 skills、systemPrompt 服務工作：把主 tool-call-planning skill 的短正文註冊爲常駐系統提示，每輪提供同一套規則，避免首次加載後逐漸遺忘，也避免維護兩份不同的規則。已在上下文中的正文無需重複讀取。
子智能體調用前加載短 subagent-routing；DSH 的篩選與路由示例按需讀取各自 references/，在契約有效時複用。工具、權限或狀態變化後只補查變化的信息，不要求每次額外發現或探測。
明確不做什麼¶
插件沒有運行時攔截、參數改寫或自動重試。指引不能修復宿主強制錯誤參數形狀的問題；遇到簽名衝突，應在執行前找到合法形式或報告具體限制。README 亦說明：運行時驗證與模型成功率分別記錄，不把參數規劃正確等同於實際執行成功。
環境與依賴¶
適用 DSH >=0.2.2-rc.1 <0.3.0、Node.js 22+。無第三方運行時依賴或安裝腳本。代碼、文檔及原創 SVG 圖標採用 MIT 授權。
安裝與啓用¶
下面介紹在 DSH 中安裝 v1.1.1 的兩種方式；安裝命令與鏈接以 README 原文爲準。
方式一：對 DSH 說一句話¶
可以直接對 DSH 說（README 中的引用塊）：
安裝並啓用這個插件：https://github.com/Jerry-George-Liang/dsh-tool-call-guidance/releases/download/v1.1.1/local-dsh-tool-call-guidance-1.1.1.tgz
通過 DSH plugin_manager 完成安裝後，按返回的 application、warnings、nextStep 判斷是否即時生效，隨後實際讀取 skill 驗證。
方式二：從 Release 下載包¶
在 v1.1.1 發佈頁 可下載：
使用包安裝時，開發目錄與運行版本分離，可在開發副本驗證後更新安裝；直接鏈接源碼時先停用再修改。
非 DSH 宿主¶
單獨使用時，把完整 skill 文件夾及 references/ 放進宿主支持的目錄。要覆蓋長會話和上下文壓縮後的調用，還應把主 skill 的短正文放進該宿主的持久項目指令或系統指令層；僅安裝可發現的 skill 不等於其正文始終在上下文中。DSH 插件已自動完成將短正文注入常駐提示這一步。
驗證¶
在插件倉庫根目錄，Node.js 22+ 環境下執行：
npm test
npm test 檢查資源、必填註冊元數據、釋放與重新激活，以及常駐提示和主 skill 正文一致。
適用場景與注意¶
適合誰
- 在 DSH 中編排多工具、多步子智能體，希望每輪調用前都有一致書面規則的團隊或個人。
- 需要把同一套 tool-call 指引在非 DSH 環境複用（獨立 skills 包）時。
使用前建議
- 插件以當前 DSH 進程權限運行；安裝前應自行檢查源碼與 MIT 許可證。
- SkillHub 等爲社區目錄站點，與 DeepSeek / 幻方無官方從屬關係；本插件爲社區維護，非官方認證包。
- 若宿主 API 或工具簽名與模型假設不一致，本插件不會自動改參或重試，仍需在執行層處理衝突。
結尾¶
dsh-tool-call-guidance 用常駐系統提示 + 可移植 skills，把「選對工具、構造合法參數、隨狀態重查」固化爲每輪可見的約束，而不是依賴一次性上下文。若你在工作流分類裏找這類能力，可從 SkillHub 目錄頁 進入，或在 GitHub 查看 README 與 Release。
