抽奖工具 · 抽奖活动创建助手

为什么需要这个技能

在运营抽奖活动时，配置项往往很零散：奖品、开奖方式、时间、中奖率、互动玩法，少填一项就要返工。手动填表也容易把测试配置直接推到线上。这个技能把整个流程收敛到对话里：你描述需求，它维护一份 config 草稿，先预览再创建，避免误操作。

核心能力与工作流

它通过“抽奖工具 MCP”连接线上活动服务，OAuth 登录和 token 刷新由当前 AI 助手平台托管，不需要你粘贴凭证或手动管理 token。

技能启动后会先读取配置 schema（config-schema.md），并把对话里的需求持续合并为一份 config。信息不足时，每轮最多追问 1–2 个问题，同时给出简短选项和推荐值。字段补齐的优先级是：奖品与数量 → 开奖方式 → 互动玩法（仅即抽即开）→ 时间/参与次数/中奖率。活动名缺失时可以自动拟一个，你说“你推荐”就直接给一套可用方案，不会把决策再推回来。

信息齐全后调用 preview_lottery 预览活动，核对玩法、开奖方式、时间、人数、奖项和中奖率。预览通过后，技能会列出“已按需求配置”的内容和“使用了哪些默认值”，必须等你明确确认，才会调用 create_lottery 写入。编辑已创建的活动时，先调用 get_lottery 读取原活动，只合并本轮差异，再预览和更新。同一次确认的重试会复用同一个 idempotency_key，避免重复创建。

适用边界与注意点

第一版按非 VIP 能力创建：每个奖项的奖品数量为 1–9999，参与人数和满人开奖人数上限均为 1000，活动时长最多 30 天。奖项名称自动生成为“一等奖、二等奖……”顺序名称，不支持自定义等级（这是 VIP 权益），但奖品名称仍按你的需求填写。

开奖方式分三种：定时开奖、满人开奖、手动开奖；互动玩法（幸运大转盘、幸运扭蛋机、欢乐砸金蛋、幸运九宫格、幸运翻翻乐）只支持即抽即开。选择互动玩法前，技能会先数奖项数量：超过 8 个不能选九宫格，超过 9 个不能选翻翻乐，超过 15 个不能选大转盘。即抽即开的每个奖项中奖率必须大于 0，总和不得超过 100；非即抽即开不传中奖率。

第一版只支持普通实物奖品或无需收集领奖信息的奖品，不支持优惠券、兑换码、助力任务、参与条件和图片上传。如果奖品是明显的实物，技能会建议收集姓名、手机、地址；兑换券或线下兑奖则建议不收集。互动玩法的背景、标题颜色和游戏皮肤由 create_lottery 自动套用小程序当前默认值，不需要你提供素材，技能也不会编造 URL。

如果 MCP 未连接或授权失效，技能会先尝试触发连接器安装/授权流程；环境允许读写文件时，会检查现有 mcp.json 或 .mcp.json，只合并“抽奖工具 MCP”，保留其他连接器。写入后引导你完成授权，而不是直接把 JSON 丢过来。只有自动安装不可用时，才提供可复制的安装指令。

创建成功后，如果返回了 mini_program_qrcode_url，技能会把小程序码下载到工作区的 outputs/lottery-qr/ 目录，确认是图片文件后用本地绝对路径嵌入 Markdown，避免第三方 CDN 图片在聊天里无法预览。如果下载失败，才降级使用原始 URL。二维码暂时生成失败时，只说明活动已创建，不会虚构链接。

另外，编辑已创建的活动时不能切换玩法；如果需要换玩法，技能会说明需新建活动。测试活动不能转为正式活动，只能保留可复用配置并引导新建。写调用超时或连接中断时，技能不会换新的 idempotency_key 重试，而是先读取活动或让你去活动列表核对。

整体上，它适合需要快速配置合规抽奖活动、又不希望在表单和状态管理上反复出错的运营或工程场景。