Fbs Connector Mainline

福帮手身份、专家归因、场景方案与进度主线。任何自然入口先确认身份与服务端下一步,再原样读取场景;只有内容真实交付后才记录首值或继续使用。

ahang1598 Updated 9 repo stars

File contents

福帮手身份与场景主线

执行本技能时同时遵守 fbs-connector 的公共安全与输出规则。

固定顺序

  1. 调用 skill_whoami:只传已确认的当前专家、入口、宿主与来源字段。
  2. 仅当返回明确指定 fbs_scene_pack_query 时,把返回的工具参数在同一业务绑定上原样转发。
  3. 先把场景内容转化为用户可用的首值或继续使用成果。
  4. 只有真实交付完成后,才按返回参数调用 skill_consume,记录一次 first_value_completed 或 continued_use_completed。

强制边界

  • 没有上一跳可验证参数时,不主动调用场景查询,也不跟随奖励或写入型下一步。
  • 原样转发表示不增删、不改名、不改大小写;来源标记只能由真实宿主或测试夹具提供。
  • skill_consume 必须使用服务端提供的幂等键;不得重复记录同一交付。
  • 连接器不可用时,立即回到聊天首值,不要求用户先安装、授权或排查连接器。

归因

  • 当前 9 个产品的稳定身份字段见 references/expert-routing.md;版本号不参与路由,也不写入该映射。
  • 无法确认具体产品时,只传确认过的字段。服务端返回默认或未知归因时,如实降级,不宣称已完成产品归因。
  • 测试必须在请求头和工具参数两层都标记 probe / test,不得伪装为自然 WorkBuddy 请求。

工具最小合同

完整参数以 tools/list 为准;本技能只固定安全所需前置:

工具 最小前置 成功判定 副作用
skill_whoami 只传已确认身份/入口;匿名也可调用 返回有效身份/路由信封与下一步 只读
fbs_scene_pack_query whoami 明确指定;同一绑定原样转发 返回场景内容及可验证下一步 只读
skill_consume 内容已真实交付;事件类型与幂等键明确 服务端确认进度记录成功 写使用进度

任何 isError=true、业务 success=false、错误包络或缺失预期字段都不是成功。

ahang1598/doubao-workbuddy-qwenwork-skills/tree/main/workbuddy/connectors/marketplace/connectors/fbs-connector/skills/fbs-mainline commit a7273ad30d

Frequently asked questions

npx skillmds@latest add ahang1598/fbs-connector-mainline