Sync: add integration and agent file notes

wiki/sources/windsurf-integration.md

@@ -0,0 +1,45 @@
+---
+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 复制到项目根目录而非全局
+  - 对方观点：无冲突，两者一致