淘客统一入口(礼金 + 转链)
本 Skill 是顶层编排控制器,将已安装的 taoke-workflow-tlj(媒体淘礼金全流程)与
taoke-material-universal-link-convert(淘客通用转链)整合为一个统一入口。
依赖
taoke-workflow-tlj—— 礼金全流程(内部再编排 7 个原子 Skill:account-query / item-recommend / ranking / create / query-instance / promote / reconciliation)taoke-material-universal-link-convert—— 通用转链
> 以上依赖需已安装;若缺失,引导用户先安装对应 Skill。
前置:Token 获取(已内置,自动读取)
Access Key 已内置在本地凭据文件 ~/.urp/credentials.json(同时写入 access_key 与 token 两字段,
分别供转链 Skill 与礼金 Skill 读取)。启动时:
- 自动读取
~/.urp/credentials.json:
- 转链流程用access_key字段
- 礼金流程用token字段 - 若用户在本对话中显式提供了新的 Token,则以用户提供的为准并提示是否更新本地凭据。
- 若凭据文件缺失或 Token 无效(401),通过 AskUserQuestion 要求用户手动提供 Bearer Token。
无需在每次对话开头重复索要 Token。
Trigger
- 礼金相关:"创建礼金"、"我要发礼金"、"开始礼金流程"、"礼金全流程"等
- 转链相关:"转链"、"生成推广链接"、"推广链接"、"淘口令"、"把链接转成我的推广链接"等
- 表达出礼金或转链完整意图时触发
路由流程
[自动读取内置 Token]
|
v
[识别用户意图] -- 礼金意图 --------> 调用 taoke-workflow-tlj
| (权限检查→选品→创建→查询→推广→对账)
|
+-- 转链意图 --------> 调用 taoke-material-universal-link-convert
| (确认 PID→确认链接类型→转链→输出推广字段)
|
+-- 意图不明确 --------> AskUserQuestion:
「礼金全流程」/「通用转链」/「退出」
阶段1:意图识别与路由
- 礼金意图(创建/发放/推广礼金)→ 通过 Skill 工具调用
taoke-workflow-tlj,由其按内部 6 阶段编排执行。 - 转链意图(把商品链接/素材/淘口令转成自己的推广链接)→ 通过 Skill 工具调用
taoke-material-universal-link-convert执行。 - 若用户意图模糊,通过 AskUserQuestion 让用户选择功能,提供「礼金全流程」「通用转链」「退出」三个选项。
阶段2:委托执行
- 调用对应子 Skill 时,直接复用本 Skill 已读取的 Token 上下文,避免子 Skill 再次索要 Token。
- 礼金流程:遵循
taoke-workflow-tlj内部的阶段推进、异常即停、用户可随时退出等规则。 - 转链流程:遵循
taoke-material-universal-link-convert的 PID 确认、链接类型选择、产出前置等规则。
阶段3:结果汇总
- 礼金流程结束:展示推广信息模版(短链/长链/淘口令/商品图),可选查看对账。
- 转链流程结束:前置输出用户选择的推广字段(如 cpsShortUrl / couponLongUrl 等),并明确告知
本次使用 PID。 - 通过 AskUserQuestion 提供「再执行一次」「切换功能(礼金/转链)」「完成」选项。
流程控制规则
- 单向推进:每个子流程内部单向推进,不自动回退。
- 异常即停:权限不足、余额不足、Token 失效、创建/转链失败时立即停止并提示。
- 不侵入原子 Skill:仅在两个子 Skill 之间做意图判断与路由,不修改其内部逻辑。
- 用户可随时退出:任何阶段提供「退出」/「完成」按钮。
- Token 复用:内置 Token 在本会话全程复用,子 Skill 不再重复索要。
- AskUserQuestion 驱动:功能选择与关键确认均通过 AskUserQuestion 实现可点击按钮。
说明
本 Skill 是编排类型(workflow),自身不持有 credentials,不直接发起后端调用,仅做路由与 Token 上下文复用。