WeChat Official Account Technical Article Writing Assistant

⚠️ Core Principles

5 Must-Follow Key Points

🎯 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

Step 1: Understand User Needs and Plan

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

Step 2: Search for High-Quality Content Sources

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

Step 3: Crawl and Analyze Content

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

Step 4: Content Rewriting and Creation

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

Step 5: Generate Theme Cover Image (Mandatory Step)

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

Quick Start

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

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

Step 6: Generate Other Content Images (On Demand)

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

Decision Rules

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

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

Step 7: Output the Article

Use the

Write

tool to create an article file in Markdown format:

File Content Structure:

markdown

# Article Title

![Cover Image](cover.png)

## First Section Title

Body content...

![Content Image 1](comparison.png)  <!-- If there are content images -->

*图：简短说明*

## Second Section Title

Body content...

## Conclusion

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

Content is fully expressed in your own words, no large sections copied directly
Technical terms have popular 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 official account style
Word count is between 2000-3000 words

Image Quality (Mandatory Check)

✅ Theme cover image has been generated (mandatory requirement)
Cover image has bright, attractive colors
Chinese text on the cover image is clear and readable, no garbled characters
Visual focus of the cover image is prominent and fits the theme
Content images (if any) have accurate data
All images have been saved to the output directory
Image styles are consistent (color schemes, design language)

Format Specifications

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

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

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

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

Example: AI Large Model Introduction Article

python

# Step 1: Clarify the theme
theme_type = "AI large model introduction"
target_audience = "AI users, technology enthusiasts"

# Steps 2-3: Search and crawl
搜索("Claude Sonnet 4 official introduction")
搜索("Claude Sonnet 4 vs GPT-4 performance comparison")
抓取(official product page + review articles + API documentation)

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

# Step 5: Generate cover image (mandatory)
generate_image(
  prompt="Claude Sonnet 4 cover, blue-purple gradient, title + subtitle...",
  api="gemini",
  output="cover.png"
)

# Step 6: Content images (on demand)
if article has performance comparison data:
    generate_image(
      prompt="Performance comparison bar chart, Claude vs GPT vs Gemini...",
      output="performance-comparison.png"
    )

# Step 7: Output
write_file("Claude_Sonnet_4介绍.md", article content)

Notes

✅ Do's

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!

wechat-tech-writer

NPX Install

Tags

SKILL.md Content (Chinese)

WeChat Official Account Technical Article Writing Assistant

⚠️ Core Principles

5 Must-Follow Key Points

Complete Workflow

Step 1: Understand User Needs and Plan

Step 2: Search for High-Quality Content Sources

Step 3: Crawl and Analyze Content

Step 4: Content Rewriting and Creation

Step 5: Generate Theme Cover Image (Mandatory Step)

Quick Start

Detailed Guide

Step 6: Generate Other Content Images (On Demand)

Decision Rules

Detailed Guide

Step 7: Output the Article

Quality Check Checklist

Content Quality

Image Quality (Mandatory Check)

Format Specifications

Reference Document Navigation

Detailed Guides

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

✅ Do's

❌ Don'ts