Busabase × WarpWarp 知识库
Warp 已经通过 Rules、Workflows、Notebooks、Skills、Prompts、MCP servers 和执行环境为 Agent 提供丰富上下文。Busabase 为最终结果补上一条跨系统记录、证据、负责人和审核决定。
保持 Warp Drive 的清晰职责
Rules、Workflows、Notebooks、Skills 和正式记录是不同运营对象。
Warp Agent 会自动检索相关 Warp Drive 对象，并在 References 或 Derived from 中展示来源。Busabase 不应复制这套对象库，只承接必须跨 session 留存或协调另一个系统的少量状态变化。
带可见来源的上下文
References 解释 Agent 为什么这样做，记录说明组织正式接受了什么。
Warp 把 Drive 对象注入 Agent context 时，conversation 可以标出引用。交接时保留这条 provenance，关联 Rule、Notebook、Workflow、Skill、MCP 记录和 run，不要把它们压扁成无法核实的摘要。
Agent 引用
哪一个 Warp Drive 对象影响了回复？
运行产物
执行了哪条命令、diff、artifact 或外部动作？
证据验证
哪项测试、日志、API 响应或人工观察支持它？
负责人接受
谁决定该状态可以驱动下一条流程？
本地与云端是不同契约
桌面上能使用的 tool，不会自动出现在 cloud run。
Warp 为本地 Agent、第三方 CLI Agent 和 cloud Agent 提供不同 MCP 路径。本地 session 可以使用桌面已授权服务；cloud run 需要可访问 endpoint、Agent Secrets 或托管授权，以及包含所需仓库与工具的执行环境。
| 工作面 | 典型任务 | 必要边界 |
|---|---|---|
| Local Warp Agent | 交互式终端或编辑器工作 | Desktop settings、Warp Drive 或 file-based MCP |
| 第三方 CLI Agent | Warp 中的 Claude Code、Codex、OpenCode 等 harness | Harness 专用或共享文件配置 |
| Cloud Agent run | 后台、定时、集成、CI 或 API 执行 | Run config、共享 MCP UUID、secrets 与云环境 |
| Busabase review | 接受跨 run 状态 | 提议 credential、Base policy 与明确审核者 |
运营交接
把一次成功运行变成另一个系统可以检查的状态变化。
Terminal transcript 或 cloud-run 页面包含执行细节。交接只提取支持、产品、安全、财务或另一个 Agent 所需的状态、证据、负责人和下一步。
从运行到记录的契约
用稳定记录比较不同 terminal、environment 和 Agent 的工作。
记录刻意比 transcript 小。它保留足以重新打开准确 run 的 provenance，也有足够字段让另一条流程筛选、通知或行动。
| 字段 | 用途 |
|---|---|
| work_key | Incident、release、request 或 operation 的稳定身份 |
| run_ref | Warp local/cloud run 与 conversation URL |
| execution_surface | Local Agent、第三方 harness、cloud run 或 schedule |
| environment_ref | 仓库、revision、host、runner 与相关 profile |
| context_refs | Rules、Notebooks、Workflows、Skills、prompts 和 MCP sources |
| evidence | Artifacts、tests、logs、diffs 与外部响应 |
| proposed_state | Agent 对运营结果的简洁解释 |
| decision | 接受、有条件接受、拒绝、阻塞或已替代 |
| owner | 对正式状态负责的人 |
| next_action | 该决定授权的下游工作 |
三个控制面
Agent Profiles、run permissions 与 record review 分别治理不同风险。
Warp Agent Profiles 与团队设置控制 model、autonomy、tools、permissions 和执行行为；MCP 控制外部能力访问；Busabase 审核控制最终字段能否成为共享事实。
EXECUTION PROFILE
该 Agent 在这个环境里可以做什么？
MCP / SECRET BOUNDARY
Run 可以使用哪些外部系统与 credential？
CHANGE REQUEST
哪些拟议状态可以成为正式记录？
连接与可达性
测试准确执行面，不要只测试抽象 MCP 配置。
本地 OAuth 连接可能无法用于无人值守 cloud run，本地 shell 中的 secret 也可能不在选定环境。按照连接页设置，并在生产实际工作面测试 identity、读取范围、提议范围、证据链接与 reviewer 分配。
Warp 团队常问的问题
Warp 知识库常见问题
Busabase 会取代 Warp Drive 吗？
不会。Warp Drive 适合 Agent 使用的 Rules、Workflows、Notebooks、Prompts、Plans、environment variables 与共享 MCP 配置。Busabase 保存已审核跨系统状态和决定历史。
Workflow 应直接写 canonical record 吗？
对需要治理的数据不应该。让 Workflow 或 Agent 先带证据创建提议，再由对应领域负责人审核。
References 或 Derived from 足够作为证据吗？
它们是重要 provenance，但正式接受还可能需要不可变仓库 revision、命令输出、测试、artifact、外部 API 响应或人工观察。
同一 workflow 可以同时在本地与云端运行吗？
通常可以，但契约不同。要分别确认仓库、环境、credential、endpoint 可达性、MCP 授权和 tool 支持。
什么内容应放进 Busabase，而不是 Warp transcript？
保存稳定 work identity、已接受状态、证据引用、负责人、生效时间和下一步；详细推理与执行步骤留在原 run。
从一次交接开始
让 Warp 执行工作，让 Busabase 建立别人可以信任的状态。
选择一项会影响另一个团队的重复 local 或 cloud run，定义 run-to-record 契约，使用只可提议的权限，在自动触发下一步前审核第一次状态变化。