Drop the removed --tool envelope call form - #1
Merged
Conversation
The gateway now exposes a single direct call form: a command is a virtual leaf under its node, so `cmds[].path` is always the full command path and the request body is the arguments object. The `tb call '<node>' --tool '<command>'` envelope form no longer exists. - SKILL.md / cli-reference.md: remove the envelope examples and the "choose the form" guidance; teach the one direct form. - Rename "tool-level help" to "command-level help" and `<node>/<tool>` to `<node>/<command>` throughout, matching the runtime where every kind resolves command-level `~help`. - Note that path identifiers are case-insensitive and normalized to lowercase. Discovery still passes: `npx --yes skills add . --list` finds only the `tool-bridge` skill.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
背景
上游 gateway 已把数据面调用彻底改为唯一直连形态:命令是节点下的虚拟叶子,
cmds[].path恒为完整命令路径,POST /<path>的 body 即 arguments 本体(无{tool,arguments}信封)。tb call '<node>' --tool '<command>'这种 envelope 形态已从 CLI 删除。Skill 里仍在教已删除的 envelope 形态,agent 照着做会失败。本 PR 让 Skill 与当前运行时对齐。
改动
SKILL.md第 4 步与cli-reference.md的 "Invocation forms" 不再出现--tool,也不再让 agent "从 node kind 选择调用形态";统一教一种直连形态,cmds[].path逐字用作调用目标。<node>/<tool>→<node>/<command>、"tool-level help" → "command-level help"。重构后所有 kind 都用命令级~help,不再是 MCP/HTTP/tool 专属。验收
npx --yes skills add . --list仅发现tool-bridgeskill(仓库 CI 的 discovery 校验)。--tool/envelope/tool-level残留。