企业级 Skills 市场建设方案

—— 从「2 天跑通最小闭环」到「完整治理平台」的两条路径

版本：v2.0（合并版）｜日期：2026-08-30

一句话结论：财务发布、人事使用、领导全量可见——这个诉求不需要从零自研。TencentDB Agent Memory 的 Skill 资产体系天然提供「发布、审核、授权、版本、统计、权限」整套市场治理能力，2~3 天即可跑通最小闭环；若后续需要独立门户与深度定制，再演进到自研 Marketplace API 的重方案。

一、需求背景

1.1 四大痛点

企业内部的 AI Agent 能力正在快速普及，各部门（财务、人事、行政、研发……）都开始沉淀自己的 Agent 技能（Skill）。随之而来的管理问题：

1. 技能散落：每个 Agent 工作区各有一份技能副本，没有统一的发布渠道，优秀实践无法跨部门复用。
2. 权限模糊：财务沉淀的「发票核验 / 报销审核」技能，需要开放给人事使用，但绝不能开放给无关人员；目前缺少按「发布者 → 使用者 → 管理者」分层的授权机制。
3. 领导不可见：管理层需要看到「企业里到底有哪些技能、谁在用、用得怎么样」，目前没有全局视图。
4. 无版本与审计：技能改版、下架、使用记录都无从追溯，无法满足合规要求。

1.2 目标角色（最小闭环）

1.3 现状盘点：我们已经具备什么

在动手之前，先盘点已经跑通的基础设施——这决定了轻路线为什么能这么快。

二、方案选型：两条路线

同一个目标，有轻重两条实现路径。它们不是互斥关系，而是演进关系。

2.1 轻路线：复用 Agent Memory 原生治理

核心思路：不做市场，而是把 Agent Memory 的 Memory Hub 当作市场后台来用——它默认服务于团队记忆，我们把它聚焦到 Skill 资产上做企业级治理。

• 治理层：TencentDB Agent Memory（发布、审核、版本、授权、统计、审计）
• 运行层：QwenPaw / WorkBuddy（技能实际加载与调用）
• 打通方式：OpenAPI / SDK / 外部技能根目录

2.2 重路线：自研 Marketplace API

核心思路：独立建设市场服务，自主研发注册中心、权限管控、审批工作流与使用分析，数据存储落到 TencentDB MySQL。

• 数据层：TencentDB MySQL（7 张表：部门/用户/技能/版本/权限/审批/日志）
• 服务层：自建 Marketplace API + 对象存储
• 接入层：自研 MCP Server（10 个工具）桥接 WorkBuddy

2.3 对比与推荐

三、为什么是 TencentDB Agent Memory：能力对照

TencentDB Agent Memory（腾讯云开源，MIT 协议，可本地部署、零外部 API 依赖、框架中立）本身就是一套「团队记忆中枢」，其中 Skill 资产 与我们要建的 Skills 市场高度同构：

一句话：TencentDB Agent Memory 的 Memory Hub 就是现成的「技能市场后台」，只是它默认服务于团队记忆，而我们把它聚焦到 Skill 资产上做企业级治理。

四、总体架构

┌─────────────────────────────────────────────────────────────┐
│                    用户层（前端入口）                         │
│   财务 / 人事 / 领导 / 管理员                                 │
│   ┌──────────┐   ┌──────────┐   ┌───────────┐                │
│   │ 发布工作台 │   │ 市场门户  │   │ 管理驾驶舱 │                │
│   └────┬─────┘   └────┬─────┘   └─────┬─────┘                │
└────────┼──────────────┼───────────────┼──────────────────────┘
         ▼              ▼               ▼
┌─────────────────────────────────────────────────────────────┐
│             治理层：TencentDB Agent Memory                   │
│   Memory Hub（控制台）                                        │
│   · 团队 / 用户 / 角色管理（System Admin ↔ Team Admin/Member）│
│   · Skill 资产库（版本 / Owner / 状态 / 可见性 / ACL）         │
│   · 审核流（草稿 → 待审 → 已发布 → 已下架）                    │
│   · 使用统计与审计日志                                         │
│   MemoryCore（记忆/资产核心）  MemoryKnowledge（OpenAPI）      │
└────────────────────────┬────────────────────────────────────┘
                         ▼  OpenAPI / SDK / MCP 装配
