@optima-chat/optima-agent 0.8.98 → 0.8.100

package/.claude/skills/kol-outreach/SKILL.md

@@ -1,371 +1,232 @@
 ---
 name: kol-outreach
-description: "KOL 建联全自动化：从 TikTok 发现潜在 KOL、提取 bio email、发送个性化 outreach、自动谈判价格与条款。当用户说'帮我找 KOL'、'{产品} KOL 建联'、'KOL 进展如何'，或收到系统触发的 [KOL_INBOUND:...] 或 [KOL_INBOUND] 标记时，使用此 skill。"
+description: |
+  KOL outreach automation: discover TikTok KOLs, extract emails, send personalized outreach, handle replies, negotiate deals.
+  Trigger: user says '帮我找 KOL', 'KOL 建联', 'KOL 进展', or message contains [KOL_INBOUND:{campaignId}] / [KOL_INBOUND].
 ---
 
-# KOL Outreach Skill
+# KOL 建联
 
-本 skill 帮助商家在 TikTok 上端到端完成 KOL 建联：发现 → 触达 → 谈判 →
-意向交付，运行时零打扰，所有决策参数在首次 onboarding 时固化。
+端到端 TikTok KOL 建联自动化：发现、触达、谈判、成交。
 
-## 核心工作目录
+## 核心：~/kol-outreach/ 工作目录
 
-所有状态都在 `~/kol-outreach/`，整个目录是一个 git repo。结构：
+所有状态都在 `~/kol-outreach/`（单个 git repo）。每次会话只做一件事。
 
-```
-~/kol-outreach/
-├── BRAND.md                # 商家品牌素材（跨 campaign）
-├── MERCHANT_LIMITS.md      # 跨 campaign 发信速率
-├── CAMPAIGNS.md            # campaign 索引
-├── PROGRESS.md             # 商家级里程碑日志
-└── campaigns/{campaignId}/
-    ├── CONFIG.md           # 本 campaign 的商品/预算/条款
-    ├── KOLS.md             # 本 campaign 的 KOL 索引
-    ├── TEMPLATES.md        # 邮件模板（4 类）
-    ├── PROGRESS.md         # 本 campaign 的事件日志
-    ├── CONVERSATIONS/{username}.md  # 每个 KOL 的对话历史
-    └── assets/             # 商品图/素材
-```
-
-## 每次 session 的启动流程
-
-按顺序执行这些检查，决定本次 session 的动作：
-
-1. **检测系统触发**：用户消息是否包含 `[KOL_INBOUND:{campaignId}]` 或 `[KOL_INBOUND]`（无 campaignId）标记？
-   - 是 → 走「KOL 回信处理」流程（见下）
-   - 否 → 继续步骤 2
-2. **检测首次使用**：`ls ~/kol-outreach/BRAND.md` 是否存在？
-   - 不存在 → 走「Merchant onboarding」→ 接着走「Campaign onboarding」
-   - 存在 → 继续步骤 3
-3. **根据用户意图**分流：
-   - 用户说"给 {新产品} 建联" → 走「Campaign onboarding」创建新 campaign
-   - 用户说"开始建联 {campaign}" / "发送 outreach" → 走「发现 + 首发 outreach」
-   - 用户说"KOL 进展" / "查看状态" → 走「查询进度」
-
-**单会话单任务原则**：每次 session 只执行一种操作，完成后 git commit 并
-更新 PROGRESS.md。出错时可以精准回滚。
-
----
+**每次会话启动**：
 
-## 流程 A：Merchant onboarding（只发生一次）
+1. 检查 `~/kol-outreach/BRAND.md` 是否存在且已完整填写 — 不存在或未完成则走初始化
+2. 读 `CAMPAIGNS.md` — 了解所有 campaign 状态
+3. `git -C ~/kol-outreach log --oneline -5` — 最近变更
+4. 根据用户意图 + 文件状态决定本次操作
+
+| 文件 | 层级 | 用途 |
+|------|------|------|
+| `BRAND.md` | merchant | 品牌素材、兜底话术、升级关键词 |
+| `MERCHANT_LIMITS.md` | merchant | 日发信配额（跨 campaign 共享） |
+| `CAMPAIGNS.md` | merchant | campaign 索引 |
+| `PROGRESS.md` | merchant | 跨 campaign 关键事件 |
+| `campaigns/{id}/CONFIG.md` | campaign | 商品、预算、条款、运行参数 |
+| `campaigns/{id}/KOLS.md` | campaign | KOL 状态索引（status: `pending_outreach` / `awaiting_reply` / `in_progress` / `deal_reached` / `needs_merchant_followup` / `rejected` / `expired` / `send_error` / `no_contact`） |
+| `campaigns/{id}/TEMPLATES.md` | campaign | 邮件模板（LLM 只填变量） |
+| `campaigns/{id}/PROGRESS.md` | campaign | 本 campaign 事件日志 |
+| `campaigns/{id}/CONVERSATIONS/{username}.md` | campaign | 每个 KOL 的完整对话 |
 
