如果你对 Windsurf 的印象还停留在“Codeium 那个免费补全器”,那你已经错过它最值钱的部分了。这个编辑器的命运相当坎坷:2025 年 7 月,Google 据报道以约 24 亿美元的“人才收购”方式挖走其 CEO Varun Mohan 团队,随后剩余公司与 Cognition(Devin 母公司)达成收购——当时国内外都有过“Windsurf 要凉”的判断。但它的 Agent 系统 Cascade 一直在迭代,官方文档里埋着一套完整的“上下文工程”机制:Memories、Rules、AGENTS.md、Workflows、Skills 五件套,能把你的团队规范、部署流程、测试模板全部固化进 AI 的脑子里。这些功能 Claude Code 用户圈讨论得火热,而 Windsurf 这边的对应物,中文社区几乎没人系统讲过。我这两天把 docs.windsurf.com 的三篇核心文档(Memories、Workflows、Skills)逐字读完,拆出 8 个立刻能用的冷门用法,全部有官方文档背书,不是玄学。
Windsurf 官方文档里有一张自我对比表,我直接翻译成中文思维版:
| 机制 | 一句话定位 | 怎么触发 |
|---|---|---|
| Rules | 告诉 Cascade “该怎么做人” | 按触发模式自动或 @提及 |
| AGENTS.md | 零配置的目录级规则 | 放进去就生效 |
| Workflows | 固定流程的“剧本” | 只能手动 /斜杠命令 |
| Skills | 带脚本模板的多步“全家桶” | 模型自动判断或 @提及 |
| Memories | Cascade 自己记的流水账 | 相关时自动取回 |
90% 的用户只用过里面 0 个——他们连 .windsurf/ 目录都没打开过。下面逐个拆。
大部分人在 .windsurf/rules/ 里建规则时都选 Always On(每条消息都注入全文)。但文档里明确写了每种模式的价格差异:
always_on:全文进系统提示词,每条消息都花上下文model_decision:系统提示词里只放 description 一句话,Cascade 觉得相关时才去读全文glob:只有碰到匹配文件(如 **/*.test.ts)时才生效manual:完全不进提示词,你手动 @规则名 才加载实战建议:把“公司用 bun 不用 npm”这类高频约束用 always_on;把“数据库迁移必须走 migration 脚本”这种低频约束改成 model_decision,省下的上下文窗口能多塞好几轮对话。每个规则是 .windsurf/rules/ 下一个独立 .md 文件(上限 12000 字符),规则还能用 XML 标签分组,比如 <coding_guidelines> 包起来,模型遵循度更高。
全局规则文件在 ~/.codeium/windsurf/memories/global_rules.md,上限 6000 字符,对所有项目生效、永远在线。预算紧张,所以别把项目规范写进来——那属于 workspace 级。全局区该放的是你的个人偏好:注释语言、命名习惯、“改代码前先跑测试”这类跨项目纪律。把 6000 字符当成你给 AI 立的家规额度来经营。
很多人不知道 Windsurf 原生吃 AGENTS.md:仓库根目录的 AGENTS.md 自动等于 always_on 规则;子目录里的 AGENTS.md 自动变成该目录的 glob 规则——你连 frontmatter 都不用写。这意味着在 Monorepo 里,packages/frontend/AGENTS.md 写前端约定、packages/backend/AGENTS.md 写后端约定,Cascade 改哪个目录就吃哪套规范,互不污染。而且 AGENTS.md 是跨工具的通用格式,这份文件在你换编辑器时照样能用,一次投入多处回收。
Memories 是 Cascade 在对话中自动记录的上下文,存在本地 ~/.codeium/windsurf/memories/,按 workspace 隔离、不进仓库。关键冷知识:你可以直接命令它记东西——对 Cascade 说 "create a memory of …"(用中文说“记住……”也行),它就会主动写入一条记忆。适合记“这个项目的测试账号是 X”、“客户要求接口返回带时间戳”这类一次性的活信息。注意官方文档的原话:一次性的活信息用 Memories,持久知识优先用 Rules 或 AGENTS.md——因为记忆不进 git,队友拿不到。
Workflows 存在 .windsurf/workflows/*.md,只能用 /名字 手动触发,天生适合部署、PR 审查、发版检查这类“每次都得走一样流程”的场景。文件结构就是:标题 + 描述 + 若干 step,Cascade 按顺序执行。两个隐藏玩法:
~/.codeium/windsurf/global_workflows/,任何项目都能 /调用。把你个人的“新模块脚手架”流程放这里,走到哪个仓库都带着。单个 workflow 上限 12000 字符,够写一份相当完整的 runbook 了。另外 Windsurf 自带内置 workflow(比如 /plan,先规划后动手)。
文档里写了一条优先级链:System > Workspace > Global > Built-in。同名 workflow,高优先级覆盖低优先级。企业版可以把 IT 统一部署的规则/工作流/技能放在系统目录(Windows 是 C:\ProgramData\Windsurf\rules\ 等路径,macOS 是 /Library/Application Support/Windsurf/,Linux 是 /etc/windsurf/),员工只读、UI 里带 System 标签、删不掉。团队 Leader 视角:这就是“强制执行公司规范”的官方开关——安全红线写系统级,项目自由度放 workspace 级,分层治理一套配齐。
官方文档在对比表里给 Skills 标了一句罕见的话:"invest here"(在这里投入)。Skill 是一个文件夹:.windsurf/skills/<名字>/SKILL.md + 任意支撑文件(脚本、清单、模板):
.windsurf/skills/deploy-to-production/
├── SKILL.md
├── deployment-checklist.md
├── rollback-procedure.md
└── config-template.yaml
核心机制是渐进式披露(progressive disclosure):平时模型只看到 skill 的 name 和 description 两行字,不占上下文;等它判断任务相关(或你 @skill-name)时,才加载全文和支撑文件。这意味着你可以囤几十个 skill 而不怕撑爆窗口。更妙的是,这套东西遵循 agentskills.io 的开放规范——和 Claude Code 的 Agent Skills 是同一个规范家族,社区里现成的 skill 资源思路可以直接搬过来改。
Windsurf 的规则和工作流发现机制会做三件事:扫描当前 workspace 及所有子目录的 .windsurf/rules;沿目录树向上找到 git 根再扫一遍;多根 workspace 里自动去重、按最短相对路径显示。含义是:你接手一个老仓库,不用动它的历史结构,把 .windsurf/ 塞进任意层级都能生效;反过来你自己维护一套“通用规则包”,扔进任何 git 仓库的父目录,旗下所有项目自动继承。
flowchart TD
A[想定制 Cascade?] --> B{要固化什么?}
B -->|行为约束/编码风格| C[Rule<br/>选对 trigger 省上下文]
B -->|某目录的局部约定| D[AGENTS.md<br/>零配置 自动glob]
B -->|固定流程/部署发版| E[Workflow<br/>斜杠命令手动触发]
B -->|多步任务+脚本模板| F[Skill<br/>渐进式披露 官方喊你投资]
B -->|一次性事实| G[Memory<br/>或直接说 create a memory]
C --> H{作用范围?}
E --> H
F --> H
H -->|全项目通用| I[workspace 级 进git 全队共享]
H -->|个人偏好| J[global 级 本地生效]
H -->|公司红线| K[system 级 只读强制]
| 你以为的 | 实际情况 |
|---|---|
| Windsurf 就是个补全器 | Cascade 有完整五件套上下文工程体系 |
| AI 记性差,重要的事得反复交代 | 一句 "create a memory" 就能写入持久记忆 |
| 团队规范只能靠 Code Review 人肉盯 | 系统级 Rules 只读下发,想删都删不掉 |
| 部署流程每次口头描述 | 写成 Workflow,一行 /deploy 全队复用 |
| 上下文预算没法省 | model_decision/glob 触发模式按需加载 |
| Skill 是 Claude Code 专属 | Windsurf Skills 遵循同一开放规范,玩法互通 |
.windsurf/rules/,写第一条 always_on 规则(技术栈约束),再写一条 model_decision 规则(低频红线),对比效果。参考来源:
本文由「51学通信」技术团队出品。51学通信由通信行业18年老兵爱卫生(微信ID: gprshome201101)维护。 聚焦5G/6G核心网、3GPP标准、AI工具实战。知识星球「51学通信」提供深度技术答疑和行业洞察。
[!tip] 51学通信知识星球 星主:爱卫生(微信:gprshome201101)——公众号「51学通信」创办者,19 年通信行业运维与讲师经验,著有《GPRS网络信令实例详解》《EPC原理与实践》《5G核心网原理与实践》三本纸质书(各大电商平台有售)。 星球定位:深耕 5G 核心网、IMS、NFV/AI、云原生等 ICT 领域,主打运维岗位与信令分析。 当前规模:5200 篇主题 / 990 个回答,198 元/年。 加入福利:加入星球后请加爱卫生微信,拉您进知识星球年度陪伴与答疑群——不限量回复您的各种问题,另有群内分享。 AI 加持:51学通信知识星球已作为 skill 接入 WorkBuddy,使用 deepseek-4-flash 在海量星球帖子中精准找贴、找视频、找 FAQ 和案例,做总结、找文档和 PPT 等场景全覆盖。
