Windsurf Cascade Plan 与 Write 工作流:规划、单步改代码与 git diff 审查
Plan 定范围 → Write 单步 diff → git diff 审查的 Cascade 工作流。
Windsurf Cascade 装好并登录之后,常见卡点变成工作流:多文件重构仍停在 Chat,或对一堆没读过的 diff 点 Accept All。先用 Plan 列步骤,再切 Write 做一步可回滚改动,最后用 git diff 审查。
检索词是 Windsurf Cascade Plan Write 工作流 可审查 diff。下文对照 windsurf.com 与 docs.devin.ai/windsurf 的 Cascade 模式说明(界面名称可能随版本变,以当前 UI 为准)。首次安装见 Cascade 安装笔记;会话发黏见 更新后刷新 Cascade。不是会议产品说明;要约短会过 diff,用 wbmeet,见 创建与加入房间。
Cascade 里的 Plan、Write 与 Chat
Cascade 是 Windsurf 的仓库级代理。官方文档区分「先规划再改文件」与纯问答:界面里通常可选 Plan(或同类规划模式)只出步骤、暂不改盘;Write 提议改文件并可能跑终端命令;Chat 偏只读解释。第二小时的重点是选对模式,不是重复安装步骤。
Plan 模式:Write 之前定范围
- 1
在仓库根打开 Cascade
Cmd+L/Ctrl+L或侧栏 Cascade。集成终端先跑git status,看清已有未提交改动。 - 2
选 Plan(规划模式)
任务跨多个文件时选 Plan——重构、新功能骨架、补测试等。示例:「列出给
parseUserId加输入校验的 3–5 步;先不要改文件。」 - 3
用 @ 缩小上下文
用
@附加单个文件或目录(以 Cascade 上下文 UI 为准)。若计划要改半个仓库,要求:「范围限定一个源文件加一个测试文件。」
Write 模式:一次只落地一个可审查 diff
- 1
切 Write,只做第 1 步
计划合理后切 Write:「只执行第 1 步:在目标文件加校验;展示 diff,等我确认再往下。」
- 2
按块 Accept,不要 Accept All
在 diff 视图逐块阅读。一次 Accept 一个文件。若提议跑
npm test、pytest等,先读命令与输出再点 Allow。 - 3
用 git diff 收尾
自己跑
git diff。不对就用git restore回滚。再 Write 第 2 步,或上下文已乱则 New Chat(见刷新文)。
# Plan → Write 工作流 · Windsurf Cascade · 2026-10-15
cd /path/to/your/repo && git status
# Cascade Plan:「@src/parser.ts — 只规划校验,不改文件」
# 切 Write:「只做第 1 步;展示 diff;等待」
# 逐块 Accept → git diff → 必要时 git restore .模式对照
| 模式 | 何时用 | 工作流注意 |
|---|---|---|
| Chat | 解释代码、概念问答 | 不应期待改文件 |
| Plan | 多步或不熟悉模块 | 明确要求暂不改盘 |
| Write | 落地具体 diff | 一条提示只做一步 |
只有 Plan 没有代码
计划便宜——必须跟一条 Write 单步,否则只是聊天。
Write 动文件过多
停止、回滚、@ 单文件重问。若只需内联补全,可对照 VS Code Copilot。
重构中途上下文发黏
新建 Cascade 对话并缩小 @;见 更新后刷新。
建议路径:Plan + 收紧 @ → Write 第 1 步 → 逐块 Accept →
git diff→ 下一步或新对话。命令与额度以你安装的 Windsurf 官方文档为准。
- 与安装文的区别
- 安装文讲下载登录;本页讲 Cascade 已可用时的 Plan → Write。
- 与刷新文的区别
- 刷新解决更新与会话陈旧;本页讲如何用模式产出可审查 diff。
- 本页主题
- 只讲 Cascade 工作流,不是 wbmeet 会议说明。
还想核对的问题
模式名称和我界面不一致?
标签会随版本调整。看 Cascade 顶部的规划/编辑切换;细节以 docs.devin.ai/windsurf 为准。
改一行 typo 也要 Plan 吗?
不必。单行修复可直接 Write:「只改一个文件,先展示 diff。」
会自动 git commit 或 push 吗?
不应未经你流程就 push。Git 命令在你允许后才会跑——学习阶段建议自己 commit。
要关掉其他 AI 扩展吗?
Copilot、Continue 等与 Windsurf 内联补全可能冲突。Write 改库时避免多个代理同时写同一棵树。