┌─────────────────────────────────────────────────────────────┐
│             运行层：QwenPaw / WorkBuddy（多 Agent）           │
│   技能池 skill_pool / 外部技能根目录 skill_paths              │
│   ├─ 财务 Agent 工作区  ── 装载「财务发布」的技能             │
│   ├─ 人事 Agent 工作区  ── 装载「被授权」的技能               │
│   └─ 领导 Agent 工作区  ── 装载「全部只读」视图               │
└─────────────────────────────────────────────────────────────┘

三层职责：

• 治理层（TencentDB Agent Memory）：技能的「市场」本体——发布、审核、版本、授权、统计、审计都在这里完成。数据存于腾讯云数据库，本地部署保证数据不出企业。
• 运行层（QwenPaw / WorkBuddy）：技能的「运行」本体——被授权的技能以 SKILL.md 形式落到对应 Agent 工作区，Agent 在对话中实际调用。
• 用户层（前端）：可以是 Memory Hub 原生界面 + 少量定制（品牌、目录、申请流），也可以单独做轻量门户对接 OpenAPI。

4.1 职责分层（重路线视角）

五、权限模型：角色 × 可见性 × ACL

5.1 角色映射

5.2 可见性四档语义（直接复用原生能力）

• private：技能仅财务本人可见（草稿期默认）。
• restricted：通过 ACL 精确授权给「人事团队」或「人事角色」——这是「财务发布给人事用」的落地方式。
• agent：定向装备——「发票核验」技能只装进人事的报销 Agent，不装进其他 Agent。
• team：团队内共享，适合财务团队内部互用。

领导的「全量可见」由 System Admin 角色天然保证；同时可通过跨团队 Admin 或全局只读视图实现，无需额外开发。

5.3 操作权限矩阵（重路线自定义时参考）

六、数据模型

6.1 轻路线：最小表集合

腾讯云数据库（TDSQL-C / MySQL）中建议的最小表集合：

skills           技能主表：id, name, slug, owner_id, team_id,
                  category, description, version, status,
                  visibility(enum), created_at, updated_at
skill_versions   版本表：skill_id, version, file_uri(SKILL.md 存储位置),
                  changelog, created_by, created_at
acl              授权表：skill_id, grantee_type(user/role/team/agent),
                  grantee_id, perm(read/use/manage), granted_by, created_at
subscriptions    订阅/装备表：skill_id, agent_id/workspace_id,
                  install_status, installed_at, synced_at
usage_logs       使用日志：skill_id, agent_id, user_id, session_id,
                  called_at, result_status
audit_logs       审计日志：asset_id, actor, action, detail, ts

6.2 重路线：完整 DDL

