Windsurf 第一天配置包

这个 pack 包含什么

你装完 Codeium Windsurf，第一次打开 Cascade，开始找：相当于 .cursorrules 的文件在哪？哪些 MCP 该第一天就装？有没有人能老实告诉我宣传视频里哪些是真的、哪些是 demo 包装？这个 pack 就是干这个的。

先说实话：Windsurf 专属技能资产目前还很薄。社区 agent 技能生产主要集中在 Claude Code 和 Cursor 周围。好消息：Windsurf 是 VS Code fork，Cascade 读 .windsurfrules 文件 + 开放的 AGENTS.md 约定 —— 所以绝大多数编辑器无关的技能、MCP 服务器、提示词模板可以原封不动用上。下面凡是编辑器无关的，都明确标注。

面向人群：从 VS Code+Copilot / Cursor / Claude Code 切过来的开发者，目标是今天下午就让 Cascade 在真实仓库上产出真实 diff，不是评估 IDE 给团队铺设。

推荐安装顺序

1. Windsurf — AI IDE with Cascade Agentic Flows （IDE 本身） — 先把 Codeium 的 IDE 装好，登录账号，确认免费档真的能用 Claude + GPT-4 跑 Cascade。在一个废弃文件上让 Cascade 做一次多步骤编辑，确认通了再装下面的。这一步坏了，后面九个都没意义。
2. AGENTS.md — Open Format for Coding Agent Instructions （编辑器无关规范） — 写第一条规则之前先把规范读了。AGENTS.md 是跨工具约定（Cursor / Windsurf / Claude Code / Aider / Codex CLI 都读或都互通）。懂了规范，下次换工具就不用从零再写一遍工具专属规则。
3. agentrules — Multi-Provider AGENTS.md Generator （编辑器无关生成器） — 从一份源生成 .windsurfrules + AGENTS.md + .cursorrules + CLAUDE.md。第一次在已有 .cursorrules 的项目里上 Windsurf 时立刻回本。别手动维护四份文件。
4. lnai — Unified AI Config for Claude, Cursor, Copilot & More （编辑器无关配置） — #3 的另一半。agentrules 解决「规则文件」同步，lnai 解决「provider 配置」同步（模型选哪个、API key 放哪、默认参数）。让你不用同时维护四个 ~/.config/ 目录。
5. MCP Reference Servers — Official Collection （编辑器无关 MCP） — Windsurf 支持 MCP。装第三方花哨服务器之前先扫一遍官方参考集（filesystem、fetch、git、memory、sequential-thinking、time 等）。大多数团队 60% 的需求在这里就解决了，不用再去 Smithery 翻。
6. Git MCP — Version Control Server for AI Agents （编辑器无关 MCP） — 专挑 Git MCP。Windsurf 的 Cascade 能读你的仓库，但 MCP server 给它结构化访问 commit 历史、blame、分支状态和 diff，不用解析 shell 输出。写代码场景下杠杆最大的 MCP。
7. Desktop Commander MCP — Local Terminal + Files （编辑器无关 MCP） — 让 Cascade 跑 shell 命令、编辑 workspace 之外的文件。需要「升级 Node 版本」或「查磁盘占用」这种 Cascade 自己做不了的事情时必备。当成给一个有 sudo 权限的初级开发用 —— 有用，但权限收紧。
8. Playwright MCP — Browser Automation Server （编辑器无关 MCP） — Cascade 能驱动浏览器。验证刚改的东西真的能渲染、填表单、截图、抓实时状态。和 Cascade 的多步骤 flow 配合特别好，因为浏览器那一步往往揭示出 code review 漏掉的 bug。
9. Awesome AI System Prompts — 32+ Tool Prompts Revealed （参考资料，含 Cascade 提示词） — 写自己的 .windsurfrules 之前先读一遍 Windsurf 实际泄露出来的 Cascade 系统提示词。知道 agent 对自己已经怎么定位，能避免写出和它基线行为相互矛盾的规则。当成「Cascade 为啥这么做」的操作手册。
10. AI Coding Agents Compared — 2026 Landscape Guide （参考资料） — 最后一个定位精选。Cascade 跑起来之后你会想「这个任务是不是用 Claude Code 或 Cursor 更合适」。这是诚实的全景图。比刷五条 Twitter 长串便宜。

