Skip to content

AnyClaw Cloud Market Product Design Document #284

@TheShigure7

Description

@TheShigure7

AnyClaw 云端市场产品设计文档

1. 产品定义

AnyClaw 云端市场是面向 AnyClaw、OpenClaw 及未来其他 runtime 的 通用 Skill / Agent 能力市场

它不是单纯的技能列表页,而是一个支持:

  • 能力发现
  • 能力搜索
  • 能力下载
  • 能力安装
  • 能力信任治理
  • 安装后恢复任务执行

的产品系统。


2. 产品目标

2.1 用户目标

让最终用户不必理解:

  • Skill 从哪里来
  • Agent 怎么安装
  • 哪个能力适合当前任务
  • 哪些能力风险高

而只需要:

  • 搜索
  • 浏览
  • 安装
  • 或直接发起任务,由系统自动补能

2.2 平台目标

让 AnyClaw 具备:

  • 统一能力来源
  • 动态补能机制
  • 受控静默安装
  • 本地优先执行
  • 面向多 runtime 的扩展能力

2.3 生态目标

让云端市场未来具备:

  • 第三方发布能力
  • 版本与依赖治理
  • 官方/已验证能力分发
  • 对 AnyClaw / OpenClaw 的中立支持

3. 目标用户

3.1 直接用户

  • AnyClaw 桌面端用户
  • AnyClaw 任务执行用户
  • 需要低门槛获取新能力的普通用户

3.2 间接用户

  • Skill 发布者
  • Agent 发布者
  • 市场审核者
  • OpenClaw 等其他 runtime 的接入方

4. 核心场景

场景 1:手动浏览和安装

用户在桌面壳中打开“技能市场”,执行:

  • 搜索
  • 查看详情
  • 点击安装

系统完成:

  • 从云端拉取目录
  • 返回详情
  • 下载并本地安装
  • 注册到当前 runtime

场景 2:执行中自动补能

用户发起任务后,主 Agent 发现本地缺少目标能力。

系统执行:

  1. 生成能力需求
  2. 检索云端市场
  3. 对候选做本地筛选
  4. 判断 Auto / Ask / Block
  5. 如允许则自动安装
  6. 热加载后继续执行当前任务

场景 3:版本升级和兼容治理

用户或系统希望升级某个已安装能力。

系统需要支持:

  • 查看可升级版本
  • 风险提示
  • 兼容性校验
  • 安装记录
  • 升级失败回滚

场景 4:第三方发布

发布者上传新的 Skill / Agent 包,系统需要支持:

  • 元数据校验
  • 标签与结构化建模
  • 版本入库
  • 审核与可见性控制
  • 下载分发

5. 产品范围

5.1 第一阶段范围

第一阶段只做最小闭环:

  • 市场列表
  • 搜索
  • 详情
  • 包下载
  • 本地安装
  • 已安装状态
  • 最小版本管理

5.2 第二阶段范围

增加智能能力:

  • 自动标签
  • 结构化字段抽取
  • 向量召回
  • 混合检索
  • 本地静默安装决策

5.3 第三阶段范围

增加生态和治理:

  • 发布端
  • 审核后台
  • 签名与 trust
  • 私有包/团队包
  • 推荐与排序增强

6. 核心功能清单

6.1 市场浏览功能

  • 浏览市场首页
  • 查看分类
  • 查看热门/最新
  • 查看包详情
  • 查看已安装状态

6.2 搜索功能

  • 关键词搜索
  • 标签搜索
  • 分类过滤
  • 类型过滤:skill / agent
  • 兼容性过滤

6.3 安装功能

  • 安装 Skill
  • 安装 Agent
  • 查看安装进度
  • 安装失败提示
  • 回滚失败安装

6.4 自动补能功能

  • 执行中缺能力检测
  • 市场检索
  • 本地筛选
  • 自动安装/询问用户
  • 安装后继续执行

6.5 发布与治理功能

  • 包上传
  • 版本发布
  • 审核
  • 下架
  • trust 标记
  • 下载与安装审计

7. 产品边界

7.1 云端市场不负责

  • 直接执行本地安装
  • 决定本地是否越权安装
  • 决定当前任务如何继续推理
  • 直接操作本地 runtime 状态

7.2 AnyClaw 本地负责

  • 最终安装决策
  • 下载后的校验与解压
  • 注册到本地 runtime
  • 与当前任务执行联动

8. 关键产品决策

8.1 市场做成独立 Registry

原因:

  • 对多客户端更友好
  • 对生态更友好
  • 对协议演进更稳定

8.2 skillagent 分开处理

原因:

  • skill 是局部能力件
  • agent 是角色/流程包
  • 静默安装策略不应完全相同

8.3 云端召回,本地决策

原因:

  • 云端适合做全量索引和召回
  • 本地最清楚环境、权限、依赖、风险边界

9. 成功标准

第一阶段成功标准:

  • 桌面壳能展示市场目录
  • 用户能从市场安装 Skill / Agent
  • AnyClaw 能识别并加载已安装能力

第二阶段成功标准:

  • 系统能对任务自动检索候选能力
  • 系统能输出 Auto / Ask / Block
  • 部分低风险 Skill 可静默安装

第三阶段成功标准:

  • 第三方可发布能力包
  • 能力包具有审核和 trust 标识
  • AnyClaw 以外客户端可复用云端市场

10. 与现有接口文档关系

当前 云端Skill与Agent市场接口设计.md 更偏:

  • 主安装链路接口
  • 包模型与安装模型

而本产品设计文档定义的是:

  • 产品范围
  • 目标用户
  • 核心场景
  • 功能边界
  • 成功标准

后续接口设计应以本产品文档定义的范围为准进行补全。

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions