46 lines
2.8 KiB
Markdown
46 lines
2.8 KiB
Markdown
---
|
||
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 复制到项目根目录而非全局
|
||
- 对方观点：无冲突，两者一致
|