用途:面向钉钉开放平台的开发文档检索,适合用户提出“开放平台文档”“API 文档”“接口文档”“调用报错”“开放接口怎么调”等需求时使用。与 dingtalk-doc(钉钉云文档,个人/企业内文档)不同,本技能聚焦开放平台侧文档。
主要能力:通过 dws devdoc 命令按关键词搜索文档文章。典型用法包括:dws devdoc article search --query "OAuth2 接入" 查询接入文档;dws devdoc article search --query "<报错关键词>" 排查 API 调用报错;dws devdoc article search --query "<接口名或场景>" 查找开放接口文档。
使用前提:需先阅读 dws-shared 技能,了解认证、全局参数、产品路由、URL 预检、错误码与安全规则;dws 二进制需在 PATH 中。命令可用性以当前 dws 二进制为准,服务发现已下线,文档随内置技能发布。若 dws <cmd> --help 不存在,说明当前版本未暴露该命令;若命令存在但调用失败,需按错误中的 endpoint 或 tool 提示确认静态端点目录与后端工具注册。实际调用前可用 dws <cmd> --help 或 --dry-run 验证。
状态与限制:标注为 EXPERIMENTAL 试验版,multi 模式当前未达 stable 标准;全部 dingtalk-* 技能已通过 dispatch verifier,但接口、命名、跨 skill 引用后续可能调整。生产或共享环境建议优先使用 mono 模式(dws skill setup --mode mono)。问题可通过 issue 反馈。具体文档覆盖范围、返回字段与调用配额暂未提供。