visual-ops-writer

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 注册账号，在 API Keys 页面 创建密钥
3. 配置环境变量：

# 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                        # 素材图片