Skip to content

JuneYaooo/xhs-writer-skill

xhs-writer

Verified

生成小红书(RedNote)笔记:把主题或用户提供的素材(文字/图片/视频)做成一套竖版卡片(图文) 或一段带分镜脚本的视频稿(视频),配 caption + hashtags,落盘到 output/小红书/。 使用时机:用户说 写小红书 / 做小红书笔记 / 小红书图文 / 小红书种草 / 出一套 xhs 卡片 / 小红书视频 / write a Xiaohongshu note / make a RedNote post。

FileKindSize
SKILL.mdskill md14.7 KB
agents/openclaw.yamlconfig930 B
references/humanizer-zh.mdmarkdown15.4 KB
references/image-sourcing.mdmarkdown3.7 KB
references/material-intake.mdmarkdown5.4 KB
references/meta-schema.mdmarkdown4.5 KB
references/output-spec.mdmarkdown4.2 KB
references/reference-search.mdmarkdown2.9 KB
references/xiaohongshu-viral-methodology.mdmarkdown17.1 KB
scripts/analyze_material.pyexecutablescript4.9 KB
scripts/collage_3x4.pyexecutablescript3.4 KB
scripts/crop_watermark.pyexecutablescript1.6 KB
scripts/image_generator.pyscript17.5 KB
scripts/normalize_slug.pyexecutablescript2.1 KB
scripts/text_on_image.pyexecutablescript5.0 KB
scripts/validate_meta.pyexecutablescript5.8 KB

references/xiaohongshu-viral-methodology.md

View on GitHub
# 小红书爆款笔记制作方法论

> 基于真实 11 万赞爆款拆解 + 实战反馈迭代

## 一、核心原则

### ❌ 不要做的(常见错误)
1. **广告感设计**:渐变背景、科技感、精美排版 → 像品牌宣传
2. **堆砌所有功能**:10 种风格、所有特性都讲 → 没重点
3. **正式文案**:"奇点来了"、"杀手功能" → 距离感
4. **纯 AI 生图**:不用真实素材 → 假、空

### ✅ 要做的(爆款特征)
1. **素人感**:纯色背景 + 大 emoji + 简单文字
2. **抓核心卖点**:只讲 1-2 个最稀缺的功能
3. **口语化**:"有没有"、"宝藏"、"好看哭了"
4. **真实素材**:项目截图、实际效果对比

---

## 二、卖点优先级判断法则

### 判断标准(按优先级)
1. **稀缺性** > 常见功能
   - 问:其他工具能做到吗?
   - 独家功能 > 常见功能

2. **实用性** > 炫技
   - 问:能解决什么具体痛点?
   - 解决痛点 > 展示技术

3. **可感知** > 抽象概念
   - 问:用户能直接看到效果吗?
   - 视觉对比 > 文字描述

### 案例:gpt-image2-ppt 项目

| 功能 | 稀缺性 | 实用性 | 可感知 | 优先级 |
|---|---|---|---|---|
| **模板克隆** | ⭐⭐⭐⭐⭐ 独家 | ⭐⭐⭐⭐⭐ 公司刚需 | ⭐⭐⭐⭐⭐ 前后对比 | 🥇 核心 |
| gpt-image-2 热点 | ⭐⭐⭐⭐ 新技术 | ⭐⭐⭐⭐ 质量提升 | ⭐⭐⭐⭐ 文字清晰 | 🥈 辅助 |
| 10 种风格 | ⭐⭐ 常见 | ⭐⭐⭐ 选择多 | ⭐⭐⭐ 风格对比 | 🥉 锦上添花 |
| 30 秒速度 | ⭐⭐ 常见 | ⭐⭐⭐⭐ 效率 | ⭐⭐ 数字 | 🥉 锦上添花 |

**结论**:封面主打"模板克隆",gpt-image-2 作为技术背书,其他功能一笔带过。

---

## 三、素材使用策略

### 真实素材 > AI 生图

| 内容类型 | 素材来源 | 处理方式 |
|---|---|---|
| **功能对比** | 项目实际截图 | 直接用,加文字标注 |
| **效果展示** | before/after 对比图 | 左右分屏或上下对比 |
| **使用场景** | 电脑屏幕拍照 | 模仿爆款的真实感 |
| **纯文字卡片** | 纯色背景 + emoji | AI 生成或代码生成 |

### 案例:gpt-image2-ppt 可用素材

