Fan Page Article Writing Workflow

Important Guidelines (Must Read)

Terminology规范: Use Traditional Chinese (Taiwan)

Step 1: Data Research

Search Requirements:
1. Parallel search across multiple sources (official documents, X/Twitter, Reddit, technical forums)
2. Prioritize obtaining the latest data (current month/quarter)
3. Can initiate multiple parallel Tasks to accelerate search
4. Conduct in-depth summarization of search results

Special Field Search Guidelines

1. Prioritize searching PubMed (https://pubmed.ncbi.nlm.nih.gov/)
   • Add

     site:pubmed.ncbi.nlm.nih.gov

     to search keywords
   • Or directly search

     [Topic] PubMed research study

2. Prioritize systematic reviews or meta-analyses
3. Pay attention to the publication year of studies; prioritize citing research from the past 5 years
4. Record the paper title, authors, journal, year, and PMID

Step 2: Article Drafting

• 1000-1500 words
• Story-driven opening with emotional tone (excitement/anxiety/curiosity)
• Prepare 2-3 alternative headlines
• Structure: Effect Demonstration → Problem Description → Step-by-Step Tutorial → Elevated Summary
• Follow the writing style and closing remarks defined in CLAUDE.md
• Use Traditional Chinese (Taiwan) terminology throughout the article

Guidelines for Labeling Strains in Nutrition/Health Articles

### ⭐ Lactobacillus plantarum KU200656

| Benefit | Data |
|------|------|
| Gastric acid tolerance | **99.48%** |
| Bile salt tolerance | **102.40%** |

> 📚 **Research Support**: Jang HJ et al. (2021). *Food Sci Biotechnol*, 30(1), 97-106.
> https://pmc.ncbi.nlm.nih.gov/articles/PMC7847474/

Step 3: Generate Viral Headlines

• Clear Pain Points: Directly address readers' pain points ("Still manually...")
• Numbers for Attraction: Specific numbers are more persuasive ("3 minutes", "5 tips")
• Result-Oriented: Promise specific benefits ("Efficiency surges 10x")
• Emotional Trigger: Words like "shocking", "pro tip", "secret"
• Suspense: Spark curiosity

Step 4: Layout Optimization

1. Paragraph Structure: 3-5 lines per paragraph; important data should be in a separate bolded paragraph
2. Image Placement: Place an accurate cover image below the headline
3. Code Blocks: Add white space before and after, enable syntax highlighting
4. Key Quotes: Place in separate paragraphs to enhance memorability

Step 5: AI Image Generation

Core Principle: One Accurate Image is Better Than Three Mediocre Ones

Prompt Design: Align with Headline Vibe

extreme close-up

macro

dramatic lighting

revealing

powerful

professional

mouth-watering

warm lighting

vibrant

natural

fresh

news photography

dramatic

Prompt Formula

[Composition/Perspective] + [Subject Description] + [Details/Texture] + [Lighting/Atmosphere] + [Style] + [Quality]

Extreme close-up of glistening Korean kimchi, vibrant red-orange
fermented napa cabbage with visible tiny bubbles from active
fermentation. Dramatic macro food photography with shallow depth
of field, warm golden backlight creating a magical glow.
Mouth-watering, alive, powerful. Editorial magazine cover quality

API Key Management

api_keys.json

python generate_image.py --status

Use the Script to Generate Images

~/.claude/skills/fanpage-article-writer/scripts/generate_image.py

# Basic Usage (one accurate image)
python generate_image.py "prompt" -o "hero.png" --model imagen --aspect 16:9

Available Models

--model imagen

--model gemini

Aspect Ratio Options

16:9

1:1

9:16

Step 6: Citation of References (Required for Nutrition/Exercise/Health Topics)

In-text Citation Format (Attach immediately below each argument)

The viable bacteria density in kimchi reaches **10⁹-10¹⁰ CFU/g**.

> 📚 **Research Support**: Park KY et al. (2014). *J Med Food*, 17(1), 6-20.
> https://pubmed.ncbi.nlm.nih.gov/24456350/

End-of-Article Reference Overview

## Reference Overview

1. Park KY et al. (2014). Health benefits of kimchi. *J Med Food*, 17(1), 6-20. https://pubmed.ncbi.nlm.nih.gov/24456350/

2. Jung JY et al. (2011). Metagenomic analysis of kimchi. *Appl Environ Microbiol*, 77(7), 2264-74. https://pubmed.ncbi.nlm.nih.gov/21317261/

Complete Workflow Example

Help me write a fan page article about Korean kimchi probiotics

1. Search PubMed Data
   • Search for kimchi, probiotics, Lactobacillus
   • Record specific strain names (e.g., KU200656, KFRI342)
2. Draft Article
   • Genus → Species → Benefits → Research Links
   • Attach PubMed links immediately below each benefit claim
3. Generate 5 Viral Headlines
4. Analyze Headline Vibe and Generate One Accurate Image
   bash

   python generate_image.py "Extreme close-up of glistening Korean kimchi..." -o "hero.png" --model imagen --aspect 16:9

5. Attach Reference Overview at the End of the Article

Troubleshooting

API Quota Exhausted (429 Error)

• The script will automatically switch to the next valid API Key

Image Generation Failed

• Use English prompts
• Avoid requesting real human faces or text

Check API Key Status

cd ~/.claude/skills/fanpage-article-writer/scripts
python generate_image.py --status