-1. 创建工作目录：
+## Session 路由
 
-   ```bash
-   mkdir -p ~/kol-outreach/campaigns
-   cp -r $CLAUDE_SKILL_DIR/template/merchant/. ~/kol-outreach/
-   cd ~/kol-outreach && git init && git add -A && git commit -m "init merchant workspace"
-   ```
-
-2. 会话式填 `BRAND.md`：
-   - 询问 brand_name
-   - 从 brand_name 生成 brand_slug 建议（kebab-case）
-   - 调 `scout outreach brand-slug check {slug}` 验证唯一性
-     - 可用 → 确认
-     - 被占用 → 使用 API 返回的 suggestions 让商家选或自己改
-   - 成功后调 `scout outreach brand-slug claim` 锁定
-   - 依次询问 brand_website / brand_social / default_contact_name / default_brand_pitch
-   - 给出默认的兜底话术模板，让商家确认或改
-   - 给出默认的双语 escalation_keywords，让商家确认或扩展
-   - Edit `BRAND.md`
-   - `git add BRAND.md && git commit -m "setup BRAND.md"`
-
-3. 会话式填 `MERCHANT_LIMITS.md`：
-   - 默认 `max_daily_sends: 50`，询问商家是否调整
-   - 初始化 `sent_today: 0`，`date_utc: $(date -u +%Y-%m-%d)`
-   - `git commit -m "setup MERCHANT_LIMITS.md"`
+按优先级依次判断：
+
+| 条件 | 流程 |
+|------|------|
+| 消息含 `[KOL_INBOUND:{campaignId}]` 或 `[KOL_INBOUND]` | → 回信处理 |
+| `~/kol-outreach/BRAND.md` 不存在 | → 商家初始化 → 创建 Campaign |
+| 用户提到了新商品 + 该商品无对应 campaign | → 创建 Campaign |
+| 用户要求发送 outreach / 开始建联 | → 发现 + Outreach |
+| 用户问进展 / 状态 / 数据 | → 查询进度 |
+
+**Campaign 定位**：用户指定了 campaign 用指定值；未指定时读 `CAMPAIGNS.md`——只有一个 active 就用它，多个则列出让商家选。
+
+## 商家初始化
+
+只在 `~/kol-outreach/BRAND.md` 不存在或未完整填写时执行。
+
+1. `cp -r $CLAUDE_SKILL_DIR/template/merchant/. ~/kol-outreach/` 并 `git init`
+2. 对话式填写 `BRAND.md`：
+   - `brand_name` → 生成 `brand_slug` 建议 → `scout outreach brand-slug check` 验证全局唯一 → 冲突则换 → `scout outreach brand-slug claim` 锁定
+   - 填完品牌基础、兜底话术、升级关键词（中英双语必填）、禁用词
+3. 填写 `MERCHANT_LIMITS.md`（默认 `max_daily_sends: 50`）
+4. `git add -A && git commit -m "merchant onboarding complete"`
+5. 继续创建第一个 campaign
+
+## 创建 Campaign
+
+1. 确定 `campaignId`：从商品标题生成 kebab-case slug，校验唯一且匹配 `^[a-z0-9][a-z0-9-]{0,29}$`
+2. `cp -r $CLAUDE_SKILL_DIR/template/campaign/. ~/kol-outreach/campaigns/{campaignId}/`
+3. 对话式填写 `CONFIG.md`，**逐段确认**：
+   - 商品信息 → KOL 画像 → 预算报价 → 合作条款 → 运行参数
+   - 预算校验：`max_price >= target_price >= first_offer`，`max_step <= max_price - first_offer`，`total_budget >= max_price`
+   - 不通过则说明原因、给建议、重新问（不退出）
+4. 更新 `CAMPAIGNS.md` 追加新行
+5. `git add -A && git commit -m "[{campaignId}] campaign ready"`
+6. 问商家是否立即开始发现 KOL
+
+## 发现 KOL + 首发 Outreach
+
+**前置检查**（任一不过则告知商家并退出）：
+- campaign 状态为 `active`
+- 本 campaign 在谈 KOL 数（`awaiting_reply` + `in_progress`）< `max_concurrent_kols`
+- merchant 今日发信数（`MERCHANT_LIMITS.md`）< `max_daily_sends`
+  - UTC 跨天时先归档昨天计数、重置 `sent_today=0`
+
+**发现**：
+
+1. `scout tiktok creators --follower-count <range> --country <region> --limit <N> --format json`
+2. 过滤：`engagement < 2%` 丢弃、已在 `KOLS.md` 丢弃、粉丝量不在区间丢弃
+3. 对每个候选：`scout tiktok creator-products @username --limit 5`，从 bio 提取 email
+4. 写入 `KOLS.md`：有 email → `pending_outreach`，无 email → `no_contact`
+5. `git commit -m "[{campaignId}] discovered N KOLs"`
+
+**Outreach**：
+
+对每个 `pending_outreach` KOL（不超过本轮发送量）：
+
+1. 读 `TEMPLATES.md` 的 `first_outreach_v1`
+2. 产出模板变量 JSON（`kol_first_name`, `opener_line`, `fit_reason`, `product_one_liner`）
+3. 渲染模板 → 终检（见「护栏」Layer 4）→ `scout outreach send`，JSON 必须包含：
+   `to`, `subject`, `body`, `from_merchant_id`, `from_campaign_id`, `from_brand_slug`, `from_brand_name`, `from_contact_name`
+4. 发送成功（`ok: true`）→ 写 `CONVERSATIONS/{username}.md`（Round 1）+ 更新 `KOLS.md` → `awaiting_reply` + `MERCHANT_LIMITS.md` sent_today +1
+5. 发送失败（`ok: false`）→ 标 `send_error`，不计入 sent_today，跳过该 KOL，不中断其他
+
+全部完成后：`git commit -m "[{campaignId}] outreach sent to N KOLs"` + 更新 PROGRESS.md
+
+## 处理 KOL 回信
+
+触发：消息含 `[KOL_INBOUND:{campaignId}]` 或 `[KOL_INBOUND]`。
+
+1. 从消息中提取 `From`, `Subject`, `Message-ID`, `In-Reply-To`, `Body`
+2. 定位 KOL：
+   - `campaignId` 已知 → 读该 campaign 的 `KOLS.md`，按 `from_email` 匹配
+   - `campaignId` 未知 → 遍历所有 `campaigns/*/KOLS.md`，按 `from_email` 匹配，多个取 `last_update` 最新
+   - 无匹配 → 写 PROGRESS.md + `sentinel report --condition-met false` + 退出
+3. 读 `CONFIG.md` + `BRAND.md` + `CONVERSATIONS/{username}.md`
+4. **预检**（见「护栏」Layer 2）→ 任一触发则发 `escalate_fallback_v1` 并退出
+5. 按「谈判策略」产出结构化决策 JSON
+6. **后验**（见「护栏」Layer 3）→ 不通过则降级为 escalate
+7. 渲染模板 → **终检**（见「护栏」Layer 4）→ `scout outreach send`
+   - 回信必须带 `in_reply_to`（KOL 的 `message_id`）和 `references`（`CONVERSATIONS` 里的完整 message-id chain）
+8. 写回 `CONVERSATIONS/{username}.md` + `KOLS.md` + `MERCHANT_LIMITS.md`
+9. 如果 `accept` → 发 `deal_confirmation_v1`，标 `deal_reached`
+10. `git commit -m "[{campaignId}] round N {action} @{username}"`
+11. `sentinel report --condition-met true --summary "..." --action-taken "..."`
+
+## 查询进度
+
+- **多 campaign**：读每个 campaign 的 `KOLS.md`，按 status 分桶统计，输出 markdown 表格 + merchant 级 `sent_today` 信息
+- **单 campaign**：读 `KOLS.md` 全表 + `PROGRESS.md` 最近 5 条。对每个 `needs_merchant_followup`，读 `CONVERSATIONS/{username}.md` 最后一轮，总结 KOL 诉求
+- 只读不写，不 commit
+
+## 谈判策略
+
+处理 KOL 回信时，产出一个结构化决策 JSON：
+
+```json
+{
+  "action": "counter_offer | accept | decline | clarify | escalate",
+  "new_price": null,
+  "final_price": null,
+  "concessions": [],
+  "template_id": "...",
+  "template_vars": {},
+  "reasoning": "..."
+}
+```
 
