维护团队可消费的 Context 全集
理解 Context Asset 的来源、沉淀状态、受众权限与开工同步。
Context Asset 是什么
Context Asset 是 Product 中可寻址、可讨论、可授权的长期知识单元。它可以是平台正文、Git 文件指针或外部链接,但都会带着来源、版本、标签、负责人和受众信息。
| 来源 | 适合内容 | 版本语义 |
|---|---|---|
| Platform | 团队在 Tandem 内持续维护的规范、决策与说明 | 正文版本 v1、v2… |
| Git | 本就以仓库文件为事实源的文档 | 固定 commit SHA |
| Link | 外部系统中的权威页面 | 保留原始 URL |
待沉淀与已沉淀
新内容默认进入待沉淀,允许团队大胆上传候选知识而不立即污染 Agent 的工作集。确认可靠后再沉淀;撤回沉淀会让它退出默认读取与下一次 Bundle 同步。
受众与权限
- Product:拥有 Product 读取权限的成员可读。
- Restricted:仅明确授权的 Team、成员或 Agent,以及安全管理员可读。
- Team 与成员授权取并集;成员退出 Team 后,Team 授权即时失效,直接授权不受影响。
开工时同步 Context Bundle
在仓库根目录同步后,Tandem 会把当前身份可读、已沉淀、未归档的 Asset 原子物化到 .tandem/context。重复同步是增量且幂等的;撤权内容会从受管目录移除,不会覆盖用户自己的文件。
$
tandem context bundle sync$
tandem context bundle sync --dry-run