qwenpaw-skills
14 KiB
14 KiB
企业级 Skills 市场建设方案
—— 基于 QwenPaw × TencentDB Agent Memory 的「技能发布、授权与治理」平台
版本：v1.0 ｜ 日期：2026-08-08
一句话结论：可以，而且不需要从零自研。 QwenPaw 负责「技能运行」，TencentDB Agent Memory 的 Skill 资产体系天然提供「发布、审核、授权、版本、统计、权限」这整套市场治理能力。两者通过 OpenAPI / SDK / 外部技能根目录打通，即可实现「财务发布 → 人事使用 → 领导全量可见」的企业级 Skills 市场。
一、需求背景
企业内部的 AI Agent 能力正在快速普及，各部门（财务、人事、行政、研发……）都开始沉淀自己的 Agent 技能（Skill）。随之而来的管理问题：
- 技能散落：每个 Agent 工作区各有一份技能副本，没有统一的发布渠道，优秀实践无法跨部门复用。
- 权限模糊：财务沉淀的「发票核验 / 报销审核」技能，需要开放给人事使用，但绝不能开放给无关人员；目前缺少按「发布者 → 使用者 → 管理者」分层的授权机制。
- 领导不可见：管理层需要看到「企业里到底有哪些技能、谁在用、用得怎么样」，目前没有全局视图。
- 无版本与审计：技能改版、下架、使用记录都无从追溯，无法满足合规要求。
目标角色（最小闭环）
| 角色 | 诉求 | 权限边界 |
|---|---|---|
| 财务（发布者） | 把自己的技能发布到市场，开放给人使用 | 创建、发布自己的技能；撤销、下架；查看自己技能的使用情况 |
| 人事（使用者） | 在市场上浏览、申请、使用财务等部门的技能 | 浏览市场；使用被授权的技能；查看自己已订阅的技能 |
| 领导（管理者） | 看到全部技能、全量使用统计、全局管控 | 查看全部技能与使用数据；审核发布；强制下架；账号与团队管理 |
| 管理员（系统） | 平台运维 | System Admin：用户、团队、全局配置 |
二、为什么选 TencentDB Agent Memory：能力对照
TencentDB Agent Memory（腾讯云开源，MIT 协议，可本地部署、零外部 API 依赖、框架中立）本身就是一套「团队记忆中枢」，其中 Skill 资产 与我们要建的 Skills 市场高度同构：
| 市场需求 | TencentDB Agent Memory 原生能力 |
|---|---|
| 技能作为独立资产管理 | Skill 是四大资产之一（Chat Memory / Skill / Wiki / CodeGraph），带版本、资源文件、触发边界、执行步骤、验证规则 |
| 发布者拥有技能 | 每项资产记录 Owner，Owner 自动拥有管理权限 |
| 谁可以用 | 四档可见性：private（仅本人）/ team（团队内可见）/ restricted（用户/角色/Agent ACL 精确授权）/ agent（定向装备给指定 Agent） |
| 领导全量可见 | System Admin（全局管理员） 可管理用户、团队，并使用全部资产管理功能 |
| 审核与管控 | Memory Hub 提供资产的生成、审核、授权、分享、装配闭环 |
| 使用统计 | 资产记录使用次数、使用记录、版本、状态，可追溯 |
| 跨框架复用 | 资产与 Agent 框架解耦，可装配给 OpenClaw、QwenPaw、Claude Code、CodeBuddy 等 |
一句话：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（多 Agent） │
│ 技能池 skill_pool / 外部技能根目录 skill_paths │
│ ├─ 财务 Agent 工作区 ── 装载「财务发布」的技能 │
│ ├─ 人事 Agent 工作区 ── 装载「被授权」的技能 │
│ └─ 领导 Agent 工作区 ── 装载「全部只读」视图 │
└─────────────────────────────────────────────────────────────┘
三层职责：
- 治理层（TencentDB Agent Memory）：技能的「市场」本体——发布、审核、版本、授权、统计、审计都在这里完成。数据存于腾讯云数据库（TDSQL / MySQL / 向量库），本地部署保证数据不出企业。
- 运行层（QwenPaw）：技能的「运行」本体——被授权的技能以
SKILL.md形式落到对应 Agent 工作区，Agent 在对话中实际调用。 - 用户层（前端）：可以是 Memory Hub 原生界面 + 少量定制（品牌、目录、申请流），也可以单独做一个轻量门户对接 OpenAPI。
四、核心设计
4.1 Skill 资产生命周期（状态机）
[草稿 Draft] ──提交──▶ [待审核 Review] ──通过──▶ [已发布 Published]
▲ │ 驳回 │
└────────────────────┘ ├──▶ [已授权给人事 Agent]
├──▶ [领导可见]
└──▶ [下架 Archived]（触发已安装端回收）
每个状态切换都记录操作人、时间、原因，形成审计链。
4.2 权限模型：角色 × 可见性 × ACL
| 业务角色 | TencentDB AM 映射 | 权限说明 |
|---|---|---|
| 财务（发布者） | Skill 资产 Owner | 可创建/编辑/发布/下架自己的技能；对自有资产自动拥有管理权 |
| 人事（使用者） | Team Member + restricted ACL |
可浏览市场；仅能使用被授权的技能（如财务开放的「发票核验」） |
| 领导（管理者） | System Admin（或跨团队 Admin） | 查看全部 Skill 资产、使用统计、审核流；可强制下架、调整授权 |
| 管理员 | System Admin | 用户、团队、全局配置、容量 |
可见性语义（直接复用原生能力）：
private：技能仅财务本人可见（草稿期默认）。restricted：通过 ACL 精确授权给「人事团队」或「人事角色」，这是「财务发布给人事用」的落地方式。agent：定向装备——「发票核验」技能只装进人事的报销 Agent，不装进其他 Agent。team：团队内共享，适合财务团队内部互用。
领导的「全量可见」由 System Admin 角色天然保证；同时可通过跨团队 Admin 或全局只读视图实现，无需额外开发。
4.3 数据模型（若需自建市场门户，可落库如下）
腾讯云数据库（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
4.4 与 QwenPaw 的装配方式（运行层落地）
被授权后，技能以标准 SKILL.md 进入 QwenPaw 运行体系，三种路径按需选择：
- 外部技能根目录
skill_paths（推荐，适合共享池） 在 QwenPawconfig.json中登记团队共享技能目录（如/opt/team/skills）， TencentDB AM 授权后把SKILL.md同步进该目录，相关工作区即可按需载入。 - 技能池 + 广播 / 自动同步
将技能放入
skill_pool/，开启「自动同步」并指定关联智能体（如人事 Agent）， 池内容变更自动下发到已安装工作区——适合版本化分发。 - CLI 安装
qwenpaw skills install <skill_url> --agent-id hr_agent，适合按需、一次性安装。
配合 SKILL.md 的
metadata.requires（如env: [HR_SYSTEM_API_KEY]）与 Skill Config 注入， 可以把财务技能的密钥/参数与人事工作区隔离，避免敏感配置跨部门泄露。
五、关键流程演示（对标需求）
场景 A：财务发布「发票核验」技能 → 人事使用
- 财务在 Memory Hub 创建 Skill 资产「发票核验」（含 SKILL.md + 校验脚本），状态
private。 - 财务提交审核 → 领导/管理员在 Hub 通过 → 状态
published，可见性设为restricted。 - 财务（或管理员）在 ACL 中把该技能授权给「人事团队 / 人事报销 Agent」。
- 系统通过 OpenAPI / SDK 将
SKILL.md推送到 QwenPaw 人事 Agent 工作区（或skill_paths共享目录）。 - 人事在对话中直接使用：Agent 加载该技能，执行发票核验；财务可查看使用统计。
场景 B：领导查看全部技能
- 领导以 System Admin 登录 Memory Hub（或定制驾驶舱）。
- 资产库 → Skill → 按团队/状态/分类筛选，看到全部技能（财务、人事、其他部门）。
- 查看每个技能的使用次数、最近使用时间、版本、授权范围。
- 发现违规技能 → 一键下架，并触发 QwenPaw 端回收（自动同步移除）。
六、结合 TencentDB 的具体落地路径
阶段一：部署与初始化（约 0.5~1 天，已有基础）
- 复用已部署的
memory-core(:8420)、memory-hub(:8125/:8424)、proxy(:8096)。 - 启动 MemoryKnowledge（:8421，此前未启动），获得 Knowledge OpenAPI / MCP 桥接能力。
- 创建团队结构：
Finance Team（财务）、HR Team（人事）、Leadership（领导只读）。
阶段二：Skill 资产化试点（1~2 天）
- 选 1~2 个财务技能（如发票核验）上架，走完「草稿→审核→发布→ACL 授权→装配到人事 Agent」闭环。
- 验证 QwenPaw 侧三种装配路径，确定主路径（建议
skill_paths或技能池自动同步）。
阶段三：门户定制（3~5 天，可选）
- 用 Knowledge OpenAPI 包一层轻量市场门户（浏览、搜索、申请、我的技能、领导驾驶舱）。
- 数据落腾讯云数据库（TDSQL-C），见 4.3 表设计；前端可用 QwenPaw Console 或公司内部系统嵌入。
阶段四：治理与推广
- 固化审核 SLA、下架/回收流程、使用统计周报（自动推送给领导）。
- 推广到更多部门，形成企业级技能资产目录。
七、风险与注意事项
| 风险 | 应对 |
|---|---|
| 财务技能含敏感规则/密钥 | 用 SKILL.md requires.env + Skill Config 注入隔离；密钥存环境变量/密钥管理，不写入技能文件 |
| 跨部门误授权 | 默认 private，授权走显式 ACL + 审核；定期审计授权清单 |
| 技能版本回滚 | 利用版本表 + 技能池自动同步的变更检测，出问题可回滚到上一版本 |
| MemoryKnowledge 未启用导致 API 缺口 | 阶段一必须补启动，作为 OpenAPI 出口 |
| QwenPaw 端残留旧版本 | 用「自动同步 + 指定关联智能体」精确下发，下架时同步移除 |
八、总结
- 结论：完全可以结合 TencentDB 完成，且推荐用 TencentDB Agent Memory 作为治理底座——它把「发布、审核、授权、版本、统计、权限」这些市场核心能力做成了原生能力，无需从零开发。
- QwenPaw 作为运行层负责技能的实际加载与调用，通过
skill_paths/ 技能池自动同步 / CLI 三条路径装配。 - 最小闭环（财务发布→人事使用→领导全量可见）在 2~3 天内即可跑通，再逐步扩展门户与治理能力。
这是一条「用现成的开源治理中枢 + 现成的 Agent 运行框架拼装企业级 Skills 市场」的低成本路线，也是目前工程上最快、最稳的路径。
本文基于 QwenPaw 2.0.1 官方文档与 TencentDB Agent Memory（Team Memory）公开资料整理，落地时以实际部署版本为准。