Skip to content

优化 Tool Bridge skill:精简主流程并对齐当前运行时契约 - #5

Merged
Disdjj merged 1 commit into
mainfrom
codex/skill-runtime-workflows
Sep 5, 2026
Merged

优化 Tool Bridge skill:精简主流程并对齐当前运行时契约#5
Disdjj merged 1 commit into
mainfrom
codex/skill-runtime-workflows

Conversation

@Disdjj

@Disdjj Disdjj commented Sep 5, 2026

Copy link
Copy Markdown
Member

旧 skill 把 search --json 当成包含完整参数 schema 的结果,并把设备调用的 HTTP body 当成 CLI 输出,可能导致猜参或把入队误报为完成。新版按当前运行时契约选择发现与调用路径,并把设备、数据、管理和恢复细节改为按需加载。

  • 主入口从 1467 词缩至 862 词(约减少 41%),常规只读调用复用已验证路径。
  • 准备调用时使用 search --schemas --json;正确处理 compact、联邦路径、缺失 delivery 和鉴权失败。
  • {delivery, result|operation} 读取显式 delivery 结果,保留单次 fallback、无默认轮询和执行未知不重试的边界。
  • 补齐配置保存/应用/并发冲突、管理入口、凭证输入、Store/Context 选择及可选上传能力;同步 README 和 Codex 元数据。

验证:

  • quick_validate.py 通过;npx --yes skills add . --list 仅发现预期 skill;12 个本地文档链接有效。
  • 58 条 shell 示例通过当前 Tool Bridge CLI 命令树解析,执行动作禁用,无网关请求。
  • 16 个明确输入的隔离场景通过实际调用 trace 断言,含确定性失败恢复、执行未知、配置冲突和文件处理。
  • 对应主仓库 pnpm verify 通过,typecheck/Vitest 命中 Turbo 缓存,lint 与仓库 Node tests 实跑。

验证使用本地模拟网关,未调用生产网关或真实上游;场景验证不代表真实部署的端到端验收。

配套主仓库接入指南同步:TokenRollAI/tool-bridge#134

旧指引把 compact 搜索当成完整 schema,并混淆设备调用的 wire body 与 CLI 输出,容易让 agent 猜参或误报完成。主入口保留最短调用路径,条件细节按需加载,在降低常用上下文开销的同时补齐管理、离线设备和文件处理的验收边界。
@Disdjj
Disdjj merged commit 5bac597 into main Sep 5, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant