wechat-tech-writer

WeChat Public Account Technical Article Writing Assistant

⚠️ Core Principles

5 key points that must be strictly followed

🎯 The cover image is mandatory
- Each article must generate an attractive theme cover image
- The cover image is independent of content illustrations and appears as the first image
Use Chinese for text in images
- All text on generated images must use Simplified Chinese
- Clearly require in the prompt: "text in simplified Chinese, minimal text, accurate"
Image quantity control
- Cover image: 1 (mandatory)
- Content illustrations: 0-2 (generated as needed)
- Judgment criteria: if there is data comparison → generate a comparison chart; if there is a complex architecture → generate an architecture diagram; in other cases, do not generate

The article outputs only the main text
- ❌ Prohibited from adding: sections such as "References", "Image captions", "Pros and cons explanation"
- ✅ Only keep: title + cover image + main text + concluding summary
Links use plain text format
- ❌ Incorrect:[官网](https://example.com/)
- ✅ Correct:官方网站：https://example.com/

Complete workflow

Step 1: Understand user needs and plan

After the user enters a topic, first:

Clarify the topic type
- AI large models: features, use cases, comparison with competitors
- Open-source tools: core features, installation and usage, application cases
- Technical concepts: explanation of principles, practical applications, development trends
- News and information: event background, impact analysis, industry reaction
Determine the article angle
- News type: timeliness + comprehensiveness
- Introduction type: accessibility + practicality
- Review type: objectivity + data-driven
- Tutorial type: operability + detail

Step 2: Search for high-quality content sources

Use WebSearch tool to conduct 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: Comparison reviews ("{product name} vs {competitor}", "{product name} review")
Round 4: Supplementary verification (supplement missing information based on the results of the first 3 rounds)

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

Step 3: Scrape and analyze content

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

Priority：

Official documentation or official blogs (authority)
Technical blogs: Juejin, CSDN, Medium (depth)
GitHub README.md (practicality)
Authoritative media technical reports (comprehensiveness)

Extract key points：

Core features and characteristics
Technical Principles (Simplified Version)
Use Cases and Examples
Advantages and Limitations
Latest Updates and Development Directions

Step 4: Content Rewriting and Creation

Core Principles：

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

Recommended Article Structure(2000-3000 words):

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

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

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

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

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

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

Language Style：

Use second-person pronouns such as "we" and "you" to increase friendliness
Use emoji appropriately (but not excessively)
Short sentences are better than long sentences (no more than 25 characters)
Use more parallel structures and subheadings

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

Step 5: Generate a Themed Cover Image (Mandatory Step)

⚠️ This is a mandatory step: Each article must generate one attractive themed cover image.

Quick Start

Core Points：

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

Quick Generation Command：

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, with no garbled characters
Colors are vivid and eye-catching
Visual focus is prominent (title is the most eye-catching)
Overall matches the theme

Detailed Guide

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, productivity, news, tutorials)
Detailed generation steps and quality verification methods
Common Troubleshooting

Step 6: Generate Other Illustrations Based on Content (As Needed)

⚠️ This is an optional step: Generate additional illustrations (0-2) only when the content truly requires them.

Decision Rules

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

Typical Scenarios：

Product review article: cover image + performance comparison chart (2 total)
Technical analysis article: cover image + technical architecture diagram (2 total)
News article: cover image only (1 total)
Tutorial guide article: cover image only (1 total)

Detailed Guide

Complete content illustration types, prompt templates, and generation process：

👉 See references/content-images-guide.md

Includes:

5 types of illustrations (bar chart, architecture diagram, comparison chart, flowchart, radar chart)
Prompt templates for each type
Data extraction and verification methods
Best practices for embedding in articles

Step 7: Output the Article

Use the Write tool to create a Markdown-format article file:

File Content Structure：

# 文章标题

![封面图](cover.png)

## 第一部分标题

正文内容...

![配图1](comparison.png)  <!-- 如有内容配图 -->

*图：简短说明*

## 第二部分标题

正文内容...

## 总结

结尾总结段落...

Important Reminders：

❌ Do not add extra sections such as "References", "Image Descriptions", or "Further Reading"
❌ Do not use Markdown hyperlink format [文本](URL)
✅ Output only: title + cover image + body + summary
✅ Links use plain text format:官方网站：https://example.com/

Output files：

