Creating & Modifying Rules
学习如何在 Windsurf 中创建和管理自定义规则，以强制保持一致的代码风格和项目特定约定，例如使用 Tailwind 类而不是原生 CSS。
【AI技能】Creating & Modifying Rules：功能详解与安装指南
技能简介
在日常开发中，你是否经常遇到这样的困扰：AI 编程助手生成的代码虽然逻辑正确，但风格却与项目既定规范格格不入？比如，你的团队明确规定前端样式必须使用 Tailwind CSS，但 AI 却总是习惯性地写出原生 CSS 甚至内联样式；或者你要求使用特定的状态管理库，它却偏要引入别的依赖。每次都要手动修改这些"不听话"的代码，简直比自己写还费劲。
Creating & Modifying Rules 正是为解决这一痛点而生的 Windsurf 专属技能。它允许开发者通过简单直观的方式，为 AI 助手设定清晰的"行为准则"——也就是自定义规则。通过这套技能，你可以将团队的代码风格、架构约定、技术栈偏好等硬性要求直接注入到 Windsurf 的上下文中，让 AI 从"凭感觉写代码"转变为"严格遵守项目规范的得力干将"。如果你希望 AI 生成的代码不仅能跑，还能直接融入你的项目体系，那么这个技能绝对不容错过。
核心优势
- 强制执行代码风格一致性：在多人协作的大型项目中，代码风格统一是永远的痛。通过该技能，你可以设定诸如"必须使用 Tailwind 类而非原生 CSS"的硬性规则。这意味着无论哪个开发者唤起 AI，生成的代码都会自动遵守同一套视觉和结构规范，彻底告别五花八门的"个人风格"代码。
- 沉淀项目特定约定，拒绝幻觉依赖：AI 模型有时会"自作聪明"地引入项目中并不存在的库或写法。利用自定义规则，你可以明确告诉它"本项目使用 Zustand 进行状态管理，禁止引入 Redux"或"API 请求必须使用项目封装的 axios 实例"。这有效遏制了 AI 的幻觉，让生成结果即插即用。
- 大幅降低代码审查成本：没有规则约束时，PR 审查者需要花大量时间纠正 AI 生成的命名不规范、样式写法错误等问题。配置规则后，AI 输出的代码在首次生成时就已对齐规范，审查者只需关注核心逻辑，极大提升了团队流转效率。
- 灵活迭代，随项目演进：项目的技术栈和规范并非一成不变。当团队决定从 JavaScript 迁移到 TypeScript，或更新了组件库版本时，你只需几分钟修改一下规则文件，Windsurf 就能立刻"学会"新规矩，无缝跟上项目演进步伐。
主要功能
| 功能 | 说明 |
|---|---|
| 创建自定义规则 | 支持在 Windsurf 中通过自然语言或特定语法编写规则，定义代码风格、技术栈偏好、架构限制等约束条件 |
| 修改与迭代规则 | 随项目需求变化，随时编辑已有规则内容，确保 AI 助手始终与团队最新的开发约定保持同步 |
| 强制风格一致性 | 自动将规则注入 AI 上下文窗口，强制模型在生成、重构或补全代码时遵循既定规范（如强制 Tailwind） |
| 规则分类与作用域管理 | 支持全局规则与项目级规则分类管理，可为不同类型的项目配置独立的规则作用域，避免规范冲突 |
如何获取与安装
作为 Windsurf 平台的内置配置技能，Creating & Modifying Rules 是完全免费的，无需额外下载插件。你只需要在项目或全局中创建并配置 Windsurf 的规则文件即可生效。以下是具体的操作步骤：
方法一：通过命令行快速创建项目级规则（推荐）
这是最直接的方式，规则文件会存放在项目根目录，跟随代码库一起进行版本控制，确保团队所有人共享同一套规则。
- 打开终端，进入你的项目根目录：
cd /path/to/your/project - 创建 Windsurf 规则文件
.windsurfrules：touch .windsurfrules - 使用编辑器打开该文件，并写入你的自定义规范。例如，强制使用 Tailwind 并规定命名规范：
echo "- Always use Tailwind CSS classes for styling. Never use raw CSS or inline styles.\n- Use camelCase for JavaScript function names and PascalCase for React components." > .windsurfrules
方法二：通过 Windsurf 编辑器界面配置
- 打开 Windsurf 编辑器，使用快捷键
Cmd + Shift + P(Mac) 或Ctrl + Shift + P(Windows/Linux) 呼出命令面板。 - 搜索并选择
Windsurf: Open Rules File或在设置面板中找到 Rules 配置入口。 - 在打开的配置面板中，你可以直接输入规则文本，或者选择将规则保存为项目级（
.windsurfrules）或用户级（全局生效）。
获取更多灵感与官方文档： 如果你不知道该如何编写高效的规则，可以访问官方指导文档获取更多示例和最佳实践： 👉 官方文档地址：https://windsurf.com/university/general-education/creating-modifying-rules
适用场景
- 多人协作的大型前端项目：当团队有严格的 UI 规范（如必须使用 Tailwind 或特定组件库）时，通过规则确保 AI 不越界。
- 企业级前后端分离开发：后端需要统一返回格式，前端需要统一请求封装，通过规则让 AI 生成符合公司基建规范的代码。
- 遗留代码重构与迁移：在将旧项目从 Vue 2 迁移到 Vue 3，或从 JS 迁移到 TS 时，设定"仅使用 Composition API"或"必须提供类型声明"的规则，防止 AI 生成旧范式代码。
- 特定技术栈的深度使用：例如 Next.js App Router 项目，设定规则强制 AI 使用 Server Components 优先，避免滥用 Client Components。
小贴士
- 规则要具体，避免模糊表述：不要写"请写好代码"，这种规则对 AI 没有约束力。应该写"变量命名必须使用驼峰式"、"禁止使用
var，必须使用const或let"这类可明确执行的指令。 - 将
.windsurfrules纳入 Git 版本控制：把规则文件提交到代码仓库，这样当新成员克隆项目时，他们的 Windsurf 会自动读取规则，实现团队规范的"零成本"同步。 - 定期审查和精简规则：规则过多或相互冲突会让 AI 感到困惑。建议每月与团队一起审查
.windsurfrules，删除过时约定，合并重复条目，保持规则集的精简与高效。
免责声明：技能效果可能因版本和配置而异，请以官方文档为准