技能介绍

要解决的问题

Dub 是常用的短链接服务，但它的管理入口主要在网页后台。当你需要批量创建链接、给链接打标签、按文件夹归档时，靠点点点既慢又难脚本化；直接调 Dub API 则要自己保管 token、处理过期和权限范围。这个技能通过 OOMOL 连接器加 oo CLI 解决这两个痛点：凭证由服务端注入，agent 不需要接触原始 token。

核心能力

覆盖短链接的 增删改查：create_link、update_link、delete_link、retrieve_link、list_links、count_links
文件夹与标签的全生命周期管理：create_/list_/update_/delete_folder 及对应的 tag 操作
retrieve_analytics 可按链接、域名或 workspace 取回分析数据

执行模型是契约优先：先跑 oo connector schema 拿到权威的输入/输出 schema，再构造匹配的 --data JSON（支持 @path/to/file.json）。响应统一为 {"data": ..., "meta": {"executionId": "..."}}，执行 id 在 meta.executionId 下，便于追踪调用。

注意点

读操作（get / list / search）可直接执行；写操作会改变 Dub 状态，运行前要和用户确认 payload 与影响；删除操作是破坏性的，必须先确认目标并获得明确批准。
首次配置只在命令真正失败时才做：oo CLI 未安装、未登录、Dub 未连接（API key 方式授权）或额度耗尽（HTTP 402）时，再走对应的一次性步骤。
每次调用前仍需读对应 action 的参考文件并拉取实时 schema，不要凭记忆拼 payload。