| 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（用于图片生成，未配置时仍可生成纯文本文章）
安装步骤
- 将本 Skill 目录添加到你的 Agent 技能列表
- 获取
REDFOX_API_KEY：前往 红狐 hub 注册账号，在 API Keys 页面 创建密钥
- 配置环境变量：
export REDFOX_API_KEY="your_key_here"
$env:REDFOX_API_KEY="your_key_here"
- 验证安装：告诉 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 写一篇推广文」 | 自动生成对齐产品能力的推广文章，内容与功能不脱节 |
| 文章配图 | 博主/编辑 | 「帮我给这篇正文加上配图」 | 智能选择配图位置与数量，无需手动规划 |
| 竞品分析 | 品牌运营 | 「分析这篇文章的写法，帮我写一篇不同角度的」 | 学习优秀内容的结构与风格，产出差异化内容 |
输出说明
完成生成后，你将收到：
- 完整文章：保存为
article.md，含标题、正文、FAQ（如有）、配图（以  嵌入对应章节）
- 质检报告：
validation_report.json，含 9 项文章质量检查结果
- 对话内全文：直接在对话中输出文章全文
- 反馈节点：如需调整某章节或配图，可告知具体修改方向
常见问答
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 # 素材图片
