用Observal Teamspaces管理团队AI资产命名空间、成员角色与审批流完整教程【免费下载链接】ObservalObserval is self-hosted registry for your coding agent extensions with a built in insight engine. Setup Observal, define the scope and share your Skills, MCPs and Agents with your peers.项目地址: https://gitcode.com/gh_mirrors/ob/ObservalObserval 是一个自托管的编码代理扩展注册中心registry内置洞察引擎insight engine用于管理团队共享的 Skills、MCP 与 Agents。本文带你用 Observal Teamspaces 快速搭起团队的 AI 资产命名空间划分成员角色owner / reviewer / member、走通公开可见性的审批流并管理成员加入与内容审核。一、什么是 Teamspaces团队的共享命名空间Teamspaces 是 Observal 中一个共享的注册中心命名空间拥有唯一的 handle例如platform-tools。团队成员发布的所有 Agent、MCP、Skill、Hook、Prompt、Sandbox 都可以归属到这个命名空间下统一可见、统一治理。几个关键设计身份唯一团队 handle 与个人用户名不能冲突避免命名混乱规范身份每个资产都有命名空间/标识符namespace/slug形式的规范身份例如platform-tools/team-reviewer个人空间隔离通过claim-personal命令可领取私有的个人 teamspace个人空间始终保持私有全局管理员兜底全局管理员global admin可以管理任意 teamspace 概念细节参考docs/core-concepts/README.md二、成员角色owner、reviewer、member 三档权限每个 teamspace 成员都有且只有一个角色权限边界清晰角色能做什么适用对象owner管理成员、邀请链接、可见性以及注册中心内容团队负责人reviewer审批或驳回该 teamspace 的待审 Agents 和组件质量把关人member查看成员列表向 teamspace 发布内容普通工程师两条安全底线teamspace 始终至少保留一个 owner最后一个 owner 不能被移除也不能退出团队。角色由 owner 或全局管理员分配通过 CLI 一条命令完成observal team members add platform-tools aliceexample.com --role reviewer --output json角色定义源码可参考 observal-server/models/team.py。三、一键创建命名空间与可见性设置任何登录用户都能在Registry → Teamspaces页面或 CLI创建 teamspaceobserval team create Platform Tools \ --handle platform-tools \ --description Internal tooling \ --visibility private \ --output json可见性只有两档private私有和public公开两者在审批流上有重要区别私有 teamspace创建后立即可用但只能发布团队私有的 Agent 和组件公开 teamspace创建时 handle 会被预留但会保持私有锁定直到全局 reviewer 及以上角色在 Review 队列中批准才真正转为公开把已有的私有 teamspace 改为公开走同样的审批流被驳回后可以补充信息再次提交。observal team visibility set platform-tools public --output json完整命令说明见 docs/cli/team.md。四、审批流全景从创建、加入、到发布Observal 的审批流review flow覆盖三个层面确保团队 AI 资产的每一步流转都可审计1. 可见性审批私有转公开observal team visibility list-requests --output json observal team visibility approve platform-tools --output json observal team visibility reject platform-tools --reason Add a public description --output json批准会立即使 teamspace 公开并自动撤销其私有邀请链接驳回则保留私有状态。2. 成员加入审批公开申请 私有邀请双通道公开 teamspace任何人可提交加入申请owner 决定批准或拒绝observal team request join platform-tools --message I maintain deployments --output json observal team request approve platform-tools alice --output json私有 teamspaceowner 创建带过期时间和最大使用次数的邀请链接invite create1–365 天有效期成员凭 token 提交访问请求后仍需 owner 批准——邀请本身不直接授予成员身份。所有待办事项审批请求、驳回通知等都会进入个人收件箱可用observal inbox查看并处理详见 docs/cli/inbox.md。3. 内容审批发布永不自动通过Teamspaces 内的发布永远不会自动批准。具体规则私有 teamspace 只能发布团队私有内容teamspace 获批公开后其 owner 和团队 reviewer 可审批该命名空间下的全部内容包括公开内容和自己的提交公开提交会同时通知全局 reviewer 与团队审批人团队私有提交只通知该 teamspace 的 owner 和 reviewer注意已公开的 teamspace 在仍拥有公开资产时不能改回私有需先限制或删除这些资产在 Web 端的 Review Queue 中审批人可以对比版本差异后一键决定例如审查一次 Skill 的版本升级五、团队热度用 Leaderboard 查看资产使用情况资产发布后并不是终点。团队的会话遥测会汇入同一台服务器Leaderboard 可以按 24h / 7 天 / 30 天统计各 Agent 与组件的下载量帮你识别最热的团队资产observal ops top --type agent # 团队使用最多的 Agents observal ops top --type mcp # 最热门的 MCP 服务器六、快速参考常用 team 命令清单场景命令查看我的团队observal team list查看详情与成员observal team show platform-tools创建团队observal team create 名称 --handle xxx --visibility private申请/领取个人空间observal team claim-personal添加成员并设角色observal team members add team email --role reviewer审批加入请求observal team request approve team user创建私有邀请observal team invite create team --expires-days 30 --max-uses 20退出 / 删除团队observal team leave team/observal team delete team --yes所有叶子命令均支持--output table|json便于接入脚本。错误退出码3认证失败、4权限不足、5未找到、6状态冲突等见 docs/cli/team.md 的 Exit codes 一节。延伸阅读使用场景指南docs/use-cases/teamspaces.md全团队注册中心搭建docs/use-cases/team-registry.md收件箱命令参考docs/cli/inbox.md团队模型与数据约束含可见性审批字段observal-server/models/team.py团队 API 路由实现observal-server/api/routes/teams.py小结Teamspaces 用命名空间 三角色 三重审批流帮团队把 AI 资产治理做扎实——私有空间即时开工公开空间先审后发成员进出全程留痕内容发布永不自动通过。【免费下载链接】ObservalObserval is self-hosted registry for your coding agent extensions with a built in insight engine. Setup Observal, define the scope and share your Skills, MCPs and Agents with your peers.项目地址: https://gitcode.com/gh_mirrors/ob/Observal创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考