visual-ops-writer git:20260817.17b8940A

Immutable. This exact content is served forever at /api/v1/blob/ffa5879e9ec5dfe4.

---
name: visual-ops-writer
description: 图文运营创作器。从选题、撰写、配图到质检，一条龙完成运营文章生产。看到好文章能仿写，给个 Skill 能生成推广长文，写完正文能自动配图。内置写作质量管控与自动配图能力，图文一体交付。触发词："生成运营文章"、"链接仿写"、"对标分析"、"Skill 推广"、"为正文配图"。
---

# 图文运营创作器

从选题、撰写、配图到质检，覆盖运营文章的完整创作链路。你只需要提供素材——一篇文章链接、一个 Skill、或者一段写好的正文，剩下的交给它。

> 核心执行流程详见 `references/core_workflow.md`

---

## 简介

图文运营创作器解决的是内容团队最常见的效率瓶颈：**一篇文章从写到配，往往需要多人协作、反复打磨**。

通过这个工具，你可以：

- 看到一篇好文章，直接仿写为自己的版本，风格一致但内容全新
- 给一个 Skill 或产品，自动生成一篇专业的推广长文，配图到位
- 写完正文不想找图，丢进来自动判断哪里该配图、配什么风格

三种场景，一个工具全覆盖。

**适用对象**

- 📝 **内容运营** — 快速产出对标风格文章与产品推广文，从写到配一条龙搞定
- 🛍️ **品牌 / 技能开发者** — 自动生成对齐产品能力的推广长文，内容与功能不脱节
- 🏢 **博主 / 编辑** — 为已有正文智能配图，省去手动规划配图位置的麻烦

---

## 功能特性

### 🎯 核心功能

- **🔗 链接仿写**：提供任意文章链接，自动抓取原文内容与图片，学习其风格与结构，仿写全新文章。配图风格与原图保持一致，适合对标分析与竞品内容学习。
- **📣 Skill 推广文**：提供 Skill 文件路径或名称，自动解析产品能力并抓取目标站点最新信息，生成与产品实际能力对齐的推广长文。配图采用红狐讲解员风格，视觉与内容双重匹配。
- **🖼️ 正文补图**：提供完整正文，自动按章节语义与字数密度分析文章结构，智能决定配图位置与数量，批量生成风格统一的配图。适合写完正文不想手动找图的场景。
- **✅ 自动质量检查**：每篇文章生成后自动执行 9 项质量检查（标题长度、章节数、表格数、字数、FAQ 数量、禁忌词、段落行数、信息密度等），输出 JSON 格式质检报告。

### 写作质量管控

不是随便写一篇就交差。文章生成过程内置完整的质量管控体系：

- **文章类型自动匹配**：根据选题自动识别为工具推介型、方法论型或危机应对型，每种类型有独立的写作侧重与结构建议
- **读者画像适配**：支持个体创作者和团队/企业两种读者定位，自动调整表达侧重（个人可执行方法 vs 工具系统协同）
- **语调可选**：直白坦率 / 专业严谨 / 轻松对话，默认直白坦率
- **成文字数可控**：支持自定义字数区间（默认 2000-3000 字），链接仿写按原文篇幅自适应

### 自动配图能力

文章配图不是简单的"插张图"，而是内容的一部分：

- **风格迁移**：链接仿写模式下，原图作为风格参照，新内容自动生成，视觉风格保持一致
- **语义匹配**：Skill 推广模式下，配图按章节语义自动匹配讲解员姿态（欢迎、分析、思考、操作等）
- **智能断章**：正文补图模式下，按 H2 章节切分 + 字数密度自动决策生图点，跳过 FAQ / 结语 / 引言等不适合配图的位置
- **数量可控**：配图数量上限 0-5 张可调，也可由系统自动决策

---

## 一键安装

### 前置条件

- Python 3.8+（用于运行配图生成与质量检查脚本）
- `REDFOX_API_KEY`（用于图片生成，未配置时仍可生成纯文本文章）

### 安装步骤

