# XHS Skills — 小红书全流程 Agent Skills

把小红书运营拆成定位、选题、写作、视觉和复盘等环节，每个环节一个 Skill，外加一个总控把它们串起来。

**不是"一键起号"按钮。** 只做分析和参谋：不自动发布、不抓取批量数据、不刷互动、不做批量起号和矩阵养号。内容永远是你的。

## 10 个 Skill

| Skill | 干什么 | 需要 Key |
|---|---|:---:|
| `space-xhs-buddy` | **总控台**：判断你卡在哪一环，路由并串成工作流 | — |
| `space-xhs-positioning` | 起号定位：赛道选择、定位句、人设三件套、内容支柱、前 20 篇、冷启动 | — |
| `space-xhs-hotspot` | 热点选题：拉高互动笔记、判趋势、爆款共性提取、跨赛道对比 | ✅ |
| `space-xhs-title` | 爆款标题：15 种小红书方法批量出候选、评分、合规校验、A/B 建议 | — |
| `space-xhs-writer` | 笔记正文：7 种笔记类型、标签策略、合规改写、发布前 14 项体检 | — |
| `space-xhs-cover` | 封面制作：标题提炼、原创风格推荐、主体保真、背景合成、单张或多版测试 | — |
| `xhs-html` | 图文排版：内容拆成 6 张以上 3:4 单文件 HTML，62 种风格、页数选择、逐页校验 | — |
| `space-xhs-image` | AI 信息图：用 Codex 内置生图模型制作单图或 6–9 张 3:4 紫绿科技感组图 | — |
| `space-xhs-account-audit` | 账号体检：八维打分、竞品对标、卡点定位 | 可选 |
| `space-xhs-note-analytics` | 笔记复盘：六层漏斗归因、多篇横向找规律 | — |

## 安装

```bash
git clone https://github.com/SpaceZephyr/creator-buddy.git
cp -r creator-buddy/xhs-Skills/space-xhs-* ~/.claude/skills/
cp -r creator-buddy/xhs-Skills/xhs-html ~/.claude/skills/
```

装完在 Claude Code 里说「帮我做小红书」会自动路由到总控，或直接点名环节，比如「帮我看看这条笔记数据」。

## 配置（可选）

除平台数据查询外，其余 Skill 不需要第三方 API Key。需要真实平台数据时配置任一：

```bash
export REDFOX_API_KEY=...        # https://redfox.hk        近 30 天爆款库，带三维评分
export SOCIALDATAX_API_KEY=...   # https://socialdatax.com  近实时搜索
export GUAIKEI_API_TOKEN=...     # https://www.guaikei.com  详情 + 评论 + 博主作品，拆号必需
```

`hotspot` 和 `account-audit` 会**运行时探测并逐级降级**，三个都没有时走公开搜索兜底 —— 仍能跑完流程，只是拿不到互动数，且会明确标注"未经数据验证"，不靠猜补齐。

`space-xhs-image` 直接调用 Codex runtime 提供的内置 `image_gen`，不需要 `GOOGLE_API_KEY`、`OPENAI_API_KEY` 或其他外部生图后端。

## 三条标准工作流

```
链 A 从零起号   positioning → hotspot → writer → title → space-xhs-cover + xhs-html / space-xhs-image → 发布
                              ↳ 累计 20-30 篇后回 account-audit 复诊

链 B 日常产出   hotspot → writer → title → space-xhs-cover + xhs-html / space-xhs-image

链 C 诊断改进   note-analytics 定位卡在漏斗哪一层
                  ├ 曝光就低      → account-audit（标签/定位/权重）
                  ├ 曝光够 CTR 低 → title + space-xhs-cover
                  └ 点击够互动低  → writer（开头留人/价值兑现）
```

**链 C 的顺序不能反。** 跳过诊断直接改标题是最常见的浪费 —— 曝光就低的时候，标题不是问题。

## 三个视觉 Skill 怎么选

- **只做首图封面时用 `space-xhs-cover`**：输入主题、标题和可选的人物、产品或背景素材，生成一张 3:4 封面；也可以做 3 或 6 版构图测试。
- **需要文字精确、可编辑时用 `xhs-html`**：把文章、教程、SOP 或清单拆成 6 张以上 3:4 图文，并输出一个可连续截图的 HTML；支持 62 种设计风格。
- **需要模型直接生成位图时用 `space-xhs-image`**：输入内容后生成单图或 6–9 张信息图，固定采用白底、紫蓝与青柠绿强调、圆角卡片和线性科技图标。
- `space-xhs-cover` 与 `space-xhs-image` 都会调用内置生图模型并复核中文；要求文字 100% 可控时仍优先选择 `xhs-html`。

## 设计上的几个取舍

**合规优先于爆款。** 小红书的违规惩罚通常是**限流**而非删帖 —— 你看得见自己的笔记，但没有推荐流量，最难自查。所以功效词、绝对化用语、医疗表述在动笔阶段就拦，不等发布前体检。`writer` 里有一张高危词对照替换表，总原则是「把客观断言改写成主观体验」。

**规则要能约束生成本身，而不只是写给人看。** 例：`title` 的红线规定正文不是 step-by-step 就不许用"保姆级"—— 哪怕"保姆级"是这个赛道点击率最高的钩子，它也会把这类候选直接淘汰。

**纪律尽量写进代码。** `note-analytics` 的脚本会自动拒绝 n<3 分组的比较、在均值/中位数 >2 时告警"别引用平均值"；`xhs-html` 的渲染脚本会逐页检查 1080×1440 尺寸、最少页数和内容溢出，并支持 `--strict` 非 0 退出。写在文档里模型可能不看，写进代码就绕不过去。

**不编造。** 没有数据源就不报互动数字，没有对标笔记就不给选题，接口拿不到粉丝数就标"无法计算"而不是估算。

## 已知限制

- `hotspot` 的 `compare_sets.py` 高频词统计用的是 n-gram 滑窗（无中文分词依赖），会有切片噪音；形态分类在部分赛道命中率低。
- `space-xhs-image` 依赖 runtime 暴露内置 `image_gen`；不支持该工具的 runtime 无法直接生图。
- `space-xhs-cover` 同样依赖 runtime 暴露内置 `image_gen`；无内置生图工具时只能生成封面方案与提示词。
- 生图模型的中文仍需逐页人工复核；连续修正后仍有错字时，改用 `xhs-html` 输出文字确定版。
- 所有第三方数据服务均为付费，按量计费，与本仓库无关联。

## 许可与免责

数据来源于第三方服务收录的公开笔记，版权归原作者所有，仅供学习和创作参考。使用者需自行遵守小红书平台规则。