Introduction to Rules, Memories, & Workflows
学习如何使用 Windsurf 的规则、记忆和工作流来自定义 Cascade 的行为，使其适应您的编码标准和实践。
【AI技能】Introduction to Rules, Memories, & Workflows：功能详解与安装指南
技能简介
AI 编程助手越来越聪明，但你是否经常遇到这样的情况：它总是用你不喜欢的命名规范写代码，或者每次开启新对话，都要重新向它解释一遍项目使用的数据库类型和架构设计？Windsurf 的 Cascade 虽然强大，但默认状态下它只是一个懂代码的“通才”，并不了解你和你的团队的独特习惯。
“Introduction to Rules, Memories, & Workflows”正是为你解决这一痛点而生的核心技能模块。它不仅是一份详尽的使用指南，更是解锁 Windsurf AI 深度定制能力的钥匙。通过这套系统，你可以将团队的编码规范、项目的架构决策以及繁琐的多步操作固化下来。规则让 AI 知道“什么该做、什么不该做”，记忆让 AI 跨会话保留“项目潜意识”，工作流则让 AI 学会“按套路出牌”。掌握了它，你就能将通用的 AI 助手调教成深谙你项目之道的专属专家，彻底消除重复沟通的摩擦力，让开发流如丝般顺滑。
核心优势
规则驱动，让代码风格“一步到位” 不再需要每次都在提示词里苦口婆心地强调“请使用 TypeScript 并遵循 ESLint 规则”。通过配置 Rules，你可以将团队的编码标准、框架偏好甚至目录结构约定硬性植入 Cascade 的思考过程。场景： 当你要求生成一个新的 API 路由时，Cascade 会自动按照你规定的特定中间件顺序和错误处理格式输出，无需任何二次修改，直接通过 Code Review。
智能记忆，跨越会话的“项目潜意识” AI 的上下文窗口总有刷新的时候，但 Memories 打破了这一限制。它能将关键的架构决策、技术栈选型或特殊的业务逻辑持久化保存。场景： 你今天告诉 Cascade“本项目统一使用 Redis 做缓存，端口配置在 env 里”，一个月后你再开启新对话询问缓存方案，它依然会默认基于 Redis 编写代码，真正做到了“一次告知，永久生效”，告别反复念叨。
工作流编排，复杂任务一键自动化 面对多步骤的繁琐操作（如：新建路由、编写控制器、添加单元测试、更新 Swagger 文档），Workflows 允许你将这些步骤固化为一套可复用的模板。场景： 当你需要新增一个 CRUD 模块时，只需触发“Create New Module”工作流，Cascade 就会按序自动完成所有文件的生成与关联修改，省去了逐个下达指令的麻烦，效率成倍提升。
无缝协同，团队规范零损耗同步 规则和工作流配置可以作为文件直接提交到 Git 仓库中。这意味着整个团队可以共享同一套 AI 行为规范。场景： 新入职的同事克隆仓库后，Cascade 自动加载团队的
.windsurfrules，他写出的第一行代码就完全符合团队标准，大幅降低了代码审查的沟通成本和新人上手门槛。
主要功能
| 功能 | 说明 |
|---|---|
| 自定义规则配置 | 允许在项目根目录创建 .windsurfrules 文件，以自然语言或特定格式定义代码生成规范、技术栈约束和输出格式要求，强制 AI 遵守 |
| 智能记忆管理 | 提供 Cascade 上下文的持久化机制，自动或手动保存关键项目决策、偏好设置，确保 AI 在不同会话和时间段内保持项目认知的连贯性 |
| 自动化工作流编排 | 支持将多步骤的复杂开发任务定义成标准化工作流（如新建完整功能模块），通过简单指令触发，让 AI 按预设步骤自动串行执行 |
| Cascade 行为定制 | 深度调整 AI 助手的响应风格，如设定回答的详细程度、代码注释的密度、是否优先提供伪代码等，适应不同开发者的思维习惯 |
| 团队规范共享与版本控制 | 规则和工作流配置文件可纳入版本控制系统（Git），实现团队间 AI 协作规范的统一分发、同步更新与历史追溯 |
如何获取与安装
作为 Windsurf 官方推出的核心教育技能，本模块完全免费。获取和配置的过程非常清晰，请按照以下具体步骤操作，将你的 Windsurf 彻底升级：
第一步：获取技能知识 访问 Windsurf University 的官方技能页面，系统学习 Rules、Memories 与 Workflows 的底层逻辑与高级语法： 👉 访问链接：https://windsurf.com/university/general-education/intro-rules-memories
第二步：在 Windsurf IDE 中配置 Rules
- 打开你的 Windsurf 编辑器，并加载目标项目。
- 在项目根目录下创建一个名为
.windsurfrules的文件（注意没有扩展名）。 - 在文件中以 Markdown 格式写入你的规则。例如：
# Project Rules - Always use TypeScript for any new files. - Follow the existing naming conventions: camelCase for variables, PascalCase for components. - Never use `var`, always use `const` or `let`. - All API endpoints must include error handling middleware. - 保存文件。下次你在 Cascade 中发出指令时，AI 会自动读取并严格遵守这些规则。
第三步：管理 Memories
- 在 Cascade 对话框中，当你提供了一个重要的项目决策（例如：“我们决定使用 Prisma 替代 TypeORM”）。
- 你可以直接告诉 Cascade：“请记住这个决定”。
- Cascade 会将其提取并存入 Memories 系统。你也可以通过 Windsurf 的设置面板（Settings > Cascade Memories）查看、编辑或删除过时的记忆条目，保持 AI 的“大脑”清晰。
第四步：创建与触发 Workflows
- 通过 Windsurf 的命令面板（
Cmd/Ctrl + Shift + P）搜索Workflows: Create New Workflow。 - 按照引导，定义触发词（如
add-crud）和具体的执行步骤提示词序列。 - 使用时，只需在 Cascade 对话框中输入
/add-crud，即可一键启动预设的复杂编排流程。
适用场景
- 企业级多人协作项目：需要严格统一代码风格、架构规范，通过 Git 共享
.windsurfrules确保 AI 辅助产出符合团队标准。 - 遗留代码库重构与维护：利用 Memories 记录复杂的历史架构决策和避坑指南，防止 AI 在修改老代码时破坏原有隐性逻辑。
- 高频样板代码生成：如每天需要新建多个类似的 CRUD 接口、组件或测试套件，通过 Workflows 一键生成全套文件，告别重复劳动。
- 个人技术栈深度定制：当你有强烈的个人编码偏好（如极度喜欢函数式编程、特定的状态管理库），通过 Rules 让 AI 完全顺应你的思维模式。
小贴士
- 规则越具体越好：避免在
.windsurfrules中写“写好代码”这种模糊描述。尽量写成“优先使用 React Hooks，禁止使用 Class 组件”这样可执行、可验证的强约束，AI 的执行效果会显著提升。 - 定期清理记忆：随着项目演进，一些早期的 Memories 可能已经过时（比如换了数据库）。定期去设置面板清理掉废弃的记忆，能防止 AI 被“旧思想”误导，产生幻觉。
- 善用自然语言编写规则：Windsurf 的规则引擎对自然语言理解极佳，你不需要学习特定的配置语法，直接用大白话把要求列出来，Cascade 就能精准领会！
免责声明：技能效果可能因版本和配置而异，请以官方文档为准