核心概念

PowerContext 使用一组领域值组织项目证据和可复用上下文。Source 保留发生过的事实，带 Revision 的 Artifact 保留经过 选择的结果，PreparedContext 为一次 Agent turn 提供有界视图。每个值都属于某个 scope。

Scope 是隔离边界

每个内容操作都使用 scope_id。Scope 选择相互隔离的 Source journal、Memory 生命周期、Candidate inbox、Handoff history 和相关 runtime state。Scope ID 是 Server 生成的不透明标识。Integration 解析显式 Scope、持久 binding 或 Server 默认 Scope；代码库、路径、session 和 Agent identity 只是 binding 输入，不是 Scope ID。

Scope ID 只选择数据，不证明用户身份，不授予工具访问权，也不提供执行授权。

Source 保存证据

Source 描述 PowerContext 可以读取的证据。Captured Source 把内容保存在 PowerContext 中；referenced Source 指向其他 adapter 管理的材料。SourceRef 通过类型和 ID 标识一个 Source。

捕获 Source 不会自动创建 Memory、Experience 或 Skill。配置好的 pipeline 可以稍后处理符合条件的 Source。Work Contract 和 Task Outcome 也会作为精确 Source 证据保存。

Artifact 使用不可变 Revision

Artifact 是可复用输出的一个不可变 Revision。精确引用包含 family、Artifact ID 和 Revision：

FAMILY/ARTIFACT_ID@REVISION

Artifact ID 保持稳定，approved replacement 会创建后续 Revision。Lineage 记录生成每个 Revision 时使用的精确 Source 和 Artifact 引用。即使 family head 已经前进，读取精确引用仍会返回对应的历史快照。

当前 Artifact family

当前 Runtime 支持七类 family：atomic-memory、experience、skill、handoff、profile、prompt 和 topic-memory。它们共享不可变 Revision 和精确引用，但可用操作不同：Atomic Memory 保存独立事实与决定； Experience 和 Skill 的生成提案经过 Candidate 审核；Handoff 记录工作连续性；Profile 保存 Scope 背景； Prompt 配置操作；Topic Memory 整理主题。直接 Artifact 写入遵循各家族的校验和权限，不会自动创建 Candidate。

Topic Memory 除 Source 后台处理和专用的 flush、search、get 操作外，也支持通用创建与替换。Source 是证据而不是 Artifact； Tag 可以整理七类当前已保存制品，不改变内容 Revision，也不是独立 Artifact family。

部分 API schema 为兼容保留旧 memory 标识，但它不是当前可写家族，也不能据此推断通用旧集合读取仍受支持。 已有数据和旧引用的处理见Atomic Memory 迁移。

按预期结果选择工作流

这些值具有不同的生命周期。应先从想要得到的结果开始，而不是把每一条已采集的 Source 都当成创建长期上下文的指令。

采集 Source 只提供证据；它本身不会创建 Memory、Experience、Skill、Handoff 或 Profile。Tag 可以帮助组织受支持的 Artifact，但不会改变 Artifact 的生命周期，也不会授予执行权限。

Memory 保存长期项目知识

每条 Atomic Memory 都是独立的带 Revision 制品，保存一条可复用的决定、约束、事实、状态或下一步。 当前状态为 active、forgotten、merged 或 retired；普通召回只选择 active 记录。 公开 lifecycle 操作使用精确 Artifact 引用及当前 state_version，接受 forgotten，让记录退出 active recall，但不删除历史。 合并与恢复使用独立操作；四种可读状态并不意味着可以任意设置四种 lifecycle 值。 正文修订、状态变更和精确历史读取见Atomic Memory。

显式写入 Memory 不需要模型。根据 Source 自动提取则需要配置 generation pipeline。Memory 可以长期保存和检索，不同于 只供一次 Agent turn 使用的临时上下文。长期知识与任务转交的边界见理解 Memory 和 Handoff。

Candidate 将 proposal 与 approved Artifact 分开

Experience 和 managed Skill proposal 会作为 pending Candidate 进入 scope-local Review Inbox。Candidate 包含一个当前 proposal version 和对应的精确证据。Review 写操作使用 expected_version，防止 proposal 被其他写入者修改后，决定仍 静默作用于旧内容。

批准会写入不可变 Artifact Revision，并返回精确的 result_artifact。拒绝只记录 decision reason，不创建 Artifact。 两种决定都是终态。操作步骤见审核 Candidate。

Experience 和 Skill 的可用方式不同

Experience 记录 situation、action、observed outcome 和 reusable lesson。Approved current head 可以参与同 scope 的 PreparedContext 召回。Pending、rejected 和历史 Experience Revision 都不会进入召回。

Managed Skill 包含名称、用于发现的描述、instructions、validation checks 和 lineage。批准不会安装或执行 Skill。必须 显式导出一个精确的 approved Revision，Agent host 才能发现对应的 host-local projection。完整审核和可用性模型见 Experience 与 Skill 生命周期。

PreparedContext 是临时值

PreparedContext 是一次 Agent turn 使用的最终有界值。Runtime 根据请求 query 选择 active Memory、approved Experience head，以及在 assembly 中显式请求的 committed Profile 或 Topic Memory，应用共享字节预算，并返回 ready content 或 empty。该结果不是新的长期记录。

召回内容属于历史信息，不是指令权威。接收它的 Agent 仍需遵循当前用户和系统指令，检查实时工作区状态，并核对自身实际 能力。

Work continuity 记录任务边界

高阶工作闭环使用四种长期或可转交的值：

Work Contract → Prepared Handoff → Acknowledgement → Task Outcome

Work Contract 将目标和完成边界保存为 Source 证据。handoff_current_work 捕获经过检查的边界，并返回临时 Prepared Handoff。只有用户需要保留里程碑时，commit Handoff 才创建长期 Revision。接收方解析 Handoff 并记录 Acknowledgement；Task Outcome 将最终状态和检查结果保存为 Source 证据。

Handoff Report 将每个选中 Scope 的最新 Handoff Revision 投影为可检查、可导出的 视图。它是只读操作，不会改写 Memory 或底层 Handoff history。

各接口暴露同一个 Server 的不同部分

HTTP 是完整的远程应用契约，Python Client 提供类型化访问，MCP 是面向 Agent 的精选投影，CLI 负责安装、诊断、Server 操作和人工审核任务。Core protocol 供需要自行组合 Source、Artifact 和 Trigger 实现的应用使用。

模型生成、Review 和执行权限彼此独立。模型可以提出内容，Review 可以批准 Artifact Revision，导出可以创建 host-local 副本；这些步骤都不会授予 Agent 执行 instructions 的权限。

当前接口可用范围见接口，精确设置和默认值见配置。RFC 记录 设计决策，可能与当前实现不同。