wechat-tech-writer

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

微信公众号技术文章写作助手

WeChat Official Account Technical Article Writing Assistant

⚠️ 核心原则

⚠️ Core Principles

必须严格遵守的5个要点

5 Must-Follow Key Points

🎯 封面图是强制要求
- 每篇文章必须生成一张吸引人的主题封面图
- 封面图独立于内容配图，作为第一张图片出现
图片文字使用中文
- 所有生成图片上的文字必须使用简体中文
- 在提示词中明确要求："text in simplified Chinese, minimal text, accurate"
图片数量控制
- 封面图：1张（强制）
- 内容配图：0-2张（按需生成）
- 判断标准：有数据对比→生成对比图；有复杂架构→生成架构图；其他情况不生成
文章只输出正文
- ❌ 禁止添加："参考资料"、"图片说明"、"优缺点说明"等章节
- ✅ 只保留：标题 + 封面图 + 正文 + 结尾总结

链接使用纯文本格式

❌ 错误：
```
[官网](https://example.com/)
```
✅ 正确：
```
官方网站：https://example.com/
```

🎯 Cover Image is Mandatory
- Every article must have an attractive theme cover image
- The cover image is independent of content images and appears as the first image
Use Chinese for Image Text
- All text on generated images must use Simplified Chinese
- Clearly specify in the prompt: "text in simplified Chinese, minimal text, accurate"
Control the Number of Images
- Cover image: 1 (mandatory)
- Content images: 0-2 (generate on demand)
- Judgment criteria: Generate comparison charts for data comparisons; generate architecture diagrams for complex architectures; do not generate for other cases
Only Output the Article Body
- ❌ Prohibited: Adding sections like "References", "Image Descriptions", "Pros and Cons"
- ✅ Only keep: Title + Cover Image + Body + Conclusion

Use Plain Text Format for Links

❌ Wrong:

