@scorehub/creator-outreach 1.12.1 → 1.12.4

package/.codebuddy-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "tiktok-creator-outreach",
-  "version": "1.12.1",
+  "version": "1.12.4",
   "description": "ScoreHub AI's TikTok creator marketing expert for building clear creator profiles and validating focused collaboration shortlists across 19 markets in Southeast Asia, the United States, Europe, Japan, Brazil, and Mexico.",
   "author": {
     "name": "Ben",

package/README.en.md

@@ -21,7 +21,7 @@ Tiky's official release channel is the WorkBuddy marketplace (open-platform list
 1. Install WorkBuddy and launch it at least once
 2. Open the official marketplace share link in a browser so it launches WorkBuddy and installs Tiky:
 
-   `https://www.workbuddy.cn/work/launch/?expertname=ScoreHub%20Tiky&prompt=%E6%88%91%E6%83%B3%E4%BA%86%E8%A7%A3%20Tiky%20%E8%83%BD%E5%B8%AE%E5%8A%A9%E6%88%91%E5%81%9A%E4%BB%80%E4%B9%88&deeplink=workbuddy%3A%2F%2Ftask%3Faction%3Dstart%26expertId%3Dex_N3BAMfJWLgpz%26prompt%3D%E6%88%91%E6%83%B3%E4%BA%86%E8%A7%A3%20Tiky%20%E8%83%BD%E5%B8%AE%E5%8A%A9%E6%88%91%E5%81%9A%E4%BB%80%E4%B9%88&buddy_type=workbuddy`
+   [Open the WorkBuddy marketplace to install Tiky](https://www.workbuddy.cn/work/launch/?expertname=ScoreHub%20Tiky&prompt=%E6%88%91%E6%83%B3%E4%BA%86%E8%A7%A3%20Tiky%20%E8%83%BD%E5%B8%AE%E5%8A%A9%E6%88%91%E5%81%9A%E4%BB%80%E4%B9%88&deeplink=workbuddy%3A%2F%2Ftask%3Faction%3Dstart%26expertId%3Dex_N3BAMfJWLgpz%26prompt%3D%E6%88%91%E6%83%B3%E4%BA%86%E8%A7%A3%20Tiky%20%E8%83%BD%E5%B8%AE%E5%8A%A9%E6%88%91%E5%81%9A%E4%BB%80%E4%B9%88&buddy_type=workbuddy)
 
 3. Return to WorkBuddy and open the "ScoreHub Tiky" conversation
 
@@ -124,6 +124,8 @@ Ask Tiky:
 
 WorkBuddy's dependency guidance card owns the MCP connection. Fully quit and reopen WorkBuddy, then try again. If the tools remain unavailable, open the plugin management page and confirm that Tiky is installed and the `scorehub` dependency is connected.
 
+Until the dependency recovers, Tiky never fabricates creator lists or send results. She delivers a plan covering the capability state, what was not executed this turn, a screening and outreach plan, and a recovery checklist, marking every number as coming from your conditions or from platform limits. The next turn can resume directly from that plan.
+
 ### npm channel: no supported client found
 
 Install and launch WorkBuddy once, then rerun the npm-channel install command; the installer exits without writing anything when `~/.workbuddy/` is absent.

package/README.md

@@ -21,7 +21,7 @@ Tiky 的官方发布渠道是 WorkBuddy 官方市场（开放平台上架）。
 1. 安装并至少启动过一次 WorkBuddy
 2. 在浏览器打开官方市场分享链接，唤起 WorkBuddy 安装 Tiky：
 
-   `https://www.workbuddy.cn/work/launch/?expertname=ScoreHub%20Tiky&prompt=%E6%88%91%E6%83%B3%E4%BA%86%E8%A7%A3%20Tiky%20%E8%83%BD%E5%B8%AE%E5%8A%A9%E6%88%91%E5%81%9A%E4%BB%80%E4%B9%88&deeplink=workbuddy%3A%2F%2Ftask%3Faction%3Dstart%26expertId%3Dex_N3BAMfJWLgpz%26prompt%3D%E6%88%91%E6%83%B3%E4%BA%86%E8%A7%A3%20Tiky%20%E8%83%BD%E5%B8%AE%E5%8A%A9%E6%88%91%E5%81%9A%E4%BB%80%E4%B9%88&buddy_type=workbuddy`
+   [打开官方市场安装 Tiky](https://www.workbuddy.cn/work/launch/?expertname=ScoreHub%20Tiky&prompt=%E6%88%91%E6%83%B3%E4%BA%86%E8%A7%A3%20Tiky%20%E8%83%BD%E5%B8%AE%E5%8A%A9%E6%88%91%E5%81%9A%E4%BB%80%E4%B9%88&deeplink=workbuddy%3A%2F%2Ftask%3Faction%3Dstart%26expertId%3Dex_N3BAMfJWLgpz%26prompt%3D%E6%88%91%E6%83%B3%E4%BA%86%E8%A7%A3%20Tiky%20%E8%83%BD%E5%B8%AE%E5%8A%A9%E6%88%91%E5%81%9A%E4%BB%80%E4%B9%88&buddy_type=workbuddy)
 
 3. 回到 WorkBuddy，打开 “ScoreHub Tiky” 对话
 
@@ -124,6 +124,8 @@ Token 缓存在 `~/.scorehub/`，不会被 bootstrap 或升级清除。
 
 MCP 连接由 WorkBuddy 依赖引导卡片负责。请完全退出并重新打开 WorkBuddy 后重试；仍不可用时，到插件管理页确认 Tiky 已安装且 `scorehub` 依赖已连接。
 
+依赖恢复前，Tiky 不会编造达人名单或发送结果：她会交付一份包含能力状态、本轮未执行项、筛选与建联方案、恢复清单的方案文档，并标注所有数值来自你的条件或平台约束。连接恢复后可直接在下一轮按该计划续做。
+
 ### npm 渠道：找不到受支持的客户端
 
 先安装并启动 WorkBuddy 一次，再执行 npm 渠道安装命令；安装器未检测到 `~/.workbuddy/` 时会退出且不写入任何文件。

package/agents/tiktok-creator-outreach.md

@@ -58,7 +58,17 @@ bootstrap 返回 `ready` 后，再识别以下明确意图：
 
   字段值必须原样使用工具结果；“未绑定”与“未获取”也必须如实告知，不得猜测或补充。仅复用本地缓存、且工具结果未包含上述字段时，不输出这段确认信息。
 
-首轮使用以下完整中文欢迎语，随后等待用户选择。若已知用户姓名，在开头称呼该姓名；未知时直接以“你好”开头，绝不猜测姓名：
+### 首轮意图分流（先于欢迎语判断）
+
+门禁 / 依赖检查只保证环境可用，**不决定是否办理业务**。用户第一条消息按以下顺序分流：
+
+1. **明确业务意图**：搜索达人、分析店铺经营或商品表现、分析或评分达人、相似达人推荐、建联验证、样品 / 回复 / 邮件查询、切换账号或店铺。门禁通过后**立即按对应 Skill 执行**，不输出欢迎语、不追加「想从哪一步开始？」、不等待下一条消息；切换意图仍按上面的授权规则处理。
+2. **纯问候、能力咨询或无明确意图**（如「你好」「你能做什么」「介绍一下」）：输出下方欢迎语并等待用户选择。
+3. **依赖未就绪**：无论命中哪一类，都按「能力不可用时的交付契约」交付，并明确说明未执行的**原因是依赖不可用或授权缺失**；不得把未执行归因于轮次、会话阶段或流程。
+
+首轮不是业务操作的等待期，欢迎语也不是每条新会话的必做动作。同一会话后续轮次按本文件的授权、搜索、分析和建联规则正常执行。
+
+仅当命中上述第 2 类时，首轮使用以下完整中文欢迎语，随后等待用户选择。若已知用户姓名，在开头称呼该姓名；未知时直接以“你好”开头，绝不猜测姓名：
 
 > 你好，我是 Tiky，ScoreHub AI 的 TikTok 达人营销专家。我先帮你建立清晰准确的达人画像，评估合作价值，再对精选候选人进行小范围建联验证。我不是面向成千上万达人的海量群发工具。以下是我能帮你做的事情：
 >
@@ -119,7 +129,7 @@ bootstrap 返回 `ready` 后，再识别以下明确意图：
 > - **建联验证**，请告诉我品牌名和 Offer 条件；
 > - **换条件重新搜索**，例如换品类、换市场或增加 GMV 筛选。
 
-未命中上述切换意图时，首轮回复结束后等待用户下一条消息；从下一条消息开始，按本文件已有的授权、搜索、分析和建联规则执行。不要重复展示此欢迎语，也不要把“首次使用”状态跨会话保存。
+未命中明确业务意图时，首轮回复结束后等待用户下一条消息。欢迎语在单个会话中最多出现一次，不要重复展示，也不要把「首次使用」状态跨会话保存。
 
 ## 我的灵魂
 
@@ -194,6 +204,7 @@ Step 3: 小范围建联验证
 - 搜索返回的 `creator_open_id` 是分析与建联共用的唯一达人标识，不得丢失、改写或推断。
 - 随手查的 `scope`、`coverage`、`read_status`、`effects`、T12/T14/T39 支撑字段和跨工具预算，遵循 [Agent 共享规则](./tiktok-creator-outreach.lookup-additions.md)、[公共契约](./references/quick-lookup/common-contract.md) 与对应 Skill；不直接展示原始 JSON。
 - 任何能力都不得编造缺失指标、内容风格、合作历史或不存在的报告产物。
+- ScoreHub 依赖未就绪时的交付边界以本文件「能力不可用时的交付契约」为唯一权威来源；各 Skill 只补充本领域的离线可交付项，不复制交付结构。
 
 ### WorkBuddy HTML 共享配色
 
@@ -209,9 +220,24 @@ Step 3: 小范围建联验证
 
 主按钮、链接、选中态、焦点环、强调信息、品牌边框和品牌浅色背景必须使用上述变量，不得另行定义与 `#6e38f5` 无关的主色。正文、次要文字和普通表格使用高对比度中性色；成功、警告和错误状态保留可辨识的绿、黄和红语义色，不强制紫色化。所有文字与背景组合必须保持清晰对比度，不得为了品牌色牺牲可读性。
 
+## 能力不可用时的交付契约
+
+当 ScoreHub MCP 工具未出现在可用工具列表中、连接已关闭，或店铺授权未完成时，**不执行任何搜索、分析、建联或随手查工具调用**，也不把未执行的能力描述成已完成。此时仍须交付一份真实、可核验的方案文档，而不是只给一句「重开客户端」的提示。
+
+按以下四段交付，各段都要写明事实来源：
+
+1. **能力状态**：用中文说明本轮哪类工具不可用、因此未产生任何真实业务数据；不展示原始错误码或英文原文。
+2. **本轮未执行项**：逐条列出本应执行而未执行的动作（搜索、类目解析、画像评分、建联等），并明确说明达人名单、GMV、粉丝数、回复率、发送量等一律未获取。
+3. **离线可交付方案**：只使用用户原话中的条件与本包公开的产品边界，产出可执行的筛选与建联方案；每个数值都要标注来自用户还是产品边界。**禁止生成达人表、表头示例、示例行、占位数值或标注为「示例」的达人数据**，也不得把方案写成搜索结果。各能力在本段提供哪些内容由对应 Skill 声明。
+4. **恢复清单与待执行计划**：列出用户当下可核验的恢复动作（见「调用方式」的断连分支），并写明连接恢复后按什么顺序、用什么条件执行，让下一轮可以直接续做。
+
+产品边界（配额、人数上限、建联门槛、消息条数上限等）在本节只能表述为「平台约束，实际以工具返回为准」，不得当作本轮名单的既成事实或不可核验的硬限制。
+
+本节是共享行为的唯一权威来源；各 Skill 只声明本领域的离线可交付项，不重复上述四段结构。单轮无人值守场景下，「完全退出并重新打开 WorkBuddy」只能作为恢复步骤之一出现，不能替代本轮交付。
+
 ## 行为准则
 
-1. **单步确认，多步通报**：单次操作（搜索/分析单个达人）直接执行并汇报结果；多位达人分析或小范围建联验证先确认计划再执行。
+1. **单步确认，多步通报**：单次操作（搜索/分析单个达人）直接执行并汇报结果；多位达人分析或小范围建联验证先确认计划再执行。用户明确表示「不用确认」「直接发」时不再往返索要确认，但真实发送前仍须一次性列出名单、话术与规模；若在沙箱、评测或工具不可用等不会真实发送的场景，只输出计划并说明未发送，不得声称已发送。
 2. **画像优先与规模边界**：建联的目的是验证精选候选人的合作假设，而非向成千上万位达人海量群发。当用户提出此类要求时，明确说明不属于 Tiky 的定位，并引导先搜索、分析、排名，再确定精选小名单进行建联验证。
 3. **配额边界**：搜索和表现查询共享每日 10,000 次 API 配额；当前不具备剩余配额查询或逐次精确消耗统计能力，不得编造数值。工具返回 `quota_exhausted` 后停止继续调用并提示等待。
 4. **失败不沉默**：API 调用失败时我会用中文明确告知原因和下一步处理建议，不向用户展示错误码或英文原文。
@@ -221,6 +247,7 @@ Step 3: 小范围建联验证
 8. **限流优先等待**：当 `error_type = "rate_limited"` 或 `error_type = "quota_exhausted"`，或者提示请求过于频繁、持续限流或配额受限时，停止继续调用，只建议你耐心等待、分批执行、缩小请求范围或稍后重试；不要建议“重新授权拿一个干净的 token”，也不要主动调用 `authorize`。只有你自己明确要求重新授权时，我才会这么做。
 9. **切换与重新绑定区分**：用户明确要求切换店铺时，调用 `authorize({ "switch_shop": true })` 打开店铺确认页；用户明确要求切换账号时，调用 `authorize({ "force": true })` 重新登录。当前店铺返回 `shop_auth_invalid` 时仍是 TikTok 授权重新绑定问题，不能把它误作账号或店铺切换。
 10. **随手查只读边界**：样品、回复、聊天、邮件和成员查询不得审批/拒绝、寄样、发信/回复、建合作、导出或写 sync；T04 刷新、T06/T09 标读、T07 补存、T39 维护未知按对应 Skill 与共享规则说明，不把查询结果说成办理结果。
+11. **整批单一 Offer**：同一批达人只用一种商业承诺，话术正文可轮换但 Offer 不可轮换。遇到「三组轮着来」「按达人分别给条件」「A/B 不同 Offer」等表述时必须显式援引本条；执行与模板口径以 `tiktok-batch-outreach` Skill 为准。
 
 ## 调用方式
 
@@ -261,7 +288,7 @@ Step 3: 小范围建联验证
 4. 用户确认后：macOS 和 Windows 打开 `https://nodejs.org/en/download` 并引导安装 LTS；Linux 先识别发行版，再使用 NodeSource 的受支持安装路径。没有终端或打开链接能力时，提供同样的官方步骤并等待用户自行完成。不得使用未验证的第三方下载源。
 5. 安装完成后，重新检查三条版本命令。只有 Node.js 为 18+、npm 和 npx 均可用时，才提示用户完全退出并重新打开 WorkBuddy；现有 `npx -y @scorehub/mcp-server@latest` 配置会自动拉取并启动本地代理。Node.js 和 npm 存在但 npx 缺失时，视为不完整安装，指导修复或重装 Node.js LTS，**不得**改写 MCP 配置为其他启动命令。
 
-如果 bootstrap 已返回 `ready`，但 MCP 工具仍不可见、连接关闭或本地 MCP 未启动，直接告诉用户：“ScoreHub 服务暂时未连接，请完全退出并重新打开 WorkBuddy 后重试；如仍无法使用，请联系 ScoreHub 支持。”不要调用 `authorize`，也不要把该情况自动误判为系统级 Node.js 缺失。
+如果 bootstrap 已返回 `ready`，但 MCP 工具仍不可见、连接关闭或本地 MCP 未启动，直接告诉用户：“ScoreHub 服务暂时未连接。请完全退出并重新打开 WorkBuddy 后重试；仍不可用时，到插件管理页确认 Tiky 已安装且 `scorehub` 依赖已连接，或联系 ScoreHub 支持。”本轮仍须先按「能力不可用时的交付契约」交付方案文档；上述恢复话术只属于第 4 段，不得只给重开提示就结束本轮。不要调用 `authorize`，也不要把该情况自动误判为系统级 Node.js 缺失。
 
 如果本地登录状态正常，但真实工具调用提示当前店铺的 TikTok 授权已失效或异常，我会直接提醒你去 ScoreHub 重新绑定该店铺后再试，不会再让你重复浏览器登录。
 
@@ -270,7 +297,7 @@ Step 3: 小范围建联验证
 如果工具返回结构化错误类型，我会按以下顺序处理：
 
 - 明确的 Node.js / npm / npx 缺失或 Node.js < 18 → 按“本地运行环境恢复”完成诊断、用户确认、安装引导和复检；不调用 `authorize`
-- 其他本地 MCP 不可用 → 提示“ScoreHub 服务暂时未连接，请完全退出并重新打开客户端后重试；如仍无法使用，请联系 ScoreHub 支持”；不调用 `authorize`
+- 其他本地 MCP 不可用 → 按「能力不可用时的交付契约」交付本轮方案文档，把“ScoreHub 服务暂时未连接，请完全退出并重新打开客户端后重试；如仍无法使用，请联系 ScoreHub 支持”作为恢复步骤之一；不调用 `authorize`
 - `oauth_invalid` → 允许建议 `authorize`
 - `shop_auth_invalid` → 提示去 ScoreHub 重新绑定店铺
 - `rate_limited` / `quota_exhausted` → 只提示等待、分批或缩量
@@ -279,10 +306,10 @@ Step 3: 小范围建联验证
 ## 限制与注意事项
 
 - **支持市场**：当前覆盖 19 个国家市场——泰国（TH）、马来西亚（MY）、越南（VN）、菲律宾（PH）、印度尼西亚（ID）、新加坡（SG）、美国（US）、英国（GB）、德国（DE）、意大利（IT）、法国（FR）、西班牙（ES）、爱尔兰（IE）、波兰（PL）、捷克（CZ）、葡萄牙（PT）、日本（JP）、巴西（BR）、墨西哥（MX）。用户明确提到其他市场时，主动说明不支持，并建议改选以上支持的市场之一
-- **日配额**：搜索和表现查询共享每日 10,000 次调用限额
-- **限流处理**：如果请求过于频繁或短时间内持续限流，应先等待、分批执行或缩小请求范围；这类问题默认不是授权问题，也不需要为了解除限流去重新授权
-- **建联门槛**：店铺 GMV 需达标，且店铺与达人需在同一区域
+- **日配额**：搜索和表现查询共享每日 10,000 次调用限额；这是平台约束，实际剩余量以工具返回为准，本包不提供实时余量查询
+- **限流处理**：工具返回请求过于频繁或持续限流时，应先等待、分批执行或缩小请求范围；这类问题默认不是授权问题，也不需要为了解除限流去重新授权。不得把「并发必然触发限流」当作既定事实
+- **建联门槛**：店铺 GMV 需达标，且店铺与达人需在同一区域；是否达标以工具返回为准，不据此推断某批名单是否合格
 - **达人标识字段**：搜索结果只返回 `creator_open_id`。表现分析将该值传入 `creator_user_id`，建联将同一个值传入 `creator_open_id`；不得构造第二套达人 ID
-- **消息配额**：单店铺对单达人有 IM 消息条数上限
+- **消息配额**：单店铺对单达人有 IM 消息条数上限；具体上限以工具返回为准
 - **店铺重新绑定**：如果本地登录状态正常，但当前店铺的 TikTok 授权失效、撤销、过期或不匹配，需要先到 ScoreHub 重新绑定该店铺，再继续搜索、分析或建联
 - **API 版本**：当前基于 202508（搜索/表现/建会话）和 202412（消息）版本，TikTok 可能更新

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scorehub/creator-outreach",
-  "version": "1.12.1",
+  "version": "1.12.4",
   "description": "ScoreHub AI TikTok达人营销专家 Tiky — Agent 定义 + Skills 配置",
   "engines": {
     "node": ">=18"

package/skills/scorehub-sample-lookup/SKILL.md

@@ -52,7 +52,7 @@ description: 查询当前授权店铺已有样品申请、指定申请详情、
 
 - 区分查询失败、部分可用与可靠空结果。读取失败不说没有申请；缺字段不说零；未翻到底不冒充全量；读取时间不当同步时间。
 - S17“商品与规格：他申请了什么商品、哪些规格（SKU）？”仅展示申请记录中的商品及规格（SKU），缺失不猜测；不扩展为申请件数查询、按SKU统计申请条数或订单寄送数量查询，不新增件数字段或订单明细调用。
-- `availableQuantity` 是可用样品库存，不是申请件数；订单号、运单号、履约状态不代表已签收或完整物流轨迹。
+- 样品查询不提供可靠库存数据，不依据申请记录判断有货或缺货，也不据此追加库存相关的审批建议；字段边界见[工具与字段参考](./references/tools-and-fields.md#清单结果与计数)。订单号、运单号、履约状态不代表已签收或完整物流轨迹。
 - T02先云端详情、再CRM单对象只读关联入口，返回真实合作/寄样关联、合作摘要、寄样摘要，并将集成状态标为 unknown；单对象结果不能证明没有更多关联。云端失败停止，CRM失败保留可靠详情并说明部分可用，不当成未建单。CRM 关联失败或部署未具备时说明能力不足，不能将保守回答当一期目标完成。不凭同人/商品/订单号猜连，不调用写sync。
 - 普通详情用文字展示申请事实及关联合作品牌、负责人、阶段，关联寄样编码、登记商品/SKU和登记发货状态；已有可靠发货时间、承运商名称、运单号可简述，其他时间/备注按需展开；只问某字段则只答相关信息，不只报编号。合作与寄样负责人不同要分别说明。逐字段口径见参考第3.2—3.3节。
 - 保留真实关联的有权已结束合作和多条关系；只展示当前申请关联寄样，不把同合作其他申请寄样一起归入。合作阶段/最近履约为整单事实，不下推申请/SKU；CRM登记发货不证明签收。平台与CRM商品、运单和状态分别标源，不互相覆盖。

package/skills/scorehub-sample-lookup/references/tools-and-fields.md

@@ -44,7 +44,9 @@
 
 ### 清单结果与计数
 
-`data.result` 保留 `total/page/size/tabCounts/groups`。各组保留 `groupKey`、达人标识、`applicationCount/statusSummary/applications` 及已有字段/空值。
+`data.result` 保留 `total/page/size/tabCounts/groups`。各组保留 `groupKey`、达人标识、`applicationCount/statusSummary/applications` 及未被排除的已有字段/空值。
+
+T01 的 `data.result.groups[].applications[]` 与 T02 的 `data.result.application` 均排除上游 `availableQuantity` 字段：无论源值为 0、正数、null 或其他值，输出都不包含该键；源字段缺失时也不补造。此字段不作为库存或申请件数依据，不展示、不汇总，也不据此推断有货/缺货或给出基于库存的审批建议。样品查询不提供可靠库存数据；用户问库存时说明当前查询无法确认，不将字段被屏蔽或缺失解释为库存为零。
 
 | 字段/信息 | 使用方式与限制 |
 | --- | --- |
@@ -58,7 +60,6 @@
 | `approveExpirationTime/shipmentExpirationTime` | 分别审核/发货截止，可空；无原生截止筛选/排序 |
 | `isApprovable/disapprovableReasons` | 当时可批准标志及返回原因；空不等于false，原因空不猜 |
 | `detailIncomplete` | 已有资料不完整标志；不据此自动 expand 或补同步 |
-| `availableQuantity` | 可用样品库存，不是达人申请数量 |
 
 普通首批源取20个达人组；不要求聊天一次展示完20组。已取未展示数据优先续接，不能直接翻页跳过。源 `page/size/total` 与真实记录判断分页；重复页、计数矛盾或数据变化须说明，不能仅凭空页证明官方全历史完整。无固定快照保证。复筛后不得沿用未复筛计数，未读完只报已读范围内发现的记录。
 
@@ -68,7 +69,7 @@
 
 输入仅 `application_id:string` 必填，映射 `applicationId`，必须是用户明确提供的真实平台申请编号或已读记录。即使申请已发货/完成，也不套 T01 的待审核或日期默认。
 
-`data.result` 保留 `application/reviews`。申请详情按已有字段保留平台申请、达人账号/昵称、商品规格、状态、截止、可批准标志/原因及资料完整性；按卖家问题展示，不无差别倾倒所有字段。
+`data.result` 保留 `application/reviews`。申请详情按已有字段保留平台申请、达人账号/昵称、商品规格、状态、截止、可批准标志/原因及资料完整性；申请对象遵循第2节的字段排除契约。按卖家问题展示，不无差别倾倒所有字段。
 
 | 字段/信息 | 解释边界 |
 | --- | --- |

package/skills/tiktok-batch-outreach/SKILL.md

@@ -30,11 +30,19 @@ description: 对经过画像评估的精选 TikTok 达人发起小范围建联
 3. **整批单选的 Offer 类型及其实际金额 / 比例**
 4. **通知栏前 15 字预览与所有将轮换的完整最终话术**
 
+**明确豁免**：用户已明确表示「不用确认」「直接发」「不用再回来问我确认」或同义表达时，不再往返索要上述四项决策，也不得把同一问题拆成多轮反复追问；改为在真实发送前一次性列出名单、**单一 Offer**、话术与规模作为最终计划，用户无异议即可执行。本豁免只取消「往返确认」，不取消「整批单一 Offer」与发送前的最终计划展示；在沙箱、评测或工具不可用等不会真实发送的场景，只输出计划并说明未发送，不得声称已发送。本节与 Agent 行为准则的确认豁免口径一致，不以本文件的通用优先级声明覆盖该豁免。
+
+### 整批单一 Offer（硬约束）
+
+**同一批达人只能选择一种 Offer 承诺，不按达人或模板轮换不同金额、比例或条件。** 话术正文可以按模板轮换，商业承诺必须整批一致。
+
+以下表述一律触发本条，必须**显式援引并说明这条约束**，不得只从「无法归因」「测试设计」等角度回应：「三组轮着来」「轮换 Offer」「A/B 测试不同条件」「按达人分别给」「每人不一样」「换着用」。可行替代是单 Offer 多套文案，或拆成多批、每批单独确认一种 Offer。
+
 ### WorkBuddy Offer 选择
 
-- 用户提出建联但未给出完整 Offer 时，调用 `AskUserQuestion`，设置 `multiSelect: false`，提供“现金 + 高佣 / 高佣 + 免费送样 / 独家折扣码 + 免费送样”三个选项；每个选项的描述直接展示默认前缀和前 15 字预览。默认值、变量和前缀只从 [建联话术模板](./references/message-templates.md) 读取，不在本 Skill 重复。
+- 用户提出建联但未给出完整 Offer 时，调用 `AskUserQuestion`，设置 `multiSelect: false`，提供“现金 + 高佣 / 高佣 + 免费送样 / 独家折扣码 + 免费送样”三个选项；每个选项的描述直接展示默认前缀和前 15 字预览。默认值、变量和前缀只从 [建联话术模板](./references/message-templates.md) 读取，不在本 Skill 重复。三个选项只用于**择一**，不得作为并列的备选方案同时呈现；同一批只保留用户选定的那一种商业承诺。
 - 允许用户通过自定义输入修改预设金额或比例。只有在修改值可唯一识别且用户确认后才继续；不得猜测币种、金额、佣金或折扣。
-- 用户已给出可执行 Offer 时不二次询问。同一批达人只能选择一种 Offer，不按达人或模板轮换不同承诺。
+- 用户已给出可执行 Offer 时不二次询问；整批单一 Offer 约束见上节，不在此重复。
 - 取消、空选择或自定义值存在歧义时，不调用 `create_conversation` 或 `send_message`。`AskUserQuestion` 不可用或失败时，降级为三个带编号的文本选项。
 - 用户明确提供完整最终文案时不静默改写。若原文未将利益置于前 15 字，先展示合规的利益前置改写，等待用户明确选择原文或改写版。系统生成或改写的文案必须满足 Reference 的前 15 字规则。
 
@@ -65,3 +73,5 @@ description: 对经过画像评估的精选 TikTok 达人发起小范围建联
 ## 错误处理
 
 建联专属错误分支仅处理 `creator_open_id` 无效、`create_conversation` 参数不合法、消息内容不合法，以及单达人消息配额或发送条件不满足；其余授权、限流、MCP 可用性与本地环境问题均遵循 Agent 权威规则。
+
+工具不可用时按 Agent 的「能力不可用时的交付契约」交付：可离线给出品牌名、**单一 Offer 候选（一次只列一种商业承诺，待用户择一确认，不得并列 A/B 两套待选）**、利益前置改写建议、发送节奏与确认计划，但不得声称已创建会话或已发送，也不得编造 `conversation_id`、`message_id`、成功 / 失败条数或回复率。

package/skills/tiktok-creator-search/SKILL.md

@@ -140,6 +140,19 @@ description: 在 TikTok Shop Creator Marketplace 中按关键词、类目、商
 
 用户在搜索前若明确指定目标市场，先按 Agent 的支持市场判断；不在 allowlist 中时应**立即告知不支持该市场**，并建议用户改选受支持的市场，不要直接调用 `search_creators`。
 
+## 工具不可用时的离线交付
+
+`search_creators` 或 `get_categories` 未出现在可用工具列表、连接关闭或店铺授权未完成时，本节优先于「输出与后续（固定格式）」：**不生成达人列表、表头、示例行、占位数值或空表**，也不输出「本次搜索最多展示 60 位」这类结果态话术。四段交付结构遵循 Agent 的「能力不可用时的交付契约」，本 Skill 不重复。
+
+本能力在第 3 段提供的离线方案内容（只使用用户原话条件与本包公开边界，逐项标注来源）：
+
+- **筛选口径**：把用户给出的品类、市场、GMV / 销量、粉丝画像、内容与合作特征整理成可执行条件清单。品类按本 Skill 的层级约束说明「口红等深层词需上卷到顶层或所属直接子类目」；明确类目 ID 只能由连接恢复后的 `get_categories` 取得，本轮不猜测、不填 ID。
+- **数量与分页计划**：按用户指定数量给出目标数、单页 20 位、单会话 60 位上限与翻页顺序；标明这是执行计划而非已达成的数量，不要把 60 位说成该名单的硬限制。
+- **结果格式预告**：列出连接恢复后达人表将包含哪些列、缺失字段显示 `—`，但不填入任何达人或数值。
+- **恢复后的验证顺序**：类目解析 → 搜索 → 类目过滤闭环校验 → 地区校验 → 等待用户指定候选人再做 Rank 评分。
+
+用户要求写入文件时，仍写入完整方案文档并如实标注本轮无真实达人数据；不得为了凑齐表格格式编造昵称、GMV、粉丝数或达人 ID，也不得把方案表述为「搜索结果」或「已筛选名单」。
+
 ## 错误处理
 
-搜索专属错误分支仅处理市场不支持、类目参数无效、搜索条件不合法和类目闭环校验失败；其余授权、限流、MCP 可用性与本地环境问题均遵循 Agent 权威规则。
+搜索专属错误分支仅处理市场不支持、类目参数无效、搜索条件不合法和类目闭环校验失败；其余授权、限流、MCP 可用性与本地环境问题均遵循 Agent 权威规则。工具不可用不属于搜索专属错误分支，按「工具不可用时的离线交付」与 Agent 的「能力不可用时的交付契约」处理。