---
title: "Windsurf Integration"
type: source
tags: []
date: 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 复制到项目根目录而非全局
  - 对方观点：无冲突，两者一致