1. 将本 Skill 目录添加到你的 Agent 技能列表
2. 获取 `REDFOX_API_KEY`：前往 [红狐 hub](https://redfox.hk?source=github) 注册账号，在 [API Keys 页面](https://redfox.hk/settings/api-keys?source=github) 创建密钥
3. 配置环境变量：

```bash
# macOS / Linux
export REDFOX_API_KEY="your_key_here"

# Windows PowerShell
$env:REDFOX_API_KEY="your_key_here"
```

4. 验证安装：告诉 Agent「帮我给这个 Skill 写一篇推广文」，确认技能正常响应

### 环境变量说明

| 变量名 | 必填 | 说明 |
|--------|------|------|
| `REDFOX_API_KEY` | 条件必填 | 图片生成服务密钥；未配置时文章正常生成，图片降级为占位符或跳过 |

---

## 使用指南

### 基础使用

#### 1. 链接仿写

告诉 Agent 你想仿写的文章链接：

> 用户：帮我仿写这篇文章，保持风格但换成我的产品
> https://example.com/some-article
>
> Agent：已抓取原文，正在学习风格与结构…文章已生成，含 3 张配图，保存为 article.md。

#### 2. Skill 推广文

提供 Skill 文件或名称：

> 用户：帮我给 xhs-ranking 这个 Skill 写一篇推广文
>
> Agent：已解析 Skill 能力并抓取目标站点信息，推广文章已生成，含红狐风格配图 3 张。

#### 3. 正文补图

粘贴正文或提供文件路径：

> 用户：帮我给这篇正文加上配图
> （粘贴正文内容）
>
> Agent：正文共 1800 字，已识别 4 个配图位置，配图生成中…完成，保存为 article.md。

### 高级使用

- 指定语调：「用专业严谨的语调写」
- 指定读者：「目标读者是团队企业」
- 指定配图数量：「最多配 2 张图」
- 关闭配图：「不需要配图」或「style 设为 none」
- 指定字数：「控制在 1500 字左右」

### 常用说法速查

| 意图 | 示例话术 | 效果 |
|------|---------|------|
| 链接仿写 | 「帮我仿写这篇文章，保持风格但换成我的产品」 | 学习原文风格与结构，生成配图一致的全新文章 |
| Skill 推广 | 「帮我给这个 Skill 写一篇推广文」 | 自动生成对齐产品能力的推广长文与配图 |
| 正文补图 | 「帮我给这篇正文加上配图」 | 智能分析文章结构，自动决定配图位置并生成 |
| 竞品分析 | 「分析这篇文章的写法，帮我写一篇不同角度的」 | 学习优秀内容的结构与风格，产出差异化内容 |
| 控制语调 | 「用轻松对话的语气写」 | 按指定语调生成文章 |
| 关闭配图 | 「不需要配图」 | 仅输出纯文本文章 |

---

## 使用场景

| 场景 | 角色 | 示例问法 | 收益 |
|------|------|---------|------|
| 对标仿写 | 内容运营 | 「帮我仿写这篇文章，保持风格但换成我的产品」 | 快速产出风格一致的高质量文章，省去从零开始的构思 |
| Skill 推广 | 技能开发者 | 「帮我给这个 Skill 写一篇推广文」 | 自动生成对齐产品能力的推广文章，内容与功能不脱节 |
| 文章配图 | 博主/编辑 | 「帮我给这篇正文加上配图」 | 智能选择配图位置与数量，无需手动规划 |
| 竞品分析 | 品牌运营 | 「分析这篇文章的写法，帮我写一篇不同角度的」 | 学习优秀内容的结构与风格，产出差异化内容 |

---

## 输出说明

完成生成后，你将收到：

1. **完整文章**：保存为 `article.md`，含标题、正文、FAQ（如有）、配图（以 `![描述](URL)` 嵌入对应章节）
2. **质检报告**：`validation_report.json`，含 9 项文章质量检查结果
3. **对话内全文**：直接在对话中输出文章全文
4. **反馈节点**：如需调整某章节或配图，可告知具体修改方向

---

## 常见问答

**Q1: 没有 API Key 能用吗？**

A: 可以。没有 `REDFOX_API_KEY` 时，文章正文正常生成，图片部分降级处理：链接仿写用占位符替代，Skill 推广和正文补图跳过配图，仅输出纯文本。

**Q2: 生成的文章可以手动调整吗？**

A: 可以。生成后直接告诉 Agent 你想调整的方向（如「第三段改短一点」「换一张配图」），Agent 会基于现有文章定向修改。

**Q3: 配图风格可以自定义吗？**

A: 支持三种风格：`redfox`（红狐讲解员）、`reference`（跟随原图风格）、`none`（无风格修饰）。告诉 Agent 你的偏好即可。

---

## 项目架构

```
visual-ops-writer/
├── SKILL.md                          # 技能入口文件
├── references/
│   ├── core_workflow.md              # 核心执行流程（Agent 执行链）
│   ├── writing-framework.md          # 写作框架参考
│   ├── article-type-templates.md     # 文章类型模板（工具推介/方法论/危机应对）
│   ├── persona-matrix.md             # 语气×读者×视觉 IP 配置矩阵
│   ├── image-decision-rules.md       # 配图决策规则
│   ├── link-rewrite-guide.md         # 链接仿写指南
│   ├── prompt-templates.md           # 提示词模板
│   └── error-handling.md             # 错误处理
├── scripts/
│   ├── fetch_article.py              # 文章抓取与解析
│   ├── validate_article.py           # 机器化质量检查
│   ├── generate_image.py             # 图片生成（支持文生图与风格迁移）
│   └── decide_images.py              # 配图位置与数量决策
└── assets/
    ├── 02.jpg                        # 素材图片
    └── 03.jpg                        # 素材图片
```