Gumloop 功能规格 - Shared & Organization Skills

初始上下文

1. 概览

背景

在 Shared & Organization Skills 之前，Gumloop 的技能体系是单用户作用域的：

v9.11.0 "Huntsville" 引入了三个相互关联的功能来解决这些问题：

1. Shared & Organization Skills — 技能的组织级作用域扩展
2. Organization Skill Discovery — 可浏览的组织技能目录
3. Agent Template Sharing — 标准化的 Agent 模板共享

这三个功能共同构成了 Gumloop 的「组织能力管理」基础设施，与已有的 User Groups、Custom Roles、Team Level Secrets 形成完整的组织协作技术栈：

┌─────────────────────────────────────────────────────────────────────────────┐
│                     Gumloop 组织协作技术栈（v9.11.0）                         │
├─────────────────────────────────────────────────────────────────────────────┤
│                                                                             │
│  ┌─────────────────────────────────────────────────────────────────────┐   │
│  │                    Agent Template Sharing                            │   │
│  │  "Agent 行为的标准化工厂"                                             │   │
│  │  预配置模型 + 技能 + 工具 + 系统提示 → 一键实例化                       │   │
│  └──────────────────────────────┬──────────────────────────────────────┘   │
│                                 │ 模板引用组织技能                           │
│  ┌──────────────────────────────▼──────────────────────────────────────┐   │
│  │              Shared & Organization Skills                           │   │
│  │  "组织知识沉淀与复用管道"                                             │   │
│  │  三级可见性：Mine → Shared with me → Organization                    │   │
│  └──────────────────────────────┬──────────────────────────────────────┘   │
│                                 │ 技能访问受角色约束                           │
│  ┌──────────────────────────────▼──────────────────────────────────────┐   │
│  │              权限层（User Groups + Custom Roles）                     │   │
│  │  "谁能创建/编辑/使用哪些技能"                                          │   │
│  │  Owner > Editor > Viewer > Use Only                                  │   │
│  └──────────────────────────────┬──────────────────────────────────────┘   │
│                                 │ 凭证/机密注入                                │
│  ┌──────────────────────────────▼──────────────────────────────────────┐   │
│  │              Team Level Secrets                                     │   │
│  │  "组织技能运行所需的安全凭证"                                          │   │
│  │  共享 API Keys / Tokens / Certificates                               │   │
│  └─────────────────────────────────────────────────────────────────────┘   │
│                                                                             │
└─────────────────────────────────────────────────────────────────────────────┘

目标

1. 消除技能碎片化：建立从个人技能到组织技能的升级管道，优秀实践自动沉淀为组织资产
2. 建设技能复用体系：通过 Skill Discovery 目录让团队成员发现已有技能，避免每个团队重复建设
3. 确保行为一致性：通过 Agent Template Sharing + Organization Skills 锁定标准和合规配置
4. 构建网络效应：技能库越丰富 → 用户越离不开 → 创建者越有动力贡献 → 平台黏性越强
5. 降低新成员启动成本：入职即获组织所有标准技能，即时具备完整生产力

2. 核心机制

2.1 三级技能共享模型 [文档已验证]

v9.11.0 将技能可见性从单一用户作用域扩展为三级共享模型：

┌─────────────────────────────────────────────────────────────────────────────┐
│                      Gumloop 技能三级共享模型                                 │
│                      (Three-Tier Skill Sharing Model)                        │
├───────────────────┬───────────────────┬─────────────────────────────────────┤
│                   │                   │                                     │
│    ┌──────────┐   │    ┌──────────┐   │    ┌──────────────────────────┐     │
│    │  Mine    │   │    │ Shared   │   │    │     Organization         │     │
│    │  我的技能  │   │    │ with me  │   │    │     组织技能              │     │
│    │          │   │    │ 与我共享   │   │    │                          │     │
│    └────┬─────┘   │    └────┬─────┘   │    └────────────┬─────────────┘     │
│         │         │         │         │                 │                   │
│         ▼         │         ▼         │                 ▼                   │
│  ┌──────────────┐ │  ┌──────────────┐ │  ┌──────────────────────────────┐   │
│  │ 仅创建者可见   │ │  │ 被直接共享    │ │  │ 全组织可见                     │   │
│  │ 创建者可编辑   │ │  │ 或通过组织共享  │ │  │ 管理员可管理                   │   │
│  │ 创建者可删除   │ │  │ 查看+使用权限  │ │  │ 按团队/角色控制可见性           │   │
│  └──────────────┘ │  └──────────────┘ │  └──────────────────────────────┘   │
│                   │                   │                                     │
│    作用域：User   │   作用域：Team     │   作用域：Organization              │
│    数据隔离：强    │   数据隔离：按共享  │   数据隔离：按权限角色              │
│                   │   列表过滤        │                                     │
└───────────────────┴───────────────────┴─────────────────────────────────────┘

                    从 Mine 到 Organization 的升级路径：

        Mine ──[发布到团队]──▶ Shared ──[发布到组织]──▶ Organization
                                   ▲                        │
                                   │                        │
                                   └──[管理员降级]────────────┘

