Windsurf 集成指南
在 Windsurf AI 中使用 Agent Skills 的详细教程。
Windsurf AI 集成
Windsurf 是 Codeium 推出的强大 AI 原生 IDE，完全支持 Agent Skills 标准。本指南将帮助你在 Windsurf 中设置和使用技能。
前置条件
- 已安装 Windsurf IDE
- Node.js 18+ 和 npm/pnpm
安装方式
方式一：CLI 命令安装
使用全局 CLI 安装技能：
npx agent-skills install expo/skills/building-native-ui技能将自动在你的 Windsurf 工作区中可用。
方式二：Cascade（Agent 模式）
Windsurf 的 Cascade 功能可以直接使用技能配置。在 Cascade 聊天中：
-
输入你的请求并提及技能：
使用 expo-native-ui 技能，帮我构建一个标签页导航 -
Cascade 会自动获取并应用技能上下文。
方式三：项目级配置
在项目的 .windsurf/skills.json 中添加技能：
{
"skills": [
"vercel-labs/agent-skills/vercel-react-best-practices",
"expo/skills/building-native-ui"
]
}打开项目时，Windsurf 会自动加载这些技能。
在 Cascade 中使用技能
Windsurf 的 Cascade（AI Agent）模式非常适合复杂任务：
@cascade 使用 react-best-practices 技能，重构我的组件以遵循 Vercel 规范Cascade 会：
- 加载技能的知识库
- 分析你的代码
- 应用技能的模式和建议
Windsurf 热门技能推荐
| 技能 | 用途 | 安装命令 |
|---|---|---|
| Building Native UI | React Native / Expo 开发 | expo/skills/building-native-ui |
| Expo Deployment | 应用商店部署 | expo/skills/expo-deployment |
| Monorepo 最佳实践 | 大型代码库管理 | jaredpalmer/skills/monorepo-best-practices |
| Better Auth | 身份认证实现 | better-auth/skills/better-auth-best-practices |
Windsurf vs Cursor：主要区别
| 功能 | Windsurf | Cursor |
|---|---|---|
| Agent 模式 | Cascade（流式） | Composer |
| 技能加载 | Cascade 中自动加载 | 需手动设置 |
| 多文件编辑 | 原生支持 | 通过 Composer |
| 上下文窗口 | 扩展型（100K+） | 标准型 |
常见问题
技能在 Cascade 中无法加载？
- 启用 Flow 模式：确保你在 "Flow" 或 "Agent" 模式下使用 Cascade。
- 检查网络：技能从 GitHub 获取，确保网络畅通。
- 重启 Windsurf：有时重启可以解决问题。
性能问题
如果技能拖慢了你的工作流：
# 清除技能缓存
npx agent-skills clear-cache
# 列出已安装的技能
npx agent-skills list
# 移除不用的技能
npx agent-skills remove <skill-name>