nexus/wiki/sources/windsurf-integration.md

title, type, tags, date

title	type	tags	date
Windsurf Integration	source		2026-04-25

Source File

• Agent/agency-agents/integrations/windsurf/README.md

Summary（用中文描述）

• 核心主题：The Agency Agent 与 Windsurf 编辑器的集成方案
• 问题域：如何在 Windsurf IDE 中使用 The Agency 的 Agent 角色
• 方法/机制：通过 .windsurfrules 文件将 Agent roster 注入 Windsurf，项目级别生效；在 prompt 中按名称引用 Agent 激活使用；install.sh 安装脚本一键部署，convert.sh 重新生成规则文件
• 结论/价值：项目级生效的 IDE 集成方案，与 Cursor Integration（项目级 .mdc）和 Aider Integration（项目级 CONVENTIONS.md）互补，共同构成 The Agency 的多 IDE 覆盖体系

Key Claims（用中文描述）

• .windsurfrules 文件将 The Agency 全部 Agent roster 合并为单一规则文件
• Windsurf 集成是项目级别生效（project-scoped），需在项目根目录安装
• Agent 通过在 prompt 中按名称引用激活（如 "Use the Frontend Developer agent..."）
• 规则文件可通过 convert.sh 重新生成

Key Quotes

"The full Agency roster is consolidated into a single .windsurfrules file." — 单一规则文件聚合全部 Agent roster "Rules are project-scoped — install them from your project root." — 项目级别生效机制 "In Windsurf, reference an agent by name in your prompt" — 按名称引用激活 Agent

Key Concepts

• Agent-Activation-Pattern：通过在 prompt 中按名称引用来激活 Agent（"Use the Frontend Developer agent to build this component."），在 windsurf-integration 和 claude-code-integration 中均有应用
• Project-Scoped-Tools：工具集成生效范围为项目级别（OpenCode/Cursor/Aider/Windsurf/Qwen Code），区别于全局安装的工具（Claude Code/GitHub Copilot）；需在项目根目录安装

Key Entities

• The-Agency：多智能体编码系统组织，本次 Windsurf 集成的 Agent 来源
• Windsurf：Codeium 开发的 AI 代码编辑器，支持通过 .windsurfrules 注入自定义规则

Connections

• integrations-readme ← part_of ← Windsurf Integration（集成生态的一员）
• Cursor Integration ← similar_pattern ← Windsurf Integration（同为项目级 IDE 集成，机制相似）
• Aider Integration ← similar_pattern ← Windsurf Integration（同为项目级 Agent 注入方案）

Contradictions

• 与 integrations-readme 存在潜在冲突：
  • 冲突点：integrations-readme.md 描述 Windsurf 为"项目级别集成"（Project-Scoped），本文档同样确认项目级别
  • 当前观点：项目级别是正确描述——install.sh 复制到项目根目录而非全局
  • 对方观点：无冲突，两者一致