spend-gate 是 gooseworks-ai/goose-skills 提供的营销类技能手册共用的一个步骤,适用于 make-static-ads、research-market、run-paid-campaigns、work-with-creators 等场景。它的核心用途是:在本次对话中,任何 credits 被消耗之前,先获得使用者的明确同意。
主要能力与规则:
- 金额始终以 GooseWorks 给出的 credits 数值呈现,绝不使用美元,也不将自身汇总作为价格展示。
- 面向营销人员时,只用通俗语言描述工作内容(例如“关于狗过敏的 Reddit 帖子,按最新排序”),不提及工具、端点或供应商名称。
使用方式按工具分为三个分支:
A. 引擎报价的工作(广告、图片、视频,或任何有试运行/价格检查的工具)
- 托管营销数据:marketing_data_describe 免费;marketing_data_lookup 默认 quote_only: true。读取返回的最大 credits 与有效期,然后针对该明确限定的工作请求批准。用报价令牌、批准上限和使用者原话提交同一请求。新的请求或过期报价需要重新报价。已有批准仅在其明确指明同一限定计划与总上限时,才能覆盖后续调用:逐次调用报价,保留原始批准原话,并将其上限设为不超过剩余已批准 credits。仅当范围变更或预算增加时才再次询问。记录每次返回的扣费并在下次调用前扣减;工具的单次调用上限不是累计计划上限。已批准计划内的免费续页无需第二次支出批准。有上限的报价是最大值,不代表最终用量。发现、成功报价或测试夹具均不得视为已付费数据读取已执行的证据。
- 向工具请求报价(其试运行、quote_only 或 gooseworks:data_price_provider 用于 fal 和 ElevenLabs 调用)。
- 按原样逐条展示每个报价;多个报价逐条展示,不要自行加总。
- 针对该报价请求同意;仅在同意后提交。计划变更需要新报价和新同意。
- 若返回等待按下的卡片,遵循服务器的卡片规则并等待使用者。
B. 代理数据读取(无价格检查)——一次同意
- 涵盖 gooseworks:data_call_provider / gooseworks:data_post_provider(与 ScrapeCreators)、gooseworks:competitor_research(与 mentions)以及有上限的导入(gooseworks:knowledge_sync、带来源的 gooseworks:knowledge_import、用于 Google 的 gooseworks:ads_library_scrape)。端点路径、查询键与时间范围选项见 proxy-endpoints.md。
- 付费读取用于深化免费结果,绝不是起点。仅在技能手册的免费环节之后提供,并与草稿答案同一消息(见 marketing-guide 技能的 research-pattern.md),只询问一次。
- 读取价格历史:research/credits-log/<YYYY-MM>.md 的当月与上月(范围见 marketing-guide 技能 §2)。
- 规划补充,每行都带上限(每查询页数、每页条数、每帖评论数、每列表档案数),并用通俗语言说明它对免费结果增加了什么。
- 估算并请求一次“最多 N credits”的同意,并标注为估算:有历史时,N 来自这些读取类型的已记录扣费;无历史时,绝不编造价格,说明补充增加什么、大致需要多少次读取,第一次读取会显示真实价格,让使用者在同一次同意中给出上限(“最多多少 credits?”);若未给数字,仅运行探测调用并先报告其价格,再做其他事。首次调用作为该上限内的探测运行——绝不单独同意。
- 工具以其自身单位设定的上限(少数导入工具采用小额美元上限)用语言描述为“小额有上限导入”,之后报告所扣 credits;绝不引用美元数字。
- 在上限内运行。先运行探测调用并保留其结果。若实际每次调用扣费使计划无法容纳,削减计划以适应上限——绝不越过;仅在使用者希望更多时再询问。先运行最便宜且最决定性的行;当某行饱和时停止。依赖先前结果的调用(对搜索找到的帖子取评论)在同一上限内。技能手册可为特定目的保留上限的一部分(research-market 用于其倾听的危机储备)。
- 每次扣费返回时记录到 research/credits-log/<YYYY-MM>.md(范围同步骤 1;读取文件、添加行、写回整个文件):date | playbook | tool/endpoint | query kind | items | credits。“查询类型”描述读取内容(如“品牌名搜索,TikTok,过去一个月”),绝不包含私人姓名或联系方式。
- 到达上限即停止。若下次调用会越过上限,停止。失败调用仅在其错误表明安全时重试一次;错误路径或键记录在案,绝不重复猜测。
- 报告:以通俗语言报告针对上限所扣的 credits。端点细节保留在日志中。
- 若使用者拒绝或削减补充,免费结果保持不变;将付费读取本会添加的内容作为缺口指明(如“未读取:TikTok 评论——补充未获批准”)。
C. 计划运行(自动化)
- 每个自动化都以暂停状态创建。仅当本次对话中获得使用者同意后才启用。
- 同意中指明任何常设的每次运行数据上限(“每次运行最多 N credits”);运行将此上限写入其提示并记录每次扣费。未指明时,计划运行仅使用免费来源,绝不在数据上花费。
- 同事自身运行成本不预先定价:说明这一点,并在首次运行后展示其使用的 credits(gooseworks:automation_list),以便使用者暂停。
- 聊天中给出的同意绝不移交至计划运行,除非其作为常设的每次运行上限给出。
适用场景:营销工作流中涉及付费数据读取、广告/图片/视频生成或自动化计划运行,且需要在消耗 credits 前获得人工批准的场景。
限制:该技能仅依据提供的资料描述流程,未提供具体定价、工具端点细节或平台功能说明;缺失事实暂未提供。