```
/home/ubuntu/github/gpt-image2-ppt-skills/docs/assets/
├── style-gallery.jpg           # 10 种风格对比(可截图用)
├── template-demo-input.jpg     # 模板输入(核心素材!)
└── template-demo-output.jpg    # 模板输出(核心素材!)
```

**使用方案**:
- 封面:用 `template-demo` 对比图 + 大字"一键复刻公司模板"
- 卡片 2-3:标注 input/output 的细节差异
- 卡片 4-5:截取 `style-gallery.jpg` 的局部展示风格

---

## 四、爆款卡片结构模板

### 模板 A:提问式封面(11 万赞款)

```
视觉:纯色背景 + 大 emoji(🤔)
文案:
  有没有那种
  [核心功能描述]
  的工具?
  
  [1-2 个关键数据/特点]
```

**适用**:新工具推荐、功能发现

### 模板 B:对比式封面(高转化)

```
视觉:左右分屏(before/after)
文案:
  左:公司模板
  右:AI 生成
  
  大字:老板都没看出来
```

**适用**:有明显效果对比的功能

### 模板 C:发现式封面(高共鸣)

```
视觉:纯色 + emoji(💡)
文案:
  我发现了个宝藏!
  
  [核心功能]
  [3 个痛点解决]
  
  终于不用 [痛点] 了😭
```

**适用**:解决痛点的工具

---

## 五、文案公式库

### 封面钩子(7 种)

1. **提问式**:"有没有那种 [功能] 的工具?"
2. **惊叹式**:"我不是最后一个知道的吧!!!"
3. **发现式**:"我发现了个宝藏!"
4. **身份共鸣**:"寻找牛马之光"、"PPT 女工的救赎"
5. **对比式**:"用了 XX 前 vs 用了 XX 后"
6. **数字冲击**:"30 秒做完 10 页 PPT"
7. **热点切入**:"gpt-image-2 爆火后,我用它做了 XX"

### 正文结构(3 段式)

```
第 1 段:痛点共鸣
  "凌晨 3 点还在改 PPT?"
  "老板说风格不对,重做?"

第 2 段:解决方案
  "[工具名] 能做到:"
  ✅ [核心功能 1]
  ✅ [核心功能 2]
  ✅ [核心功能 3]

第 3 段:社交证明 + CTA
  "我试了一下,[具体效果]"
  "开源地址评论区👇"
  "试完告诉我你的体验"
```

### 情绪词库

| 场景 | 正面情绪 | 负面情绪(痛点) |
|---|---|---|
| 发现 | 宝藏、绝了、爱了 | 后悔没早知道 |
| 效果 | 好看哭了、太强了 | 之前白熬夜了 |
| 速度 | 秒出、瞬间搞定 | 等到天荒地老 |
| 质量 | 专业、设计师级 | 土到掉渣 |

---

## 六、视觉风格指南

### 真实爆款的视觉特征

```
背景:
  ✅ 纯色(米色 #F5F1E8、浅黄 #FFF9E6、浅粉 #FFE5E5)
  ❌ 渐变、纹理、图案

Emoji:
  ✅ 超大(占画面 20-30%)
  ✅ 位置:顶部居中
  ✅ 常用:🤔💡✨🔥😭🪄

文字:
  ✅ 手写感(不规则、有倾斜)
  ✅ 关键词下划线(波浪线)
  ✅ 大小对比强烈
  ❌ 完美对齐、网格排版

整体:
  ✅ 看起来"不专业"(素人感)
  ✅ 随意、真实、有温度
  ❌ 精美、高大上、品牌感
```

### gpt-image-2 生成 prompt 模板

```
A Xiaohongshu style card, 9:16 vertical, SIMPLE and CASUAL.

Background: Solid [color] (#XXXXXX), NO gradients, NO effects

Top: ONE LARGE emoji [emoji], centered, 30% of image

Text (hand-written casual style, Chinese):
"[文案内容]"

Key words "[关键词]" with blue wavy underlines

Style:
- SIMPLE, not polished
- Looks like made by a regular person
- Casual, relatable, authentic
- NO fancy graphics, NO tech aesthetics
```

---

## 七、制作流程 SOP

### Step 1:卖点分析(5 分钟)
1. 列出所有功能
2. 按"稀缺性 × 实用性 × 可感知"打分
3. 选出 Top 1 核心卖点

