Amp 知识库Busabase x Amp coding agent

Amp 知识库

Amp 可以让一个编码任务跨 Project、Thread、远程 Orb、CLI 和多台设备延续。连续上下文有利于执行,但不等于其他团队或 Agent 可以不看证据就复用的已审核事实。

Thread 结果提议需要审核
Busabase 正在审核 Amp 提出的记录
Amp 保存工作过程,Busabase 决定哪些结果可以成为共享知识。

执行地图

Project、Thread 与 Orb 回答的是三个不同问题。

Amp Project 标识代码库与共享 runtime 设置;Thread 保存一次任务的 prompts、replies、tool calls 和文件变化;Orb 是实际执行工作的隔离远程机器。知识记录可以引用这三层,但不能把任何一层直接当成已接受结论。

Amp 层负责什么持久性边界
ProjectRepository、项目设置、共享执行默认值管理代码库,不管理每条业务事实
ThreadConversation、tools、files、changes、handoff可以分享、归档、导出或删除
Orb远程机器、filesystem、services、runtime proof执行环境,不是 policy authority
Reviewed record已接受结果、证据、owner、freshness只能通过可审核提议变更

Thread 边界

可分享的 Thread 是 provenance,不会自动变成真相。

Amp Thread 记录 prompts、replies、tool calls、files、跨设备 handoff,并能从 commit 回到原始任务。它可以是 private、workspace、group 或 unlisted。保留准确 Thread URL 作为证据,但只提升其他人真正需要的 decision-sized result。

01 · THREAD

Prompt、tools、files、changes

02 · VERIFY

Diff、tests、service checks

03 · PROPOSE

一条有边界的 claim

04 · REVIEW

Owner 接受或拒绝

05 · REUSE

Canonical record 成为上下文

指令与扩展层

运行指导、复用流程、runtime code 与已接受事实必须分层。

Amp 为不同工作加载不同 surface。把它们都塞进一个大文件,会同时制造过期事实和过宽权限。

Surface适合保存不适合保存
AGENTS.mdRepository layout、commands、conventions、review steps客户、发布或 incident 的变化状态
Skill带 scripts 与 references 的聚焦流程自动接受流程最新输出
PluginTools、commands、events、UI、policy hooks静默拥有 canonical records
MCP外部 tools、resources、authenticated calls把 tool response 当成已批准知识
Busabase可审核 records、Docs、files、Skills、Apps替代 repository-local code review

扩展边界

Skills 延迟加载流程,Plugins 执行代码,MCP 连接外部系统。

Amp 建议把聚焦 MCP server 放进 Skill,让 tools 只在相关流程加载后出现。Plugin 可以注册 tools、commands、events、UI 与 Skills,但会在 active environment 执行代码。Plugin 是 executable software,Skill 是 versioned workflow,MCP response 是仍需解释的证据。

SKILL

Lazy-loaded instructions、scripts、references、optional MCP

PLUGIN

带 tools 与 lifecycle events 的 executable code

MCP

有 scoped tools 与 auth 的 local/remote server

RECORD

这些层都不能自行接受的 reviewed outcome

Orb 边界

远程执行会改变 credentials 与 tools 应该放在哪里。

Orb 是新的远程环境,可以在笔记本关闭后继续工作。机器上的本地 Amp 设置不会自动出现。Project-safe config 放进 repository,browser OAuth 使用 remote MCP definitions,secret 放在指定 secret store,不写进 committed config。

LOCAL CLI

可使用本机 Amp config 与 browser OAuth

ORB

使用 repository config、Orb secrets 或 remote MCP definitions

THREAD

跨 clients 保存 conversation 与执行引用

RECORD

只跨任务和团队保存已审核 claim

证据包

保留足够 Amp 运行证据,让结论以后仍可被质疑。

精简 evidence bundle 应标明 Project、Thread、执行位置、repository revision、instructions 与 extensions、关键 tool calls 和 verification,不需要复制整段对话。

project_refAmp Project 与 repository URL
thread_ref稳定 Thread URL 或 ID
executorOrb、runner 或 local CLI
instruction_refsAGENTS.md 与相关 Skill revisions
tool_trace关键 Plugin 或 MCP calls
repository_refBase branch、commit、diff、shipped revision
verificationTests、portals、screenshots 或 external readback
Busabase 正在保存 Amp Thread 的证据

知识契约

提升一条即使 Thread 不再方便访问也能独立理解的结果。

记录必须说明发生了什么、证据是什么、谁接受,以及什么时候会过期。后续 Agent 不需要继承无关 prompts 或宽泛 Orb 权限。

knowledge_key可复用 claim 的稳定身份
proposed_stateAmp 产出的精简结果
source_refsThread、code、Docs、外部证据
scope受影响 projects、services 或 teams
owner负责接受的人
decision接受、有条件、拒绝或已替代
verified_at最近证据检查
next_review_at下一次时效检查

不要提升

绝大多数 Thread 内容应该留在执行历史中。

只有会影响当前任务之外决策的内容才值得进入审核。

留在 THREAD

探索路径、失败命令、临时备注、中间假设

留在 GIT

源码、配置、测试、repository-local instructions

提交审核

架构决定、已验证 runbook、发布事实、incident 结论

拒绝或过期

没有证据、owner、scope 或 freshness 的 claim

实际问题

Amp 知识库常见问题

Busabase 会取代 Amp Threads 吗?

不会。Threads 保存任务历史与协作;Busabase 保存少量已审核结果。

每个 Amp Thread 都要建记录吗?

不用。只有结果会指导 Thread 之外的后续工作时才提议。

Unlisted Thread 能成为唯一来源吗?

可作 provenance,但还要保留不受 visibility 变化影响的 code、test 或外部证据。

Amp Skill 会强制审核吗?

Skill 指导执行;权限与 Change Request 才决定记录是否 canonical。

Orb 会自动使用本地 MCP 设置吗?

不会。当前 Amp 文档明确区分 local config 与适用于 Orb 的 repository/remote definitions。

从一个 Thread 开始

把一个已验证的 Amp 结果转成团队可审核知识。

选择完成的任务,附上 Thread 与 repository evidence,让责任人只审核一条有边界的提议。