Superpowers 是一套給 coding agent 用的軟體開發方法論,由一組可組合的 skills 加上開場指令組成,讓 agent 在對話一開始就自動套用。它把流程固定成先問清需求、寫設計、拆計畫、再進 TDD 實作與程式碼審查,而不是一看到需求就直接寫程式。與單純的規則檔不同,這些 skills 會依情境自動觸發,並支援 Claude Code、Codex、Cursor、Gemini CLI、OpenCode 等多個 harness。
AgriciDaniel/claude-seo
專案簡介
以上內容由 AI 根據官方 README 整理,未經實測;指令以官方文件為準。
原始描述
Universal SEO skill for Claude Code. 26 sub-skills + 19 sub-agents covering technical SEO, E-E-A-T, schema, GEO/AEO, agent readiness (Lighthouse Agentic Browsing, WebMCP, llms.txt), backlinks, local SEO, e-commerce, international SEO, Google APIs, and PDF/Excel reporting. 9 optional extensions for live SEO data.
AI 規格
主要功能
- 26 個子技能與 19 個專責 agent,最多 17 個 agent 平行稽核同一站台
- 技術 SEO 檢查涵蓋可爬取性、索引、sitemap、robots.txt、重新導向與 Core Web Vitals
- Schema.org 標記的偵測、驗證與產生,並有 hook 在寫入時檢查
- GEO 分析評估頁面被 AI Overviews、ChatGPT、Perplexity、Gemini 引用的機會
- 本機、電商與多語系 SEO 檢查,含 GBP、評論、map pack 與 hreflang
- 報告輸出為 Markdown,並可經 Google API 產生 PDF 報告
系統需求
- Python 3.11 至 3.14,需有 pip
- Git,用於複製倉庫
- 已安裝並設定好的 Claude Code CLI
- Playwright Chromium 為選用,只有 SPA 渲染與截圖需要
安裝方式
在 Claude Code 內加入外掛 marketplace
/plugin marketplace add AgriciDaniel/claude-seo安裝 claude-seo 外掛
/plugin install claude-seo@agricidaniel-claude-seo建立隔離的 Python venv 與 Chromium
/seo setup手動安裝時先淺層複製倉庫
git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git在 macOS 或 Linux 執行安裝腳本
bash claude-seo/install.sh在 Windows PowerShell 執行安裝腳本
powershell -ExecutionPolicy Bypass -File claude-seo\install.ps1驗證受管理的執行環境
~/.claude/skills/seo/scripts/claude-seo doctor
設定教學
外掛安裝後要跑一次 /seo setup 建立隔離的 Python venv 與 Chromium,之後用 /seo doctor 唯讀確認。手動安裝則由 install.sh 或 install.ps1 代為處理,不需要另外設定環境變數;Windows 若 Python 偵測有問題可設 CLAUDE_SEO_PYTHON 指定執行檔。
環境變數
| 變數 | 用途 | 必填 | 範例/預設值 |
|---|---|---|---|
CLAUDE_SEO_PYTHON | 指定 Windows 安裝時要使用的 Python 執行檔路徑,需為 3.11 至 3.14。 | 否 | — |
主要設定檔
.claude-plugin/plugin.json— 外掛安裝時 Claude Code 讀取的外掛資訊檔。.claude-plugin/marketplace.json— 定義 marketplace 名稱與外掛來源,供 /plugin marketplace add 使用。hooks/hooks.json— 定義 hook 觸發時機與要執行的腳本,例如 schema 驗證。requirements.txt— Python 依賴清單,安裝時由 installer 複製到技能目錄並裝進隔離的 venv。extensions/dataforseo/field-config.json— DataForSEO 擴充的欄位對應設定。schema/templates.json— Schema.org 產生器使用的範本定義。
部署方式
外掛安裝(Claude Code 1.0.33+,建議路徑)
在 Claude Code 內加入 marketplace
/plugin marketplace add AgriciDaniel/claude-seo安裝 claude-seo 外掛
/plugin install claude-seo@agricidaniel-claude-seo一次性建立隔離的 Python venv 與 Chromium
/seo setup唯讀檢查執行環境是否就緒
/seo doctor
手動安裝(macOS、Linux)
淺層複製倉庫
git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git執行安裝腳本
bash claude-seo/install.sh驗證受管理的執行環境
~/.claude/skills/seo/scripts/claude-seo doctor
手動安裝(Windows PowerShell)
淺層複製倉庫
git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git執行 PowerShell 安裝腳本
powershell -ExecutionPolicy Bypass -File claude-seo\install.ps1
設定內容整理自 repository 內的設定檔與文件,未經實測;變數名稱與指令以官方檔案為準。
適合用途
- 想替每個客戶定期跑稽核、並在兩次稽核之間監控變化的 SEO 代理商
- SaaS、出版或電商公司的 in-house SEO 團隊,想在每次審查前多一輪檢查
- 想在第一次通話就拿出實際分數與修正清單的自由接案 SEO 顧問
- 要檢查網站對 AI 搜尋與 AI agent 存取是否友善的開發者
常見問題
裝好之後要怎麼確認能用?
在 Claude Code 輸入 /seo 會列出所有指令;跑 /seo doctor 可唯讀檢查執行環境是否就緒。若指令不存在,先確認 ~/.claude/skills/seo/SKILL.md 存在,或重新安裝外掛。
執行需要哪些前置條件?
需要 Python 3.11 到 3.14 與 pip,以及 Git 和已設定好的 Claude Code CLI。Playwright Chromium 為選用,只有 SPA 渲染與截圖才需要,安裝失敗不會中斷核心功能。
Python 套件裝在哪裡?可以自己 pip install 嗎?
依賴會裝在 ~/.claude/skills/seo/.venv/ 這個隔離的虛擬環境,不會裝到全域或使用者層級。遇到 ModuleNotFoundError 時,外掛安裝請跑 /seo doctor 與 /seo setup,手動安裝則跑 ~/.claude/skills/seo/scripts/claude-seo setup。
要怎麼移除?
外掛安裝用 /plugin uninstall claude-seo@agricidaniel-claude-seo 與 /plugin marketplace remove AgriciDaniel/claude-seo。手動安裝則從新的 clone 執行 uninstall.sh,它會清掉子技能、子代理與 settings.json 裡的 MCP 項目。
為什麼完整稽核跑很久?
完整稽核最多爬 500 頁,大站會比較久;子代理會平行分析來加速。只想快速檢查時可改用 /seo page 針對單一 URL。
出現 Agent 'seo-technical' not found 怎麼辦?
外掛安裝的子代理是從外掛載入,不是放在 ~/.claude/agents/。出現 Agent not found 時先用 /plugin list 確認並重新安裝 claude-seo@agricidaniel-claude-seo。