六个核心对象
| 对象 | 它负责什么 | 举例 |
|---|---|---|
| Repository | Git 内容来源与同步配置 | 团队 skills 仓库 |
| Skill Version | 某个 Skill 的不可变内容版本 | sql-query 的新查询规范 |
| Release Snapshot | 一组 Skill 版本构成的完整视图 | A 新版 + B 原版 + C 原版 |
| Channel | 指向某个快照的可变发布入口 | canary、stable |
| Agent Profile | 选择渠道、允许的 Skills、模式与离线策略 | 研发测试助手 |
| Mount Client | 一个终端的独立身份与凭据 | 构建机上的某个 Agent |
为什么需要快照
一个 Agent 可能同时使用多个 Skills。快照把版本组合固定下来，便于复现和整体回滚。相同集合可以去重；创建后不能直接编辑快照内容。
更新时创建新快照，再改变渠道指向。旧快照保留，不依赖 Git 远端继续在线才能读取。
Profile 决定可见范围
渠道提供版本集合，Profile 从中授权具体的 Skills，客户端只能读取授权文件。Profile 选中的 Skill 如果没有包含在渠道快照中，不会凭空出现。
建议先建立两个 Profile：测试助手跟随 canary，生产助手跟随 stable。它们可以选择不同的 Skill 集合。
dynamic 与 pinned
| 模式 | 更新行为 | 适用场景 |
|---|---|---|
| dynamic | 渠道更新后刷新索引，新打开的文件使用新版本 | 持续运行的交互助手 |
| pinned | 保持绑定快照，显式 repin 才重新绑定 | 需要任务期间版本稳定的作业 |
旧的打开句柄保留旧内容。dynamic 不保证一个长任务的多次文件打开都来自同一快照；这类任务应使用 pinned。
渠道 generation
每次成功推进或回滚渠道，generation 都会递增。平台用它避免两个管理员的发布相互覆盖。遇到并发冲突时刷新页面，重新审阅当前差异后再操作。