-4. 告诉商家：商家级配置完成，现在为第一个商品创建 campaign，进入流程 B。
+**决策框架**：
 
----
+| KOL 回应 | 判断 | action |
+|----------|------|--------|
+| KOL 报价 ≤ `first_offer` | 低于预期，直接接受 | `accept` |
+| KOL 报价 ≤ `target_price` | 在目标范围内，可接受 | `accept` |
+| KOL 报价 ≤ `max_price` | 超出目标但可谈，渐进加价 | `counter_offer` |
+| KOL 报价 > `max_price` | 超预算，回一次低价试探 | `counter_offer`（报 `target_price`） |
+| KOL 连续 2 轮报价 > `max_price` | 已试探过，差距太大 | `decline` |
+| KOL 对之前的 counter 再次还价，且 ≤ `max_price` | 拉锯中，评估是否值得让步 | `counter_offer` 或 `accept` |
+| KOL 明确拒绝合作 | 尊重意愿 | `decline` |
+| KOL 问非价格问题（产品细节、时间线等） | 信息补充 | `clarify` |
+| KOL 提到超出授权范围的话题 | 不要硬答 | `escalate` |
 
-## 流程 B：Campaign onboarding（每次新建 campaign）
+**出价规则**：
 
-1. 确定 campaignId：
-   - 询问商家要为哪个商品建联（可列出他的 Optima 店铺商品作为选项）
-   - 从商品标题生成 kebab-case slug 建议（"Titanium Travel Tumbler" → "titanium-tumbler"）
-   - 校验：与 `CAMPAIGNS.md` 现有 campaign 不重复；匹配 `^[a-z0-9][a-z0-9-]{0,29}$`
-   - 告诉商家建议值，让他确认或改
+- 首次 counter：从 `first_offer` 开始
+- 每轮加价不超过 `max_step`
+- 绝不超过 `max_price`
+- 加 concession 时优先用 `allowed_uses` 里的授权项（转发、二创等）作为附加价值，而非直接加钱
+- 本 campaign 已承诺预算（`deal_reached` 的 offer 总和）+ 本次报价不能超 `total_budget`
 
