Windsurf

Windsurf AI IDE 助手，精通 Cascade Agent、AI Flow、规则配置、快捷键

Security Scan

The skill's requirements and instructions match its stated purpose as an IDE assistant that can read/write project files and run build/git commands; it appears internally coherent but grants broad project access typical for this kind of tool, so use the usual caution.

Purpose & Capability

Name and description (Windsurf AI IDE assistant with Cascade/AI Flow) align with the SKILL.md: it documents features like multi-step agents, project indexing, file read/write, and terminal command execution, which are expected for an IDE agent.

Instruction Scope

The SKILL.md explicitly describes behaviors that read and modify the entire project, run terminal commands (e.g., npm install, git commit), and reference a per-project rules file (.windsurfrules) and a global config (~/.windsurf/global_rules.md). This is coherent for an IDE assistant, but it implies broad filesystem and command execution capability — users should be aware the agent can change code and run shell commands.

Install Mechanism

Instruction-only skill with no install spec, no downloads, and no declared binaries — lowest-risk install surface and consistent with a documentation/behavior guidance skill.

Credentials

No environment variables, credentials, or config paths are declared as required. The only file paths mentioned are the project-level .windsurfrules and the optional ~/.windsurf/global_rules.md, which are reasonable for a per-project/global IDE configuration.

Persistence & Privilege

always is false and the skill uses the platform-default model invocation behavior; nothing requests permanent forced inclusion or modification of other skills' configs. Autonomous invocation is allowed by default (normal), but combined with the described file/command capabilities it increases the importance of user controls.

Assessment

This skill is internally consistent with an IDE assistant: it expects to index your project, edit files, and run build/git commands. Before installing, consider: 1) only enable autonomous runs if you trust the skill and environment; prefer Chat/interactive modes for sensitive projects; 2) do not keep secrets in source files or in the global rules file (~/.windsurf/global_rules.md); putting .env in .gitignore helps with git commits but does not prevent local file reads—treat it as a safeguard, not a guarantee; 3) keep backups or use a branch when allowing automatic commits, and review all automated diffs/commits; 4) if you want lower risk, restrict the skill's permissions or disable autonomous invocation where possible. Overall the skill appears coherent and not malicious, but its ability to modify code and run shell commands means standard caution is warranted.

Windsurf AI IDE 技能指南

概述

Windsurf 是 Codeium 推出的 AI 原生 IDE，基于 VS Code fork 构建。核心卖点是 Cascade —— 一个能自主执行多步骤任务的 AI Agent，比传统的代码补全和聊天助手更进一步。

核心功能

Cascade（AI Agent 模式）

Cascade 是 Windsurf 的旗舰功能，区别于普通 AI 聊天：

• 多步骤自动执行：给出高层目标，Cascade 自动拆解为多个步骤依次执行
• 文件读写：自动读取相关文件、创建新文件、修改现有代码
• 终端命令：自动运行 npm install、git commit 等命令
• 上下文感知：自动索引整个项目，理解文件间的依赖关系
• Write/Chat 模式：Write 模式直接修改代码，Chat 模式仅讨论不动代码

使用技巧：

• 描述目标而非步骤，让 Cascade 自己规划执行路径
• 遇到错误时 Cascade 会自动尝试修复，通常不需要手动干预
• 用 @file 或 @folder 显式指定上下文范围，提高准确度

AI Flow（智能代码补全）

AI Flow 是 Windsurf 的上下文感知补全引擎：

• 多行补全：不只补全当前行，能预测接下来多行代码
• 跨文件感知：根据项目中其他文件的模式和类型定义生成补全
• Tab 接受：按 Tab 接受建议，按 Esc 拒绝
• Supercomplete：基于最近编辑行为预测下一步操作

Cmd+I 内联编辑

选中代码后按 Cmd+I（macOS）或 Ctrl+I（Windows/Linux）：

• 直接在代码位置弹出编辑指令输入框
• 适合小范围重构、添加注释、修改逻辑
• 修改以 diff 形式展示，可逐个接受或拒绝

Chat 面板

侧边栏对话面板，用于：

• 询问代码相关问题、解释复杂逻辑
• 生成代码片段后手动粘贴
• 用 @ 引用文件、符号、文档等上下文

规则配置

在项目根目录创建 .windsurfrules 文件，控制 AI 行为：

# .windsurfrules 示例

你是一个 TypeScript 全栈开发专家。

技术栈：
- 前端：React 18 + TypeScript + Tailwind CSS
- 后端：Node.js + Express + Prisma
- 测试：Vitest + React Testing Library

代码规范：
- 使用函数式组件和 Hooks
- 所有函数必须有 TypeScript 类型标注
- 错误处理使用 try-catch，禁止静默吞错
- 组件文件使用 PascalCase 命名

也支持全局规则文件 ~/.windsurf/global_rules.md，对所有项目生效。

快捷键速查表

功能	macOS	Windows/Linux
打开 Cascade	Cmd+L	Ctrl+L
内联编辑	Cmd+I	Ctrl+I
接受补全	Tab	Tab
拒绝补全	Esc	Esc
命令面板	Cmd+Shift+P	Ctrl+Shift+P
切换 Write/Chat	面板内切换	面板内切换
引用文件	@file	@file
引用文件夹	@folder	@folder
终止执行	Cmd+Backspace	Ctrl+Backspace

Windsurf vs Cursor 对比

维度	Windsurf (Cascade)	Cursor (Composer)
自主性	高，自动规划多步骤	中，需要更多人工确认
可控性	较低，Agent 自行决策	高，每步可审查
代码索引	自动全项目索引	需手动 @codebase
终端集成	自动执行命令	需确认后执行
免费额度	有免费层	有免费层
VS Code 兼容	完全兼容插件	完全兼容插件
适合人群	喜欢放手让 AI 干	喜欢精细控制

Windsurf 更像"放手让 AI 干"，Cursor 更像"AI 辅助你干"。选择取决于你对 AI 自主性的接受程度。

使用场景和最佳实践

适合场景：从零搭建脚手架、批量重构、快速原型、探索不熟悉的技术栈

最佳实践：

1. 先写好 .windsurfrules，确保 AI 输出符合团队规范
2. 大任务用 Cascade，小修改用 Cmd+I 内联编辑
3. Cascade 执行过程中可随时中断并调整方向
4. 定期检查 Cascade 的自动提交，避免引入不需要的改动
5. 敏感文件（.env、密钥）加入 .gitignore，防止 AI 误操作
6. 复杂项目建议分模块给 Cascade 任务，避免一次性改动过大