它们怎么协同

Windsurf IDE (#1)
   │
   └─ Cascade 读 .windsurfrules + AGENTS.md
         │
AGENTS.md 规范 (#2) ── agentrules (#3) ── lnai (#4)
   │                       │                  │
   └─ 一份源 ──────────────┴──────────────────┘
         ├─ .windsurfrules (Windsurf)
         ├─ AGENTS.md (跨工具)
         ├─ .cursorrules (Cursor，如果你保留)
         └─ CLAUDE.md (Claude Code，如果你保留)
         │
MCP 层：
   ├─ MCP 官方参考集 (#5)        ← 先扫一遍
   ├─ Git MCP (#6)              ← 日常驱动
   ├─ Desktop Commander (#7)    ← workspace 外的 shell + 文件
   └─ Playwright MCP (#8)       ← 真浏览器验证
         │
参考书架：
   ├─ Awesome AI System Prompts (#9)  ← Cascade 实际怎么想
   └─ AI Coding Agents Compared (#10) ← 什么时候该换工具

agentrules + AGENTS.md + Git MCP 这三件套是承重墙。没装这三个，其他都是装饰。如果装完 Windsurf 之后只有 30 分钟，装 #3 + #2 + #6 就收工。

你会遇到的取舍（Windsurf vs Cursor / Cascade vs Composer）

• Windsurf vs Cursor — Cursor 资产生态更大（更多 .cursorrules 示例、更多 YouTube 内容、更多专门为它做的技能）。Windsurf 有 Cascade，更接近「能自己规划 + 执行多文件编辑的 agent」，Cursor 的 Composer 更接近「针对一次任务提出一个 diff 让你审批的聊天框」。要开车的编程伙伴选 Windsurf；要响应快的助手选 Cursor。#3 和 #4 让你两个同时用，不用维护重复配置。
• Cascade vs Composer — Composer 是交互优先（每一步都让你在 loop 里）。Cascade 是自主优先（自己规划、执行、错误自恢复，最后给你一个总结）。Cascade 在绿地重构上更强。Composer 在生产代码库上更安全，每个变更可审批。别和 Cascade 的自主性较劲 —— 通过 #3 给它一份紧凑的 .windsurfrules，然后放它跑。
• Supercomplete vs Copilot autocomplete — Supercomplete 预测多行编辑，包括删除和重构邻近代码，不只是下一个 token。意图命中率更高，但错的时候更突兀。前一小时建议关掉，先适应 Cascade；规则文件稳定后再打开。
• Windsurf 里用 MCP vs Claude Desktop 里用 MCP — Windsurf 的 MCP 集成比较新，对错误报得很安静。如果某个 server 启动失败，UI 上可能没反馈。新 MCP server 永远先在 Claude Desktop 或 MCP Inspector 里测通，再搬到 Windsurf。

常见踩坑

• 手动分别写 .windsurfrules 和 .cursorrules — 别。第一天就用 #3（agentrules）。即使你觉得自己只用 Windsurf，6 个月内你大概率会去试 Claude Code 或 Cursor，到时候希望生成器早就架好了。
• 一次装 10 个 MCP server — 和 Claude Code 一个坑：MCP 太多 = agent 变慢 + 工具选择变差。第一周就守着 #5–#8。遇到具体缺口再加。
• 忘了 Cascade 有记忆 — Cascade 按项目维度记忆。改了 .windsurfrules 但 Cascade 还按老规矩走 —— 清一下项目记忆，它在缓存旧指令。
• 把泄露的系统提示词当圣经 — #9 非常宝贵，但厂商会悄悄改系统提示词。当成「Cascade 上个月相信什么」，不是「Cascade 现在相信什么」。每季度复核一次。
• 因为已经选了 Windsurf 就跳过全景图（#10） — 你为这个项目选了 Windsurf。半年后另一个任务可能更适合 Claude Code 或 CLI agent。了解全景不是优柔寡断，是避免把每个任务都硬塞进恰好打开的那一个 IDE。