@scorehub/creator-outreach 1.3.2 → 1.3.3

package/.codebuddy-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "tiktok-creator-outreach",
-  "version": "1.3.2",
+  "version": "1.3.3",
   "description": "ScoreHub AI's TikTok creator marketing expert for building clear creator profiles and validating focused collaboration shortlists across Southeast Asia.",
   "author": {
     "name": "Ben",

package/package.json

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

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

@@ -25,19 +25,19 @@ description: 获取 TikTok 达人近 30 天表现数据，按候选集相对评
 
 ### 输出（固定格式）
 
-禁止直接展示 MCP 原始 JSON，也不得复述候选人来源搜索的市场、类目、GMV、关键词、粉丝画像或目标人数等条件。评分是候选集内归一化后的**相对分**，按以下两种情况输出：
+禁止直接展示 MCP 原始 JSON，也不得在摘要或报告头部复述候选人来源搜索的市场、类目、GMV、关键词、粉丝画像或目标人数等完整条件。推荐理由可引用与单个达人决策直接相关的简短目标，但不得借此重建完整搜索条件。评分是候选集内归一化后的**相对分**，按以下两种情况输出：
 
 #### 单个达人
 
 - 不输出综合分或五维相对分，避免单元素归一化造成虚高分数。
-- 固定展示：达人身份、近 30 天 GMV/销量、直播和视频表现、粉丝数与画像、品类分布、标签、数据缺口、优势/风险、合作建议。
+- 固定展示：达人身份、近 30 天 GMV/销量、直播和视频表现、粉丝数与画像、品类分布、标签、数据缺口、优势/风险、合作判断、推荐理由与合作建议。
 - 明确说明：“当前仅有 1 位达人，无法生成有意义的相对评分；至少需要 2 位候选人才可评分排名。”
 
 #### 两个及以上达人
 
 1. **评分摘要**：成功分析数、失败数、评分对象范围和相对评分说明；不展示原搜索条件。
-2. **排行榜**：固定展示“排名 / 达人 / 综合分 / 带货能力 / 内容影响力 / 粉丝规模 / 品类匹配 / 粉丝质量 / 标签”。
-3. **达人详情**：逐人展示关键原始指标、优势/风险、数据缺口、合作建议，以及从搜索上下文保留的标识。
+2. **排行榜**：固定展示“排名 / 达人 / 综合分 / 带货能力 / 内容影响力 / 粉丝规模 / 品类匹配 / 粉丝质量 / 标签 / 推荐结论 / 推荐理由”。推荐理由使用评分模型规定的一句话短理由。
+3. **达人详情**：逐人展示关键原始指标、优势/风险、数据缺口、推荐结论、两条推荐依据、主要风险、建议动作，以及从搜索上下文保留的标识。
 4. **失败名单**：部分分析失败时单列达人和用户可理解的原因，不得把失败值作为 0 分参与排序。
 5. **下一步**：建议选择达人建联、补充候选人或调整筛选，不自动发送消息。
 
@@ -47,14 +47,14 @@ description: 获取 TikTok 达人近 30 天表现数据，按候选集相对评
 - 分数均按评分模型取整并以 `/100` 展示；品类数据未授权或维度无法计算时显示 `—` 和原因，不用无说明的 0 分掩盖缺口。
 - 必须保留搜索结果中的 `creator_open_id`。`creator_performance` 不返回该 ID，只能从当前对话中的搜索结果透传，不能猜测或推断。
 - 无法关联 `creator_open_id` 时显示“达人 ID 不可用”，并说明该达人暂不能分析或建联；Markdown 中弱化为详情末项，HTML 中放入可展开复制区域。
-- 建议必须由实际指标、维度分、相对排名和数据缺口支撑，不得编造内容风格、合作历史或转化表现。
+- 推荐结论、理由和建议必须由用户目标、实际指标、维度分、相对排名和数据缺口支撑，不得编造内容风格、合作历史或转化表现。结论分级、目标覆盖、证据选择和单达人合作判断遵循评分模型 Reference。
 
 ### WorkBuddy HTML 可视化
 
 - HTML 报告的共享品牌配色遵循 Agent 的“WorkBuddy HTML 共享配色”契约，本 Skill 不自行定义另一套主色或色阶。
 - 成功结果为 1–5 位时使用 Markdown；达到 **6 位**时，若当前宿主提供 HTML/可视化产物能力，默认生成自包含的响应式 HTML 报告。用户明确要求 HTML 时不受人数限制。
 - 宿主不支持 HTML，或 HTML 生成失败时，必须回退为包含完整排行榜、详情和失败名单的 Markdown。
-- HTML 评分报告必须包含：不含原搜索条件的评分摘要、可排序排行榜、五维分数、达人详情、数据缺口、合作建议和弱化的达人 ID 复制区域。
+- HTML 评分报告必须包含：不含完整原搜索条件的评分摘要、可排序排行榜、五维分数、推荐结论、一句话推荐理由、达人详情证据链、数据缺口、合作建议和弱化的达人 ID 复制区域。
 - 只使用内联 CSS/JavaScript，不依赖 CDN、远程字体或外部图片；只实现真实可用的搜索、排序、展开和复制交互，不添加无法触发 Agent 或 MCP 操作的伪按钮。
 - 昵称、用户名、标签及所有工具返回文本写入 HTML 前必须转义；禁止把工具内容作为 HTML 或脚本执行。
 - 生成 HTML 后仍需在对话中给出成功/失败数量、前三名和数据完整性的简短摘要。只有实际生成产物时才可声明存在 HTML，不得虚构文件名或 `outputs` 路径。

package/skills/tiktok-creator-analysis/references/scoring-model.md

@@ -47,6 +47,55 @@
 | 📢大V / 🎤腰部 / 🌱尾部达人 | 粉丝数 >50K / 10K–50K / <10K |
 | 🔴直播型 / 🟣混合型 / 🟢视频型 | 直播 GMV 占比 >0.8 / >0.5 / 其他 |
 
+## 推荐结论与理由
+
+推荐结论解释的是**当前候选集内的合作优先级**，不是对达人能力的绝对评级。理由只能使用用户本轮目标、原始指标、五维分、相对排名、标签和已标注的数据缺口，不得根据昵称、简介或常识补写内容风格、合作历史、转化表现等未返回事实。
+
+### 多达人结论
+
+成功评分数 `n >= 2` 时，先按综合分排序结果计算排名百分位 `p = (rank - 1) / (n - 1)`：
+
+| 条件 | 基础结论 |
+|------|---------|
+| `p <= 0.30` | 优先推荐 |
+| `0.30 < p <= 0.70` | 值得测试 |
+| `p > 0.70` | 谨慎考虑 |
+
+再按以下优先级覆盖基础结论：
+
+1. **明确不匹配 → 本轮不推荐**：仅当用户给出可由现有字段直接验证的核心目标，且已授权、口径和层级一致的数据明确未达到目标时使用。可验证目标限于：同层级目标类目没有交集；用户明确给出的性别、年龄、直播或视频指标下限未达到。不得因综合分或单一维度排名靠后直接输出“本轮不推荐”。
+2. **核心数据缺失 → 谨慎考虑**：目标类目缺 `category_gmv_distribution`，目标性别缺 `follower_gender`，目标年龄缺 `follower_age`，直播目标缺直播观看或互动字段，视频目标缺视频播放或互动字段时，结论最高为“谨慎考虑”。不同类目层级无法可靠比较时也按数据缺失处理，不得判为不匹配。
+3. 其他情况保留排名百分位对应的基础结论。多个目标同时存在时，“明确不匹配”优先于“核心数据缺失”。无法由现有字段验证的目标不参与结论覆盖，只能在风险中说明仍需建联验证。
+
+### 证据选择
+
+按以下顺序生成理由，避免只复述综合分：
+
+1. 优先选择与用户明确目标直接相关且可验证的匹配证据；只引用与当前达人有关的目标短语，不复述完整搜索条件。
+2. 再从带货能力、内容影响力、粉丝规模、品类匹配和粉丝质量中选择最有区分度的优势；优先引用维度分及该维度相对名次，并用一个原始指标补充依据。
+3. 风险按“明确目标不匹配 → 目标所需数据缺失 → 其他数据缺口 → 最弱维度”的顺序选择。缺失值必须明确写出，不能当作真实低表现。
+4. 榜单短理由使用一条完整句，包含一至两项核心证据，并在存在关键风险或缺口时用后半句指出；控制在 60 个中文字符以内。示例：`品类匹配 88，带货能力位列本组第 2；直播互动数据缺失，建议先小范围验证。`
+
+### 详情证据链
+
+每位达人详情固定包含：
+
+1. **推荐结论**：结论及适合优先验证的合作方向；只有直播或视频相关原始数据能够支撑时，才可指定对应内容形式，否则使用通用的“小范围合作验证”。
+2. **推荐依据**：两条最有区分度的证据，每条包含维度分或相对名次，并尽量附一个原始指标。
+3. **主要风险**：一条明确不匹配、数据缺口或最弱维度；若没有明显风险，写明“当前数据未发现突出短板”，不得虚构风险。
+4. **建议动作**：优先建联验证合作意愿、报价和档期；只有用户已给出 Offer 或合作形式时才引用该条件，不替用户承诺新的金额、佣金或合作权益。
+
+### 单达人结论
+
+单达人不使用排名百分位、综合分或五维相对分。按以下优先级给出合作判断：
+
+1. 可验证的核心目标明确不匹配 → `暂不推荐`。
+2. 核心目标所需字段缺失或层级不可比 → `信息不足，暂缓推荐`。
+3. 可验证的核心目标匹配 → `值得进一步验证`。
+4. 用户未提供可验证目标 → `需加入更多候选后判断优先级`。
+
+单达人仍展示原始指标、标签、数据缺口、优势/风险与建议动作，但不得用单元素归一化结果作为推荐依据。
+
 ## MCP 字段映射说明（重要）
 
 MCP 工具 `creator_performance` 直接透传 TikTok 详情接口的原始 JSON 响应（见官方 API 文档 `Get Marketplace Creator Performance`）。