有赞工具包

要解决的问题

有赞的开放接口与文档分布在多个入口：业务 API 有版本差异，知识服务需要单独配置端点，CLI 命令也会随版本调整。直接去网页翻文档很容易出现「文档写的是旧版、本地 CLI 是新版」的错配，鉴权失败或字段缺失时也难定位是命令问题还是参数问题。

技能如何工作

• 通过 youzan-toolkit 执行真实操作，而不是把文档摘要塞进模型上下文。
• 每个 CLI 版本内嵌对应版本的 Skills；执行业务命令前先运行 youzan-toolkit skills read yzy-open-knowledge-search，拿到与当前版本严格匹配的操作指南。
• 首次使用知识服务时用 config init --endpoint 配置公网 HTTPS 地址，之后依赖 docs search、docs read 做只读检索。
• 需要确认接口形状时走 openapi schema，把字段定义交给命令行而不是凭记忆描述。
• 更新流程只访问有赞云公网 npm 镜像，并在 CLI 更新后同步同版本的内嵌 Skills。

适用边界与注意点

这是一个只读查询为主的工具：docs search、docs read 和 openapi schema 都用于检索与确认，不应被当作写入业务数据的通道。CLI 不在 PATH 中时需要先完成安装，并在安装或更新后重启 Agent 客户端，否则加载不到内嵌 Skills。

使用结果时要先把检索结果转成结论再输出，而不是把接口 JSON 整段贴回来；知识服务没有返回的事实不要自行补全。命令报错或鉴权异常时，第一步是读对应命令的 --help 和内嵌 Skill，确认当前版本的真实参数与端点配置，再改代码。