fanpage-article-writer

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

粉絲專頁文章寫作流程

Fan Page Article Writing Workflow

6 步完成高品質粉專文章:搜尋資料 → 撰寫文章 → 生成標題 → 排版優化 → 生成配圖 → 引用文獻

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)

禁止使用中國用語,必須使用台灣用語:
❌ 中國用語✅ 台灣用語
矽 (Si)
視頻影片
軟件軟體
硬件硬體
信息資訊
網絡網路
數據資料
優化最佳化
激活啟用
默認預設
交互互動
鏈接連結
博客部落格
用戶使用者
人工智能人工智慧

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: 搜尋資料

Step 1: Data Research

使用 WebSearch 工具搜尋主題相關資料:
搜尋要求:
1. 並行搜尋多個來源(官方文件、X/Twitter、Reddit、技術論壇)
2. 優先取得最新資料(當月/當季)
3. 可啟動多個並行 Task 加速搜尋
4. 深度總結搜尋結果
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

營養學、運動科學、健康相關主題:
  1. 優先搜尋 PubMed (https://pubmed.ncbi.nlm.nih.gov/)
    • 搜尋關鍵字加上
      site:pubmed.ncbi.nlm.nih.gov
    • 或直接搜尋
      [主題] PubMed research study
  2. 尋找 systematic review 或 meta-analysis 優先
  3. 注意研究的發表年份,優先引用近 5 年內的研究
  4. 記錄論文標題、作者、期刊、年份、PMID

Nutrition, Exercise Science, Health-related Topics:
  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: 撰寫文章

Step 2: Article Drafting

必須先讀取用戶的 CLAUDE.md 獲取寫作風格
撰寫要求:
  • 1000-1500 字
  • 故事化開頭,帶情感色彩(興奮/焦慮/好奇)
  • 準備 2-3 個備選標題
  • 結構:效果展示 → 問題描述 → 步驟教學 → 昇華總結
  • 遵循 CLAUDE.md 中定義的寫作風格和結尾語
  • 全文使用台灣正體中文用語
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

涉及微生物(益生菌、發酵食品)的文章,必須明確區分:
層級定義範例
菌屬大分類Lactobacillus(乳酸桿菌屬)
菌種中分類Lactobacillus plantarum(植物乳桿菌)
菌株具體編號L. plantarum KU200656
重要:每個健康功效聲稱,必須在該段落下方立即附上研究連結
markdown
undefined
For articles involving microorganisms (probiotics, fermented foods), must clearly distinguish:
LevelDefinitionExample
GenusBroad classificationLactobacillus
SpeciesMid-level classificationLactobacillus plantarum
StrainSpecific strain numberL. plantarum KU200656
Important: For every health claim, immediately attach a research link below the corresponding paragraph
markdown
undefined

⭐ Lactobacillus plantarum KU200656

⭐ Lactobacillus plantarum KU200656

功效數據
胃酸耐受性99.48%
膽鹽耐受性102.40%
📚 研究支持:Jang HJ et al. (2021). Food Sci Biotechnol, 30(1), 97-106. https://pmc.ncbi.nlm.nih.gov/articles/PMC7847474/

---
BenefitData
Gastric acid tolerance99.48%
Bile salt tolerance102.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: 生成標題

Step 3: Generate Viral Headlines

生成 5 個爆款標題,特點:
  • 痛點明確:直擊讀者痛處(「還在手動...」)
  • 數字吸引:具體數字更有說服力(「3分鐘」、「5個技巧」)
  • 結果導向:承諾具體收益(「效率暴漲10倍」)
  • 情緒調動:驚、神技、秘笈等詞彙
  • 懸念設置:引發好奇心

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: 排版優化

Step 4: Layout Optimization

優化建議:
  1. 段落結構:每段 3-5 行,重要數據單獨成段加粗
  2. 配圖位置:標題下方放置一張精準的封面圖
  3. 程式碼區塊:前後留白,語法高亮
  4. 金句:單獨成段,增強記憶點

Optimization Suggestions:
  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 圖片生成)

Step 5: AI Image Generation

使用 Gemini API 生成 一張精準的配圖
Use the Gemini API to generate one accurate high-quality image.

核心原則:一張精準勝過三張平庸

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

不要生成多張圖片! 專注於一張能傳達文章核心 vibe 的高品質配圖。
Do NOT generate multiple images! Focus on one high-quality image that conveys the core vibe of the article.

Prompt 設計:對應標題 Vibe

Prompt Design: Align with Headline Vibe

