Skip to content

AnyClaw Cloud Market Product Design Document #284

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
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions