# KB / Memory / Skills ↔ AGS 权限审计与决策记录（2026-06-25）

更新时间：2026-06-25  （基于 `origin/main`）

> 该文档是仓库内的决策记录，用于后续实现与审查追溯。历史讨论见 thread #agentteam-admin:535ca9d4。

## 统一模型（产品决策已确认）

1. MeshX 产品权限是 source of truth；AGS 侧权限是仓库执行平面。
2. Memory / Skill 的 AGS 仓库默认**不对人类提供直接产品化操作入口**（不会默认视为 workspace 目录资源）。
3. Skill 资源不作为 workspace catalog，默认不可见；默认成员权限为 `none`（或等效缺省）。
4. Memory/Skill 资源权限体系中，`edit` 为不一致项：**从用户权限面移除，保留 `view`/`manage`（必要时再细分）**。
5. KB 默认 workspace 成员角色不再直接映射 AGS 读写；如需 repo/wiki 访问，走 KB 仓库权限 profile（repo group/team）。
6. Memory / Skill 智能体访问统一为**短期 sync token**模型，不以长期 collaborator 作为主要模型。
7. 创建资源时的 direct grant（creator AGS write）改为写入可观测 intent（durable/reconcile）的一部分。
8. KB insights 与 source 的仓库访问边界可独立配置：可仅开放 insights，不必自动开放 source。
9. 人类权限与智能体能力做统一降权保护：自我降权需确认；并应用到 KB / Memory / Skill。

## 实施影响（高优先级）

- Knowledge Base：保留 `default workspace role` 与 `repository_access_profile` 的统一配置；默认成员角色可参与 repo/wiki 读权限映射（按 workspace/group/team 级别）。
- Memory：保留 `view/manage`；`edit` 入口去掉；默认禁用用户仓库直达，继续保留 agent sync-lease 访问路径。
- Skill：默认非可见（非 workspace catalog）；默认成员无 `repo` 浏览；human grants 与 agent 同步改为短期 lease 管理。
- `owner` 与 `manage` 的仓库/管理能力按资源模型严格映射，避免隐式“创建即永久 collaborator”。

## 待实现清单（建议顺序）

1. **规范收敛**：更新 `SKILL_MEMORY_AGS_PERMISSION_MATRIX.md`、`specs/ags/ags-resource-permission-matrix.md`、`specs/ags/resource-repository-lifecycle.md` 的条款。
2. **产品界面收敛**：将 Memory / Skill 的权限入口与默认角色从 `edit` 改为 `manage`/`view`/`none`。
3. **授权模型收敛**：将人类/智能体授权统一到 short-term token 与 outbox 刷新语义。
4. **creator intent**：将创建者权限写入可恢复的 access intent 与状态表，加入 repair。
5. **insights 越权保护**：source 与 insights 的仓库访问采用独立映射/配置。
6. **统一降权弹窗**：KB/Memory/Skill 的 self-demotion 一致化。