Skip to content
Back to search

xhs-writer-skill

小红书爆款笔记生成器,基于gpt-image-2,强力超快生成,自然语言修改,超好用!

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/juneyaooo--xhs-writer-skill/badge.svg)](/listings/juneyaooo--xhs-writer-skill)

HTML

<a href="/listings/juneyaooo--xhs-writer-skill"><img src="/api/listings/juneyaooo--xhs-writer-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

方式一:让 AI 自己装(推荐)

把下面这段 prompt 丢给你的 AI 助手(Claude Code / OpenClaw / Codex / Cursor 都行),它会自动完成安装:

帮我安装 xhs-writer-skill:
https://raw.githubusercontent.com/JuneYaooo/xhs-writer-skill/main/docs/install.md

agent 会自己 clone 仓库、跑安装脚本、提示你重启。

方式二:手动安装

git clone https://github.com/JuneYaooo/xhs-writer-skill.git
cd xhs-writer-skill
bash install_as_skill.sh

脚本会把 skill 装到 `~/.claude/skills/xhs-writer-skill/`,Claude Code 重启后自动识别。

配置(可选)

如果需要图生图功能(推荐),配置 OpenAI API key:

# 创建 .env 文件
cat > ~/.claude/skills/xhs-writer-skill/.env << 'EOF'
OPENAI_BASE_URL=https://api.openai.com
OPENAI_API_KEY=sk-your-key-here
GPT_IMAGE_MODEL_NAME=gpt-image-2
GPT_IMAGE_QUALITY=high
EOF