Mine（我的技能） [文档已验证]

• 用户自己创建的技能
• 仅创建者可见和可编辑
• 创建者可随时重命名和删除
• 作为技能创建的起点——先在个人空间验证，再发布为团队/组织技能

Shared with me（与我共享） [文档已验证]

• 他人直接共享给你或通过组织间接共享的技能
• 仅查看和使用权限，不可修改或删除（除非你是该技能所在项目的成员）
• 标签页展示所有与你相关的共享技能，按来源分组
• 注意：当前不支持直接共享给个人用户——「Skills cannot be shared directly with individual users at this time」[文档已验证]

Organization（组织技能） [文档已验证]

• 发布到组织层级的技能，全组织可见
• 管理员可配置按团队/角色控制可见性和使用权限
• 支持版本管理——更新发布后全组织生效
• 与 User Groups 和 Custom Roles 深度集成

2.2 技能权限角色表 [文档已验证]

三级技能共享模型与 Gumloop 通用四层角色体系（Owner > Editor > Viewer > Use Only）结合后，产生以下权限矩阵：

Access Resolution Order（访问解析顺序） [文档已验证]

当查询一个技能的用户访问级别时，系统按以下优先级解析：

Direct user grant → Team grant → Organization grant → Public grant → No access

即：直接授权 > 团队授权 > 组织授权 > 公开访问 > 拒绝访问。

2.3 Agent 技能发现机制 [文档已验证]

Personal Assistant Agents（个人助手 Agent）

• 自动拥有空间中所有技能的访问权限
• 使用语义搜索（semantic search）匹配技能描述与当前任务
• Agent 不依赖显式附加（attachment）——而是按需从技能库检索
• 这一机制为 Shared 和 Organization 技能提供了「零配置接入」路径 [推断]

Custom Agents（自定义 Agent）

• 仅能看到显式附加的技能
• 附加的技能出现在系统提示（system prompt）中
• 每个技能消耗约 50-100 tokens [文档已验证]
• Custom Agent 自己创建的技能自动附加；通用 Agent 的技能进入库但不自动附加 [文档已验证]

Organization Skill Discovery（组织技能发现目录） [推断]

v9.11.0 新增的可浏览技能目录界面：

• 支持按名称、类别、标签、创建者搜索
• 每个技能卡片展示：描述、使用次数、最近更新时间、维护者
• 管理员可查看使用分析——哪些技能频繁使用、哪些无人问津
• 功能定位：解决「技能孤岛」问题——组织中有人创建了优秀技能，但其他人不知道它的存在

┌───────────────────────────────────────────────────────────────┐
│                  Organization Skill Discovery                  │
│                                                               │
│  ┌───────────────────────────────────────────────────────┐   │
│  │  🔍 搜索技能...                          [分类▼] [标签▼]  │   │
│  └───────────────────────────────────────────────────────┘   │
│                                                               │
│  ┌─────────────────────┐  ┌─────────────────────┐            │
│  │ 代码审查 Skill       │  │ SQL 查询优化 Skill   │            │
│  │ 使用 1,234 次        │  │ 使用 892 次          │            │
│  │ 更新 2026-06-01      │  │ 更新 2026-05-28      │            │
│  │ 维护者：安全团队      │  │ 维护者：数据团队      │            │
│  └─────────────────────┘  └─────────────────────┘            │
│                                                               │
│  ┌─────────────────────┐  ┌─────────────────────┐            │
│  │ Jira 工单管理        │  │ 客户外联 Skill       │            │
│  │ 使用 567 次          │  │ 使用 3,201 次        │            │
│  │ 更新 2026-05-15      │  │ 更新 2026-06-02      │            │
│  │ 维护者：工程团队      │  │ 维护者：客户成功团队   │            │
│  └─────────────────────┘  └─────────────────────┘            │
│                                                               │
│  📊 管理员仪表盘：[使用分析] [未使用技能] [高价值技能]         │
└───────────────────────────────────────────────────────────────┘

2.4 技能编辑与创建开关 [文档已验证]

每个 Agent 的 Tools 配置中设有全局编辑开关（Skill Editing & Creation Toggle）：

关键约束 [文档已验证]：

• 全局作用域：开关作用于 Agent 上所有技能，不可逐技能单独配置
• 并发编辑风险：多人编辑同一技能时采用 last-write-wins（最后写入胜出）策略
• 共享技能的编辑安全：Disabled 状态可防止 Agent 意外修改组织级共享技能，保护标准化配置不被自动学习覆盖 [推断]