-2. 创建 campaign 目录：
+**tone**：
 
-   ```bash
-   mkdir -p ~/kol-outreach/campaigns/{campaignId}
-   cp -r $CLAUDE_SKILL_DIR/template/campaign/. ~/kol-outreach/campaigns/{campaignId}/
-   cd ~/kol-outreach && git add -A && git commit -m "init campaign {campaignId}"
-   ```
+- 专业友好，不卑不亢
+- 不要用 "unfortunately" / "sadly" — 直接说 "our budget is..."
+- 每封回信开头用一句话承接 KOL 上一封的内容（`acknowledge_line`）
+- 永远不要透露 `max_price`、`total_budget`、或谈判策略
 
-3. 分段会话式填 campaign `CONFIG.md`：
-   - 3.1 Campaign 元信息（填 campaignId、创建时间、status=active）
-   - 3.2 商品段（ID/URL/标题/卖点/受众/样品）
-   - 3.3 目标 KOL 画像
-   - 3.4 预算与报价
-     - **校验**：`max_price >= target_price >= first_offer`、
-       `max_step <= max_price - first_offer`、`total_budget >= max_price`
-     - 任一不过 → 说明原因 + 建议调整 + 重新问，不要跳过
-   - 3.5 合作条款边界（保留时长/使用授权/付款节点/样品政策）
-   - 3.6 兜底话术覆写（默认留空继承 BRAND.md）+ 运行参数（max_rounds/max_days/max_concurrent_kols/覆写的 escalation_keywords/forbidden_phrases）
-   - 每段填完 → Edit CONFIG.md → `git commit -m "[{campaignId}] setup CONFIG section N"`
+## 护栏
 
-4. 追加 `CAMPAIGNS.md`（新增一行，status=active）
+四层防线。任一层失败都**不问商家**——自动降级为发兜底话术 + 标记 `needs_merchant_followup`。
 
-5. `git commit -m "[{campaignId}] campaign ready"`
+### Layer 1 — Onboarding 校验
 
-6. 告诉商家 campaign 已就绪，问他是否立即开始发现 KOL。
+写 `BRAND.md` / `CONFIG.md` 时执行：
+- 所有必填字段非空
+- `brand_slug` 全局唯一（通过 `scout outreach brand-slug check`）
+- `max_price >= target_price >= first_offer`
+- `max_step <= max_price - first_offer`
+- `total_budget >= max_price`
+- `escalation_keywords` 中英双语都有
+- 不通过 → 继续追问，不退出 onboarding
 
----
+### Layer 2 — 回信预检（调 LLM 前）
 