Article file:{主题名称}.md
Cover image:cover.png
Content images (if any):performance-comparison.png、architecture.pngetc.

Quality checklist

Before outputting, be sure to confirm:

Content quality

Content is expressed entirely in your own words, with no large copied passages
Technical terms have plain-language explanations
Includes specific examples and application scenarios
Factual information is accurate
Article structure is clear and easy to read
Language is natural and fluent, suitable for WeChat official account style
Word count is between 2000-3000 words

Image quality (mandatory check)

✅ Theme cover image has been generated(mandatory requirement)
Cover image colors are vivid and attractive
Chinese text on the cover image is clear and readable, with no garbled characters
Cover image has a prominent visual focus and matches the theme
Content images (if any) have accurate data
All images have been saved to the output directory
Image style is consistent (consistent color scheme and design style)

Format specifications

Cover image is the first image in the article (immediately after the title)
Links use plain text format (not markdown hyperlinks)
No extra sections such as "References" or "Image captions" have been added
File naming follows specifications (no Chinese special characters)

Reference document navigation

Detailed guide

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 setup)
fact-checking.md - Fact-checking key points

Usage examples

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

Practical scripts

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张）

Cover image color scheme quick reference

Article type	Color scheme	Color code
AI/tech type	Blue-purple gradient	#1a1f5c → #7c3aed
Tool/productivity type	Green-orange gradient	#10b981 → #f97316
Data/analysis type	Blue-green gradient	#0891b2 → #06b6d4
Creative/design type	Pink-purple gradient	#ec4899 → #a855f7

Common commands

Generate cover image (Gemini)：

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

Generate cover image (DALL-E HD)：

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

Typical workflow example

Example: AI large model introduction article

# 步骤1：明确主题
主题类型 = "AI大模型介绍"
目标读者 = "AI用户、技术爱好者"

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

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

# 步骤5：生成封面图（强制）
generate_image(
  prompt="Claude Sonnet 4 封面，蓝紫渐变，标题+副标题...",
  api="gemini",
  output="cover.png"
)

# 步骤6：内容配图（按需）
if 文章有性能对比数据:
    generate_image(
      prompt="性能对比柱状图，Claude vs GPT vs Gemini...",
      output="performance-comparison.png"
    )

# 步骤7：输出
write_file("Claude_Sonnet_4介绍.md", 文章内容)

Notes

✅ What should be done

Generate a cover image every time - This is a mandatory requirement and cannot be omitted
Verify Chinese clarity - After generation, check whether the text is clear
Control the number of images - The total should not exceed 3 (1 cover + 0-2 content images)
Keep the style consistent - If there are multiple accompanying images, the color scheme and design language should be consistent
Use plain text for links - Do not use markdown hyperlink format

❌ What should not be done

Do not skip the cover image - It must be generated even if time is tight
Do not overuse accompanying images - Better to have none than too many; do not generate images with no value
Do not copy the original text - You must rewrite it in your own words
Do not add extra sections - Such as "References" or "Image Captions"
Do not ignore quality checks - You must go through the checklist before output

Key points for improving quality

The topic should be precise: Understand what the user really wants to know
The information should be accurate: Facts and data must be reliable
The language should be accessible: Technical terms should be explained, and more metaphors should be used
The structure should be clear: Subheadings, lists, and charts help reading
The cover should be eye-catching: Bright colors, a prominent title, and a matching theme

Remember: The goal of this skill is to generatehigh-quality、easy-to-read、attractiveWeChat official account popular science articles. Every step is important and cannot be omitted!

About this skill

⚠️ Core Principles

5 key points that must be strictly followed

Complete workflow

Step 1: Understand user needs and plan

Step 2: Search for high-quality content sources

Step 3: Scrape and analyze content

Step 4: Content Rewriting and Creation

Step 5: Generate a Themed Cover Image (Mandatory Step)

Quick Start

Detailed Guide

Step 6: Generate Other Illustrations Based on Content (As Needed)

Decision Rules

Detailed Guide

Step 7: Output the Article

Quality checklist

Content quality

Image quality (mandatory check)

Format specifications

Reference document navigation

Detailed guide

Usage examples

Practical scripts

Quick reference

Article type decision tree

Cover image color scheme quick reference

Common commands

Typical workflow example

Example: AI large model introduction article

Notes

✅ What should be done

❌ What should not be done

Key points for improving quality