Windsurf 知识库Busabase × Windsurf

Windsurf 知识库

Windsurf 现在横跨两套 Agent runtime。Legacy Cascade 保留 Memories、Workflows 和自己的 MCP 配置,而 Devin Local 已成为新标签页的默认 Agent,并使用另一套配置面。知识进入长期共享前,必须先说明它来自哪套 runtime。

带 runtime 的提议迁移边界清晰
Busabase 正在审核 Windsurf 结果
不记录 runtime 的结论看似可移植,实际可能依赖另一套 memory、tools 与 controls。

两套 Agent runtime

先记录任务来自 legacy Cascade 还是 Devin Local,再讨论 memory。

当前 Windsurf 文档明确说明 Cascade Memories、Workflows 与 Cascade MCP 只属于 legacy runtime;Devin Local 是新标签页默认 Agent,并采用 Devin CLI 配置。Runtime 是必填 provenance,不是脚注。

SurfaceLegacy CascadeDevin Local知识含义
新标签页默认不能假设 Cascade 状态
Auto memories有,限 workspace该系统不持久化只提升核验过的事实
Workflows手动 slash command改用 Skills保留流程身份
MCP configmcp_config.jsonDevin CLI config记录准确 tool surface

迁移

迁移可复用指导,不要整包搬运过期 recollection。

Windsurf 建议用 Rules 或 AGENTS.md 保存持久 instructions,用 Skills 保存复杂 procedures。Cascade 自动 memory 只在本机 workspace 生效且不进 Git。每条内容进入新 runtime 或共享记录前都要重新审核。

01 · INVENTORY

找出依赖的 memories 与 workflows

02 · CLASSIFY

区分 instruction、procedure、changing fact

03 · MIGRATE

进入 Rule、AGENTS.md 或 Skill

04 · VERIFY

在目标 runtime 重新执行

05 · PROMOTE

只提升跨团队结论

Instruction scopes

Global、workspace、directory 与 system rules 对应不同所有权。

Workspace Rules 可以进版本控制,AGENTS.md 按目录生效,global rules 属于个人,enterprise system rules 由管理员管理。变化中的业务事实不属于任何 instruction scope。

GLOBAL

跨 workspace 的个人偏好

WORKSPACE

随仓库共享的团队约定

AGENTS.md

按目录生效的 instructions

SYSTEM

管理员维护的企业基线

Workflows 与 Skills

手动 Workflow 和模型选择的 Skill 都是流程,不是任务成功证据。

Cascade Workflows 只能通过 slash command 调用;Skills 可由模型动态选择并携带支持文件。保留 procedure version,同时记录每次执行产生的 diff、tests、logs 与外部响应。

WORKFLOW

手动调用、仅 Cascade 使用

SKILL

模型选择、可带支持文件

MCP 边界

同一个 server name 在两套 runtime 中可能对应不同授权与控制面。

Cascade MCP 支持 stdio、HTTP、SSE、OAuth、tool toggles、registries 与 enterprise allowlists;Devin Local 读取另一套 CLI 配置。记录 server identity、transport、runtime、enabled tools、认证账号与返回证据。

CONFIGURED

当前 runtime 配置能加载

ALLOWED

团队 policy 允许 server

AUTHORIZED

当前身份可以执行

EXECUTED

返回有边界的证据

REVIEWED

负责人接受结论

执行证据

Windsurf checkpoint 或成功 tool call 是可恢复执行状态,不是组织事实。

关联 runtime、workspace、repository revision、instruction set、Skill/Workflow、tool calls、产物、验证与未解决 warning。恢复机制留在 Windsurf,只发布其他系统真正需要的结论。

runtimecascade 或 devin-local
workspace_refWorkspace 与 repository
instruction_refsRules、AGENTS.md、system policy
procedure_refWorkflow 或 Skill revision
tool_evidenceMCP calls、logs 与 responses
verificationDiff、tests、hooks、reviewer notes
Busabase 记录正在保存 Windsurf 执行证据

知识契约

原 Windsurf tab 消失后,迁移知识仍应可以被质疑。

一条记录只表达一个可复用结论,并保留它为何能跨越 runtime 边界。

knowledge_keySession 外稳定身份
runtimeCascade 或 Devin Local
source_refsFiles、docs、records、APIs
procedure_refRule、Workflow、Skill 或 AGENTS.md
proposed_state精简跨团队结论
owner对接受负责的人
freshness观察与下次审核日期
decision接受、有条件接受、拒绝、已替代

控制面

Enterprise allowlist 管执行,Change Request 管什么能成为可复用事实。

不能把 MCP registry approval、system Rules 或 Hooks 当成记录审核。前者决定动作能否运行和如何被观察,负责人决定结果能否进入 canonical state。

Control回答的问题
System Rules所有 Agent 必须遵循什么?
MCP registry / allowlist哪些外部 tools 可以加载?
Hooks哪些动作应阻止、记录或验证?
Change Request结果是否进入共享状态?

实际问题

Windsurf 知识库常见问题

Busabase 会取代 Windsurf Rules 吗?

不会。Rules 指导 Agent 行为;Busabase 保存少量有 owner 和 lifecycle 的已审核事实。

Cascade memories 应该直接复制到 Devin Local 吗?

不应该整包复制。先区分 instruction、procedure 与 changing fact,再在目标 runtime 核验。

Devin Local 支持 Workflows 吗?

当前文档把 Workflows 定义为 Cascade 专属,并建议把流程迁移到 Skills。

MCP 授权会让输出自动具有权威吗?

不会。授权只允许 tool call,返回状态仍要证据与审核。

记录应该写哪套 runtime?

写实际执行任务的 runtime,以及它使用的 config 与 tool surface。

从一条 runtime 边界开始

只提升 Cascade 或 Devin Local 关闭后仍成立的事实。

选一项已完成的 Windsurf 任务,标明 runtime 与证据,剥离本地 recollection,再把一条可复用结论送审。