-## 流程 C：发现 KOL + 首发 Outreach
-
-触发：用户说"给 {campaign} 开始建联" / "为 {campaign} 发送 outreach"。
-如果商家没指定 campaign，读 `CAMPAIGNS.md`：
-- 只有一个 active → 用它
-- 多个 active → 列出让商家选
-
-1. 读配置：
-   - `CONFIG.md`（目标画像/运行参数/预算）
-   - `KOLS.md`（已存在 KOL 列表）
-   - `BRAND.md`（后面生成 outreach 需要）
-   - `MERCHANT_LIMITS.md`（今日发信数）
-
-2. 并行上限预检：
-   - `in_flight = KOLS.md 中 status ∈ {awaiting_reply, in_progress} 的行数`
-   - `available_slots = max_concurrent_kols - in_flight`
-   - `available_slots <= 0` → 告诉商家"当前 {in_flight} 个 KOL 在谈，已达并行上限。等 KOL 进入终态后再继续。"退出
-   - `target_new = min(CONFIG.target_kols_this_round, available_slots)`
-
-3. 日发信上限预检（merchant 级）：
-   - 读 MERCHANT_LIMITS.md 的 sent_today 和 max_daily_sends
-   - 如果当前 UTC 日期 ≠ MERCHANT_LIMITS.md 的 date_utc：归档昨天计数到历史表，sent_today=0，写回
-   - `daily_budget = max_daily_sends - sent_today`
-   - `daily_budget <= 0` → 告诉商家"今日所有 campaign 合计发信配额已用完"，退出
-   - `本轮发送量 = min(target_new, daily_budget)`
-
-4. 调 `scout tiktok creators` 发现 KOL：
-
-   ```bash
-   scout tiktok creators \
-     --follower-count "<CONFIG.powder_count_range>" \
-     --country "<CONFIG.region>" \
-     --limit <本轮发送量 * 3> \
-     --format json
-   ```
-
-   （×3 给过滤留空间）
-
-5. 过滤：
-   - engagement_rate < 2% 丢弃
-   - 已在 KOLS.md 的 username 丢弃
-   - 粉丝量不在目标区间的丢弃
-
-6. 对每个候选 KOL：
-   - 调 `scout tiktok creator-products @username --limit 5` 获取最近视频（用于生成开场白）
-   - 如果 scout 的 creators 响应 **没有返回 bio**，也从这里拉（见 probe Task 0.2）
-   - 用正则从 bio 抠 email：
-
-     ```bash
-     python3 -c "import re, sys; print(re.findall(r'[\\w.+-]+@[\\w-]+\\.[\\w.-]+', sys.stdin.read())[0] if re.search(r'[\\w.+-]+@[\\w-]+\\.[\\w.-]+', sys.stdin.read()) else '')" <<< "$BIO"
-     ```
-
-   - 有 email → 追加到 KOLS.md，status=pending_outreach
-   - 没 email → 追加到 KOLS.md，status=no_contact
-   - `git commit -m "[{campaignId}] discovered N KOLs"`
-
-7. 对每个 status=pending_outreach 的 KOL（限制本轮发送量）：
-   - 读 `TEMPLATES.md` 的 first_outreach_v1 骨架
-   - **LLM 决策**（结构化 JSON 输出）：
-     - 输入：CONFIG 商品段 + BRAND.md（覆盖后） + KOL 最近视频 + template 变量列表
-     - 输出：
-       ```json
-       {
-         "kol_first_name": "...",
-         "opener_line": "...",
-         "fit_reason": "...",
-         "product_one_liner": "..."
-       }
-       ```
-     - 你只决定变量值，**不要直接写 email body**
-   - 模板渲染：把变量代入 first_outreach_v1 → 最终 body
-   - **Layer 4 内容终检**：
-     - body 不含 CONFIG.forbidden_phrases（fallback 到 BRAND.md default）
-     - body 长度 ≤ 2000 字符
-     - 任一不过 → 跳过这个 KOL，写 KOLS.md status=send_error，记 PROGRESS.md
-   - Edit `CONVERSATIONS/{username}.md` 追加 Round 1 (outreach sent) 段
-   - 调 `scout outreach send`：
-
-     ```bash
-     echo '{
-       "to": "kol_email",
-       "subject": "Collaboration opportunity with <brand_name>",
-       "body": "<rendered body>",
-       "from_merchant_id": "<merchantId>",
-       "from_campaign_id": "<campaignId>",
-       "from_brand_slug": "<BRAND.brand_slug>",
-       "from_brand_name": "<BRAND.brand_name>",
-       "from_contact_name": "<effective contact_name>"
-     }' | scout outreach send
-     ```
-
-   - 解析响应，拿 message_id 写回 CONVERSATIONS/{username}.md 的 Message-ID chain
-   - Edit KOLS.md：status: pending_outreach → awaiting_reply，offer=first_offer
-   - 读 MERCHANT_LIMITS.md，sent_today += 1，写回
-   - `git commit -m "[{campaignId}] outreach sent to @{username}"`
-
-8. 追加本 campaign 的 PROGRESS.md；重要事件同步追加 merchant PROGRESS.md
-
-9. 告诉商家本次发送结果。
+- `rounds >= max_rounds` → `needs_merchant_followup`
+- `now - started >= max_days` → 标 `expired`，**不发邮件**，直接退出
+- KOL 回信命中 `escalation_keywords`（中英双语匹配） → 发 `escalate_fallback_v1`
+- `in_reply_to` 与 conversation 最后一条 inbound 的 `message_id` 不一致 → 发 `escalate_fallback_v1`
 
