SuperAPI AI 工具集

dingtalk-shared

通用与其它

查看项目

更新于 10-15 21:10

技能介绍

用途:作为 DWS(钉钉工作区 CLI)的共享入口。仅在泛称 DWS、跨产品流程、URL 预检或意图不清时使用;明确单产品请求直接走对应 dingtalk-* skill,已内嵌最小执行契约的产品根 Skill 无需先读本文件。

最小执行契约:只用 dws;结构化读取加 --format json,按真实返回判断。已知命令直调;参数/约束/安全不明时查 leaf 窄 Schema,Schema 不可用才读一次已知 leaf Help,unknown flag 用同 leaf Help 修正一次;unknown command 不查 Help,优先用错误中的 suggestion,其次已加载 Skill/reference 中的兼容入口,均无则报漂移并停止,禁全 Catalog。不猜命令/flag/字段/ID/账号/业务事实,ID 取自真实返回。多账号只用唯一 isOrgCurrent=true,禁止选择第一项或最近账号。不输出或记录 token、refresh token、appSecret、webhook token。写操作须符合明确意图,确认以最终 Runtime gate/Schema 为准,确认后才加 --yes,写后验证结果,不凭退出码宣称成功。国际版或 .io 区域登录须执行 dws auth login --intl(无头环境加 --device),--intl 只用于登录。

渐进加载:只读当前任务需要的文件。已明确单一产品读对应 ../dingtalk-*/SKILL.md;需选产品读 routing.md;跨产品多步骤读 workflow-routing.md;含 alidocs /i/nodes/ URL 或来源未验证 nodeId 读 url-patterns.md;URL 类型不明读 url-patterns.md;边界难判读 intent-guide.md;认证/全局 flag/输出格式读 global-reference.md;出错读 error-codes.md;写确认读 confirmation.md;命令发现与 Schema 读 schema-usage.md;怀疑能力不支持读 capability-limits.md;批量采集读 conventions.md;固定短流程读 lite-catalog.md。产品命令、脚本和字段细节在对应产品 skill 维护。

路由顺序:先识别明确产品内容意图,明确则直选对应产品;但用户直供的 alidocs /i/nodes/ URL 或来源未验证 nodeId 仍须读 url-patterns.md,先做节点类型探测,extension=dlink 时将 drive info 的 result.fileId 存为入口 ID 传给 dws doc info,再按 linkSourceInfo.nodeId 逐跳解析,把最终目标 ID 交给候选产品。多步骤跨产品请求即使 URL 已识别也读 workflow-routing.md;产品不明读 routing.md。仍无法判断时向用户追问,不猜测。

错误最短路径:unknown command/flag 运行对应层级 --help,按公开 flag 修正后最多重试一次;confirmation_required 按 confirmation.md 处理,不静默加 --yes;认证权限错误读 global-reference.md 与 error-codes.md;其他错误优先读 JSON 中的 retryable、retry_after_seconds、next_retry_at、hint 和 actions,仅 retryable=true 才按服务端节奏重试,缺重试语义时用 --verbose 诊断并停止。明确不支持的能力应说明边界,不绕过。

限制:仅作入口与契约,不重复维护产品命令细节;metadata.requires.skills 不会自动加载,相对 Read 链接为运行时依赖。