2.5 版本历史与审计 [文档已验证]

Edits 标签页展示完整的文件级变更时间线：

• 每次编辑记录包含修改者身份（哪个 Agent 做了哪次编辑）
• 文件级粒度：SKILL.md、scripts/、references/ 等子文件的变更独立追踪
• 变更归因：可区分「用户手动编辑」与「Agent 自主编辑」

2.6 软删除与恢复 [文档已验证]

• 删除的技能被标记为 inactive（不活跃），进入软删除状态
• 软删除的技能可能由技术支持恢复——「potentially recoverable by support」
• Organizational Skills 的软删除应有额外保护（如二次确认、冷却期），防止误操作影响全组织 [推断]

3. 功能需求

模块 A — 技能共享基础设施

模块 B — 权限控制

模块 C — Agent 技能发现与附加

模块 D — 审计与恢复

4. 用户场景

5. 竞争分析

关键洞察

1. 「组织技能目录」是差异化能力：现有协作工具（GitHub、Notion、Slack）都依赖于被动共享模型——只有被显式分享给你的内容才能看到。Gumloop 的 Organization Skills + Discovery 目录是主动的、可浏览的、带使用分析的组织知识资产管理模式。这在 Agent 平台赛道上尚无直接对标。
2. 三级共享（Mine → Shared → Organization）的渐进设计是正确选择：相比直接跳到「全组织公共」或保留「纯个人」，三级模型允许技能在个人验证→小范围共享→组织推广的路径上渐进成熟。这与开源社区的「个人项目→团队仓库→公共发布」逻辑一致。
3. 网络效应的来源是技能而非数据：GitHub 的网络效应来自代码（开发者社群），Notion 的网络效应来自文档（团队协作），Gumloop 的网络效应来自可执行的 Agent 技能——这比文档或代码更具黏性，因为技能直接产生工作成果（输出价值 > 知识价值）。
4. Agent Template Sharing 构建了「一致性 vs 灵活性」的平衡点：完全锁定配置（只有管理员能改）会阻碍创新，完全开放会导致混乱。模板的参数化配置（哪部分可改、哪部分锁定）是关键的架构决策——它定义了组织治理的灵活性边界。
5. 版本管理是隐形护城河：Shared Skills 的「更新即时全组织生效」是双刃剑——对统一标准极有价值，但缺乏版本锁定（version pinning）可能在某些高合规场景中引发风险。这是未来「技能版本锁定」和「灰度发布」的演进空间。

6. 遥测

7. 路线图

关键演进判断

1. 从 Shared 到 Organization 的「发布率」是网络效应启动的先行指标：如果大量技能停留在 Shared（小范围共享）而很少升级为 Organization（全组织公开），说明用户对质量/标准化缺乏信心，或组织缺乏「公共知识」文化。需要分析阻止因素——是技能质量不够、还是组织架构不支持跨团队共享。
2. Skill Discovery 的「浏览到附加」转化漏斗是核心健康指标：如果大量用户搜索/浏览技能但很少附加使用，可能意味着：(a) 技能描述与实际能力不匹配；(b) 附加门槛过高（当前 Custom Agent 需手动附加）；(c) 技能质量不足以满足需求。
3. 版本管理和灰度发布是高合规场景的「入场券」：当前「全组织即时生效」的设计对标准化极为高效，但金融、医疗、政府等行业的合规要求通常要求变更审批 + 版本锁定。缺乏这两个能力将限制 Gumloop 进入这些市场。
4. 组织间共享 → Marketplace 是商业模式的质变机会：从「内部共享」到「跨组织共享」是网络效应的第二次飞跃——一个经过 6 个月组织内打磨的技能库，一旦允许跨组织发布和交易，将使 Gumloop 进入平台经济的范畴。

8. 源文档参考

• spec_resource/gumloop-docs_skills-full.md — Skills 官方帮助文档完整存档（技能结构、三级标签页、权限层级、Agent 附加机制、编辑开关、版本历史、软删除）
• spec_resource/gumloop-docs_share-permissions.md — Share Permissions 官方帮助文档（四层角色体系、General Access 级别、Access Resolution Order、Action Requests、跨组织/企业功能）
• changelog/changelog_html/v9.11.0_Huntsville.html — v9.11.0 "Huntsville" 更新详情（Shared & Organization Skills、Organization Skill Discovery、Agent Template Sharing 的功能描述、应用场景、战略分析）

由 Claude 竞品情报系统生成 · 来源：Gumloop Skills 帮助文档 / Gumloop Share Permissions 帮助文档 · 评分 8/13（战略2 护城河2 用户2 复杂度1 创新1）