[Official Website](https://example.com/)

✅ Correct:
```
官方网站：https://example.com/
```

完整工作流程

Complete Workflow

步骤1：理解用户需求并规划

Step 1: Understand User Needs and Plan

当用户输入一个话题后，首先：

明确主题类型
- AI大模型：功能特点、使用场景、与竞品对比
- 开源工具：核心功能、安装使用、应用案例
- 技术概念：原理解释、实际应用、发展趋势
- 新闻资讯：事件背景、影响分析、行业反应
确定文章角度
- 新闻类：时效性 + 全面性
- 介绍类：通俗性 + 实用性
- 评测类：客观性 + 数据性
- 教程类：可操作性 + 详细性

After the user inputs a topic, first:

Clarify the Theme Type
- AI large models: Functional features, usage scenarios, comparisons with competitors
- Open-source tools: Core functions, installation and usage, application cases
- Technical concepts: Principle explanations, practical applications, development trends
- News and information: Event background, impact analysis, industry reactions
Determine the Article Angle
- News type: Timeliness + comprehensiveness
- Introduction type: Popularity + practicality
- Review type: Objectivity + data-driven
- Tutorial type: Operability + detail

步骤2：搜索高质量内容源

Step 2: Search for High-Quality Content Sources

使用

WebSearch

工具进行3-5轮搜索：

搜索策略：

第1轮：官方信息（"{产品名} 官方文档"、"{产品名} GitHub"）
第2轮：技术解析（"{产品名} 详细介绍"、"{产品名} 教程"）
第3轮：对比评测（"{产品名} vs {竞品}"、"{产品名} 评测"）
第4轮：补充验证（根据前3轮结果补充缺失信息）

质量标准：优先选择官方文档、知名技术博客、权威媒体报道

Use the

WebSearch

tool for 3-5 rounds of searches:

Search Strategy:

Round 1: Official information ("{Product Name} Official Documentation", "{Product Name} GitHub")
Round 2: Technical analysis ("{Product Name} Detailed Introduction", "{Product Name} Tutorial")
Round 3: Comparative reviews ("{Product Name} vs {Competitor}", "{Product Name} Review")
Round 4: Supplementary verification (fill in missing information based on the first 3 rounds of results)

Quality Standards: Prioritize official documentation, well-known technical blogs, and authoritative media reports

步骤3：抓取和分析内容

Step 3: Crawl and Analyze Content

使用

WebFetch

获取2-5篇代表性文章的完整内容：

优先级：

官方文档或官方博客（权威性）
技术博客：掘金、CSDN、Medium（深度）
GitHub README.md（实用性）
权威媒体技术报道（全面性）

提取要点：

核心功能和特性
技术原理（简化版）
使用场景和案例
优势和局限性
最新动态和发展方向

Use

WebFetch

to obtain the complete content of 2-5 representative articles:

Priority:

Official documentation or official blogs (authoritativeness)
Technical blogs: Juejin, CSDN, Medium (depth)
GitHub README.md (practicality)
Technical reports from authoritative media (comprehensiveness)

Key Points to Extract:

Core functions and features
Simplified technical principles
Usage scenarios and cases
Advantages and limitations
Latest developments and future directions

步骤4：内容改写与创作

Step 4: Content Rewriting and Creation

核心原则：

用自己的语言重新组织，绝不照搬原文
面向普通用户，避免过度技术化
增加生动的比喻和实例
保持事实准确性

推荐文章结构（2000-3000字）：

1. 引子（100-200字）
   用一个场景或问题引入话题

2. 是什么（300-500字）
   产品/技术的基本介绍
   用类比帮助理解核心概念

3. 能做什么（500-800字）
   核心功能特性
   实际应用场景
   具体使用案例

4. 为什么选择它（300-500字）
   独特优势
   与同类产品对比

5. 如何开始（200-300字）
   快速上手指引
   提供官方资源链接（纯文本格式）

6. 总结（100-200字）
   总结要点
   展望未来

语言风格：

使用"我们"、"你"等第二人称，增加亲切感
适当使用emoji（但不要过度）
短句优于长句（不超过25字）
多用并列结构和小标题

详细写作指南：参见 references/writing-style.md

Core Principles:

Reorganize in your own words, never copy the original text directly
Target general users, avoid excessive technical jargon
Add vivid metaphors and examples
Maintain factual accuracy

Recommended Article Structure (2000-3000 words):

1. Introduction (100-200 words)
   Introduce the topic with a scenario or question

2. What is it? (300-500 words)
   Basic introduction of the product/technology
   Use analogies to help understand core concepts

3. What can it do? (500-800 words)
   Core functional features
   Practical application scenarios
   Specific usage cases

4. Why choose it? (300-500 words)
   Unique advantages
   Comparisons with similar products

5. How to get started? (200-300 words)
   Quick start guide
   Provide official resource links in plain text format

6. Conclusion (100-200 words)
   Summarize key points
   Look to the future

Language Style:

Use second-person pronouns like "we" and "you" to increase intimacy
Use emojis appropriately (but not excessively)
Prefer short sentences (no more than 25 words)
Use more parallel structures and subheadings

Detailed Writing Guide: See references/writing-style.md

步骤5：生成主题封面图（强制步骤）

Step 5: Generate Theme Cover Image (Mandatory Step)

⚠️ 这是强制步骤：每篇文章必须生成一张吸引人的主题封面图。

⚠️ This is a mandatory step: Every article must have an attractive theme cover image.

快速开始

Quick Start

核心要点：

根据主题选择配色：AI类用蓝紫渐变、工具类用绿橙渐变、效率类用橙粉渐变
标题：主题关键词（中英文结合）
副标题：一句话核心价值（简体中文）
视觉元素：与主题相关的3D元素、光效、粒子

快速生成命令：

bash

cd /root/.claude/skills/wechat-tech-writer

python scripts/generate_image.py \
  --prompt "A stunning cover for [主题], gradient [配色], title '[标题]', subtitle '[副标题]' in Chinese..." \
  --api gemini \
  --output cover.png

质量验证清单：

中文文字清晰可读，无乱码
颜色鲜明，吸引眼球
视觉重点突出（标题最醒目）
整体符合主题

Core Points:

Choose color schemes based on the theme: Blue-purple gradient for AI topics, green-orange gradient for tools, orange-pink gradient for efficiency topics
Title: Theme keywords (combination of Chinese and English)
Subtitle: One-sentence core value (Simplified Chinese)
Visual elements: 3D elements, light effects, particles related to the theme

Quick Generation Command:

bash

cd /root/.claude/skills/wechat-tech-writer

python scripts/generate_image.py \
  --prompt "A stunning cover for [主题], gradient [配色], title '[标题]', subtitle '[副标题]' in Chinese..." \
  --api gemini \
  --output cover.png

Quality Verification Checklist:

Chinese text is clear and readable, no garbled characters
Colors are bright and eye-catching
Visual focus is prominent (title is the most eye-catching)
Overall fits the theme

详细指南

Detailed Guide

完整的封面图设计原则、提示词模板、执行步骤：

👉 参见 references/cover-image-guide.md

包含：

5类文章的配色方案
5个提示词模板（AI类、工具类、效率类、新闻类、教程类）
详细的生成步骤和质量验证方法
常见问题排查

Complete cover image design principles, prompt templates, and execution steps:

👉 See references/cover-image-guide.md

Includes:

Color schemes for 5 types of articles
5 prompt templates (AI, tools, efficiency, news, tutorials)
Detailed generation steps and quality verification methods
Troubleshooting common issues

步骤6：根据内容生成其他配图（按需）

Step 6: Generate Other Content Images (On Demand)

⚠️ 这是可选步骤：仅在内容确实需要时才生成额外配图（0-2张）。

⚠️ This is an optional step: Only generate additional content images (0-2) when the content truly requires them.

决策规则

Decision Rules

阅读文章内容
  │
  ├─ 有明确数据对比？ → 是 → 生成性能对比图
  │
  ├─ 有复杂技术架构？ → 是 → 生成架构示意图
  │
  └─ 其他情况 → 不生成配图

典型场景：

产品评测文章：封面图 + 性能对比图（共2张）
技术解析文章：封面图 + 技术架构图（共2张）
新闻资讯文章：仅封面图（共1张）
教程指南文章：仅封面图（共1张）

Read the article content
  │
  ├─ Are there clear data comparisons? → Yes → Generate performance comparison chart
  │
  ├─ Is there a complex technical architecture? → Yes → Generate architecture diagram
  │
  └─ Other cases → Do not generate content images

Typical Scenarios:

Product review articles: Cover image + performance comparison chart (total 2 images)
Technical analysis articles: Cover image + technical architecture diagram (total 2 images)
News and information articles: Only cover image (total 1 image)
Tutorial guide articles: Only cover image (total 1 image)

详细指南

Detailed Guide

完整的内容配图类型、提示词模板、生成流程：

👉 参见 references/content-images-guide.md

包含：

5种配图类型（柱状图、架构图、对比图、流程图、雷达图）
每种类型的提示词模板
数据提取和验证方法
嵌入文章的最佳实践

Complete content image types, prompt templates, and generation processes:

👉 See references/content-images-guide.md

Includes:

5 types of content images (bar charts, architecture diagrams, comparison charts, flowcharts, radar charts)
Prompt templates for each type
Data extraction and verification methods
Best practices for embedding in articles

步骤7：输出文章

Step 7: Output the Article

使用

Write

工具创建Markdown格式的文章文件：

文件内容结构：

markdown

undefined

Use the

Write

tool to create an article file in Markdown format:

File Content Structure:

markdown

undefined

文章标题

Article Title

第一部分标题

First Section Title

正文内容...

图：简短说明

Body content...

图：简短说明

第二部分标题

Second Section Title

正文内容...

Body content...

总结

Conclusion

结尾总结段落...


**重要提醒**：
- ❌ 不要添加"参考资料"、"图片说明"、"延伸阅读"等额外章节
- ❌ 不要使用markdown超链接格式 `[文本](URL)`
- ✅ 只输出：标题 + 封面图 + 正文 + 总结
- ✅ 链接使用纯文本格式：`官方网站：https://example.com/`

**输出文件**：
- 文章文件：`{主题名称}.md`
- 封面图：`cover.png`
- 内容配图（如有）：`performance-comparison.png`、`architecture.png`等

---

Conclusion paragraph...


**Important Reminders**:
- ❌ Do not add extra sections like "References", "Image Descriptions", "Further Reading"
- ❌ Do not use Markdown hyperlink format `[Text](URL)`
- ✅ Only output: Title + Cover Image + Body + Conclusion
- ✅ Use plain text format for links: `官方网站：https://example.com/`

**Output Files**:
- Article file: `{Theme Name}.md`
- Cover image: `cover.png`
- Content images (if any): `performance-comparison.png`, `architecture.png`, etc.

---

质量检查清单

Quality Check Checklist

在输出前务必确认：

Be sure to confirm the following before outputting:

内容质量

Content Quality

图片质量（强制检查）

Image Quality (Mandatory Check)

格式规范

Format Specifications

封面图作为文章第一张图片（紧跟标题）
链接使用纯文本格式（不是markdown超链接）
没有添加"参考资料"、"图片说明"等额外章节
文件命名规范（无中文特殊字符）

The cover image is the first image in the article (right after the title)
Links use plain text format (not Markdown hyperlinks)
No extra sections like "References" or "Image Descriptions" are added
File naming is standardized (no Chinese special characters)

参考文档导航

Reference Document Navigation

详细指南

Detailed Guides

writing-style.md - 详细的写作风格指南和范例
cover-image-guide.md - 封面图生成完整指南（设计原则、提示词模板）
content-images-guide.md - 内容配图生成指南（判断标准、图表类型）
image-guidelines.md - 图片选择和处理标准（真实图片提取）
ai-image-generation.md - AI图片生成技术细节
api-configuration.md - 生图API配置指南（Gemini/DALL-E密钥设置）
fact-checking.md - 事实核查要点

writing-style.md - Detailed writing style guide and examples
cover-image-guide.md - Complete cover image generation guide (design principles, prompt templates)
content-images-guide.md - Content image generation guide (judgment criteria, chart types)
image-guidelines.md - Image selection and processing standards (real image extraction)
ai-image-generation.md - Technical details of AI image generation
api-configuration.md - Image generation API configuration guide (Gemini/DALL-E key settings)
fact-checking.md - Key points for fact-checking

使用示例

Usage Examples

EXAMPLES.md - 完整的使用示例（3个不同类型的文章）
- 示例1：技术新闻/资讯类（VSCode更名事件）
- 示例2：AI大模型介绍（Claude Sonnet 4）
- 示例3：开发工具介绍（LangChain）

EXAMPLES.md - Complete usage examples (3 different types of articles)
- Example 1: Technical news/information (VSCode renaming incident)
- Example 2: AI large model introduction (Claude Sonnet 4)
- Example 3: Development tool introduction (LangChain)

实用脚本

Practical Scripts

scripts/generate_image.py - 生图API调用脚本（支持Gemini/DALL-E/Claude原生）
scripts/generate_cover_optimized.py - 优化的封面图生成脚本
scripts/generate_temp.py - 临时图片生成工具

scripts/generate_image.py - Image generation API call script (supports Gemini/DALL-E/Claude native)
scripts/generate_cover_optimized.py - Optimized cover image generation script
scripts/generate_temp.py - Temporary image generation tool

快速参考

Quick Reference

文章类型决策树

Article Type Decision Tree

用户输入话题
  │
  ├─ 包含"最新"、"发布"、"更名" → 新闻资讯类
  │   └─ 搜索：官方公告 + 社区反应
  │       └─ 配图：仅封面图（1张）
  │
  ├─ 是AI模型/工具名称 → 介绍类
  │   ├─ AI大模型 → 功能+评测+案例
  │   │   └─ 配图：封面 + 可选性能对比图（1-2张）
  │   │
  │   └─ 开发工具 → 文档+教程+案例
  │       └─ 配图：封面 + 可选架构图（1-2张）
  │
  └─ 是技术概念 → 概念科普
      └─ 搜索：定义+原理+应用
          └─ 配图：封面 + 可选概念对比图（1-2张）

User inputs a topic
  │
  ├─ Contains "latest", "release", "rename" → News and information category
  │   └─ Search: Official announcements + community reactions
  │       └─ Images: Only cover image (1)
  │
  ├─ Is it an AI model/tool name → Introduction category
  │   ├─ AI large model → Features + reviews + cases
  │   │   └─ Images: Cover + optional performance comparison chart (1-2)
  │   │
  │   └─ Development tool → Documentation + tutorials + cases
  │       └─ Images: Cover + optional architecture diagram (1-2)
  │
  └─ Is it a technical concept → Popular science category
      └─ Search: Definition + principles + applications
          └─ Images: Cover + optional concept comparison chart (1-2)

封面图配色速查

Cover Image Color Scheme Quick Reference

文章类型	配色方案	色彩代码
AI/科技类	蓝紫渐变	#1a1f5c → #7c3aed
工具/效率类	绿橙渐变	#10b981 → #f97316
数据/分析类	蓝绿渐变	#0891b2 → #06b6d4
创意/设计类	粉紫渐变	#ec4899 → #a855f7

Article Type	Color Scheme	Color Codes
AI/Technology	Blue-purple gradient	#1a1f5c → #7c3aed
Tools/Efficiency	Green-orange gradient	#10b981 → #f97316
Data/Analysis	Blue-green gradient	#0891b2 → #06b6d4
Creativity/Design	Pink-purple gradient	#ec4899 → #a855f7

常用命令

Common Commands

生成封面图（Gemini）：

bash

python scripts/generate_image.py \
  --prompt "提示词" \
  --api gemini \
  --output cover.png

生成封面图（DALL-E高清）：

bash

python scripts/generate_image.py \
  --prompt "提示词" \
  --api dalle \
  --quality hd \
  --size 1792x1024 \
  --output cover.png

Generate Cover Image (Gemini):

bash

python scripts/generate_image.py \
  --prompt "Prompt text" \
  --api gemini \
  --output cover.png

Generate High-Definition Cover Image (DALL-E):

bash

python scripts/generate_image.py \
  --prompt "Prompt text" \
  --api dalle \
  --quality hd \
  --size 1792x1024 \
  --output cover.png

典型工作流示例

Typical Workflow Example

示例：AI大模型介绍文章

Example: AI Large Model Introduction Article

python

undefined

python

undefined

步骤1：明确主题

Step 1: Clarify the theme

主题类型 = "AI大模型介绍" 目标读者 = "AI用户、技术爱好者"

theme_type = "AI large model introduction" target_audience = "AI users, technology enthusiasts"

步骤2-3：搜索和抓取

Steps 2-3: Search and crawl

搜索("Claude Sonnet 4 官方介绍") 搜索("Claude Sonnet 4 vs GPT-4 性能对比") 抓取(官网产品页 + 评测文章 + API文档)

搜索("Claude Sonnet 4 official introduction") 搜索("Claude Sonnet 4 vs GPT-4 performance comparison") 抓取(official product page + review articles + API documentation)

步骤4：改写创作

Step 4: Rewrite and create

写作( 引子="实际应用场景引入", 正文="功能特点 + 性能对比 + 应用案例 + 上手指引", 字数=2800 )

步骤5：生成封面图（强制）

Step 5: Generate cover image (mandatory)

generate_image( prompt="Claude Sonnet 4 封面，蓝紫渐变，标题+副标题...", api="gemini", output="cover.png" )

generate_image( prompt="Claude Sonnet 4 cover, blue-purple gradient, title + subtitle...", api="gemini", output="cover.png" )

步骤6：内容配图（按需）

Step 6: Content images (on demand)

if 文章有性能对比数据: generate_image( prompt="性能对比柱状图，Claude vs GPT vs Gemini...", output="performance-comparison.png" )

if article has performance comparison data: generate_image( prompt="Performance comparison bar chart, Claude vs GPT vs Gemini...", output="performance-comparison.png" )

步骤7：输出

Step 7: Output

write_file("Claude_Sonnet_4介绍.md", 文章内容)

---

write_file("Claude_Sonnet_4介绍.md", article content)

---

注意事项

Notes

✅ 应该做的

✅ Do's

每次都生成封面图 - 这是强制要求，不可省略
验证中文清晰度 - 生成后检查文字是否清晰
控制图片数量 - 总数不超过3张（1封面 + 0-2内容）
保持风格统一 - 如有多张配图，配色和设计语言要一致
链接用纯文本 - 不使用markdown超链接格式

Generate a cover image every time - This is a mandatory requirement and cannot be skipped
Verify Chinese text clarity - Check if the text is clear after generation
Control the number of images - Total no more than 3 (1 cover + 0-2 content)
Maintain consistent style - If multiple images are used, color schemes and design language must be consistent
Use plain text for links - Do not use Markdown hyperlink format

❌ 不应该做的

❌ Don'ts

不要跳过封面图 - 即使时间紧也必须生成
不要过度配图 - 宁缺毋滥，没价值的图不生成
不要照搬原文 - 必须用自己的语言改写
不要添加额外章节 - 如"参考资料"、"图片说明"
不要忽视质量检查 - 输出前必须过一遍检查清单

Don't skip the cover image - Must generate even if time is limited
Don't overuse images - Better to have none than useless images
Don't copy the original text - Must rewrite in your own words
Don't add extra sections - Such as "References", "Image Descriptions"
Don't ignore quality checks - Must go through the checklist before outputting

Remember: The goal of this skill is to generate high-quality, easy-to-read, and attractive WeChat Official Account popular science articles. Every step is important and cannot be skipped!

提升质量的关键点

—

选题要精准：理解用户真正想了解什么
信息要准确：事实和数据必须可靠
语言要通俗：技术术语要解释，多用比喻
结构要清晰：小标题、列表、图表帮助阅读
封面要吸睛：配色鲜明、标题醒目、主题契合

记住：这个技能的目标是生成高质量、易读、吸引人的微信公众号科普文章。每个步骤都很重要，不可省略！

—