生成圖片前,先分析標題的情緒和關鍵詞:
標題關鍵詞VibePrompt 對應
數字(100億、3分鐘)震撼、豐富
extreme close-up
,
macro
揭密、秘密發現、好奇
dramatic lighting
,
revealing
超強、神技力量、專業
powerful
,
professional
日常食物類親近、食慾
mouth-watering
,
warm lighting
健康、養生活力、自然
vibrant
,
natural
,
fresh
新聞、時事嚴肅、即時
news photography
,
dramatic
Before generating the image, first analyze the emotion and keywords of the headline:
Headline KeywordsVibeCorresponding Prompt Elements
Numbers (10 billion, 3 minutes)Shocking, abundant
extreme close-up
,
macro
Reveal, secretDiscovery, curiosity
dramatic lighting
,
revealing
Super powerful, pro tipStrength, professionalism
powerful
,
professional
Daily foodApproachable, appetizing
mouth-watering
,
warm lighting
Health, wellnessVibrant, natural
vibrant
,
natural
,
fresh
News, current eventsSerious, timely
news photography
,
dramatic

Prompt 公式

Prompt Formula

[構圖/視角] + [主體描述] + [細節/質感] + [光線/氛圍] + [風格] + [品質]
範例:泡菜益生菌文章
標題:「一口泡菜 = 100 億益生菌!」
Vibe 分析:「一口」→ 微距特寫 / 「100億」→ 活躍豐富 / 「益生菌」→ 發酵、活的
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

[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 管理

API Key Management

腳本會自動從
api_keys.json
讀取有效的 API Key,並檢查到期日。
目前已設定的 API Key:
帳號到期日方案
bingo@napesone.com2026-02-24Free Trial $300 USD
bingo@mynet.com.tw2026-04-08Free Trial $300 USD
查看 API Key 狀態:
bash
python generate_image.py --status
The script automatically reads valid API Keys from
api_keys.json
and checks expiration dates.
Currently Configured API Keys:
AccountExpiration DatePlan
bingo@napesone.com2026-02-24Free Trial $300 USD
bingo@mynet.com.tw2026-04-08Free Trial $300 USD
Check API Key Status:
bash
python generate_image.py --status

使用腳本生成圖片

Use the Script to Generate Images

腳本位置:
~/.claude/skills/fanpage-article-writer/scripts/generate_image.py
bash
undefined
Script Location:
~/.claude/skills/fanpage-article-writer/scripts/generate_image.py
bash
undefined

基本用法(一張精準配圖)

Basic Usage (one accurate image)

python generate_image.py "提示詞" -o "hero.png" --model imagen --aspect 16:9
undefined
python generate_image.py "prompt" -o "hero.png" --model imagen --aspect 16:9
undefined

可用模型

Available Models

模型參數特點費用
Imagen 4
--model imagen
照片級品質(推薦)$0.03/張
Gemini 2.5 Flash
--model gemini
上下文理解佳免費額度
ModelParameterFeaturesCost
Imagen 4
--model imagen
Photo-realistic quality (Recommended)$0.03/image
Gemini 2.5 Flash
--model gemini
Excellent context understandingFree tier available

比例選項

Aspect Ratio Options

比例用途
16:9
FB 封面、YouTube 縮圖(推薦)
1:1
Instagram 貼文
9:16
IG 限時動態、Reels

Aspect RatioUsage
16:9
FB cover, YouTube thumbnail (Recommended)
1:1
Instagram post
9:16
Instagram Stories, Reels

Step 6: 引用文獻(營養/運動/健康類必須)

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

行內引用格式(每個論點下方立即附上)

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

markdown
泡菜的活菌密度高達 **10⁹-10¹⁰ CFU/g**
> 📚 **研究支持**:Park KY et al. (2014). *J Med Food*, 17(1), 6-20.
> https://pubmed.ncbi.nlm.nih.gov/24456350/
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
undefined
markdown
undefined

參考文獻總覽

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/

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

用戶請求:
幫我寫一篇關於韓國泡菜益生菌的粉專文章
執行流程:
  1. 搜尋 PubMed 資料
    • 搜尋 kimchi, probiotics, Lactobacillus
    • 記錄具體菌株名稱(如 KU200656、KFRI342)
  2. 撰寫文章
    • 菌種 → 菌株 → 功效 → 研究連結
    • 每個功效聲稱下方立即附上 PubMed 連結
  3. 生成 5 個爆款標題
  4. 分析標題 Vibe,生成一張精準配圖
    bash
    python generate_image.py "Extreme close-up of glistening Korean kimchi..." -o "hero.png" --model imagen --aspect 16:9
  5. 文末附上參考文獻總覽

User Request:
Help me write a fan page article about Korean kimchi probiotics
Execution Workflow:
  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 配額耗盡 (429 錯誤)

API Quota Exhausted (429 Error)

  • 腳本會自動切換到下一個有效的 API Key
  • The script will automatically switch to the next valid API Key

圖片生成失敗

Image Generation Failed

  • 使用英文提示詞
  • 避免要求生成真實人臉或文字
  • Use English prompts
  • Avoid requesting real human faces or text

查看 API Key 狀態

Check API Key Status

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