----
+### Layer 3 — 决策后验（产出 JSON 后）
 
-## 流程 D：KOL 回信处理（由 `[KOL_INBOUND:{campaignId}]` 或 `[KOL_INBOUND]` 触发）
-
-1. 解析 prompt：
-   - 如果包含 `[KOL_INBOUND:{campaignId}]` → 直接知道 campaignId，同时抠 email metadata（From / Subject / Message-ID / In-Reply-To / References / Body）
-   - 如果包含 `[KOL_INBOUND]` + `merchant_id: {X}` → campaignId 未知，抠 merchant_id 和 email metadata；campaignId 在步骤 3 中搜索确定
-     （`merchant_id` 仅用于日志和审计。campaign 查找基于 `~/kol-outreach/campaigns/*/KOLS.md` 遍历，因为工作目录已隐含了 merchant 身份。）
-
-2. 校验 campaign 存在（仅 campaignId 已知时）：
-   - `ls ~/kol-outreach/campaigns/{campaignId}/CONFIG.md`
-   - 不存在 → 写 merchant PROGRESS.md 异常记录 + `sentinel report --condition-met false --summary "unknown campaign"` + 退出
-
-3. 按 from_email 查找 KOL：
-   - **campaignId 已知**（from step 1）：只读该 campaign 的 KOLS.md
-     - 找到 → 继续步骤 4
-     - 找不到 → orphan_inbound：写 campaign PROGRESS.md + sentinel report false + 退出
-   - **campaignId 未知**（fallback）：遍历 `~/kol-outreach/campaigns/*/KOLS.md`
-     - 唯一匹配 → 确定 campaignId，继续步骤 4
-     - 多个匹配 → 选 **KOLS.md 中该 email 对应条目的 `last_update` 字段**最新的那个 campaign
-     - 无匹配 → orphan_inbound：写 merchant PROGRESS.md + sentinel report false + 退出
-
-   ※ 同一 campaign 内如果同一 email 出现多条记录（例如 KOL 换 username 后被重新添加），取 status 非终态（非 rejected / expired / no_contact）的活跃记录。
-
-4. 读本 campaign 的 `CONFIG.md`、`BRAND.md`、`CONVERSATIONS/{username}.md`
-
-5. **Layer 2 预检**（收到回信后、调 LLM 前）：
-   - 当前 KOL `rounds >= CONFIG.max_rounds` → escalate
-   - 对话时长 `>= CONFIG.max_days` → expired
-   - KOL 最新回信 body 匹配 escalation_keywords（先查 CONFIG 覆写，再 fallback 到 BRAND 默认） → escalate
-   - Idempotency：最后一条 inbound round 的 message_id ≠ 本次 in_reply_to → escalate
-
-6. **如果 Layer 2 触发**：
-   - 用 `escalate_fallback_v1` 模板渲染一封兜底回复
-   - 调 `scout outreach send` 发出去（带 in_reply_to / references）
-   - 更新 KOLS.md：status → needs_merchant_followup
-   - git commit
-   - `sentinel report --condition-met true --summary "layer2 escalate" --action-taken "..."`
-   - 退出
-
-7. **LLM 结构化决策**（每一轮都重新调一次 LLM，全量对话历史放进上下文）：
-   输入：
-   - campaign CONFIG.md 全文
-   - BRAND.md 全文
-   - CONVERSATIONS/{username}.md 全文
-   - 最新 KOL 回信
-   - TEMPLATES.md 里 counter_offer_v1 / deal_confirmation_v1 / escalate_fallback_v1 的变量列表
-
-   输出（结构化 JSON）：
-   ```json
-   {
-     "action": "counter_offer | accept | decline | clarify | escalate",
-     "new_price": 200,
-     "final_price": 250,
-     "concessions": ["video_retention_90d"],
-     "template_id": "counter_offer_v1",
-     "template_vars": { },
-     "reasoning": "..."
-   }
-   ```
-
-8. **Layer 3 后验**（基于本 campaign CONFIG 的预算和条款，不跨 campaign）：
-   - `action ∈ {counter_offer, accept, decline, clarify, escalate}`
-   - 如果 `counter_offer`:
-     - `CONFIG.first_offer ≤ new_price ≤ CONFIG.max_price`
-     - `new_price - previous_offer ≤ CONFIG.max_step`
-   - 如果 `accept`:
-     - `CONFIG.first_offer ≤ final_price ≤ CONFIG.max_price`
-     - `committed_so_far (本 campaign KOLS.md 中 deal_reached 的 offer 总和) + final_price ≤ CONFIG.total_budget`
-   - `concessions ⊆ CONFIG.allowed_uses ∪ {'video_retention_N'}`
-   - `template_id ∈ 本 campaign TEMPLATES.md 的模板列表`
-   - 任一不过 → 降级为 escalate（走 Layer 2 失败分支）
-
-9. 模板渲染：套对应模板 + template_vars → 最终 body
-
-10. **Layer 4 终检**：
-    - body 不含 forbidden_phrases（CONFIG 覆写优先，fallback BRAND）
-    - body 长度 ≤ 2000 字符
-    - 不过 → 降级为 escalate
-
-11. Edit `CONVERSATIONS/{username}.md` 追加 Round N (response sent)，包括完整 LLM decision JSON 供审计
-
-12. 调 `scout outreach send`：
-    - 带 `in_reply_to = KOL 的 message_id`
-    - 带 `references = 原 references 追加 KOL 的 message_id`
-    - 拿到新 message_id 写回 CONVERSATIONS
-
-13. Edit `KOLS.md`：更新 rounds、current_offer、last_update、status
-    - 如果 action == accept：status → deal_reached
-    - 否则 status → awaiting_reply
-
-14. 读 `MERCHANT_LIMITS.md`，sent_today += 1，写回
-
-15. 如果 action == accept：
-    - 额外调 `scout outreach send` 发 deal_confirmation_v1 的 recap 给**商家注册邮箱**
-    - 在 merchant PROGRESS.md 记录 `[campaignId] DEAL REACHED with @username ($final_price)`
-
-16. `git commit -m "[{campaignId}] round N {action} with @{username}"`
-
-17. 追加 campaign PROGRESS.md
-
-18. `sentinel report --condition-met true --summary "..." --action-taken "..."`
+- `action` 必须在白名单内
+- `counter_offer`: `first_offer <= new_price <= max_price`，`new_price - previous_offer <= max_step`
+- `accept`: `first_offer <= final_price <= max_price`，`committed + final_price <= total_budget`
+- `concessions ⊆ allowed_terms`
+- `template_id` 存在于 `TEMPLATES.md`
+- 任一不通过 → 降级 `escalate`，不重试
 
