如何用 Windsurf 从 Keyword 到 Content Workflow

你会建立什么

这篇教学会示范如何用 Windsurf 把 keyword data 转成 content briefs 和可执行的 publishing calendar。目标不是把 keywords 丢给 AI writer。目标是建立一个 workflow，告诉你哪些 pages 要 refresh、哪些 pages 要 create、哪些 ideas 要 ignore，以及每一页需要什么 evidence。

你会建立：

.windsurf/workflows/keyword-to-content-brief.md
seo-geo/keyword-workflow/
inputs/
keywords.csv
gsc-queries.csv
bing-queries.csv
existing-urls.csv
competitor-pages.csv
outputs/
cleaned-keywords.md
clusters.md
page-map.md
briefs/
calendar.md

图说：先检查 existing URLs，再决定 refresh、create、merge 或 ignore，避免为同一 intent 建太多页。

步骤 1：准备 input files

建立 folders：

mkdir -p .windsurf/workflows seo-geo/keyword-workflow/inputs seo-geo/keyword-workflow/outputs/briefs

如果你已经使用 SEO tools，就从平常的工具汇出 CSV files。如果没有，先用小样本手动开始也可以，workflow 仍然能跑。

建立一个简单 keyword file：

cat > seo-geo/keyword-workflow/inputs/keywords.csv <<'EOF2'
keyword,volume,difficulty,intent,source
ai reporting dashboard,900,42,commercial,keyword_tool
reporting automation software,500,38,commercial,keyword_tool
how to automate weekly reports,700,27,informational,keyword_tool
best reporting tools for startups,350,31,comparison,keyword_tool
EOF2

建立 existing URL inventory：

cat > seo-geo/keyword-workflow/inputs/existing-urls.csv <<'EOF2'
url,title,page_type,last_updated
/features/reporting,Reporting Automation,landing,2026-05-10
/blog/weekly-report-automation,How to Automate Weekly Reports,blog,2025-11-18
/tools/report-template-generator,Report Template Generator,tool,2026-02-03
EOF2

Optional 但有用的 inputs：

步骤 2：建立 Windsurf workflow

建立 workflow file：

cat > .windsurf/workflows/keyword-to-content-brief.md <<'EOF2'
# Keyword to Content Brief

Goal: convert keyword, search, competitor, and AI-prompt inputs into a page map, content briefs, and a 90-day content calendar.

Required inputs:
- `seo-geo/keyword-workflow/inputs/keywords.csv`
- `seo-geo/keyword-workflow/inputs/existing-urls.csv`

Optional inputs:
- `gsc-queries.csv`
- `bing-queries.csv`
- `competitor-pages.csv`
- `ai-prompts.md`

Steps:
1. Read all available inputs.
2. Clean obvious duplicates and merge keyword variants.
3. Group queries by user intent, not by exact wording only.
4. Label each cluster as informational, commercial, comparison, support, technical, local, or GEO prompt.
5. Map every cluster to one of four decisions: refresh existing page, create new page, merge with another cluster, or ignore for now.
6. For approved clusters, create a brief under `seo-geo/keyword-workflow/outputs/briefs/`.
7. Create `seo-geo/keyword-workflow/outputs/page-map.md`.
8. Create `seo-geo/keyword-workflow/outputs/calendar.md`.

Approval gate:
- Stop after the page map.
- Ask the user to approve which briefs to create.
- Do not draft full articles unless the user approves the page map.

Brief requirements:
- target cluster
- search intent
- GEO prompt version
- page type
- existing URL or proposed slug
- reader problem
- outline
- proof needed
- internal links
- screenshots or examples needed
- quality risks
- measurement plan

Forbidden actions:
- do not publish
- do not invent search volume
- do not invent customer proof
- do not create multiple pages for the same intent
- do not recommend a new page before checking existing URLs
EOF2

步骤 3：第一次执行 workflow

在 Windsurf 里，用精准 request 呼叫 workflow：

Run /keyword-to-content-brief using `seo-geo/keyword-workflow/inputs/`.

First output only:
1. cleaned keyword notes
2. intent clusters
3. page map with refresh/create/merge/ignore decisions

Do not draft articles yet. Do not edit website pages. Stop after `page-map.md` and ask me what to approve.

有用的 first output 应该像这样：