### Step 2:素材盘点(5 分钟)
1. 项目截图(功能演示、效果对比)
2. 真实场景照片(电脑屏幕、手机截图)
3. 数据图表(如有)
4. 判断:哪些能直接用?哪些需要 AI 生成?

### Step 3:确定封面类型(3 分钟)
- 有对比图 → 模板 B(对比式)
- 解决痛点 → 模板 C(发现式)
- 新工具推荐 → 模板 A(提问式)

### Step 4:设计卡片结构(10 分钟)
```
卡片 1(封面):核心卖点 + 视觉冲击
卡片 2-3:展开核心卖点(真实素材 + 标注)
卡片 4:技术背书 / 对比其他工具
卡片 5:使用场景 / 案例
卡片 6-7:CTA + 互动引导
```

### Step 5:生成 / 制作卡片(20 分钟)
- 真实素材:直接用 + 文字标注
- 纯文字卡片:AI 生成(用上面的 prompt 模板)

### Step 6:文案优化(10 分钟)
- 检查:是否口语化?
- 检查:是否有情绪词?
- 检查:是否有 emoji?
- 检查:关键词是否突出?

---

## 八、常见错误 Checklist

发布前自查:

- [ ] 封面是否抓住了最稀缺的卖点?(不是堆砌所有功能)
- [ ] 视觉是否有"素人感"?(不是广告海报)
- [ ] 文案是否口语化?(不是正式文案)
- [ ] 是否用了真实素材?(不是纯 AI 生图)
- [ ] 是否有大 emoji?(不是纯文字)
- [ ] 关键词是否突出?(下划线、加粗、颜色)
- [ ] 是否有情绪共鸣?(痛点 + 解决)
- [ ] CTA 是否清晰?(评论区拿地址)

---

## 九、案例库(持续更新)

### 案例 1:gpt-image2-ppt(本次)

**初版问题**:
- ❌ 广告感太强(渐变背景、科技风)
- ❌ 堆砌功能(10 种风格、速度、质量都讲)
- ❌ 纯 AI 生图(没用项目真实截图)

**优化方向**:
- ✅ 聚焦"模板克隆"(最稀缺)
- ✅ 用真实对比图(template-demo)
- ✅ 素人感设计(纯色 + emoji)

**预期效果**:保守 5k-10k 赞

---

## 十、工具推荐

### 图片处理
- **截图标注**:手机自带标注工具
- **拼图对比**:美图秀秀、Canva
- **去水印**:`scripts/crop_watermark.py`

### 文案工具
- **emoji 库**:emojipedia.org
- **情绪词库**:本文档第五节

### 生成工具
- **纯文字卡片**:gpt-image-2(用本文档 prompt 模板)
- **真实素材卡片**:直接截图 + 标注

---

## 附录A:术语对照表

| 术语 | 含义 | 示例 |
|---|---|---|
| 素人感 | 看起来像普通人做的,不是设计师作品 | 纯色背景 + 手写字 |
| 口语化 | 日常对话的语气,不是书面语 | "有没有"、"宝藏"、"绝了" |
| 钩子 | 吸引注意力的开场 | "我不是最后一个知道的吧" |
| 痛点共鸣 | 说出用户的困扰 | "凌晨 3 点还在改 PPT" |
| 社交证明 | 别人的使用反馈 | "老板都没看出来" |
| CTA | Call To Action,行动号召 | "评论区拿地址" |

---

## 附录B:真实案例库

### 案例1:gpt-image2-ppt-skills(2026-04)

**项目类型**:开源工具(AI 生成 PPT)

**核心卖点识别**:
| 功能 | 稀缺性 | 实用性 | 可感知 | 得分 | 优先级 |
|---|---|---|---|---|---|
| 模板克隆 | 5 | 5 | 5 | 125 | 🥇 核心 |
| gpt-image-2 | 4 | 4 | 4 | 64 | 🥈 辅助 |
| 10种风格 | 2 | 3 | 3 | 18 | 🥉 锦上添花 |

**迭代过程**:
- V1:纯 AI 生图(广告风)❌ → 像品牌宣传
- V2:素人感设计 ✅ → 符合小红书风格
- V3:真实爆款分析 ✅✅ → 发现提问式钩子
- V4:卖点优先级判断 ✅✅✅ → 聚焦模板克隆
- V5:真实素材融入 ✅✅✅✅ → 图生图效果最佳
- V6:细节优化 ✅✅✅✅✅ → 文案精准化