----
+### Layer 4 — 内容终检（发送前）
 
-## 流程 E：查询进度
+- body 不含 `forbidden_phrases`
+- body 长度 ≤ 2000 字符
+- 不通过 → 不发送，降级 `escalate`
 
-触发：商家说"KOL 进展如何" / "查看 {X} 状态"。
+## 允许的命令
 
-1. 读 `CAMPAIGNS.md`
-2. 解析范围：
-   - 商家指定 campaign → 只汇报该 campaign
-   - 未指定 + 只有一个 active → 只汇报该 campaign
-   - 未指定 + 多个 active → 先汇报跨 campaign 摘要，再提示可说"查看 {X}"
+- `scout tiktok creators` / `scout tiktok creator-products`
+- `scout outreach send` / `scout outreach brand-slug check|claim`
+- `sentinel report`
 
-3. **跨 campaign 摘要**：
-   - 对每个 campaign 读 KOLS.md 统计 in_flight / deal_reached / needs_merchant_followup
-   - 读 CONFIG 的 total_budget，算已承诺预算
-   - 读 MERCHANT_LIMITS.md 今日 sent
-   - 汇报表格（markdown）
+## 常见错误
 
-4. **单 campaign 详情**：
-   - 读 KOLS.md 按 status 分桶统计
-   - 对每个 needs_merchant_followup：读 CONVERSATIONS/{username}.md 最后一轮，总结 KOL 的诉求
-   - 读 campaign PROGRESS.md 最近 5 条
-   - 汇报（markdown 表格 + 待办列表）
+❌ 自由撰写邮件正文 → ✅ 只产出模板变量 JSON，用 TEMPLATES.md 渲染
 
----
+❌ 一次 session 混做多个流程 → ✅ 单会话单任务
 
-## 核心规则 / 必须遵守
+❌ 每一小步都 git commit → ✅ 每个逻辑动作完成后 commit 一次（发现、outreach、单个回信处理）
 
