smart-blog-skills
v1.4 · 2026-04-06
用 Claude 寫部落格，不怕 AI 亂掰數據。
四層防線：反幻覺三層驗證 + Humanizer 29 模式反 AI 審稿。
100 分品質評分、SEO + E-E-A-T + AI 引用優化、YouTube 影片嵌入、
Google PageSpeed/CrUX 效能檢測、品質監控與月度比較、PDF 報告輸出。
繁體中文優先。
安裝
Claude Code / Claude Desktop
/plugin marketplace add rainday/smart-blog-skills
/plugin install smart-blog-skills
安裝完成後直接使用，不需要重啟。
手動安裝（Antigravity / Codex CLI / 其他平台）
macOS / Linux
git clone https://github.com/rainday/smart-blog-skills.git && cd smart-blog-skills && chmod +x install.sh && ./install.sh
Windows (PowerShell)
git clone https://github.com/rainday/smart-blog-skills.git; cd smart-blog-skills; .\install.ps1
選裝
agent-browser（建議）：
npm install -g agent-browser
讓研究 agent 可以用真正的瀏覽器讀取網頁，大幅降低幻覺風險。未安裝時退回 WebFetch。
PDF 報告（選用）：
pip install weasyprint markdown
讓 analyze 和 monitor 可以輸出 PDF 報告。未安裝時輸出 Markdown。
Google API Key（選用）：
/smart-blog-skills:google setup
設定後可使用 PageSpeed Insights（專屬配額）和 CrUX 真實用戶數據。
不設定也可使用免費 PageSpeed（共用配額）。Config 存在 ~/.config/smart-blog-skills/，不會進入 git。
7 個指令
所有指令都可以用 /smart-blog-skills: 前綴呼叫，也可以直接搜尋指令名或打 "smart-blog"。
| 指令 | 功能 | 快速搜尋 |
|---|
/smart-blog-skills:blog [子指令] | 主路由器，自動分派到子指令 | /blog |
/smart-blog-skills:write <主題> | 從零寫一篇新文章 | /write |
/smart-blog-skills:analyze <檔案> | 品質審計 + 100 分評分 | /analyze |
/smart-blog-skills:rewrite <檔案> | 優化改寫現有文章 | /rewrite |
/smart-blog-skills:outline <主題> | 生成 SERP 導向大綱 | /outline |
/smart-blog-skills:google <子指令> <URL> | PageSpeed / CrUX 效能檢測 | /google |
/smart-blog-skills:monitor <子指令> <檔案> | 品質監控與月度比較 | /monitor |
常用 flag：
--full：outline 產出完整內容簡報（含關鍵字研究 + 競品分析）--update：rewrite 輕量更新（只更新數據和日期，保留 70%+ 原文）--pdf：analyze / monitor compare 輸出 PDF 報告--force-research：忽略 research cache，強制重新研究
建議工作流程
1. /smart-blog-skills:outline "主題" --full ← 先產大綱 + 簡報
2. /smart-blog-skills:write "主題" ← 寫文章（含 YouTube 嵌入 + Humanizer 審稿）
3. /smart-blog-skills:analyze ./file.md ← 品質檢查 100 分評分
4. /smart-blog-skills:rewrite ./file.md ← 分數不夠就改寫
5. /smart-blog-skills:monitor snapshot ./posts/ ← 建立品質快照
6. /smart-blog-skills:monitor compare ./posts/ ← 下個月比較進步
使用範例
從零開始寫一篇文章
/smart-blog-skills:outline "如何用 AI 優化 SEO" --full
系統會分析 SERP 前 5 名、產出完整大綱 + 關鍵字研究 + 競品分析，存入 docs/smart-blog/ai-seo-optimization.brief.md。確認後：
/smart-blog-skills:write ai-seo-optimization
自動讀取 brief，跳過大綱步驟，直接進入研究和寫作。
不同文章類型
# 教學文（自動匹配 how-to-guide 模板）
/smart-blog-skills:write "如何設定 Next.js 的 ISR"
# 比較文（自動匹配 comparison 模板）
/smart-blog-skills:write "Tailwind CSS vs Bootstrap 2026 比較"
# 排行文（自動匹配 listicle 模板）
/smart-blog-skills:write "2026 年 10 個最佳 AI 寫作工具"
# 新聞分析（自動匹配 news-analysis 模板）
/smart-blog-skills:write "Google 2026 年 3 月核心更新影響分析"
# 基準測試報告（自動匹配 benchmark-report 模板）
/smart-blog-skills:write "AI 寫作工具效能實測：品質與速度比較"
# 專家訪談（自動匹配 interview 模板）
/smart-blog-skills:write "專訪 Vercel CEO：AI 對前端開發的影響"
# 案例分析（自動匹配 case-study 模板）
/smart-blog-skills:write "某電商如何用 SEO 三個月提升 200% 流量"
# 主題指南（自動匹配 pillar-page 模板）
/smart-blog-skills:write "2026 年完整 SEO 指南"
分析和改寫現有文章
# 分析單篇文章
/smart-blog-skills:analyze ./posts/my-old-post.md
# 批次分析整個目錄
/smart-blog-skills:analyze ./posts/
# 改寫低分文章（完整改寫）
/smart-blog-skills:rewrite ./posts/my-old-post.md
# 輕量更新（只更新過時數據和日期，保留 70%+ 原文）
/smart-blog-skills:rewrite ./posts/my-old-post.md --update
Research Cache
# 第一次寫 AI SEO 主題 → 完整研究，結果自動存入 docs/research/ai-seo-optimization/
/smart-blog-skills:write "AI SEO 優化策略"
# 兩週後寫相關主題 → cache 仍新鮮，跳過研究直接寫作
/smart-blog-skills:write "AI SEO 實戰技巧"
# 四個月後更新文章 → cache 統計數據已過期，只重新搜尋統計，圖片沿用
/smart-blog-skills:rewrite ./posts/ai-seo.md
# 強制重新研究（忽略 cache）
/smart-blog-skills:write "AI SEO 優化策略" --force-research
Google PageSpeed 檢測
# 設定 API Key（選用，不設定也能用免費版）
/smart-blog-skills:google setup
# 檢測頁面效能
/smart-blog-skills:google pagespeed https://example.com/blog/my-post
# CrUX 真實用戶數據（需要 API Key）
/smart-blog-skills:google crux https://example.com
品質監控
# 建立品質快照
/smart-blog-skills:monitor snapshot ./posts/
# 下個月建立新快照後，比較變化
/smart-blog-skills:monitor compare ./posts/
# 查看歷史趨勢
/smart-blog-skills:monitor trend ./posts/
英文文章
# 指定英文
/smart-blog-skills:write "How to Optimize for AI Search Engines"
# 系統會在主題確認時詢問語言，也可以在對話中說「用英文寫」
指令詳解
write — 從零寫一篇新文章
/smart-blog-skills:write "如何用 AI 優化 SEO"
流程：
- 主題確認 — 詢問目標受眾、關鍵字、字數（都有預設值，可跳過）
- 模板選擇 — 根據主題自動匹配 8 個模板之一
- 大綱生成 — H2/H3 結構 + 字數建議 + 圖片位置，等你確認後才繼續
- Cache 檢查 — 有未過期的研究 cache 直接使用，否則進入研究
- 研究 — orchestrator 平行派遣 3 個 agent 搜尋統計、圖片、競品
- YouTube 影片發現 — 搜尋 2-3 個相關影片（品質分 60+ 才嵌入）
- 寫作 — writer agent 撰寫 + Humanizer Pass（29 模式掃描 + 反 AI 審稿二次修正）
- 交付 — 文章 + YouTube 嵌入 + VideoObject Schema + 驗證報告
analyze — 品質審計 + 100 分評分
rainday