---
name: xiaohongshu-writer
description: 小红书图文内容创作助手。**必须传入 content**（含 title、body、hashtags、thumbnail），建议 generate_thumbnail=true。用 Pillow 绘制封面，优先本地字体。
license: MIT
compatibility: Requires Python 3.x with Pillow (pip install Pillow)
metadata:
  author: skillLite
  version: "1.0"
---

# 小红书图文创作助手

## 工作流程

1. **Agent 用本 Skill 的指引**，根据用户主题生成完整内容（标题、正文、标签、封面设计）
2. **调用本工具**，传入生成的 `content`，建议 `generate_thumbnail: true`
3. **脚本**：优先用 Pillow 绘制封面（快速、无浏览器），失败时可选 Playwright 截图；返回 base64 及保存到 `image_path`

**无需 OpenAI**，优先 Pillow 绘图，可选 Playwright 渲染 HTML。

---

## 输出结构（工具返回）

```json
{
  "success": true,
  "title": "吸睛标题，带 emoji",
  "body": "正文内容",
  "hashtags": ["#话题1", "#话题2"],
  "thumbnail": {
    "cover_title": "封面显示标题",
    "accent_color": "#FF6B6B",
    "style": "gradient",
    "image_base64": "封面图 base64（仅当未保存到文件时返回，避免输出过大）",
    "image_path": "项目根目录下保存的图片路径，如 xiaohongshu_thumbnail.png",
    "image_source": "pillow 或 playwright"
  }
}
```

---

## 标题规则

- **长度**：15-25 字为宜，信息密度高
- **必备**：至少 1 个 emoji，放在开头或关键词处
- **禁止**：标题党、夸张承诺、违禁词
- **技巧**：数字+结果、反常识、疑问式、场景代入

---

## 正文规则

- **分段**：每段 2-4 行，多用空行隔开
- **语气**：口语化、像朋友分享，用"我"、"你"
- **emoji**：适当点缀，每段 0-2 个，不过度
- **结构**：开头抓人 → 干货/故事 → 总结/互动
- **禁止**：硬广感、堆砌关键词、违禁词

---

## 标签规则

- **数量**：3-5 个
- **搭配**：1 个大类话题 + 2-3 个细分 + 1 个热门
- **示例**：#生活好物 #平价好物 #宿舍党必备 #618攻略

---

## 缩略图（封面）设计

封面为**高质量图文风格**，包含三部分：**主标题**、**正文摘要**（2–5 行）、**话题标签**。由 Pillow 绘制（主）或 HTML + Playwright 截图（备选）生成，竖版 3:4。成功后保存到项目根目录 `xiaohongshu_thumbnail.png`。

### Agent 生成 content 时，thumbnail 需包含：

| 字段 | 说明 | 示例 |
|------|------|------|
| `cover_title` | 封面上显示的主标题（可略，默认用 title） | "3 件办公室好物" |
| `accent_color` | 主色调，十六进制或中文 | "#FF6B6B" 或 "暖橙" |
| `style` | 风格 | "gradient" / "minimal" / "vibrant" |

### 风格说明

- `gradient`：渐变背景，主色到深色（默认）
- `minimal`：简约灰白
- `vibrant`：纯色块

---

## 使用方式

**工具调用**：传入 `content`（必填），即 Agent 已生成的内容。格式：

```json
{
  "content": {
    "title": "🛒 打工人的 3 件办公室好物！",
    "body": "正文...",
    "hashtags": ["#办公室好物", ...],
    "thumbnail": {
      "cover_title": "3 件办公室好物",
      "accent_color": "#FF6B6B",
      "style": "gradient"
    }
  },
  "generate_thumbnail": true
}
```

**前置条件**：
- `pip install Pillow`（必需，skilllite init 时会安装）
- **中文字体**：macOS 自带 PingFang 即可；Linux 需 `apt install fonts-noto-cjk` 或于 `fonts/` 目录放入 NotoSansCJKsc-Regular.otf（否则封面标题会显示为方框）
- 可选：`playwright` + `playwright install chromium`（Pillow 失败时备用；skilllite init 会安装）

## Runtime

```yaml
entry_point: scripts/main.py
language: python
input_schema:
  type: object
  properties:
    content:
      type: object
      description: Agent 生成的小红书内容，含 title、body、hashtags、thumbnail
    generate_thumbnail:
      type: boolean
      description: 是否生成缩略图
      default: true
  required:
    - content
```