① 首次启动(一次性,5 分钟)
菜单 → File → Open Folder → 选 ~/restosuite-channel-agent
切完后 Claude 会自动加载 CLAUDE.md 作为项目级指令。
新对话里输入 /agents,应该列出:
sourcing, qualifying, outreach, meeting, partner-crm, analytics, enablement, cosell, commission
浏览器或 Lark App 打开:
https://your-org.larksuite.com/base/XXXXXXXX-internal-base
应该看到 9 张表(条数随增长变化,下为 2026-06 快照):
| 表 | 角色 | 当前条数 |
|---|---|---|
| Candidates | raw 候选池(评分前) | ~846 |
| ★ Leads | 评过分 / 追踪中(带 Tier + Score) | ~700 |
| ★ Partners | 真合作(MOA+) | 1 |
| Outreach Drafts | 邮件草稿 | — |
| Review Queue | 模糊待审重复 | — |
| Meetings / Opportunities / Commissions / Activities | 会议 / 报备 / 返佣 / 通用日志 | — |
看本套 HTML 文档:http://127.0.0.1:8080/
Claude 已经帮你配好,直接在对话里说"启动预览 server"。
② 4 个核心使用场景
这 4 个场景覆盖 95% 的日常工作。其他需求都是这 4 个的变种。
场景 A · 找新渠道线索 + 起草邮件
最高频用,一周 1-3 次
怎么用
或者直接自然语言:
Claude 会自动做什么
| ① 调 sourcing agent | WebSearch + 多 source 抓候选 → 写 Lark Candidates 表 |
| ② 跑 dedup (5 层去重) | 过滤已在 CRM / BLOCKED / 疑似重复 → 疑似的写 Lark Review Queue |
| ③ 调 qualifying agent | 5 维度打分 + 分 Tier → 写 Lark Leads 表(Engagement=LEAD) ⚠️ 不写 Partners 表 — Partners 只放真合作的 |
| ④ 调 outreach agent | 从 Leads 表筛 Tier S/A/B + LEAD,起草 step 1 邮件 → 本地 drafts/ + Lark Outreach Drafts |
| ⑤ 用 AskUserQuestion | 把 Tier S 邮件挨个问你要不要批准 |
| ⑥ 给你 Lark URL | 你立刻在 Lark App / 网页看到全部新数据 |
你大约花 5-10 分钟
主要时间是审 Tier S 的 1-2 封邮件 — 其他全自动。
典型输出
场景 B · 审 / 改 / 批准邮件草稿
紧跟场景 A 之后,每次几分钟
Claude 怎么问你
我会用 AskUserQuestion 弹出选项:
3 种回复方式
1. 直接批准
Claude 在 DB 标 status='APPROVED',等真发邮件时自动出。
2. 改某段
Claude 重写、给新版本、再问你确认。
3. 看完整文件
对话里只显示摘要,看完整 markdown:
cat drafts/PRTN-006/step_1.md
drafts/ + DB 标 APPROVED。等接通 Gmail API 后才真发。场景 C · Partner 回复了 / 报备客户
不定期触发,通常每天 1-3 次
3-1 · Partner 邮件回复
Claude 自动做:
| # | 动作 | 产物 / 写到哪 |
|---|---|---|
| 1 | 触发 meeting agent | — |
| 2 | 拉历史数据 | Lark Partners + Activities |
| 3 | 生成 brief(画像 + timeline + Top 3 切入点 + 风险) | data/briefs/MTG-XXX.md |
| 4 | 新建会议记录(Status=SCHEDULED,Intent=4) | Lark Meetings |
| 5 | partner-crm 改 Lifecycle Stage LEAD → MOA | Lark Partners |
| 6 | 创建会议(POC 阶段是 draft) | Calendar |
3-2 · Partner 报备客户
Claude 自动做:
| # | 动作 | 产物 / 写到哪 |
|---|---|---|
| 1 | 触发 cosell agent | — |
| 2 | 冲突检查(同 brand 没活跃 opportunity) | 查 Lark Opportunities |
| 3 | 无冲突 → 写一条记录,Stage=REGISTERED,Locked Until=60 天 | Lark Opportunities |
| 4 | 匹配模块(reservation + customer analytics 最 fit) | — |
| 5 | 估算 ARR:$36K/year | Estimated ARR 字段 |
| 6 | 生成 deck.pptx + quote.pdf | drafts/cosell/OPP-XXX/ |
| 7 | 写通知日志(Type=NOTE) | Lark Activities |
3-3 · Partner 提问(渠道商赋能)
Claude 自动做:
| # | 动作 | 产物 / 分支 |
|---|---|---|
| 1 | 触发 enablement agent | — |
| 2 | 知识库 RAG | .claude/memory/ |
| 3 | 找到答案 + confidence 评分 | — |
| 4 | confidence ≥ 70 → 直接答 + 留 thumbs up/down | 写 Lark Activities(Type=RAG_ANSWER) |
| 5 | confidence < 70 或政策类 → 立刻升级你 | 👤 你 |
场景 D · 看周报 / 异常 / Ad-hoc 数据
每周一上午用一次
跑本周周报
Claude 自动做:
| # | 动作 | 产物 / 写到哪 |
|---|---|---|
| 1 | 拉全部数据(lark-cli +record-list) | Partners / Candidates / Drafts / Opportunities / Commissions |
| 2 | 计算漏斗:入库→qualified→sent→opened→replied→MOA | — |
| 3 | 检测异常(reply rate / sourcing 量 / stale) | — |
| 4 | 输出周报 markdown | data/reports/W22.md |
| 5 | 异常写日志(Type=HEALTH_CHECK) | Lark Activities |
| 6 | 推关键数字 | 对话 + Slack/Lark |
Ad-hoc 数据查询(随口问)
Claude 用 analytics agent + Bash + SQL 实时算。不需要 Tableau。
③ 渠道经理每周 SOP
每周固定 1-3 小时 · 分 4 段时间
节奏总览
| 时间 | 时长 | 干啥 | 在哪 |
|---|---|---|---|
| 周一 09:00-09:30 | 30 分钟 | 晨间审批(本周核心) | Lark Base |
| 周二-周四 | 不定 | 接 partner 回信 / 会议 / 客户报备 | Claude Code + Zoom |
| 周五 16:00-16:15 | 15 分钟 | 周回顾 | Lark Dashboard |
| 月底 | 20 分钟 | 大额返佣 + 月报 | Lark Commissions |
☀️ 周一 09:00-09:30(晨间例行)
| # | 步骤 | 时长 | 在哪 | 做什么 / 判断 |
|---|---|---|---|---|
| 1 | 看 Dashboard | 2 min | Dashboard | 4 个数字:Leads / Partners(真合作)/ Drafts 待审 / Candidates 增量。 🟢 漏斗健康 · 🟡 数字不动→查 sourcing 是否在跑 · 🔴 有 HEALTH_CHECK→优先处理 |
| 2 | 处理 Review Queue | 5 min | Review Queue 表 | 看 Status=PENDING:同一家→CONFIRMED_DUP · 另一家→NEW_PARTNER(自动进 Candidates)· 不确定→留 PENDING |
| 3 | 审 Leads 待审 | 10 min | Leads 表(按 Engagement 看板) | 重点看 PENDING_REVIEW 列(评分了没人审):值得追→拖 LEAD · 不追→DROPPED · 优先 Tier A(B 批量 LEAD,C 多 DROPPED) |
| 4 | 审 Outreach Drafts | 10 min | Outreach Drafts(Kanban) | Tier S 必看→APPROVED 或改 markdown · A 抽检 10% · B 批量 APPROVED。改 PENDING_APPROVAL→APPROVED |
| 5 | 触发本周新 Sourcing | 2 min | Claude Code | "找 10 个上海高端餐饮咨询渠道" 或 /recruit-partners --icp "日本 POS 厂商" --limit 8 |
🌤️ 周二-周四(被动响应)
场景 A · Partner 回邮件
Claude 自动改 Engagement=ENGAGED + 触发 meeting 生成 brief。
场景 B · Partner 报备客户
Claude 自动:冲突检查 → 锁单 60 天 → 写 Opportunities + deck/quote。
场景 C · 会议日
- 提前 1 天:Lark 推送 brief 链接
- 会议前 10 分钟:看 brief Top 3 切入点
- 30 分钟 Zoom(亲自)
- 会后:paste 录音 / 转写给 Claude
🌙 周五 16:00-16:15(周回顾)
1. 看本周漏斗(5 分钟)
Dashboard 对比上周:新入 / 升 Leads / 邮件 / 回复 / MOA
红灯:
- Reply rate < 10% 持续 2 周 → 跟 Claude 说"outreach 重写 Tier B 模板"
- 新 Leads = 0 → 检查 sourcing 是否被卡
2. 跟进 Stale(10 分钟)
Leads 表筛 Engagement=ENGAGED + Last Touched > 7 天
对每个:重发 / 安排电话 / 降到队列底 / DROPPED
📅 月底 20:00-20:20
1. 审大额返佣(10 分钟)
Commissions 表筛 Status=NEEDS_APPROVAL,逐条审 > $10k
2. 看月报(10 分钟)
analytics 推 markdown 月报到 Slack。看 ARR 增量 / Top 3 partner / 异常。
④ Review Queue 处理(每周一 5 分钟)
Dedup 第 4 层(Fuzzy match,相似度 0.85+)抓到的疑似重复,不直接入主表,先进 Lark Review Queue 表。每周一你花 5 分钟过一遍。
方式 A · 直接在 Lark 里改(推荐 ⭐)
- 打开 Lark Base「渠道拓展 CRM」→ Review Queue 表
- 看 Status = PENDING 的行
- 对每行,点 Status 单元格,从下拉选:
- CONFIRMED_DUP — 确实是同一家
- NEW_PARTNER — 是另一家公司,移到 Candidates
- IGNORE — 不感兴趣,丢弃
- 改完自动保存,5 秒完成一条
方式 B · 跟 Claude 说
Claude 显示:
选完 Claude 自动用 lark-cli +record-update 改 Lark 表的 Status。
⑤ 完整流程 · 动作 · 执行人 — 参考,想深入系统怎么跑再看
每一步都明确:动作是什么、谁干(你 / agent / Lark)、产物在哪。
核心概念:Candidate / Lead / Partner 三层
| 层 | 是什么 | 有没有分数 | 关键字段 |
|---|---|---|---|
| Candidate | 原料 — sourcing 抓进来的原始候选 | ❌ 不存分数 | 只有 Status:NEW → QUALIFIED / OUT_OF_REACH / BLOCKED |
| ★ Lead | 成品 — candidate 评过分后晋升的记录 | ✅ 分数在这里 | Tier + Score + Score Breakdown + Engagement Status |
| ★ Partner | 真合作 — MOA 签署后才创建 | 沿用 Tier | Lifecycle Stage:MOA / PILOT / ACTIVE |
⭐ 评分评的是 candidate(读它的字段),但分数(Tier/Score)写在晋升出来的 Lead 上。 OUT_OF_REACH / BLOCKED 的 candidate 不晋升 → 没有 Lead、没有分数,只在 Candidates 表挂个 Status。所以 846 candidates 里只有 700 条变成了 Lead。
主流程 18 步:Candidate → Partner
| # | 阶段 | 动作 | 执行人 | 产物 |
|---|---|---|---|---|
| 1 | 配置 ICP | 定义谁是理想 partner | 👤 你 | .claude/memory/icp.md |
| 2 | 触发 sourcing | "找 10 个 X 渠道" | 👤 你 | (启动) |
| 3 | 抓数据 | WebSearch + 多 source | 🤖 sourcing | (内部) |
| 4 | 5 层 dedup | 去重 + 标 BLOCKED/DUP | 🤖 sourcing | 跳过 / 入 Review Queue |
| 5 | 入 Candidates | 写真新候选 | 🤖 sourcing | Lark Candidates +N |
| 6 | 评分 | 5 维度打 Tier | 🤖 qualifying | (内部) |
| 7 | 升 Leads | Engagement=CANDIDATE | 🤖 qualifying | Lark Leads +N |
| 8 | 人审 | 拖卡 LEAD / DROPPED | 👤 你 (Lark Kanban) | Engagement Status 改 |
| 9 | 起草邮件 | 4 步序列个性化 | 🤖 outreach | Lark Outreach Drafts + drafts/ |
| 10 | 审批邮件 | Tier S 必审 / A 抽检 | 👤 你 (Lark) | Status: PENDING → APPROVED |
| 11 | 真发邮件 | (生产化才有) | 🤖 outreach + Gmail | (邮件发出) |
| 12 | 检测回复 | Engagement=ENGAGED | 🤖 outreach | Lark Leads 更新 |
| 13 | 生成 brief | partner 画像+切入点 | 🤖 meeting | Lark Meetings + briefs/ |
| 14 | 参加会议 | 30 分钟 Zoom | 👤 你 (亲自) | (录音) |
| 15 | 抽 intent | 录音 → 结构化 | 🤖 meeting | Lark Meetings 更新 |
| 16 | intent ≥ 4 | 升 READY_FOR_MOA | 🤖 meeting | Lark Leads 更新 |
| 17 | 签 MOA | 法律 + 合规 | 👤 你 + 法务 | (合同) |
| 18 | 升 Partners | 新建 PRTN-XXX | 🤖 meeting | Lark Partners +1 ⭐ |
真 Partner 之后:持续运营 15 步
| # | 阶段 | 动作 | 执行人 | 产物 |
|---|---|---|---|---|
| 19 | Onboarding W1-W4 | 4 周培训推送 | 🤖 enablement | Activities ×4 |
| 20 | Partner 提问 | RAG 答疑(政策类升你) | 🤖 enablement | Activities (RAG_ANSWER) |
| 21 | Partner 报客户 | Form 提交 | 👤 partner | (待 cosell 处理) |
| 22 | 冲突检查 | 查直销 + 其他 partner | 🤖 cosell | 无冲突 → 锁单 |
| 23 | 锁单 60 天 | 写 Opportunities | 🤖 cosell | Lark Opportunities +1 |
| 24 | Match 模块 | 推荐产品组合 | 🤖 cosell | Recommended Modules |
| 25 | 生成 deck/quote | PPT + 报价 PDF | 🤖 cosell | drafts/cosell/OPP-XXX/ |
| 26 | 客户决策 | 试用 / 谈判 | 👤 你 + partner | (反馈) |
| 27 | Stage 流转 | REGISTERED→QUALIFIED→PILOT | 🤖 cosell | Opportunities.Stage |
| 28 | WON | Stage=WON + Won At | 🤖 cosell | Opportunities 更新 |
| 29 | 升 ACTIVE | Partner Lifecycle=ACTIVE | 🤖 partner-crm | Lark Partners 更新 |
| 30 | 算返佣 | Tier × MRR × 期限 | 🤖 commission | Lark Commissions +1 |
| 31 | 反作弊检查 | 3 条规则 | 🤖 commission | pass / 升级 |
| 32 | 大额返佣审批 | > $10k | 👤 Finance Controller | Status 改 APPROVED |
| 33 | 月度对账单 | PDF + 财务系统 | 🤖 commission | PDF + Quickbooks |
永远在跑的后台 7 项
| # | 动作 | 执行人 | 产物 |
|---|---|---|---|
| A | 每日 metrics | 🤖 analytics | data/metrics/{date}.json |
| B | 异常检测 | 🤖 analytics | Activities (HEALTH_CHECK) |
| C | 每周一周报 | 🤖 analytics | Slack/Lark 推送 |
| D | Tier S stale 告警 | 🤖 partner-crm | Activities + 通知 |
| E | Champion 离职检测 | 🤖 partner-crm | 触发 sourcing 找替补 |
| F | Reply rate 跌告警 | 🤖 analytics | 触发 outreach 重写 |
| G | 团队 Form 提交 | 👤 团队 → 🤖 sourcing | Lark Candidates +1 |
⑥ 怎么查 / 改数据
5 个数据所在地(Lark 第一,SQLite 已废弃)
| 在哪 | 看 / 改什么 | 怎么打开 |
|---|---|---|
| 🟢 Lark Base「渠道拓展 CRM」 | 9 张表:Candidates(raw)/ ★ Leads(追踪中)/ ★ Partners(真合作 MOA+)/ Drafts / Meetings / Opportunities / Commissions / Review Queue / Activities | Lark App 或浏览器 — 主入口 |
| 对话面板 | agent 输出、所有决策、ad-hoc 查询 | Claude Code / Claude Desktop 窗口 |
drafts/ | 邮件草稿原文 markdown | Finder / cat / 任何编辑器 |
.claude/memory/ | 知识库(ICP / 产品 / 政策 / Lark 表 ID) | 任何编辑器 — 改了立刻生效 |
~/restoflow/docs/ | 本地预览站(渠道地图 + 本套文档) | http://127.0.0.1:8080 — 让 Claude「启动预览 server」 |
Lark Base 直接打开
https://your-org.larksuite.com/base/XXXXXXXX-internal-base
在 Lark 里能干啥(不用 Claude)
- 切视图:Partners 表右上角 → 网格 / 看板(按 Tier 分列)/ 画廊 / Form
- 改数据:点单元格直接改,自动保存 — 比如把 Partner Tier 从 A 升到 S
- 筛 / 排序:右上角 Filter / Sort
- 分享:右上角分享 → 邮箱或群
- 评论:每条记录可以 @ 同事讨论
- 历史:右键单元格 → 查看历史(自带 audit log)
- 导出:Excel / CSV 一键
常见查询(说给 Claude 听)
直接改知识库(不用 Claude)
用任何编辑器打开 .claude/memory/ 下的 markdown,改完保存,下次 Claude 会读到新内容。
# 编辑 ICP open .claude/memory/icp.md # 编辑产品矩阵 open .claude/memory/products.md # 编辑渠道政策 open .claude/memory/channel-policy.md # Lark 表 ID 常量(改了 Lark 重命名表才需要动) open .claude/memory/lark-tables.md
⑦ 常用命令速查表
Slash command(在对话里输入)
/recruit-partners | 跑完整 workflow |
/recruit-partners --limit 5 | 限制候选数 |
/agents | 列出所有 sub-agent |
/help | Claude Code 自带帮助 |
自然语言命令(直接说)
| "找 X 类型的渠道线索" | 触发 sourcing |
| "给 PRTN-XXX 打 tier" | 触发 qualifying |
| "给 PRTN-XXX 起草 step N 邮件" | 触发 outreach |
| "PRTN-XXX 回邮件了,内容是 ..." | 触发 meeting |
| "PRTN-XXX 报备客户 Y" | 触发 cosell |
| "跑本周周报" | 触发 analytics |
| "看 review queue 待审" | 列 candidates_review_queue |
| "启动预览 server" | 开 http://127.0.0.1:8080/ |
Terminal 命令(高级)
# 查 Lark Partners 表 lark-cli base +record-list --as user --base-token "XXXXXXXX-internal-base" \ --table-id "tblZHXT5GggZLaAF" # 查所有表名 + ID lark-cli base +table-list --as user --base-token "XXXXXXXX-internal-base" # 验证 Lark 认证状态 lark-cli auth status # 测试 dedup python3 scripts/dedup.py # 启动 HTML 预览 server python3 ~/restoflow/serve.py # 重新生成渠道地图数据(刷新后同步到预览站) python3 scripts/export_map_data.py
⑧ 必须停下找你的红线
这些情况 Claude 永远不会自动决定 — 一定会用 AskUserQuestion 找你确认:
| 红线 | 谁来决定 |
|---|---|
| Tier S partner 的邮件外发 | 👤 渠道经理 |
| 单笔返佣 > $10,000 | 👤 Finance Controller |
| 折扣超 tier 上限 | 👤 Finance |
| 锁单冲突(2+ partner 报同客户) | 👤 渠道 GM |
| 客户邮箱域名 = partner 域名(疑似 sock-puppet) | 👤 渠道 GM |
| Partner 问政策类问题(返佣率/排他/价格) | 👤 渠道经理 |
| Champion 离职检测到 | 🤖 sourcing 找替补 + 通知你 |
| Reply rate 跌 30% | 🤖 outreach 重写 + 告警 |
| 升 Partners 表(MOA 签署后) | 👤 渠道经理 + 法务 双签 |
| Lead → Partner 升级(从 Leads 表迁到 Partners 表) | 👤 渠道经理 在 Lark 确认 |
⑨ FAQ + 故障排查
| 问题 | 解决 / 排查 |
|---|---|
| Claude 不认识 9 个 sub-agent | 没切到项目目录。File → Open Folder → 选 ~/restosuite-channel-agent |
| Lark 表被改坏 / 误删 | Lark Base 自带历史:右上角「更多」→「版本历史」→ 恢复到任意时间点。 本地 SQLite 已于 2026-05-29 移除,Lark 是唯一真相源,无需(也没有)本地 DB 备份。 |
| 报错 "Lark token expired" | token 2 小时过期。重跑 lark-cli auth login --domain base,drive,docs --no-wait → 浏览器登录 → lark-cli auth login --device-code <code> |
| 想加新字段 / 改字段名 | 直接在 Lark Base 改 — 但必须同步更新 .claude/memory/lark-tables.md,否则 agent 因字段名错而写入失败 |
| HTML 预览 server 起不来 | 让 Claude 修(他懂 sandbox 限制)。手动:cp docs/*.html ~/restoflow/docs/ && python3 ~/restoflow/serve.py |
| Review Queue 堆了几十条 | 让 Claude 批量过高相似度的: 「列 review queue 里相似度 ≥ 0.95 的,全部标 CONFIRMED_DUP」 |
改了 icp.md 要重启吗 | 不用。下次 agent 跑会读最新内容 —— memory 是热更新的 |
| 怎么备份数据 / 状态 | 数据:Lark 版本历史(自动)。代码/drafts/memory:git add . && git commit -m "snapshot $(date +%F)";drafts 打包 tar -czf backups/drafts_$(date +%F).tgz drafts/ |
| 要接 Gmail 真发邮件 | 跟 Claude 说"接 Gmail API 真发",他会引导过 checklist:① outreach 加发送 tool ② deliverability 监控 ③ unsubscribe 链接 ④ dry_run 测试 |
| 给团队 / 老板看发什么 | 见下方「给谁看什么」表 ↓ |
给谁看什么
| 受众 | 发什么 |
|---|---|
| 👔 老板 | architecture.html 的「概览」+「视角 1 高层架构」 |
| 🧑💼 渠道经理 | 本说明书 |
| 🛠️ 技术团队 | architecture.html 的「视角 4 数据模型」+「Dedup 5 层」 |
| 💰 财务 | architecture.html 的「决策点矩阵」+「commission agent」 |