你会建立什么
这篇教学会把 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。