**关键学习**:
1. **真实素材 > AI 生图**:项目的 template-demo 对比图比任何 AI 生成的都有说服力
2. **聚焦核心卖点**:模板克隆(稀缺)> 10种风格(常见)
3. **素人感设计**:纯色 + emoji + 口语化 > 精美广告
4. **图生图最佳**:保留真实感 + AI 设计能力
5. **用户痛点 > 功能堆砌**:"复刻任意模板" > "10种风格、30秒"

**最终成果**:
- 7张卡片(封面、对比图、风格展示、谁需要、真实案例、CTA、GitHub)
- 配套文案(2个版本 + 8个 hashtags + 5个标题选项)
- 预期效果:保守 5k-10k 赞,乐观 20k-50k 赞

**可复用流程**:
```
1. 卖点分析(稀缺性 × 实用性 × 可感知)
2. 爆款研究(tikhub 搜索 + 图片分析)
3. 素材盘点(项目截图 > AI 生图)
4. 图生图生成(真实素材 + 小红书风格)
5. 迭代优化(用户反馈 → 改进)
6. 配套文案(标题 + Caption + Hashtags)
```

**时间成本**:约 2-3 小时(含 6 次迭代)
**API 成本**:约 $2-5(OpenAI gpt-image-2)

---

## 附录C:图生图 Prompt 模板

### 模板1:纯文字卡片(素人感)

```
A Xiaohongshu style cover, 9:16 vertical, SIMPLE and CASUAL.

Background: Solid light [color] (#XXXXXX), NO gradients, NO effects

Top: ONE LARGE emoji [emoji], centered, 30% of image

Text (hand-written casual style, Chinese):
"[文案内容]"

Key words "[关键词]" with blue wavy underlines

Style:
- SIMPLE, not polished
- Looks like made by a regular person
- Casual, relatable, authentic
- NO fancy graphics, NO tech aesthetics
```

### 模板2:真实素材 + 文字叠加

```
Based on the reference image ([描述参考图]), create a Xiaohongshu style card, 9:16 vertical.

Keep the original image visible as the main content.

Add overlays:
- Top: [顶部文字]
- Bottom: [底部文字]

Style:
- Keep original image clear and readable
- Casual Xiaohongshu style text
- Semi-transparent overlays for readability
- Authentic, not too polished
```

### 模板3:对比卡片

```
Based on the reference image (two items for comparison), create a Xiaohongshu comparison card, 9:16 vertical.

Keep both items visible.

Add labels:
- Top item: Red label "[标签1]"
- Bottom item: Green label "[标签2]"

Middle area:
- Arrow pointing down: ↓
- Text: "[对比说明]"

Style:
- Clear comparison layout
- Casual annotations
- Xiaohongshu authentic feel
```

---

## 附录D:常见错误清单

### 错误1:广告感太强

**表现**:
- 渐变背景、科技感、精美排版
- 品牌 logo、专业设计元素
- 正式文案("革命性"、"颠覆性")

**原因**:想做得"专业"、"高大上"

**解决**:
- ✅ 纯色背景(米色、浅黄、浅粉)
- ✅ 大 emoji(占画面 20-30%)
- ✅ 手写感文字(不规则、有倾斜)
- ✅ 口语化("有没有"、"宝藏"、"绝了")

---

### 错误2:堆砌功能

**表现**:
- "10种风格、30秒、高质量、开源免费"
- 把所有功能都列出来
- 没有重点

**原因**:想展示所有优势

**解决**:
- ✅ 只讲最稀缺的 1-2 个功能
- ✅ 用卖点优先级公式:稀缺性 × 实用性 × 可感知
- ✅ 其他功能作为辅助,不是主角

**案例**:
- ❌ "10种风格随便挑,30秒就能生成"
- ✅ "复刻任意模板,一键排版生成"

---

### 错误3:纯 AI 生图

**表现**:
- 所有卡片都是 AI 生成
- 没有项目真实截图
- 缺少真实感

**原因**:觉得 AI 生图更快、更统一

**解决**:
- ✅ 优先使用项目真实素材(截图、对比图)
- ✅ 用图生图(保留真实感 + AI 设计)
- ✅ 纯 AI 生图只用于纯文字卡片

**效果对比**:
| 方式 | 真实感 | 说服力 | 制作难度 |
|---|---|---|---|
| 纯 AI 生图 | ⭐⭐ | ⭐⭐ | ⭐ |
| 代码叠加文字 | ⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐ |
| 图生图 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ |

