Skill229 repo starsupdated 27d ago
social-account-doctor
# social-account-doctor This Claude Code skill helps creators on Chinese social platforms (Xiaohongshu, Douyin, Kuaishou, video accounts) generate drafts for their next viral posts by identifying benchmark content, analyzing what makes it work, and adapting successful formulas to the creator's own materials. Users invoke it when they need to find comparable viral posts, deconstruct what makes them successful, write new content inspired by top performers, or transform raw materials (documents, images, videos) into publishable post drafts using a four-step closed loop: compose raw materials, find benchmarks, crack their success mechanics, and adapt to create original content.
Install in Claude Code
Copygit clone https://github.com/JuneYaooo/social-account-doctor ~/.claude/skills/social-account-doctorThen start a new Claude Code session; the skill loads automatically.
Definition
SKILL.md
# social-account-doctor — 找对标 / 拆爆款 / 套自己
> **不挖钩子建仓库,不写诊断报告。**
> 直接对着具体爆款 → 输出**我的下一条笔记初稿**(标题 + 封面大字 + 首段 + CTA)。
---
## 0A. 交付质量硬规则(防伪装完成)
这些规则适用于 find / crack / adapt / diagnostic。违反时不要硬写报告;在对话里明说缺哪一步、为什么缺、用户可以怎么补。
**H1 — find 必须有真对标搜索**
- `find` 模式至少跑过 1 次平台搜索,并拿到真实账号或作品候选:小红书 `xiaohongshu_app_v2_search_notes` / 抖音账号搜索或视频搜索 / 快手 `kuaishou_app_search_video_v2` / 视频号 `wechat_channels_v2_fetch_search_channel_videos` / B 站 `bilibili_web_fetch_general_search`。
- 只拿了我的账号信息或作品列表就写“对标结论” = 违规。没有对标搜索,就只能标成“仅基于我方数据的初步判断”。
**H2 — 视觉判断必须先跑多模态**
- 报告里只要出现“封面模板 A/B/C/D/E”“大字比例”“真人出镜/实物展示/表格截图”“封面公式”“首帧钩子”等判断,就必须先用 `scripts/analyze_image.py` 分析本地封面/首帧。
- 我方账号诊断优先跑 top 3 + bottom 3;完整诊断最好覆盖近 7 条。对标可只跑 top 3,不能零调用。
- 报告正文必须嵌入我方/对标封面图,至少让用户能图文对照。无图的视觉诊断只能算口头评价。
- 视频画面结论必须与口播/字幕品类交叉校验。若口播在讲食品或母婴商品,而视觉结果出现无关的软件、效率工具、职场等内容,必须判为跨模态冲突并弃用;改用真实关键帧复核或重新分析,不能把冲突结果写进报告。
- 完整账号报告的对标部分不能只写“账号名 + 一句可借鉴机制”。至少交代对标样本数、账号内容母题、代表作品公开数据、开头钩子、画面证据链、流量/转化作用,以及 `该借鉴 / 不要照抄`;详细图文版每个代表视频至少放开头、中段、结尾 3 张有效帧。
- 嵌入报告前必须逐张确认对标帧与账号、作品和图注一致。自动时间点截图若与完整逐帧接触表、口播或商品不一致,直接弃用并改选已人工复核的帧;不得让不同账号复用串片画面。
**H3 — 半成品要显式标注**
- 搜索 API 挂、tikhub 不通、对标不足 3 条、截图字段不全、音频转写失败,都不能静默跳过。
- 报告开头或对话里必须标注完整度:`完整` / `部分(缺 Layer X)` / `仅 L1`。
- 对标为 0 条时写:`本次未能获取有效对标数据,以下结论仅基于账号自身数据,可能不够准确。`
**H4 — 标题干净,状态放正文**
- 用户可见 H1 不写 `(补充版)`、`(无对标)`、`(技术分析)`、`(Gemini 分析)` 这类内部状态词。
- 状态说明放在标题下方引用块或 TL;DR 上方。
**H5 — 账号定位不清晰要警告**
- 账号简介为空/模糊、近 30 条覆盖 4 个以上不相关赛道、作品数 < 10、简介和内容明显不符时,必须在报告开头提示“定位风险”。
- 涉及账号定位、简介改写、人设切换、粉丝画像、变现模式时,缺硬数据就写“数据不足,暂不下结论”,不要凭感觉改号。
**H6 — 报告语言面向非技术用户**
- 用户报告里不要出现脚本名、模型名、API 名、命令行、JSON、ffmpeg、OCR bbox 等技术实现细节。
- 写“从封面设计来看……”“在平台上搜索同赛道内容发现……”,不要写“通过 analyze_image.py / tikhub 接口 / Gemini 得出……”。
**H7 — 诊断默认给行动,不默认写脚本**
- 用户问“为什么不爆 / 账号怎么调 / 完整诊断”时,默认输出漏斗判断、对标差距、内容结构、视觉标准、复盘指标、P0/P1/P2 行动。
- 账号诊断必须同时看 top/bottom;同一机制至少在 2 条赢家中重复且未同样高频出现在 bottom,才叫账号公式。输出 `继续保持 / 从对标补齐 / 不要照抄` 和下一轮单变量测试。
- 只有用户明确说“下一条发什么 / 帮我写脚本 / 给案例”时,才写下一条可发布初稿或逐字脚本。
- 如果账号内容明显是 AI 视频 / AI 插画 / 数字人口播,必须加一节“AI 视频表达差距”:首帧冲突、人物连续性、场景连续性、字幕安全区、模板感、可信度、时长承载能力。
**H8 — PDF 按需,但排版要自检**
- 默认只写 `.md`。用户明确要 PDF 时再跑 `scripts/render_report_pdf.py`。
- PDF 报告避免超宽表格、手机长截图整张塞入、Markdown 表格包在 HTML 容器里。生成后至少检查文件存在、页数合理、图片没有明显丢失。
---
## 0. 闭环图
```
[我的原始素材(文档 / 图片 / 视频 / 非平台链接)] ← 新入口(compose)
│
▼ ⓪ compose (多模态解析 → 核心事实/独家要素/金句清单 → 5 维本质 → 信息缺口)
│
[我的账号 / 选题方向 / compose 画像]
│
▼ ① find (多模态识别本质 → 矩阵搜 → 相似度过滤)
[5-10 个真对标爆款]
│
▼ 人工勾选 3-5 条 ✋
[选定对标]
│
▼ ② crack
[每条 4 维钩子拆解(视觉/文字/口播/剧情)+ 综合权重 + 骨架 + 封面 + 标签]
│
▼ ③ adapt (有素材时:每个产出必须溯源到"对标公式 + 素材条目")
[3 标题 + 3 封面大字 + 1 段首段 + 1 个 CTA] → 可发
```
**副产品(可选,必须问)**:crack 跑完后**主动问**用户「要把这些钩子积累到 `./assets/hooks-{platform}.md` 吗?」 — 用户答 yes 才追加。**不会自动写**。库的质量由你把关,跑多了自然形成弹药库。
---
## 1. 输入路由
| 用户说什么 | 走哪个命令 |
|---|---|
| "找对标" / "我这个号有什么对标" / "扫一下同赛道" | **find** |
| "拆这条爆款" / "这条为什么爆" / "提取这条的钩子" | **crack**(单条) |
| "对着这条仿写" / "下一条该怎么写" / "套这条的钩子写一条" | **crack + adapt** |
| "我想发 XX 主题,有什么参考" / "缺爆款选题" | **find + crack + adapt**(全闭环) |
| "我有素材帮我写一条能爆的" / "这份文档/这组图/这段视频能出一条爆款吗" / "基于这些材料做一条" | **compose + find + crack + adapt**(素材打底全闭环) |
| "诊断这个带货账号" / "分析这个带货视频链接或文件" / "根据商品资料写带货脚本" | **commerce**(账号诊断 + 对标内容分析,见 §1B) |
---
## 1A. compose 命令 SOP(素材 → 初稿的新入口)
> **触发**:用户带着**自己的原始素材**(本地文档 / 图片 / 视频 / 非平台链接)+ 一句"帮我写一条能爆的"。
> **作用**:跑在 `find` 之前,把一堆散素材炼成"5 维本质 + 独家要素清单 + 信息缺口",让下游 find/crack/adapt 有的放矢、且不乱编素材。
### 输入
- **必选** 1-N 份原始素材(任意组合):
- 本地文档 `.md` / `.txt` / `.pdf` → `scripts/analyze_document.py <path>`(md/txt 也可以直接 Read;pdf 走脚本)
- 图片 `.jpg` / `.png` → `scripts/analyze_image.py`
- 视频 `.mp4` / `.mov` → `scripts/analyze_video.py`
- 非平台链接(文章 / 博客 / 新闻 / 自己的官网/产品页)→ `WebFetch` 取正文
- **必选**:我的账号定位(一句话)+ 目标平台
- **可选**:我想强调的卖点 / 情绪 / 必须保留的关键词
- **不走本命令**:小红书 / 抖音 / 快手 / 视频号 / B 站 / 公众号链接 — 那些是"别人的爆款",直接走 `crack`
### Step 1 逐份解析(多模态必跑,跟 find Step 1 对称)
每份素材都跑一次对应脚本,**不要看一份就下结论**。汇总成**素材画像**,5 个字段:
| 字段 | 说明 | 来源要标到具体素材 |
|---|---|---|
| 核心事实 | 3-5 条原子事实 | 每条标 `[素材 X · 段落/时间戳]` |
| **独家要素** | 其他人没有的点:人物 / 数据 / 画面 / 场景 / 金句 | adapt 强制嵌入,必须标来源 |
| 视觉素材候选 | 图片 / 视频帧 / 文档配图 | adapt 的封面直接从这里挑 |
| 情绪基调 | 全部素材汇总出的情绪色 | 后续 Step 2 的 5 维输入 |
| **信息缺口** | adapt 想成立但素材没覆盖的点 | 明文列,**问用户**不要编 |
### Step 2 炼 5 维本质(复用 find Step 1 框架)
基于素材画像,按 `find` 的 5 维(载体形态 / 情绪锚点 / 审美风格 / 内容结构 / **反差点**)推断这条内容**应该长成什么样**。输出形容词三元组 + 一句话定位。
这 5 维直接喂给 `find` → **find 可以跳过自己的 Step 1**(已经有 5 维了),从 Step 2 矩阵搜索开始。
### Step 3 交棒 find → crack → adapt(素材模式)
后面三步的差异:
- `find`:跳过 Step 1,直接用 compose 的 5 维跑 Step 2-5
- `crack`:完全复用 SOP
- `adapt`(**素材模式,强制项**):
1. 标题 / 首段 / CTA 各至少嵌入 **1 条素材独家要素**
2. 封面大字**优先**从素材画像的"候选金句"里选
3. 每个产出除了现有的"抄了对标什么 + 改了什么",**加一行** `用了素材:[素材 X · 具体要素]`
4. 素材覆盖不到、只能走通用话术的位置,**必须 ⚪ 推断 标记** — 用户看到就知道这块是脑补
5. 缺口明显影响成稿时(例:素材里没有具体数字但对标都有)→ **停下来问用户补**,不要编一个假数字
### compose 的输出
落盘到 `./reports/{YYYYMMDD-HHMM}-compose-{素材短码}.md`,含:
- 素材清单(文件名 + 字/帧/时长)
- 5 维本质 + 形容词三元组
- 独家要素清单(编号)
- 候选金句 / 视觉素材清单
- **信息缺口清单 → 给用户的补充素材请求**(如有)
完整闭环跑完后,adapt 报告里**必须含"素材溯源列"** — 没有这一列视同半成品,不写盘。
### compose 的铁律
1. **素材全吃完再下结论**:N 份素材全跑完解析再炼 5 维,不要跑到第 2 份就开写
2. **不编独家要素**(对齐全局 feedback `账号资料修改要斟酌` 的铁律 — 素材没给的不要凭空加):adapt 想写但素材没给 → 问用户或标 ⚪ 推断
3. **素材优先于通用话术**:adapt 的每一行能从素材抠出来的,就不要用通用公式兜底
4. **每一行要能双向溯源**:对标公式(抄了什么)+ 素材条目(用了什么)两头都挂得上钩
---
## 1B. commerce 命令 SOP(账号诊断 + 对标内容分析)
> **作用**:复用本 Skill 的核心 `diagnostic/find/crack/adapt` 链路,诊断带货账号,解析平台带货视频链接或本地视频。用户要求诊断、差距或改进时,必须结合 3-5 条同类对标;只要求客观拆解时可先完成单条 `crack`。商品详情截图、SKU、资质文件和用户确认事实用于商品一致性检查与脚本生成。
> **不提供**:在线商品页解析、选品、趋势监控、GMV/佣金推断。视频链接与商品链接必须分开处理。
### commerce 输入门禁
检测到 commerce 请求后,按目标索要材料:
| 目标 | 必选输入 | 可选输入 |
|---|---|---|
| 诊断带货账号 | 账号主页链接;平台 | 后台指标截图/JSON、用户认可的对标账号 |
| 分析带货内容 | 平台视频链接或本地 `.mp4/.mov`;账号定位 | 商品详情/SKU/资质材料、后台指标、用户指定对标 |
| 生成带货脚本 | 商品名称;至少一份详情/SKU/资质/品牌资料;账号定位;目标人群 | 本地参考视频、表达风格、目标指标 |
- 平台视频链接:先复用通用 `crack` 的链接解析、详情和媒体下载链路;连续 3 次失败后,明确标记工具不可用并要求用户上传本地视频,不能假装看过画面。
- 抖音/小红书/快手/B 站可以接收各自支持的作品链接;视频号客户端没有普通可复制作品 URL,按账号名/关键词搜索或用户上传本地文件处理。
- `tikhub --health` 和工具出现在 `list` 中只证明客户端/目录正常,不证明业务接口能返回数据;必须以一次真实调用成功作为本次任务的能力门禁。
- 只有