-- **git commit 节奏**：每个原子操作后立即 commit（一个 KOL 的一次发送 / 一个 CONFIG 段 / 一次状态更新），不要批量 commit
-- **LLM 只填变量，不写 body**：所有对外邮件必须走模板渲染；直接生成 body 的 bypass 护栏
-- **运行时零打扰**：任何护栏不过都**不要**问商家，降级为发 escalate_fallback + 标记 needs_merchant_followup
-- **单会话单任务**：一次 session 只做一种动作（onboarding / 发 outreach / 处理回信 / 查询），完成后 git commit 并退出
-- **文件路径**：所有路径都在 `~/kol-outreach/` 之下；运行前先 `cd ~/kol-outreach`
-- **幂等性**：处理回信前检查 `in_reply_to` 是否等于最后一条 outbound 的 message_id；不等则 escalate（防止重复投递）
+❌ 护栏失败后重试 LLM → ✅ 直接降级为 escalate
 
-## 错误处理要点
+❌ 透露 max_price / total_budget / 谈判策略 → ✅ 只透露当前报价
 
-| 故障 | 处理 |
-|---|---|
-| `scout outreach send` 返回 `ok: false` | Edit KOLS.md status=send_error，记 PROGRESS.md，不中断其他 KOL 的处理 |
-| LLM 结构化输出格式错误 | 重试 1 次；仍失败降级为 escalate |
-| git commit 失败 | 说明冲突原因，修复后重试；不要擅自 reset |
-| 当前 UTC 日期跨天 | 读 MERCHANT_LIMITS.md 时先归档昨天计数再继续 |
+❌ expired 的 KOL 还发邮件 → ✅ 标 expired 直接退出，不发信
 
-## 相关工具
+❌ 修改不属于当前任务的 campaign 状态 → ✅ 只操作当前 campaign
 
-- `scout tiktok creators` — 发现 KOL
-- `scout tiktok creator-products` — 获取 KOL 最近内容用于个性化
-- `scout outreach send` — 发送邮件（内部调 Resend）
-- `scout outreach brand-slug check|claim` — 验证/锁定 brand_slug
-- `sentinel report` — 回信处理结束时汇报结果（仅在 `[KOL_INBOUND]` 触发的会话里）
+❌ scout outreach send 失败就中断全部 → ✅ 标 send_error 跳过该 KOL，继续其他

package/.claude/skills/linting-the-wiki/SKILL.md

@@ -0,0 +1,60 @@
+---
+name: linting-the-wiki
+description: "检查知识库健康度。当用户说'检查知识库'、'知识库有什么问题'时使用。"
+---
+
+# Linting The Wiki
+
+检查 wiki 随时间推移后的完整性和可维护性。
+
+## 启动 SOP
+
+1. `ls ~/kb/REGISTRY.md`
+   - 不存在 → 告诉用户"还没有知识库，需要先创建一个"，引导使用 initializing-kb
+2. 读 `~/kb/REGISTRY.md` — 获取所有 active 的 KB 列表
+3. 确定目标 KB：
+   - 用户明确指定了 KB slug 或主题 → 直接用
+   - 用户说"全部 lint" → 遍历所有 active KB
+   - 只有一个 active KB → 用它
+   - 多个 active → 列出让用户选
+4. 读 `~/kb/<slug>/AGENTS.md` 了解该 KB 的契约
+
+## Lint 流程
+
+1. 检查 `~/kb/<slug>/index.md`、关键 wiki 目录和一组有代表性的页面
+2. 先识别结构性问题，再决定是否动手修改
+3. 按类型归类问题：链接、覆盖度、过时、矛盾、重复、页面规模或索引问题
+4. 除非用户要求更大范围修复，否则只应用小而明确的修补
+5. 清楚报告仍未解决的问题
+6. 追加 `~/kb/PROGRESS.md`
+7. `cd ~/kb && git add -A && git commit -m "[<slug>] lint: <发现N个问题，修复M个>"`
+
+## 要检查什么
+
+- 没有入链或出链的页面
+- 被反复提及但没有独立页面的实体或概念
+- 本应并入 overview 的 analysis 页面，或反过来的情况
+- 新来源进入后仍未更新的旧综述
+- `index.md` 与实际长期页面之间的漂移
+- 为了清晰起见应被拆分的大页面
+- 由于缺少来源而无法回答、但明显值得继续调查的问题
+
+## 修复边界
+
+安全的 lint 修复通常包括：
+
+- 增加缺失链接
+- 更新 `index.md`
+- 澄清过时标签
+- 就地标出矛盾
+
+不要把 lint 变成无边界重写。需要更深层次调整时，明确说出来并停下，除非用户明确要求继续。
+
+## 最小交付标准
+
+一次成功的 lint 至少应留下：
+
+- 一份简短但具体的问题清单
+- 已经完成的有边界修复
+- 已修复问题与剩余债务之间的清晰区分
+- 需要通过新来源或 web search 继续补足的空白点