---

### 错误4:功能导向 > 痛点导向

**表现**:
- 说"有什么功能",不说"能解决什么问题"
- 技术细节太多
- 用户看不懂价值

**原因**:开发者视角,不是用户视角

**解决**:
- ✅ 先说痛点:"凌晨3点还在改PPT?"
- ✅ 再说解决方案:"能自动复刻公司模板"
- ✅ 最后说结果:"再也不用熬夜了"

**公式**:痛点 + 解决方案 + 结果

---

### 错误5:第一版就想完美

**表现**:
- 花很多时间打磨第一版
- 不愿意迭代
- 害怕用户反馈

**原因**:完美主义

**解决**:
- ✅ 快速出第一版(60分即可)
- ✅ 收集用户反馈
- ✅ 快速迭代(每次改进 1-2 个关键点)
- ✅ 6次迭代 > 1次完美

**数据**:
- gpt-image2-ppt 案例:V1 → V6,质量提升 10 倍
- 时间分配:V1 占 20%,迭代占 80%

---

## 附录E:工具使用指南

### 1. tikhub(小红书数据抓取)

**安装**:
```bash
# 已集成在 social-account-doctor skill
```

**用途**:
- 搜索关键词爆款笔记
- 下载真实图片分析
- 获取互动数据(点赞、收藏、评论)

**使用技巧**:
1. ✅ 先分析真实爆款,再动手做
2. ✅ 看图片比看文字更重要
3. ✅ 下载 Top 3-5 条爆款的图片
4. ✅ 分析共同特征(背景、emoji、文案风格)

**案例**:
```bash
# 搜索"AI做PPT"相关爆款
xhs-search "AI做PPT" --sort likes --limit 10

# 下载图片
# 图片会自动保存到本地
```

---

### 2. gpt-image-2(图生图)

**用途**:
- 纯文字卡片生成
- 真实素材 + 文字叠加(图生图)

**Prompt 技巧**:
1. **明确风格**:"Xiaohongshu style", "SIMPLE and CASUAL"
2. **强调真实感**:"Looks like made by a regular person"
3. **禁止元素**:"NO fancy graphics", "NO tech aesthetics"
4. **保留原图**:"Keep the original image visible"(图生图时)

**失败处理**:
- API 返回 550 错误 → 降低图片分辨率重试
- 图生图失败 → 改用代码叠加文字
- 生成比例不对 → 重新生成(自动重试 2 次)

**成本**:
- 纯文字卡片:约 $0.3-0.5 / 张
- 图生图:约 $0.5-0.8 / 张
- 7张卡片总成本:约 $2-5

---

### 3. PIL(Python 图片处理)

**用途**:
- 组合多张图片(对比图)
- 添加文字标注
- 调整尺寸和比例

**优缺点**:
- ✅ 快速原型
- ✅ 完全可控
- ❌ 字体和设计感不如 AI
- ❌ 需要手动调整位置

**使用场景**:
- 快速验证想法
- 作为图生图的参考图
- 图生图失败时的降级方案

---

## 附录F:标题生成公式

### 公式1:痛点+解决方案

```
{具体痛点}?{解决方案}
```

**案例**:
- "凌晨3点还在改PPT?这个工具能一键复刻公司模板"
- "老板的模板太复杂?AI帮你自动复刻风格"

**适用**:有明确痛点的工具类产品

---

### 公式2:提问式

```
有没有那种{功能描述}的{产品类型}?
```

**案例**:
- "有没有那种能复刻公司PPT模板的AI工具?"
- "有没有那种一键生成小红书图文的工具?"

**适用**:新工具推荐、功能发现

---

### 公式3:发现式

```
我发现了个宝藏!{核心价值}
```

**案例**:
- "我发现了个宝藏!AI能完全复刻公司PPT模板"
- "我发现了个宝藏!30秒生成小红书爆款图文"

**适用**:兴奋分享、好物推荐

---

### 公式4:热点词

```
{热点词}爆火后,我用它做了{场景}
```

**案例**:
- "gpt-image-2爆火后,我用它做了个PPT神器"
- "Sora爆火后,我用它做了个视频工具"

**适用**:蹭热点、技术类产品

---

### 公式5:身份共鸣

```
{身份标签}必备!{核心功能}
```

**案例**:
- "打工人必备!一键复刻老板的PPT模板"
- "设计师必备!AI自动生成配色方案"

**适用**:有明确目标人群的产品
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall