你會建立什麼
這篇教學會把 Windsurf Cascade Workflows 變成一個小型 SEO/GEO operating system。即使你還不知道如何設計 automation，也可以照著做。
Windsurf 這裡最重要的細節是：workflows 是存放在 .windsurf/workflows/ 的 markdown procedures，並且透過 slash commands 手動呼叫。這很適合 SEO/GEO 工作，因為 process 可以重複，但人仍然要選 page、檢查 evidence、核准 edits。
完成後，你的 repo 會有：
.windsurf/
workflows/
seo-page-refresh.md
geo-prompt-audit.md
technical-seo-check.md
weekly-search-report.md
seo-geo/
inputs/
reports/
approvals/
圖說：把每個 SEO/GEO 任務拆成可重複 workflow，但保留人工選頁、審核與核准。
步驟 1：建立 folders
從網站 repo root 建立 workflow 與 SEO/GEO folders：
mkdir -p .windsurf/workflows seo-geo/inputs seo-geo/reports seo-geo/approvals
如果你不確定自己是否在 repo root，執行：
pwd
ls
你應該會看到 package.json、astro.config.*、next.config.*、src/、app/、pages/ 或 CMS export folder 等檔案。
步驟 2：先做一個 workflow，不要一次做四個
很多團隊第一個 Windsurf workflow 做得太大。不要建立 /optimize-site。先從一個只 refresh 一個 approved page 的 workflow 開始。
建立這個檔案：
cat > .windsurf/workflows/seo-page-refresh.md <<'EOF2'
# SEO Page Refresh
Goal: improve one approved page for SEO and GEO without changing unsupported claims.
Required inputs:
- target URL or local page file
- main query or keyword theme
- current title/meta description if available
- GSC/Bing/GA4 exports if available
- proof sources the page is allowed to use
Before editing:
1. Identify the page file, metadata file, schema file, and internal links that may be affected.
2. Diagnose intent match, answer clarity, entity clarity, internal links, evidence, metadata, schema, and technical risk.
3. Write a short plan in `seo-geo/approvals/page-refresh-plan.md`.
4. Stop and ask for approval.
Allowed changes after approval:
- improve headings and answer blocks
- improve title and meta description
- add or fix relevant internal links
- add FAQ only when the page really answers those questions
- improve schema only when the existing framework supports it
Forbidden actions:
- do not invent statistics, testimonials, logos, customer names, awards, or pricing
- do not change robots.txt, redirects, canonical logic, sitemap generation, or analytics tags
- do not edit unrelated pages
- do not publish or deploy
Final report:
- changed files
- exact SEO/GEO improvements made
- validation commands run
- risks still open
- metrics to watch for 14 days
EOF2
步驟 3：像 slash command 一樣呼叫它
打開 Windsurf，要求 Cascade 依名稱執行 workflow。請使用狹窄 request：
Run /seo-page-refresh for this page:
- URL: https://example.com/features/reporting
- Local file if you can find it: unknown
- Main query: reporting automation software for small teams
- Goal: make the page easier for Google and AI answer engines to understand
First locate the relevant file and write the approval plan only. Do not edit yet.
Cascade 的好 first response 應該包含：
Target file found: src/pages/features/reporting.astro
Possible related files: src/data/navigation.ts, src/lib/schema.ts
Main risks: metadata helper affects all feature pages; no proof source for the "fastest" claim
Proposed edits: title, opening answer block, comparison table, two internal links
Waiting for approval before editing.
如果 Cascade 立刻開始 editing，請停下來，把 workflow file 收緊。Approval stop 才是重點。
步驟 4：加入 GEO prompt audit workflow
這個 workflow 會檢查你的品牌或頁面是否能回答 AI 搜尋裡常見的買家問題。它應該寫出報告，不應該直接修改內容。
cat > .windsurf/workflows/geo-prompt-audit.md <<'EOF2'
# GEO Prompt Audit
Goal: evaluate whether a target page answers the prompts that buyers may ask in AI search systems.
Inputs:
- target URL or page file
- brand name
- product/category
- competitor names if known
- prompt list or keyword cluster
- AI answer snapshots if available
Steps:
1. Read the target page and any provided prompt list.
2. Convert keyword themes into buyer-style prompts.
3. Check whether the page provides concise answers, evidence, entity clarity, comparison context, and next steps.
4. Create `seo-geo/reports/geo-prompt-audit.md`.
5. Recommend page changes, but do not edit.
Report format:
- prompt
- current answer support: strong / partial / missing
- evidence available
- likely citation weakness
- recommended page section
- priority
EOF2
用這樣的方式執行：
Run /geo-prompt-audit for our reporting page. Use the query theme "reporting automation software for small teams" and create 12 buyer prompts. Write the report only; do not edit files.
步驟 5：加入 technical SEO check workflow
當你懷疑 crawl 或 indexation 有問題時使用這個 workflow。請把它和 content workflows 分開。
cat > .windsurf/workflows/technical-seo-check.md <<'EOF2'
# Technical SEO Check
Goal: inspect technical SEO risk without making broad sitewide changes.
Inputs:
- target URL or route group
- issue description
- crawl/export notes if available
Steps:
1. Inspect robots, sitemap generation, canonical tags, noindex logic, metadata helpers, structured data, and route rendering for the target area.
2. Classify each issue as low, medium, or high risk.
3. For high-risk files, recommend a ticket instead of editing.
4. Ask before any code change.
Forbidden actions:
- no redirects without approval
- no robots.txt changes without approval
- no canonical helper changes without approval
- no sitemap generator changes without approval
Output:
- risk table
- likely cause
- safe validation command
- proposed fix scope
EOF2
初學者 prompt：
Run /technical-seo-check for the /features/ route group. I suspect some pages have weak metadata, but I do not want any sitewide changes. Return a risk table and stop before editing.
步驟 6：加入 weekly search report workflow
這個 workflow 會整理 exports，告訴你下一步做什麼。它不應直接重寫頁面。
cat > .windsurf/workflows/weekly-search-report.md <<'EOF2'
# Weekly Search Report
Goal: turn search and AI visibility exports into a prioritized action queue.
Inputs:
- GSC query/page export
- Bing query/page export
- GA4 landing page export
- AI visibility or prompt snapshot notes
- list of pages changed in the last 30 days
Steps:
1. Read exports from `seo-geo/inputs/`.
2. Find rising queries, declining pages, low-CTR opportunities, and AI visibility gaps.
3. Group opportunities by page.
4. Separate refresh tasks, technical tasks, internal-link tasks, and research tasks.
5. Write `seo-geo/reports/weekly-search-report.md`.
Do not edit content. Do not publish. Do not submit URLs.
EOF2
把 CSV 檔案放進 seo-geo/inputs/，然後執行：
Run /weekly-search-report using the files in seo-geo/inputs. Produce an action queue with no more than 10 items. Separate content refreshes from technical fixes. Do not edit any page.
如何判斷 workflows 是否有效
前兩次執行後，用這張簡單評分表：
| Check | Good sign | Bad sign |
|---|---|---|
| Scope | 一個 page 或一份 report | Cascade 碰到無關 files |
| Inputs | 會詢問 missing data | 假裝 missing data 存在 |
| Approval | editing 前停下 | plan 核准前就 edits |
| Output | 建立清楚 report | 只在 chat 給 vague advice |
| Validation | 說明 commands 與 risks | 沒證據就說全部 fixed |
如果 workflow 失敗，先修 workflow markdown，再換下一個 page。
初學者常見錯誤
第一個錯誤是混用 workflows。Keyword workflow 不應該改 canonical tags。Technical workflow 不應該重寫 homepage。每個 workflow 都要保持單調、狹窄、可控。
第二個錯誤是在 page map 出現前就要求 final content。Windsurf 可以 draft，但它需要乾淨 inputs：target query、page role、evidence、internal links 和 forbidden claims。
第三個錯誤是讓 reports 留在 chat 裡。要求 Cascade 把檔案寫到 seo-geo/reports/，你才可以長期比較 decisions。
初學者可直接複製的 prompt
如果你想要最簡單的起點，把這段貼進 Windsurf：
I want to use Windsurf Cascade Workflows for safe SEO/GEO work.
Please inspect this repo and help me create one workflow first: `.windsurf/workflows/seo-page-refresh.md`.
Requirements:
- The workflow must work on one approved page at a time.
- It must diagnose before editing.
- It must write an approval plan to `seo-geo/approvals/page-refresh-plan.md`.
- It must forbid invented claims, unrelated file edits, publishing, deployment, redirects, robots changes, and sitemap changes.
- It must return changed files, validation commands, and metrics to watch.
Do not edit page content yet. First create or update only the workflow file and explain how I should run it.
FAQ
Windsurf workflows 應該自動執行嗎？
不要。對初學者來說，manual slash-command invocation 比較安全。把 workflows 當成 reusable procedures，不是 unattended bots。
一開始應該建立幾個 workflows？
先從一個開始。等第一個 workflow 能可靠地停下來等待核准，再加入 prompt audit、technical check 與 weekly report workflows。
可以用 workflow 發布頁面嗎？
一開始不要。用 Windsurf 準備 approved diff 與 validation report。Review 後，再透過正常 CMS 或 deployment process 發布。
AI coding agents for SEO/GEO 學習路徑
Windsurf track：
- Cursor vs Windsurf vs Gemini CLI：SEO/GEO 自動化怎麼選
- 如何建立 Windsurf Cascade Workflows 做 SEO/GEO
- 如何把 Windsurf Rules and Memories 用在 SEO/GEO Projects
- 如何用 Windsurf 把 Keyword Research 變成 Content Briefs
- 如何用 Windsurf 處理 SEO/GEO PR Comments
- Cursor、Windsurf、Gemini CLI、Codex、Claude Code 的 SEO/GEO 營運模型
Sources and notes
- Windsurf/Devin Desktop documentation: Cascade Workflows 。
- Related Auspia guide: Cursor vs Windsurf vs Gemini CLI for SEO/GEO Automation 。
Author: Nathan Reed, Auspia 80+ Growth Systems AI Marketing Workflow Designer。Nathan 撰寫 cross-channel systems 與 repeatable AI marketing workflows。
