技能介绍

要解决的实际问题

海外运营团队在搭建问卷业务链路时，常会遇到「单步接口调用逻辑分散」的问题：问卷分享作为链路中的最小原子动作，若每次都由上层 Agent 重复编写接口地址、参数校验、鉴权处理逻辑，不仅会增加代码冗余，还容易出现正式环境地址被误改、鉴权头重复拼接等问题。这个技能专门封装了 KuteSmart 海外运营平台的问卷分享接口动作，把单个接口的调用逻辑标准化，让上层 Agent 无需关心该步骤的具体实现，只需传入问卷 ID 即可拿到分享结果。

技能如何工作

这个技能是最小颗粒度的原子 Skill，只承担 share_questionnaire 这一个平台接口动作：

固定使用 SKILL.md frontmatter 中定义的正式环境地址 GET https://www.kutetailor.com/api/marketing/marketing/questionnaire-info/shareQuestionnaire/{id}，不会接受用户输入覆盖 base_url；
所有调用参数统一封装在嵌套的 params 对象中，问卷 ID 写入 params.path 替换 URL 中的路径变量；
登录态处理遵循「不重复拼接」原则：若传入的 params.accessToken 已包含 Bearer 前缀，则直接用于生成 Authorization 头，否则自动拼接前缀；
调用完成后会把接口返回的结果原样透传给上层 Agent，若出现认证、权限、参数或业务错误，也会将原始错误码和错误信息完整返回，不会自行编造返回数据。

适用边界与注意点

这个技能仅覆盖问卷分享的单个接口动作，若需要完成「创建问卷→配置分享权限→生成分享链接→统计数据」这类完整的业务链路，需要由上层 Agent 按业务计划编排多个原子 Skill 协同完成。此外，调用时仍需遵循当前登录态的租户和用户权限，若当前账号无对应问卷的分享权限，接口会直接返回错误，技能不会绕过权限校验。