Fan Page Article Writing Workflow
6 Steps to Create High-Quality Fan Page Articles: Data Research → Article Drafting → Headline Generation → Layout Optimization → Image Generation → Citation of References
Important Guidelines (Must Read)
Terminology规范: Use Traditional Chinese (Taiwan)
Prohibit using Mainland China terms; must use Taiwan terms:
| ❌ Mainland China Terms | ✅ Taiwan Terms |
|---|
| 硅 | Silicon (Si) |
| 视频 | Video |
| 软件 | Software |
| 硬件 | Hardware |
| 信息 | Information |
| 网络 | Network |
| 数据 | Data |
| 优化 | Optimization |
| 激活 | Activate |
| 默认 | Default |
| 交互 | Interaction |
| 链接 | Link |
| 博客 | Blog |
| 用户 | User |
| 人工智能 | Artificial Intelligence |
Step 1: Data Research
Use the WebSearch tool to search for topic-related data:
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
Nutrition, Exercise Science, Health-related Topics:
- Prioritize searching PubMed (https://pubmed.ncbi.nlm.nih.gov/)
- Add
site:pubmed.ncbi.nlm.nih.gov
- Or directly search
[Topic] PubMed research study
- Prioritize systematic reviews or meta-analyses
- Pay attention to the publication year of studies; prioritize citing research from the past 5 years
- Record the paper title, authors, journal, year, and PMID
Step 2: Article Drafting
Must first read the user's CLAUDE.md to obtain writing style
Drafting Requirements:
- 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
For articles involving microorganisms (probiotics, fermented foods), must clearly distinguish:
| Level | Definition | Example |
|---|
| Genus | Broad classification | Lactobacillus |
| Species | Mid-level classification | Lactobacillus plantarum |
| Strain | Specific strain number | L. plantarum KU200656 |
Important: For every health claim, immediately attach a research link below the corresponding paragraph
markdown
### ⭐ Lactobacillus plantarum KU200656
|------|------|
| 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
Generate 5 viral headlines with the following characteristics:
- 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
Optimization Suggestions:
- Paragraph Structure: 3-5 lines per paragraph; important data should be in a separate bolded paragraph
- Image Placement: Place an accurate cover image below the headline
- Code Blocks: Add white space before and after, enable syntax highlighting
- Key Quotes: Place in separate paragraphs to enhance memorability
Step 5: AI Image Generation
Use the Gemini API to generate one accurate high-quality image.
Core Principle: One Accurate Image is Better Than Three Mediocre Ones
Do NOT generate multiple images! Focus on one high-quality image that conveys the core vibe of the article.
Prompt Design: Align with Headline Vibe
Before generating the image, first analyze the emotion and keywords of the headline:
| Headline Keywords | Vibe | Corresponding Prompt Elements |
|---|
| Numbers (10 billion, 3 minutes) | Shocking, abundant | , |
| Reveal, secret | Discovery, curiosity | , |
| Super powerful, pro tip | Strength, professionalism | , |
| Daily food | Approachable, appetizing | , |
| Health, wellness | Vibrant, natural | , , |
| News, current events | Serious, timely | , |
Prompt Formula
[Composition/Perspective] + [Subject Description] + [Details/Texture] + [Lighting/Atmosphere] + [Style] + [Quality]
Example: Kimchi Probiotics Article
Headline: "One Bite of Kimchi = 10 Billion Probiotics!"
Vibe Analysis: "One bite" → macro close-up / "10 billion" → lively, abundant / "Probiotics" → fermented, alive
Prompt:
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
The script automatically reads valid API Keys from
and checks expiration dates.
Currently Configured API Keys:
| Account | Expiration Date | Plan |
|---|
| bingo@napesone.com | 2026-02-24 | Free Trial $300 USD |
| bingo@mynet.com.tw | 2026-04-08 | Free Trial $300 USD |
Check API Key Status:
bash
python generate_image.py --status
Use the Script to Generate Images
Script Location:
~/.claude/skills/fanpage-article-writer/scripts/generate_image.py
bash
# Basic Usage (one accurate image)
python generate_image.py "prompt" -o "hero.png" --model imagen --aspect 16:9
Available Models
| Model | Parameter | Features | Cost |
|---|
| Imagen 4 | | Photo-realistic quality (Recommended) | $0.03/image |
| Gemini 2.5 Flash | | Excellent context understanding | Free tier available |
Aspect Ratio Options
| Aspect Ratio | Usage |
|---|
| FB cover, YouTube thumbnail (Recommended) |
| Instagram post |
| Instagram Stories, Reels |
Step 6: Citation of References (Required for Nutrition/Exercise/Health Topics)
In-text Citation Format (Attach immediately below each argument)
markdown
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
markdown
## 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
User Request:
Help me write a fan page article about Korean kimchi probiotics
Execution Workflow:
-
Search PubMed Data
- Search for kimchi, probiotics, Lactobacillus
- Record specific strain names (e.g., KU200656, KFRI342)
-
Draft Article
- Genus → Species → Benefits → Research Links
- Attach PubMed links immediately below each benefit claim
-
Generate 5 Viral Headlines
-
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
-
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
bash
cd ~/.claude/skills/fanpage-article-writer/scripts
python generate_image.py --status