-- 部门表
CREATE TABLE departments (
    id          INT PRIMARY KEY AUTO_INCREMENT,
    name        VARCHAR(100) NOT NULL,
    parent_id   INT DEFAULT NULL,
    sort_order  INT DEFAULT 0,
    created_at  TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

-- 用户表
CREATE TABLE users (
    id          INT PRIMARY KEY AUTO_INCREMENT,
    name        VARCHAR(100) NOT NULL,
    email       VARCHAR(200) UNIQUE NOT NULL,
    dept_id     INT NOT NULL,
    role        ENUM('publisher', 'consumer', 'admin', 'super_admin') DEFAULT 'consumer',
    status      ENUM('active', 'disabled') DEFAULT 'active',
    created_at  TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    FOREIGN KEY (dept_id) REFERENCES departments(id)
);

-- 技能表
CREATE TABLE skills (
    id            INT PRIMARY KEY AUTO_INCREMENT,
    name          VARCHAR(100) NOT NULL,
    description   TEXT,
    category      VARCHAR(50),          -- 技能分类
    publisher_id  INT NOT NULL,         -- 发布者
    dept_id       INT NOT NULL,         -- 发布部门
    status        ENUM('draft', 'pending', 'published', 'archived', 'rejected') DEFAULT 'draft',
    current_ver   VARCHAR(20) DEFAULT '1.0.0',
    skill_pkg_url VARCHAR(500),         -- 技能包下载地址
    tags          VARCHAR(500),         -- 逗号分隔标签
    created_at    TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    updated_at    TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
    FOREIGN KEY (publisher_id) REFERENCES users(id),
    FOREIGN KEY (dept_id) REFERENCES departments(id)
);

-- 技能版本表
CREATE TABLE skill_versions (
    id            INT PRIMARY KEY AUTO_INCREMENT,
    skill_id      INT NOT NULL,
    version       VARCHAR(20) NOT NULL,
    changelog     TEXT,
    pkg_url       VARCHAR(500),
    published_by  INT NOT NULL,
    published_at  TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    FOREIGN KEY (skill_id) REFERENCES skills(id),
    FOREIGN KEY (published_by) REFERENCES users(id)
);

-- 权限规则表
CREATE TABLE skill_permissions (
    id          INT PRIMARY KEY AUTO_INCREMENT,
    skill_id    INT NOT NULL,
    scope_type  ENUM('dept', 'role', 'user', 'public') NOT NULL,
    scope_id    INT,                    -- dept_id / role / user_id
    permission  ENUM('view', 'install', 'use') DEFAULT 'use',
    FOREIGN KEY (skill_id) REFERENCES skills(id)
);

-- 审批记录表
CREATE TABLE skill_reviews (
    id           INT PRIMARY KEY AUTO_INCREMENT,
    skill_id     INT NOT NULL,
    version      VARCHAR(20) NOT NULL,
    reviewer_id  INT NOT NULL,
    action       ENUM('approve', 'reject', 'request_changes') NOT NULL,
    comment      TEXT,
    reviewed_at  TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    FOREIGN KEY (skill_id) REFERENCES skills(id),
    FOREIGN KEY (reviewer_id) REFERENCES users(id)
);

-- 使用日志表
CREATE TABLE usage_logs (
    id           BIGINT PRIMARY KEY AUTO_INCREMENT,
    skill_id     INT NOT NULL,
    user_id      INT NOT NULL,
    action       ENUM('view', 'install', 'execute', 'uninstall') NOT NULL,
    metadata     JSON,                  -- 调用上下文
    created_at   TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    INDEX idx_skill (skill_id),
    INDEX idx_user (user_id),
    INDEX idx_time (created_at)
);

七、生命周期与审批流

7.1 状态机

┌────────┐   提交审核    ┌─────────┐   审核通过    ┌───────────┐
│ Draft  │ ───────────> │ Pending │ ───────────> │ Published │
│  草稿   │              │  待审核  │              │   已发布   │
└────────┘              └─────────┘              └───────────┘
     ▲                       │                         │
     │                       │ 驳回                     │ 下架
     │                       ▼                         ▼
     │                 ┌──────────┐              ┌──────────┐
     └─────────────────│ Rejected │              │ Archived │
        修改后重新提交    │  已驳回   │              │  已归档   │
                       └──────────┘              └──────────┘
                                                        │
                                                        ▼
                                                 触发已安装端回收

每个状态切换都记录操作人、时间、原因，形成审计链。

7.2 审批工作流五步

八、运行层装配：技能如何落到 Agent 工作区

被授权后，技能以标准 SKILL.md 进入运行体系，三种路径按需选择：

1. 外部技能根目录 skill_paths（推荐，适合共享池）
   在 QwenPaw config.json 中登记团队共享技能目录（如 /opt/team/skills），
   TencentDB AM 授权后把 SKILL.md 同步进该目录，相关工作区即可按需载入。
2. 技能池 + 广播 / 自动同步
   将技能放入 skill_pool/，开启「自动同步」并指定关联智能体（如人事 Agent），
   池内容变更自动下发到已安装工作区——适合版本化分发。
3. CLI 安装
   qwenpaw skills install <skill_url> --agent-id hr_agent，适合按需、一次性安装。

配合 SKILL.md 的 metadata.requires（如 env:）与 Skill Config 注入，
可以把财务技能的密钥/参数与人事工作区隔离，避免敏感配置跨部门泄露。

九、MCP Server 集成设计（重路线）

在 WorkBuddy 与 Marketplace API 之间，通过自定义 MCP Server 桥接。该 MCP Server 复用现有 tencentdb-memory MCP 的架构模式（StdioServerTransport + HTTP 转发）。

9.1 工具清单

9.2 配置示例

{
  "skill-marketplace": {
    "command": "node",
    "args": ["/Users/figmarlite/.workbuddy/mcp-servers/skill-marketplace/index.mjs"],
    "env": {
      "MARKETPLACE_API_URL": "https://api.apescale.com/skill-market",
      "TDB_MYSQL_HOST": "gz-cdb-xxxxx.sql.tencentcdb.com",
      "TDB_MYSQL_PORT": "63306",
      "TDB_MYSQL_DB": "skill_market",
      "TDB_MYSQL_USER": "skill_admin",
      "TDB_MYSQL_PASS": "********",
      "TDB_MEM_SERVICE_ID": "default",
      "TDB_MEM_USER_KEY": "sk-mem-xxxxx",
      "TDB_MEM_TEAM_ID": "team-xxxxx"
    },
    "disabled": false
  }
}

十、实施路径

10.1 轻路线：四阶段（约 1 周）

10.2 重路线：五阶段（7~12 周）

十一、风险与注意事项

十二、典型场景

场景 A：财务发布「发票核验」→ 人事使用（轻路线）

1. 财务在 Memory Hub 创建 Skill 资产「发票核验」（含 SKILL.md + 校验脚本），状态 private。
2. 财务提交审核 → 领导/管理员在 Hub 通过 → 状态 published，可见性设为 restricted。
3. 财务（或管理员）在 ACL 中把该技能授权给「人事团队 / 人事报销 Agent」。
4. 系统通过 OpenAPI / SDK 将 SKILL.md 推送到人事 Agent 工作区（或 skill_paths 共享目录）。
5. 人事在对话中直接使用：Agent 加载该技能，执行发票核验；财务可查看使用统计。

场景 B：领导查看全部技能

1. 领导以 System Admin 登录 Memory Hub（或定制驾驶舱）。
2. 资产库 → Skill → 按团队/状态/分类筛选，看到全部技能（财务、人事、其他部门）。
3. 查看每个技能的使用次数、最近使用时间、版本、授权范围。
4. 发现违规技能 → 一键下架，并触发运行层回收（自动同步移除）。

场景 C：自然语言发现技能（AI 增强）

1. 人事部用户说：「我需要计算员工个税」。
2. Agent Memory 通过 skill_smart_search 匹配 L1 层技能特征标签。
3. 返回推荐：「找到财务部发布的『个税计算器』技能，是否安装？」
4. 用户确认安装，MCP Server 调用 skill_market_install，技能包下载到本地，立即可用。

场景 D：AI 智能推荐的四种能力

• 自然语言检索：基于 L1/L2 层记忆语义匹配，无需记住技能名称。
• 上下文推荐：基于 L2 场景记忆 + L3 核心记忆，按当前任务主动推荐（如处理薪酬时推荐「个税计算器」）。
• 跨部门发现：查询其他 Team 的公开 Block，发现可复用技能。
• 使用模式分析：L0→L1→L2→L3 逐层提炼，形成部门级技能画像，供领导决策。

十三、总结与展望

结论：完全可以结合 TencentDB 完成，且推荐用 TencentDB Agent Memory 作为治理底座——它把「发布、审核、授权、版本、统计、权限」这些市场核心能力做成了原生能力，无需从零开发。

核心优势：

• 角色隔离：发布者/消费者/管理员三层权限模型，满足企业管理需求
• 审批管控：完整的技能生命周期管理，发布前需审批
• AI 增强：自然语言搜索和智能推荐，降低技能发现门槛
• 数据驱动：使用日志和分析看板，为管理决策提供依据
• 无缝集成：通过 MCP Server 与 WorkBuddy 深度集成，用户体验自然

为什么推荐「先轻后重」：这是一条「用现成的开源治理中枢 + 现成的 Agent 运行框架拼装企业级 Skills 市场」的低成本路线。最小闭环（财务发布 → 人事使用 → 领导全量可见）在 2~3 天内即可跑通，用真实数据验证价值后，再按需扩展门户与治理能力，避免一开始就陷入 7~12 周的自研投入。

后续演进方向：

• 技能评分和评论系统
• 技能依赖管理（技能 A 依赖技能 B）
• 跨组织技能交换（子公司间共享）
• 技能自动化测试和合规扫描
• 基于使用数据的技能质量评估和自动推荐排序

本文基于 TencentDB Agent Memory 公开资料与实际部署环境整理，落地时以实际版本为准。