拆解 Warp AI Agent（五）：跨生态联邦——10 种 Skill + MCP + 多 Harness 互操作设计

系列终篇。前四篇讲了类型安全、风险调度、对话状态机、增量索引——都是 Warp 自身的架构。本篇看 Warp 如何与外部世界互联10 种 Skill Provider、MCP 协议、多 Harness Bridge构成一个AI Agent 联邦。一、问题为什么 AI Agent 需要互操作2025-2026 年的 AI Agent 生态是碎片化的Claude Code → .claude/skills/ → Claude API Cursor → .cursor/skills/ → 自研 API Codex → .codex/skills/ → OpenAI API Gemini → .gemini/skills/ → Google API Copilot → .copilot/skills/ → GitHub API Warp → .warp/skills/ → Warp API每个工具有自己的 Skill 目录、自己的 Agent 引擎、自己的工具链。用户的问题是我在 Claude Code 里写的 Skill能在 Warp 里用吗Warp 的答案是能而且优先级可配置。二、10 种 Skill Provider优先级联邦2.1 Provider 定义// crates/ai/src/skills/skill_provider.rspubenumSkillProvider{Warp,Agents,Claude,Codex,Cursor,Gemini,Copilot,Droid,Github,OpenCode,}2.2 优先级排序pubstaticSKILL_PROVIDER_DEFINITIONS:LazyLockVecSkillProviderDefinitionLazyLock::new(||{vec![// 优先级从高到低SkillProviderDefinition{provider:SkillProvider::Agents,skills_path:PathBuf::from(.agents/skills)},SkillProviderDefinition{provider:SkillProvider::Warp,skills_path:PathBuf::from(.warp/skills)},SkillProviderDefinition{provider:SkillProvider::Claude,skills_path:PathBuf::from(.claude/skills)},SkillProviderDefinition{provider:SkillProvider::Codex,skills_path:PathBuf::from(.codex/skills)},SkillProviderDefinition{provider:SkillProvider::Cursor,skills_path:PathBuf::from(.cursor/skills)},SkillProviderDefinition{provider:SkillProvider::Gemini,skills_path:PathBuf::from(.gemini/skills)},SkillProviderDefinition{provider:SkillProvider::Copilot,skills_path:PathBuf::from(.copilot/skills)},SkillProviderDefinition{provider:SkillProvider::Droid,skills_path:PathBuf::from(.factory/skills)},SkillProviderDefinition{provider:SkillProvider::Github,skills_path:PathBuf::from(.github/skills)},SkillProviderDefinition{provider:SkillProvider::OpenCode,skills_path:PathBuf::from(.opencode/skills)},]});优先级规则同名 Skill排在前的 Provider 优先。也就是说.agents/skills/的 Skill 优先级最高项目级、通用标准.warp/skills/其次Warp 特定.claude/skills/再次Claude 兼容…依次类推2.3 自动识别pubfnget_provider_for_path(path:Path)-OptionSkillProvider{letpath_components:Vec_path.components().collect();fordefinSKILL_PROVIDER_DEFINITIONS.iter(){// 检查路径中是否包含该 Provider 的目录letskill_components:Vec_def.skills_path.components().collect();forwindowinpath_components.windows(skill_components.len()){ifwindowskill_components.as_slice(){returnSome(def.provider);}}}None}效果把一个.claude/skills/my-skill/SKILL.md文件丢给 WarpWarp 自动识别它来自 Claude加载时打上SkillProvider::Claude标签。2.4 Scope 区分pubenumSkillScope{/// 用户主目录下的 Skill (e.g. ~/.agents/skills)Home,/// 项目目录下的 Skill (e.g. ./repo/.agents/skills)Project,/// Warp 内置 SkillBundled,}三重作用域Home全局 Project项目 Bundled内置。项目级 Skill 覆盖全局 Skill类似于.gitignore的层叠规则。三、项目上下文双文件规则WARP.md AGENTS.md3.1 为什么是两个文件// crates/ai/src/project_context/model.rsconstRULES_FILE_PATTERN:[str;2][WARP.md,AGENTS.md];WARP.md— Warp 特定的规则终端操作偏好、Agent 行为配置AGENTS.md— 通用 Agent 规则跨工具兼容Claude Code / Codex / Cursor 都能读类似于.github/和.agents/的关系一个是平台特定的一个是跨平台通用的。3.2 层叠累积/ → WARP.md (全局规则) /project/ → WARP.md AGENTS.md (项目规则) /project/src/ → WARP.md AGENTS.md (src 子目录规则) /project/src/components/ → WARP.md (组件特定规则)structRuleAtPath{parent_path:PathBuf,warp_md:OptionProjectRule,// WARP.mdagents_md:OptionProjectRule,// AGENTS.md}fnfind_active_or_applicable_rules(self,path:Path)-FindRulesResult{letmutactive_rulesVec::new();letmutavailable_rule_pathsVec::new();forruleinself.rules{ifletSome(respected_rule)rule.respected_rule(){// 目标路径在该规则的父目录下 → 活跃规则ifpath.starts_with(rule.parent_path){active_rules.push(respected_rule.clone());}else{// 否则 → 可用但未激活available_rule_paths.push(respected_rule.path.to_string_lossy().to_string());}}}// ...}关键区分Active Rules— 当前文件路径的祖先目录中的规则自动注入 Agent 上下文Available Rules— 其他目录的规则只有相关时才加载如编辑该目录下的文件时这解决了规则太多撑爆 Token 窗口的问题——只加载与当前工作相关的规则。四、MCP 协议4 种 Provider// app/src/ai/mcp/mod.rspubenumMCPProvider{Warp,// Warp 自有配置Claude,// Claude Desktop 兼容Codex,// Codex 兼容Agents,// 通用 Agents 兼容}4.1 多格式配置解析Warp 能读取多种 MCP 配置格式来源配置文件路径格式Warp 自有~/.warp/mcp_config.jsonWarp 格式Claude Desktop~/.claude/claude_desktop_config.jsonClaude 格式VS Code.vscode/mcp.jsonVS Code 格式项目级.mcp.json标准 MCP 格式4.2 Transport 类型pubenumTransportType{/// 标准输入输出 (CLI Server)CLIServer,/// Server-Sent EventsServerSentEvents,}4.3 模板变量MCP Server 配置支持模板变量比如环境变量注入{mcpServers:{my-server:{command:my-mcp-server,env:{API_KEY:{{API_KEY}}}}}Warp 会自动提取{{API_KEY}}模板变量在启动 MCP Server 时从用户的 Secret 管理器中注入。五、Multi-Harness BridgeAgent SDK 的联邦枢纽5.1 三层 Harness 架构┌──────────────────────────────────────────┐ │ CLI 层: Harness enum │ │ Oz / Claude / Gemini / OpenCode │ ├──────────────────────────────────────────┤ │ 对话层: AIAgentHarness enum │ │ Oz / ClaudeCode / Gemini / Unknown │ ├──────────────────────────────────────────┤ │ 驱动层: HarnessKind enum │ │ Oz / ThirdParty(dyn HarnessRunner) │ │ / Unsupported │ └──────────────────────────────────────────┘5.2 ThirdPartyHarness trait// app/src/ai/agent_sdk/driver/harness/mod.rs#[cfg_attr(not(target_family wasm), async_trait)]pubtraitThirdPartyHarness:SendSync{fnharness(self)-Harness;fncli_agent(self)-CLIAgent;fninstall_url(self)-staticstr;/// 校验 Harness 是否就绪默认检查 CLI 是否在 PATH 上asyncfnvalidate(self)-Result(),AgentDriverError;/// 准备 CLI 特定的配置文件fnprepare_environment_config(self,...)-Result();/// 获取恢复对话所需的 payloadasyncfnfetch_resume_payload(self,...)-ResultOptionResumePayload;/// 构建运行器asyncfnbuild_runner(self,...)-ResultBoxdynHarnessRunner;}5.3 HarnessRunner traitpub(crate)traitHarnessRunner:SendSync{/// 启动 Harness在终端中执行 CLI 命令asyncfnstart(self,foreground:ModelSpawnerAgentDriver)-ResultCommandHandle;/// 保存对话状态asyncfnsave_conversation(self,save_point:SavePoint,...)-Result();/// 优雅退出asyncfnexit(self,foreground:ModelSpawnerAgentDriver)-Result();/// 清理后台状态asyncfncleanup(self,foreground:ModelSpawnerAgentDriver)-Result();}5.4 Bridge 路由fnharness_kind(harness:Harness)-ResultHarnessKind,AgentDriverError{matchharness{Harness::OzOk(HarnessKind::Oz),Harness::ClaudeOk(HarnessKind::ThirdParty(Box::new(ClaudeHarness))),Harness::GeminiOk(HarnessKind::ThirdParty(Box::new(GeminiHarness))),Harness::OpenCodeOk(HarnessKind::Unsupported(Harness::OpenCode)),Harness::UnknownErr(AgentDriverError::InvalidRuntimeState),}}关键设计HarnessKind::ThirdParty(Boxdyn ThirdPartyHarness)— 用 trait object 实现运行时多态。新增一个 Harness 只需要实现ThirdPartyHarnesstrait不需要修改路由代码。5.5 对话恢复pubenumResumeOptions{Oz(BoxConversationRestorationInNewPaneType),ThirdParty(BoxResumePayload),}Oz Harness 恢复对话时直接还原完整对话转录到终端 pane第三方 Harness 则使用 harness-specific payload如 Claude 的 session ID。六、Cloud MCP 同步跨设备配置共享设备 A 添加 MCP Server → Warp Drive 同步队列 → 云端存储 → 设备 B 下行同步 → 自动加载新 MCP ServerMCP 配置可以通过 Warp Drive 云同步实现跨设备共享。这是 Warp 作为云原生终端的独特优势。七、与业界方案对比维度WarpClaude CodeCursorGitHub CopilotSkill 跨工具兼容10 Provider仅 Claude仅 Cursor无项目规则WARP.md AGENTS.mdCLAUDE.md.cursorrules无MCP 支持4 Provider 配置源仅 Claude部分无外部 AgentClaude/Gemini/OpenCode CLI无无无配置云同步Warp Drive无无无Warp 是唯一同时支持跨工具 Skill 兼容 外部 Agent CLI 委托 MCP 多源配置的终端 Agent。八、可复用模式Cross-Ecosystem Federation┌─────────────────────────────────────────┐ │ Cross-Ecosystem Federation │ ├─────────────────────────────────────────┤ │ 1. 优先级联邦 │ │ - 多 Provider 按优先级排序 │ │ - 同名 Skill 取最高优先级 │ │ - 自动识别 Provider 来源 │ │ │ │ 2. 双文件规则 │ │ - 平台特定: WARP.md │ │ - 跨平台通用: AGENTS.md │ │ - 层叠累积 按需加载 │ │ │ │ 3. MCP 多源 │ │ - 多格式配置解析 │ │ - 模板变量自动注入 │ │ - 云端配置同步 │ │ │ │ 4. Harness Bridge │ │ - trait object 运行时多态 │ │ - 新增 Harness 零修改路由代码 │ │ - 对话恢复按 Harness 类型分派 │ └─────────────────────────────────────────┘九、系列总结七个架构模式#模式核心价值通用度1Type-Driven Tool Protocol编译期工具类型安全★★★ (需要 ADT 语言)2Exhaustive Cancellation新增 Action 不遗漏取消处理★★★3Risk-Graded Execution只读并行 危险串行★★★★4Conversation State Machine五态模型管理对话生命周期★★★★5LRC Dual-ModeAgent↔用户交替控制长时命令★★ (终端特有)6Merkle Tree IndexO(changes) 增量索引★★★★★7Cross-Ecosystem Federation10 Provider MCP Harness 互操作★★★★通用度最高的三个可直接落地到任何 Agent 项目Risk-Graded Execution— 任何 Agent 都需要区分安全和危险操作Merkle Tree Index— 任何需要索引代码库的 Agent 都能受益Cross-Ecosystem Federation— 越来越多 Agent 工具需要互操作Warp 最独特的设计LRC Dual-Mode长时命令双模控制——这是终端 Agent 独有的需求IDE Agent 不需要。十、给 Agent 构建者的建议工具协议优先用类型系统不管什么语言只要能穷举就用穷举只读操作一定要并行这是最简单的性能提升对话状态设计成状态机而不是 if-else 堆砌代码索引用 Merkle Tree比轮询快一个数量级Skill/规则要跨工具兼容AGENTS.md 比 CLAUDE.md 更通用配置要能云同步跨设备体验是刚需一句话总结Warp 的 AI Agent 是一个联邦——10 种 Skill Provider 联盟、4 种 MCP 配置源聚合、3 种 Harness 引擎桥接所有外部工具都在同一个优先级体系下运行。系列导航一类型即协议二风险分级执行三对话状态机四Merkle Tree 增量索引五跨生态联邦 ← 你在这里