Skip to content

同步 Agent Skill 接入指南与运行时验收契约 - #134

Merged
Disdjj merged 2 commits into
mainfrom
codex/agent-skill-contract-sync
Sep 5, 2026
Merged

同步 Agent Skill 接入指南与运行时验收契约#134
Disdjj merged 2 commits into
mainfrom
codex/agent-skill-contract-sync

Conversation

@Disdjj

@Disdjj Disdjj commented Sep 5, 2026

Copy link
Copy Markdown
Member

Agent 接入指南仍把 compact 搜索当作带 schema 的发现结果,并未准确说明显式 delivery 的 CLI 包装结构;这些旧结论会让外部 skill 再次偏离当前实现。本次同步运行时流程与验收条件,使指南能约束正确的调用和完成判断。

  • 区分本机 --help 与运行时 tb help、compact 探索与 --schemas 调用准备,并检查 whoami 的认证字段。
  • 说明显式 delivery 的 {delivery, result|operation} 输出与缺 delivery 时的帮助补查。
  • 澄清 Store 对象身份、Context 可选 direct upload,以及管理配置 desired/applied 和 revision 冲突。
  • 验收 fixture 以最终 CLI stdout 建模,避免用 HTTP body 替代 SDK 包装后的结果。

验证:llmdoc validate 通过(只有行数建议);pnpm verify 通过(typecheck/Vitest 命中 Turbo 缓存,lint 和仓库 Node tests 实跑)。外部 skill 同步完成 58 条命令解析及 16 个隔离场景验证。

本次仅更新接入指南及其 fingerprint;全局 baseline 保留原值,既有 Dashboard 文档漂移不在此次范围。没有可发布包、打包配置或依赖变化。

配套 skill 优化:TokenRollAI/tool-bridge-skill#5

@Disdjj
Disdjj merged commit 57bcf87 into main Sep 5, 2026
2 checks 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