Windsurf 1.13.6 重磅更新 - 支持 Claude Skills

在 2026 年1月12日，Windsurf 再次通过 1.13.6 版本 证明了它是目前最懂开发者的 AI 编辑器。本次更新引入了核心功能 —— Skills（技能）。

简单来说，如果之前的 AI 只是一个“听懂指令的实习生”，那么拥有 Skills 后的 Cascade（Windsurf 的 AI 核心）就进化成了带工具箱的高级工程师。

它不再只是根据你的 Prompt 瞎猜，而是能读取你预设的文档、脚本和模版，严格按流程办事。

为什么你需要 Skills？

你是否遇到过这些痛点？

• 重复劳动：每次让 AI 写爬虫，都要强调“记得加 User-Agent，记得用 Headless 模式”。
• 规范遗漏：每次让 AI 写 Java 代码，它总是不记得用 Lombok 或者特定的注解。
• 上下文丢失：Prompt 越来越长，但 AI 还是会漏掉关键步骤。

Skills 就是为了解决这个问题而生的。 它是 Prompt 的“持久化”和“结构化”版本，让你的工程标准成为 AI 的本能。

一、快速上手（基础篇）

目标：创建一个“代码审查 (Code Review)”技能

场景：AI 写的代码有时不符合团队规范（例如缺少注释、变量命名随意）。我们要创建一个技能，让 AI 在 Review 代码时自动加载我们的检查清单。

步骤 1：创建技能目录

WindSurf和 Claude Code Skills 的目录基本一致，只是根目录从.claude换成了.windsurf，请在您的项目根目录下，创建以下文件夹结构：

.windsurf/
  skills/
    code-review/          <-- 技能名称

WindSurf Skills目录结构示例：

步骤 2：编写核心描述文件 (SKILL.md)

在 code-review 文件夹中创建 SKILL.md。这是技能的“大脑”，定义了它的触发条件和执行逻辑。

---
name: code-review
description: 用于对代码进行审查、重构和优化。当用户要求检查代码、优化代码或进行 Code Review 时调用此技能。
---

# 代码审查专家

你现在是团队的高级技术负责人。请根据以下检查清单对代码进行审查：

## 1. 基础规范
- [ ] 变量命名是否遵循驼峰命名法 (Java/TS) 或下划线命名法 (Python)？
- [ ] 是否存在硬编码的 Magic Numbers 或字符串？
- [ ] 关键逻辑是否有注释说明？

## 2. 安全性检查
- [ ] SQL 注入风险（必须使用参数化查询）
- [ ] 敏感信息（API Key、密码）是否已脱敏？

## 3. 性能优化
- [ ] 循环中是否存在不必要的数据库查询？
- [ ] 集合操作是否高效？

请以列表形式输出审查结果，并给出修改后的代码建议。

步骤 3：测试调用

1. 打开 Windsurf Cascade 对话框。
2. 输入：@code-review 帮我看看这段 Python 代码有什么问题（或者直接说 帮我 Review 一下当前打开的文件，Cascade 会根据 description 自动识别）。
3. 效果：AI 会严格按照你 SKILL.md 中的三个维度（规范、安全、性能）进行输出，而不是泛泛而谈。

WindSurf Skills 触发 Skills 示例：

二、进阶实战（带模版的生成器）

目标：创建一个“Spring Boot 模块生成器”技能

场景：开发 Java Spring Boot 应用时，重复写 Controller/Service/Repository 结构非常枯燥，且容易出错。

步骤 1：准备模板文件

在 .windsurf/skills/spring-feature-gen/ 目录下，放置两个文件：

1. ControllerTemplate.java (辅助资源)

package com.example.demo.controller;

import org.springframework.web.bind.annotation.*;
import lombok.RequiredArgsConstructor;

// 强制要求：所有 Controller 必须使用 RestController
// 强制要求：必须使用构造器注入
@RestController
@RequestMapping("/api/v1/${resource}")
@RequiredArgsConstructor
public class ${Resource}Controller {
    private final ${Resource}Service service;
    
    @GetMapping("/{id}")
    public ${Resource}Dto getById(@PathVariable Long id) {
        return service.findById(id);
    }
}

2. SKILL.md (核心指令)

---
name: spring-feature-gen
description: 为 Java Spring Boot 项目生成标准的 Controller-Service-Repository 分层代码结构。
---

# Spring Boot 功能模块生成器

当用户要求生成一个新的业务模块（Feature）时，请严格遵循以下架构：

## 技术栈要求
1. **框架**: Spring Boot 3.x
2. **构建**: Maven/Gradle
3. **原生支持**: 考虑到后续可能编译为 GraalVM Native Image，避免使用复杂的动态反射。

## 生成步骤
1. 读取当前目录下的 `ControllerTemplate.java` 作为风格参考。
2. 生成 DTO (Record 类型), Service 接口与实现类, Repository (JPA)。
3. 确保所有依赖注入使用 `@RequiredArgsConstructor` (Lombok)。

## 输出格式
请直接生成代码文件内容，不要过多解释。

步骤 2：实战调用

在 Cascade 中输入：

"帮我生成一个用户管理模块（User Management），包含增删改查功能。"

结果：AI 会自动读取技能并参考你的 Java 模板，生成一套符合你团队习惯的代码。

三、实战玩法（用 Skill Creator 创建 AI Skills）

手动编写 SKILL.md 还是觉得麻烦？Windsurf 的 Skills 机制与 Claude 官方的 ecosystem 是兼容的。我们可以利用官方的 Skill Creator 来让 AI 帮我们写 Skills，除此之外，您也可以参考Anthropic Claude Code Skills 深度解析。

1. 引入官方 Skill Creator

Claude Code Skill Creator是 Anthropic 官方提供的一个“元技能”，专门用来生成其他技能。

1. 创建目录：.windsurf/skills/skill-creator/
2. 下载文件：将官方仓库中的 SKILL.md 内容复制进去。
   • 源码地址：Claude Skill Creator Template

2. 如何使用

安装好这个技能后，你就可以套娃操作了：

用户：@skill-creator 我想要一个专门写 Python 单元测试的技能，要求使用 pytest，并且覆盖率要达到 90% 以上。

Cascade：(自动调用 skill-creator) 好的，我为您生成了 python-tester 的技能结构，包含 SKILL.md 和推荐的测试规范...

3. 更多官方灵感

Anthropic 官方维护了一个 Skills 仓库，里面包含了很多开箱即用的简单教程和案例（如数据分析、文档编写等），建议收藏并在 Windsurf 中尝试：

• 官方仓库：https://github.com/anthropics/skills

核心技巧总结

1. Description 是关键： Cascade 依靠 frontmatter 中的 description 字段来决定是否自动调用技能。写得越具体，AI 自动触发越精准。
   • ❌ description: 代码工具
   • ✅ description: 当用户询问有关 Playwright 爬虫编写、浏览器自动化脚本时使用此技能。
2. 全局 vs 项目级：
   • 全局习惯（如“总是用 Python Type Hint”）：放在 ~/.codeium/windsurf/skills/。
   • 项目规范（如“本项目使用 MyBatis”）：放在 .windsurf/skills/。
3. Skills vs Rules：
   • 使用 Rules (.windsurf/rules) 设定你的基本身份（“我是谁”）。
   • 使用 Skills 处理具体任务（“怎么做”）。

现在，打开你的 Windsurf，试着创建你的第一个 Skill，把重复的工作流“外包”给 AI 吧！