> 🔒 **不会误吃密钥**:只从 skill 自己目录的 `.env` 加载。 > > 💡 **图生图 vs 纯文字卡片**:有真实素材时,图生图效果远超纯 AI 生图(保留真实感)。没有 API key 也能用,会生成纯文字卡片。

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 419 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. name: xhs-writer
  3. description: >-
  4. 生成小红书(RedNote)笔记:把主题或用户提供的素材(文字/图片/视频)做成一套竖版卡片(图文)
  5. 或一段带分镜脚本的视频稿(视频),配 caption + hashtags,落盘到 output/小红书/。
  6. 使用时机:用户说 写小红书 / 做小红书笔记 / 小红书图文 / 小红书种草 / 出一套 xhs 卡片 /
  7. 小红书视频 / write a Xiaohongshu note / make a RedNote post。
  8. ---
  9. # xhs-writer — 小红书笔记生成
  10. 把一个主题 + (可选)用户素材,生成**图文卡片组**或**短视频脚本**,按规范落盘到 `output/小红书/`。
  11. ## 核心理念
  12. 小红书读者看的不是长文,是**卡片组**或**短视频**。长文原稿只是中间产物;caption 只是发布配文。
  13. - **图文帖(image post)**:3-9 张 9:16 竖版卡片(cover + content × N + ending),每张 ≤80 字中文。
  14. - **视频帖(video post)**:一段 15-90 秒竖屏视频脚本 + 封面卡,分镜写在 `meta.json.shots` 里,视频合成本 skill 不做。
  15. ### 爆款方法论(通用原则)
  16. **5大核心原则**:
  17. 1. **真实素材优先**:项目截图、对比图、演示图 > 纯 AI 生图
  18. 2. **聚焦核心卖点**:用公式判断优先级(见 Step 0.5)
  19. 3. **素人感设计**:纯色背景 + 大 emoji + 口语化 > 品牌宣传风格
  20. 4. **痛点导向**:说"能解决什么问题" > 堆砌功能列表
  21. 5. **快速迭代**:V1(60分) → 用户反馈 → V2(70分) → 持续优化
  22. **详细方法论**:见 `references/xiaohongshu-viral-methodology.md`
  23. ## 工作流
  24. 按顺序执行。**不要跳步**。
  25. ### Step 0 — Intake(必问,一次问完)
  26. 收到请求后不要动手,先向用户确认以下要点,尽量一条消息问完:
  27. 1. **主题 / 目标读者 / 核心观点**
  28. 2. **输出形态**:图文 or 视频?(默认图文)
  29. 3. **素材**:有没有已有的文字/图片/视频要用?贴路径或拖文件
  30. 4. **风格**:简约清新 / 科技感 / ins 风 / 商务 / 文艺复古 / 可爱卡通(默认"简约清新")
  31. 5. **卡片数量 / 视频时长**:图文默认 5-7 张;视频默认 30-60 秒
  32. ### Step 0.5 — 卖点/亮点分析(推荐执行)
  33. **触发条件**:
  34. - 推广类:产品、项目、工具、服务
  35. - 分享类:好物推荐、经验总结、知识科普
  36. - 测评类:产品对比、使用体验
  37. **执行**:
  38. 1. 列出所有功能/特性/亮点
  39. 2. 用 AskUserQuestion 让用户打分(每个点):
  40. - 稀缺性(1-5):别人有吗?独特吗?
  41. - 实用性(1-5):能解决多大问题?
  42. - 可感知(1-5):用户能直接看到/感受到吗?
  43. 3. 计算得分 = 稀缺性 × 实用性 × 可感知
  44. 4. 排序,选择 Top 1-2 作为核心卖点/亮点
  45. **输出**:
  46. ```markdown
  47. ## 卖点/亮点分析结果
  48. | 点 | 稀缺性 | 实用性 | 可感知 | 得分 | 优先级 |
  49. |---|---|---|---|---|---|
  50. | 亮点A | 5 | 5 | 5 | 125 | 🥇 核心 |
  51. | 亮点B | 2 | 3 | 3 | 18 | 🥉 辅助 |
  52. **核心卖点/亮点**:亮点A(聚焦这个,其他作为辅助)
  53. ```
  54. **参考**:`references/xiaohongshu-viral-methodology.md` 第2节
  55. ### Step 1 — 素材清点(有素材才做)
  56. 如果用户提供了素材路径,**先跑脚本生成清单**,再由 AI 用多模态能力填描述:
  57. ```bash
  58. python3 scripts/analyze_material.py <path>... \
  59. --out <work-dir>/reference/materials.json \
  60. --frames-dir <work-dir>/reference/frames
  61. ```
  62. 脚本只做确定性预处理(分类、取分辨率/时长、抽帧)。AI 随后用视觉能力 **打开** `materials.json` 里每条 image/frame,填 `caption` 和 `usage`(cover / content-N / ending / reference)。详见 [`references/material-intake.md`](references/material-intake.md)。
  63. **素材分类(按价值排序)**:
  64. 1. **对比图**(最有价值):before/after、input/output、不同版本对比
  65. 2. **功能演示**:界面截图、操作流程图、效果展示
  66. 3. **数据图表**:性能对比、用户增长、功能覆盖
  67. 4. **品牌素材**:Logo、配色方案、官方截图
  68. **素材使用策略**:
  69. - ✅ **优先级**:真实素材 > 图生图 > 代码叠加 > 纯 AI 生图
  70. - ✅ **对比图**:用图生图(保留真实感 + 叠加小红书风格文字)
  71. - ✅ **纯文字卡片**:用 AI 生图(素人感设计)
  72. - ❌ **避免**:所有卡片都用纯 AI 生图(缺少真实感)
  73. **参考**:`references/xiaohongshu-viral-methodology.md` 第3节
  74. ### Step 2 — 采集外部参考(观点类 / 资讯类必做;纯素材驱动可跳过)
  75. 按 [`references/reference-search.md`](references/reference-search.md) 执行,结果写入同一 `reference/` 目录。核心数据 ≥2 个来源交叉验证。
  76. ### Step 3 — 写长文原稿(2000-4000 字)
  77. 从 H2 开始(**不写 H1**;标题入 `meta.json.title`)。写完**先给用户看**,确认主旨再继续,不要直接跳到卡片/分镜。反模式清单以 [`references/humanizer-zh.md`](references/humanizer-zh.md) 为准。
  78. ### Step 4 — 去 AI 化
  79. 读 [`references/humanizer-zh.md`](references/humanizer-zh.md) 五层原则,完整扫描重写原稿,给出质量评分(满分 50)。
  80. ### Step 4.5 — 图生图处理(有真实素材时必做)
  81. **触发条件**:Step 1 发现了对比图、功能演示等高价值素材
  82. **工具**:gpt-image-2 图生图(需要 OpenAI API key)
  83. **执行**:
  84. ```python
  85. # 使用本项目的 image_generator
  86. import sys
  87. sys.path.insert(0, '~/.claude/skills/xhs-writer-skill/scripts')
  88. from image_generator import GptImage2Generator
  89. generator = GptImage2Generator(aspect_ratio="9:16")
  90. # 图生图:保留真实素材 + 叠加小红书风格文字
  91. generator.generate_scene_image(
  92. scene_data={
  93. 'index': 1,
  94. 'image_prompt': """Based on the reference image, create a Xiaohongshu style card, 9:16 vertical.
  95. Keep the original image visible.
  96. Add overlays:
  97. - Top: "{标题}"
  98. - Bottom: "{引导文字}"
  99. Style:
  100. - Keep original clear
  101. - Casual Xiaohongshu style
  102. - Authentic feel"""
  103. },
  104. output_path='output.jpg',
  105. size='auto',
  106. reference_image_path='material.jpg'
  107. )
  108. ```
  109. **Prompt 模板**:见 `references/xiaohongshu-viral-methodology.md` 附录C
  110. **失败处理**:
  111. 1. 重试 1 次
  112. 2. 降低图片分辨率(max 1024px)
  113. 3. 改用代码叠加文字(`scripts/text_on_image.py`)
  114. ### Step 5 — 分发:图文 or 视频
  115. #### 5A. 图文帖:拆成 3-9 张卡片
  116. - 结构:`cover`(第 1 张) + `content`(中间若干) + `ending`(最后 1 张)
  117. - 每张 ≤80 字(`title` + `content` 合计,代码点计数)
  118. - 一张卡只讲一个论点;数字 / 对比 / 金句优先上卡
  119. - 全套卡片 emoji 风格与配色保持一致
  120. 每张卡选一种 **合成策略**(写入 `cards[i].synthesis_strategy`),五选一。详见 [`references/material-intake.md`](references/material-intake.md):
  121. | strategy | 适用 | 工具 | 优先级 |
  122. |---|---|---|---|
  123. | `img2img` | 有真实素材(对比图/演示图) | gpt-image-2 图生图 | 🥇 最佳 |
  124. | `text_on_photo` | 有 1 张合适照片 + 一句钩子 | `scripts/text_on_image.py` | 🥈 次选 |
  125. | `collage` | 有 2-4 张互补照片 | `scripts/collage_3x4.py` | 🥉 可用 |
  126. | `pure_text` | 无素材,纯文字卡 | AI 生图(素人感) | ✅ 常用 |
  127. | `ai_generated` | 概念图 / 数据图 | 用户自备 t2i 服务 | ⚠️ 慎用 |
  128. **策略选择原则**:
  129. - ✅ 有真实素材 → 优先 `img2img`(保留真实感)
  130. - ✅ 纯文字卡片 → 用 `pure_text`(素人感设计)
  131. - ❌ 避免所有卡片都用 `ai_generated`(广告感强)
  132. 素材有水印 → 先跑 `scripts/crop_watermark.py` 或按 [`references/image-sourcing.md`](references/image-sourcing.md) 处理。
  133. #### 5B. 视频帖:写分镜脚本
  134. - 写 6-12 个分镜,每镜 2-8 秒,累计时长对齐用户预期
  135. - 每镜含:`narration`(口播,≤30 字)、`on_screen_text`(屏幕字,≤15 字)、`visual`(画面描述)、`material_ref`(若引用 `materials.json` 里某条素材)
  136. - 仍要出一张 `cover` 卡(3:4)作为封面;视频本体由用户侧工具合成,本 skill 只产脚本
  137. 字段结构见 [`references/meta-schema.md`](references/meta-schema.md) 的 `shots[]` 定义。
  138. ### Step 6 — caption + hashtags + 标题
  139. **标题生成(5种公式)**:
  140. 1. **痛点+解决方案**:`{具体痛点}?{解决方案}`
  141. - 适用:有明确痛点的工具/产品
  142. 2. **提问式**:`有没有那种{功能描述}的{产品类型}?`
  143. - 适用:新工具推荐、功能发现
  144. 3. **发现式**:`我发现了个宝藏!{核心价值}`
  145. - 适用:兴奋分享、好物推荐
  146. 4. **热点词**:`{热点词}爆火后,我用它做了{场景}`
  147. - 适用:蹭热点、技术类产品
  148. 5. **身份共鸣**:`{身份标签}必备!{核心功能}`
  149. - 适用:有明确目标人群的产品
  150. **参考**:`references/xiaohongshu-viral-methodology.md` 附录F
  151. **caption**:
  152. - 100-300 字,hook 开头(数字/提问/惊叹) → 关键信息 → 行动号召(点赞/收藏/关注)
  153. - 带 emoji,闺蜜语气
  154. - **结构**:痛点共鸣 → 解决方案 → 具体功能 → 真实案例 → CTA
  155. - **避免**:堆砌功能、正式文案、广告感
  156. **hashtags**:
  157. - 5-8 个,与主题强相关
  158. - **核心标签**(4个):热点词 + 核心功能 + 差异化卖点 + 目标人群
  159. - **辅助标签**(4个):场景词 + 品类词
  160. - 避免 `#生活` 等过度泛化标签
  161. 只写进 `meta.json`,**不**粘进卡片或正文
  162. ### Step 7 — 落盘
  163. 目录与命名规则见 [`references/output-spec.md`](references/output-spec.md)。
  164. ```
  165. output/小红书/{YYYY-MM-DD}/{短标题}_{YYYYMMDDHHmm}/
  166. ├── {完整标题}.md # 长文原稿
  167. ├── meta.json # 元数据(卡片 / 分镜 / caption / hashtags / materials)
  168. ├── images/ # (图文)最终卡图 / (视频)封面
  169. └── reference/ # materials.json / 搜索结果 / summary / 思考过程
  170. ```
  171. 目录短标题与时间戳**必须**走脚本标准化,别手写:
  172. ```bash
  173. python3 scripts/normalize_slug.py "原始长标题" --with-ts
  174. ```
  175. `meta.json` 完整字段定义见 [`references/meta-schema.md`](references/meta-schema.md)。
  176. ### Step 8 — 校验(强制)
  177. 写完 `meta.json` 后必须跑:
  178. ```bash
  179. python3 scripts/validate_meta.py <work-dir>/meta.json
  180. ```
  181. 非 0 退出 → 读报错修 `meta.json` 再跑,直到 clean。不要把未校验的产物交给用户。
  182. ## 不要做的事
  183. - 不写 H1;标题只放 `meta.json.title`
  184. - 不在正文末尾写"参考来源 / References";只落到 `reference/`
  185. - 不在 `.md` 里留 `【插入图片:...】` 占位符;图片同步下载 + 引用相对路径
  186. - 不跳过 Step 4(去 AI 化)和 Step 8(validate)
  187. - 不自己手算目录名 / 时间戳,一律走 `normalize_slug.py`
  188. ---
  189. ## 工具依赖
  190. ### 必需工具
  191. - Python 3.8+
  192. - PIL (Pillow)
  193. ### 可选工具
  194. - OpenAI API key(用于图生图,推荐)
  195. - 配置:在 `~/.claude/skills/xhs-writer-skill/.env` 填入 `OPENAI_API_KEY`
  196. - 没有 API key 也能用,会生成纯文字卡片
  197. ### 图生图使用
  198. ```python
  199. # 添加路径
  200. import sys
  201. sys.path.insert(0, '~/.claude/skills/xhs-writer-skill/scripts')
  202. from image_generator import GptImage2Generator
  203. # 初始化
  204. generator = GptImage2Generator(aspect_ratio="9:16")
  205. # 生成
  206. generator.generate_scene_image(
  207. scene_data={'index': 1, 'image_prompt': '...'},
  208. output_path='output.jpg',
  209. size='auto',
  210. reference_image_path='material.jpg' # 图生图模式
  211. )
  212. ```
  213. ---
  214. ## 参考资料
  215. ### 核心方法论
  216. - **`references/xiaohongshu-viral-methodology.md`**:完整爆款方法论
  217. - 卖点优先级判断公式
  218. - 素材使用策略(优先级排序)
  219. - 爆款卡片结构(标准6-7张)
  220. - 文案公式库(5种标题公式)
  221. - 视觉风格指南(素人感 vs 精美设计)
  222. - 图生图 Prompt 模板(3种场景)
  223. - 常见错误清单(5大错误 + 解决方案)
  224. - 工具使用指南
  225. ### 其他参考
  226. - `references/humanizer-zh.md`:去 AI 化原则
  227. - `references/material-intake.md`:素材处理流程
  228. - `references/image-sourcing.md`:图片来源处理
  229. - `references/meta-schema.md`:元数据字段定义
  230. - `references/output-spec.md`:输出目录规范
  231. ---
  232. ## 快速开始
  233. ### 场景1:推广产品/项目
  234. ```bash
  235. # 用户说:"帮我推广这个项目 /path/to/project"
  236. # Step 0.5: 卖点分析
  237. # → 列出功能,让用户打分(稀缺性×实用性×可感知)
  238. # → 选出核心卖点
  239. # Step 1: 素材盘点
  240. # → 扫描项目截图、对比图、演示图
  241. # → 分类:对比图(最有价值)> 功能演示 > 其他
  242. # Step 4.5: 图生图
  243. # → 对比图用图生图(保留真实感 + 小红书风格)
  244. # → 纯文字卡片用 AI 生图(素人感)
  245. # Step 6: 生成标题(5个选项)
  246. # → 痛点式、提问式、发现式、热点词、身份共鸣
  247. # 输出:6-7张卡片 + caption + hashtags
  248. ```
  249. ### 场景2:好物分享/经验总结
  250. ```bash
  251. # 用户说:"写一条关于 XX 好物推荐的小红书笔记"
  252. # Step 0: Intake
  253. # → 确认主题、目标读者、输出形态
  254. # Step 0.5: 亮点分析
  255. # → 这个好物的核心亮点是什么?
  256. # Step 1: 素材盘点
  257. # → 产品图、使用场景图、效果对比图
  258. # Step 3-4: 写长文 + 去 AI 化
  259. # Step 5: 拆成卡片
  260. # → 封面(提问/发现式)+ 亮点展示 + 使用场景 + 真实体验 + CTA
  261. # 输出:5-7张卡片 + caption + hashtags
  262. ```
  263. ### 场景3:知识科普/教程
  264. ```bash
  265. # 用户说:"写一条关于 XX 知识的小红书笔记"
  266. # Step 0: Intake
  267. # → 确认主题、目标读者、知识点
  268. # Step 2: 采集外部参考
  269. # → 搜索相关资料,交叉验证
  270. # Step 3-4: 写长文 + 去 AI 化
  271. # Step 5: 拆成卡片(纯文字)
  272. # → 用 AI 生图(素人感设计)
  273. # → 结构:封面 + 核心概念 + 步骤/要点 + 注意事项 + CTA
  274. # Step 6: caption + hashtags
  275. # 输出:5-7张卡片 + caption + hashtags
  276. ```
  277. ---
  278. ## 常见问题
  279. ### Q1:什么时候用图生图?
  280. **A**:有真实素材(对比图、演示图、截图)时优先用图生图。效果:真实感 > 代码叠加 > 纯 AI 生图。
  281. ### Q2:如何判断卖点优先级?
  282. **A**:用公式 `优先级 = 稀缺性(1-5) × 实用性(1-5) × 可感知(1-5)`,选择得分最高的 1-2 个作为核心卖点。
  283. ### Q3:封面选哪种风格?
  284. **A**:
  285. - 有明确痛点 → 痛点式
  286. - 新工具推荐 → 提问式
  287. - 好物分享 → 发现式
  288. - 蹭热点 → 热点词式
  289. - 明确人群 → 身份共鸣式
  290. ### Q4:图生图失败怎么办?
  291. **A**:三级降级策略
  292. 1. 重试 1 次
  293. 2. 降低图片分辨率(max 1024px)
  294. 3. 改用代码叠加文字(`scripts/text_on_image.py`)
  295. ### Q5:需要多少张卡片?
  296. **A**:
  297. - 最少:3张(封面 + 核心卖点 + CTA)
  298. - 标准:6张(封面 + 卖点 + 功能 + 人群 + 案例 + CTA)
  299. - 完整:7张(+ 开源地址/官方链接)
  300. ---
  301. **更新时间**:2026-04-25
  302. **适用场景**:产品推广、好物分享、知识科普、经验总结、测评对比等各类小红书内容
