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 topic cover image
- The cover image is independent of the content illustrations and appears as the first image
Use Chinese text in images
- All text on generated images must use Simplified Chinese
- Explicitly 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
- ❌ Do not add: sections such as "References", "Image Descriptions", "Pros and Cons"
- ✅ Keep only: title + cover image + main text + concluding summary
Use plain text format for links
- ❌ Incorrect:[官网](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 topic type
- AI large models: features, use cases, comparison with competitors
- Open-source tools: core features, installation and usage, application cases
- Technical concepts: principle explanation, practical applications, development trends
- News and information: event background, impact analysis, industry reactions
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 the 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: Comparative reviews ("{product name} vs {competitor}", "{product name} review")
Round 4: Supplementary verification (fill in 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: Crawl and analyze content

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

Priority：

Official documentation or official blog (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 Developments and Future Directions

Step 4: Content Rewriting and Creation

Core Principles：

Reorganize in your own words, never copy the original text
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 like "we" and "you" to create a friendly tone
Use emoji appropriately (but not excessively)
Short sentences are better than long sentences (no more than 25 characters)
Use parallel structures and subheadings frequently

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

Step 5: Generate the Topic Cover Image (Mandatory Step)

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

Quick Start

Key Points：

Choose colors based on the topic: blue-purple gradients for AI, green-orange gradients for tools, orange-pink gradients for productivity
Title: Topic keywords (combined Chinese and English)
Subtitle: One-sentence core value (Simplified Chinese)
Visual elements: 3D elements, light effects, and particles related to the topic

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 topic

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
Troubleshooting common issues

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

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

Decision Rules

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

Typical Scenarios：

Product review article: cover image + performance comparison chart (2 images total)
Technical analysis article: cover image + technical architecture diagram (2 images total)
News article: cover image only (1 image total)
Tutorial guide article: cover image only (1 image 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 into articles

Step 7: Output the Article

Use 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 passages copied verbatim
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 the WeChat official account style
Word count is between 2,000 and 3,000 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 that 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 additional sections such as "References" or "Image Captions" have been added
File naming follows specifications (no Chinese special characters)

Reference Documentation 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 - AI image generation technical details
api-configuration.md - Image generation API configuration guide (Gemini/DALL-E key settings)
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 calling 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/Technology	Blue-purple gradient	#1a1f5c → #7c3aed
Tools/Productivity	Green-orange gradient	#10b981 → #f97316
Data/Analytics	Blue-green gradient	#0891b2 → #06b6d4
Creativity/Design	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 mandatory and cannot be omitted
Verify Chinese text 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 must 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 over-illustrate - Better to have none than too many; do not generate images with no value
Do not copy the original text - Must rewrite in your own words
Do not add extra sections - Such as "References" or "Image Captions"
Do not ignore quality checks - Must go through the checklist before output

Key points for improving quality

The topic must be precise: Understand what the user really wants to know
The information must be accurate: Facts and data must be reliable
The language must be accessible: Technical terms must be explained, and more analogies should be used
The structure must be clear: Subheadings, lists, and charts help reading
The cover must be eye-catching: Bright colors, a prominent title, and a fitting 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: Crawl and analyze content

Step 4: Content Rewriting and Creation

Step 5: Generate the Topic 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 Documentation 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