Cluster: reporting automation software
Intent: commercial evaluation
GEO prompt: "What is the best reporting automation software for a small startup?"
Decision: refresh existing page
Target URL: /features/reporting
Reason: existing landing page matches the commercial intent but lacks comparison criteria and proof.
Risk: do not claim integrations that are not documented.
Priority: high

如果 Windsurf 没有检查 existing URLs，就直接建立十个新文章 idea，代表 workflow 失败。把这行加进 workflow：No new page may be recommended until existing-urls.csv has been checked.

步骤 4：只核准小范围 page map

不要全部核准。先选一个 refresh 和一个 new page。

使用这段 prompt：

Approve only these two actions:
1. Refresh `/features/reporting` for the cluster "reporting automation software".
2. Create one blog brief for "how to automate weekly reports".

Create briefs for only these two. Do not draft final articles. Include evidence needed, screenshots needed, internal links, FAQ candidates, and measurement plan.

步骤 5：要求 writer 真的能用的 brief

好的 Windsurf brief 应该是 operational，不只是 title 和 outline。使用这个格式：

要求 Windsurf 把每份 brief 存成档案：

Save the approved briefs under seo-geo/keyword-workflow/outputs/briefs/ using short filenames. Include a final checklist at the bottom of each brief.

步骤 6：briefs 通过后再建立 90 天 calendar

只有在 page map 和 first briefs 存在后才建立 calendar。否则 calendar 只是虚构。

Prompt：

Create `seo-geo/keyword-workflow/outputs/calendar.md` for 90 days.
Use only approved clusters and briefs.
For each item include: week, page type, target URL or proposed slug, owner, required proof, difficulty, expected business value, GEO prompt target, and validation metric.
Limit the calendar to work a small team can actually finish.

Example row：

步骤 7：brief 核准后才用 Windsurf 起草

准备 draft 时，request 仍然要 narrow：

Using only the approved brief `seo-geo/keyword-workflow/outputs/briefs/automate-weekly-reports.md`, draft the article in a new markdown file under `seo-geo/drafts/`.
Do not edit the live website.
Do not invent proof.
Mark missing screenshots or product facts as TODO.
Include natural internal links only where the brief allows them.

这可以避免 Windsurf 把 keyword research 变成 unsupported content。

Troubleshooting

初学者可直接复制的 prompt

I want to use Windsurf to turn keyword data into content briefs, not final articles.

Please create `.windsurf/workflows/keyword-to-content-brief.md` and use the files in `seo-geo/keyword-workflow/inputs/`.

Rules:
- Check existing URLs before recommending new pages.
- Group keywords by intent.
- Map each cluster to refresh, create, merge, or ignore.
- Stop after the page map and ask for approval.
- After approval, create briefs with proof needed, internal links, GEO prompt targets, screenshots needed, quality risks, and measurement plan.
- Do not publish. Do not edit live pages. Do not invent volume, proof, or customer claims.

FAQ

Windsurf 可以自己找 keywords 吗？

如果你的 environment 有连接工具，它可以协助处理 files 或使用 connected tools。但初学者安全 workflow 应该从 exports 或小型手动 CSV 开始。缺少 search volume 时，就标成 unknown，不要让它捏造。

每个 keyword 都应该变成一页吗？

不是。很多 keywords 应该 merge 到现有页、ignore，或留到之后再做。一个 page 应该拥有一个清楚 intent。

这对 GEO 有什么帮助？

每个 keyword cluster 都会转成 buyer-style prompt。Brief 接著指定 page 应支援什么答案、需要什么 evidence，以及之后如何检查 AI visibility。

AI coding agents for SEO/GEO 学习路径

Windsurf track：

1. Cursor vs Windsurf vs Gemini CLI：SEO/GEO 自动化怎么选
2. 如何建立 Windsurf Cascade Workflows 做 SEO/GEO
3. 如何把 Windsurf Rules and Memories 用在 SEO/GEO Projects
4. 如何用 Windsurf 把 Keyword Research 变成 Content Briefs
5. 如何用 Windsurf 处理 SEO/GEO PR Comments
6. 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: Clara Bennett, Auspia 10-Year Content Strategy Practitioner。Clara 撰写 editorial systems、topic maps 与 repeatable SEO/GEO production workflows。