README.md · README · 246 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <div align="center">
  2. # xhs-writer-skill
  3. **小红书爆款笔记生成器 — 从主题到发布,一条龙。**
  4. Claude Code / OpenClaw Skill。装进 agent 后,用一句自然语言生成 9:16 竖版卡片组(图文)或短视频脚本,配 caption + hashtags,按规范落盘。支持真实素材图生图、卖点分析、5种标题公式。
  5. [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](./LICENSE)
  6. [![Python](https://img.shields.io/badge/python-3.8%2B-blue.svg)](https://www.python.org/)
  7. [![Claude Code](https://img.shields.io/badge/Claude%20Code-Skill-orange.svg)](https://www.anthropic.com/claude-code)
  8. </div>
  9. ---
  10. ## 🎬 效果演示:真实案例
  11. **案例**:推广 gpt-image2-ppt-skills 开源项目
  12. <table>
  13. <tr>
  14. <th width="50%">输入:GitHub 项目原图</th>
  15. <th width="50%">输出:小红书风格卡片(9:16 竖版)</th>
  16. </tr>
  17. <tr>
  18. <td><img src="docs/assets/input-github-screenshot.jpg" width="100%" alt="GitHub 原图:模板演示"></td>
  19. <td><img src="docs/assets/demo-comparison.jpg" width="100%" alt="小红书卡片:对比图"></td>
  20. </tr>
  21. <tr>
  22. <td align="center"><sub>GitHub 项目截图(原始素材)</sub></td>
  23. <td align="center"><sub>卡片2:对比图(图生图)<br/>保留真实对比效果 + 小红书风格文字</sub></td>
  24. </tr>
  25. <tr>
  26. <td><img src="docs/assets/input-style-gallery.jpg" width="100%" alt="GitHub 原图:10种风格"></td>
  27. <td><img src="docs/assets/demo-styles.jpg" width="100%" alt="小红书卡片:风格展示"></td>
  28. </tr>
  29. <tr>
  30. <td align="center"><sub>GitHub 项目截图(10种风格展示)</sub></td>
  31. <td align="center"><sub>卡片3:风格展示(图生图)<br/>保留真实素材 + 素人感设计</sub></td>
  32. </tr>
  33. </table>
  34. **完整案例**:
  35. - **输入**:GitHub 项目链接 `https://github.com/JuneYaooo/gpt-image2-ppt-skills` + 项目截图素材
  36. - **流程**:
  37. 1. 扫描项目素材(README 图片、演示图、对比图)
  38. 2. 搜索同类爆款("AI做PPT"、"PPT工具"相关笔记)
  39. 3. 卖点分析(模板克隆 125分 > 10种风格 18分)→ 聚焦核心卖点
  40. 4. 拆解爆款结构(标题模式、卡片布局、钩子套路)
  41. 5. 图生图处理(保留真实素材 + 小红书风格文字)
  42. 6. 生成 5 个标题选项(痛点式、提问式、发现式、热点词、身份共鸣)
  43. - **输出**:7张卡片 + caption + hashtags + 发布方案
  44. - **效果**:素人感设计 + 真实素材 + 爆款公式 = 可直接发布
  45. ---
  46. ## ✨ 能做什么
  47. - 🔍 **智能分析** — 给一个 GitHub 项目链接 + 素材,自动扫描项目内容、搜索同类爆款、分析卖点优先级
  48. - 🎯 **卖点/亮点分析** — 用公式(稀缺性×实用性×可感知)自动判断优先级,聚焦核心卖点
  49. - 📚 **爆款拆解** — 搜索同类内容的爆款笔记,提取标题模式、卡片结构、钩子套路
  50. - 🖼️ **真实素材优先** — 项目截图、对比图用图生图(gpt-image-2),保留真实感 > 纯 AI 生图
  51. - 🎨 **素人感设计** — 纯色背景 + 大 emoji + 口语化,不是品牌宣传风格
  52. - 📝 **5种标题公式** — 痛点式、提问式、发现式、热点词、身份共鸣,自动生成选项
  53. - 🔄 **快速迭代** — V1(60分) → 用户反馈 → V2(70分),持续优化
  54. - 📦 **完整交付** — 6-7张卡片 + caption + hashtags + 发布方案,可直接发布
  55. ## 📱 适用场景
  56. - ✅ **产品推广** — 开源项目、SaaS 工具、App 应用
  57. - ✅ **好物分享** — 数码产品、生活好物、美妆护肤
  58. - ✅ **知识科普** — 技术教程、生活技巧、行业知识
  59. - ✅ **经验总结** — 职场经验、学习方法、成长心得
  60. - ✅ **测评对比** — 产品对比、使用体验、效果评测
  61. ---
  62. ## 🚀 安装
  63. ### 方式一:让 AI 自己装(推荐)
  64. 把下面这段 prompt 丢给你的 AI 助手(Claude Code / OpenClaw / Codex / Cursor 都行),它会自动完成安装:
  65. ```
  66. 帮我安装 xhs-writer-skill:
  67. https://raw.githubusercontent.com/JuneYaooo/xhs-writer-skill/main/docs/install.md
  68. ```
  69. agent 会自己 clone 仓库、跑安装脚本、提示你重启。
  70. ### 方式二:手动安装
  71. ```bash
  72. git clone https://github.com/JuneYaooo/xhs-writer-skill.git
  73. cd xhs-writer-skill
  74. bash install_as_skill.sh
  75. ```
  76. 脚本会把 skill 装到 `~/.claude/skills/xhs-writer-skill/`,Claude Code 重启后自动识别。
  77. ### 配置(可选)
  78. 如果需要图生图功能(推荐),配置 OpenAI API key:
  79. ```bash
  80. # 创建 .env 文件
  81. cat > ~/.claude/skills/xhs-writer-skill/.env << 'EOF'
  82. OPENAI_BASE_URL=https://api.openai.com
  83. OPENAI_API_KEY=sk-your-key-here
  84. GPT_IMAGE_MODEL_NAME=gpt-image-2
  85. GPT_IMAGE_QUALITY=high
  86. EOF
  87. ```
  88. > 🔒 **不会误吃密钥**:只从 skill 自己目录的 `.env` 加载。
  89. >
  90. > 💡 **图生图 vs 纯文字卡片**:有真实素材时,图生图效果远超纯 AI 生图(保留真实感)。没有 API key 也能用,会生成纯文字卡片。
  91. ---
  92. ## 🛠 在 Claude Code 里怎么用
  93. 装完直接跟 Claude 说人话就行:
  94. ### 场景1:推广产品/项目(推荐配合 social-account-doctor)
  95. > 帮我推广这个项目 `https://github.com/xxx/project`,项目截图在 `/path/to/screenshots`,先搜一下同类产品的爆款笔记,然后参考它们的结构做一套小红书卡片。
  96. Claude 会:
  97. 1. **扫描项目**:读取 GitHub README、项目介绍、功能列表
  98. 2. **素材盘点**:你的项目截图、对比图、演示图
  99. 3. **找对标**:搜索同类产品的爆款笔记(用 social-account-doctor)
  100. 4. **拆爆款**:分析标题模式、卡片结构、钩子套路
  101. 5. **卖点分析**:让你打分(稀缺性×实用性×可感知)
  102. 6. **套公式**:用爆款的结构 + 你的真实素材
  103. 7. **图生图**:保留真实素材 + 小红书风格文字
  104. 8. **输出**:6-7 张卡片 + caption + hashtags + 发布方案
  105. ### 场景2:快速生成(不分析对标)
  106. > 帮我推广这个项目 `/path/to/project`,做一套小红书卡片。
  107. Claude 会:
  108. 1. 扫描项目素材(截图、对比图、演示图)
  109. 2. 卖点分析(让你打分:稀缺性×实用性×可感知)
  110. 3. 生成 5 个标题选项(痛点式、提问式等)
  111. 4. 用图生图处理真实素材
  112. 5. 输出 6-7 张卡片 + caption + hashtags
  113. ### 场景3:好物分享
  114. > 写一条关于 XX 好物推荐的小红书笔记。
  115. Claude 会:
  116. 1. 确认亮点(这个好物的核心优势是什么)
  117. 2. 素材盘点(产品图、使用场景图)
  118. 3. 生成卡片(封面 + 亮点展示 + 使用场景 + 真实体验 + CTA)
  119. ### 场景4:知识科普
  120. > 写一条关于 XX 知识的小红书笔记。
  121. Claude 会:
  122. 1. 采集外部参考(搜索资料,交叉验证)
  123. 2. 写长文原稿 + 去 AI 化
  124. 3. 拆成卡片(封面 + 核心概念 + 步骤/要点 + 注意事项 + CTA)
  125. > 🧑‍💻 想自己写脚本调 CLI 而不走 agent?看 [`SKILL.md`](./SKILL.md),完整工作流程都在那。
  126. ---
  127. ## 📊 方法论框架
  128. ### 5大核心原则
  129. 1. **真实素材优先** — 项目截图、对比图、演示图 > 纯 AI 生图
  130. 2. **聚焦核心卖点** — 用公式判断优先级(稀缺性×实用性×可感知)
  131. 3. **素人感设计** — 纯色背景 + 大 emoji + 口语化 > 品牌宣传风格
  132. 4. **痛点导向** — 说"能解决什么问题" > 堆砌功能列表
  133. 5. **快速迭代** — V1(60分) → 用户反馈 → V2(70分) → 持续优化
  134. ### 5种标题公式
  135. | 公式 | 格式 | 适用场景 |
  136. |---|---|---|
  137. | 痛点式 | `{具体痛点}?{解决方案}` | 有明确痛点的工具/产品 |
  138. | 提问式 | `有没有那种{功能描述}的{产品类型}?` | 新工具推荐、功能发现 |
  139. | 发现式 | `我发现了个宝藏!{核心价值}` | 兴奋分享、好物推荐 |
  140. | 热点词 | `{热点词}爆火后,我用它做了{场景}` | 蹭热点、技术类产品 |
  141. | 身份共鸣 | `{身份标签}必备!{核心功能}` | 有明确目标人群的产品 |
  142. ### 工作流程建议
  143. **推荐流程**(结合 [social-account-doctor](https://github.com/JuneYaooo/social-account-doctor)):
  144. ```
  145. Step 1: 找对标爆款
  146. → 用 social-account-doctor 搜索同类内容
  147. → 分析爆款的钩子、结构、封面风格
  148. Step 2: 拆解爆款
  149. → 提取可复用的公式(标题模式、卡片结构、文案套路)
  150. → 不是照搬,是学习底层逻辑
  151. Step 3: 套自己的内容
  152. → 用 xhs-writer-skill 生成初稿
  153. → 应用从爆款学到的公式
  154. → 保留自己的真实素材和独特卖点
  155. Step 4: 快速迭代
  156. → V1 发布 → 看数据 → 优化 → V2
  157. ```
  158. **卡片结构**:不固定模板,根据对标爆款和内容类型灵活调整。
  159. 常见结构参考:
  160. - 推广类:封面 + 核心卖点 + 功能展示 + 目标人群 + 真实案例 + CTA + 链接
  161. - 好物类:封面 + 产品亮点 + 使用场景 + 效果对比 + 购买建议 + CTA
  162. - 知识类:封面 + 核心概念 + 步骤拆解 + 注意事项 + 总结 + CTA
  163. 详细方法论见:[`references/xiaohongshu-viral-methodology.md`](./references/xiaohongshu-viral-methodology.md)
  164. ---
  165. ## 📁 输出结构
  166. ```
  167. output/小红书/{YYYY-MM-DD}/{短标题}_{YYYYMMDDHHmm}/
  168. ├── {完整标题}.md # 长文原稿
  169. ├── meta.json # 元数据(卡片/caption/hashtags/materials)
  170. ├── images/ # 最终卡图(9:16 竖版)
  171. └── reference/ # materials.json / 搜索结果 / 思考过程
  172. ```
  173. ---
  174. ## 💬 Community
  175. [**LINUX DO — 中文开发者社区**](https://linux.do/)
  176. ---
  177. ## License
  178. Apache License 2.0,详见 [LICENSE](./LICENSE)。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.