前言¶
在 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。
