Agent 技能共享上游边界¶

状态：已提议进行正式工程与法务评审。

日期：2026-08-11。

背景¶

Orca 需要私有的、持久的、跨机器的技能共享，并具备受限归档摄取、主机拥有的目标解析、崩溃安全事务、溯源以及混合版本远程支持。vercel-labs/skills 暴露了一个 CLI，但没有提供 Orca 所需的 Cloud 授权或本地事务契约。

行为评估使用了上游提交 c6f69c631292444cc541ac6d91e2226b0ff247da。

决策¶

Orca 独立实现其包、Cloud、安装、提供方放置和恢复行为。上游项目仅作为行为参考。

不要复制或机械翻译上游源代码、测试、测试夹具、注册表条目、提供方路径表、注释或文档。应从官方提供方文档派生提供方路径，并通过真实安装进行验证。Orca 不依赖上游 CLI、npm 包或不受支持的编程 API。

如果未来变更提议纳入上游材料，请在实现或合并前停止，并审查确切材料、许可证、署名、声明以及维护影响。

影响¶

• Orca 负责此范围更窄的安装器的稳定性、安全性、兼容性和维护。
• 没有自动上游同步任务。
• 当从需求和官方提供方契约独立派生时，类似行为是可接受的；文本或结构复制则不可接受。
• 提供方注册表变更需要常规代码评审，以及官方文档和真实主机证据。
• 拉取请求模板要求评审人确认相关变更符合此边界。

评审记录¶

产品在规划期间选择了仅参考方案。在外部推出之前，正式工程与法务评审人仍待指定。