Skip to content

Skill 仓库前端支持多种 Skill 下载/安装方式,不强制依赖 clawhub #4385

Description

@zacYL

问题陈述

Skill 仓库前端「使用指引」与包详情页的安装说明目前仅展示 clawhub v0.11.0 CLI 方式(npm i -g clawhub + clawhub install)。用户若无法或不愿安装 Node.js/npm 及 clawhub,则无法从 UI 获知如何获取 Skill 制品。

后端已实现 ClawHub v1 /download 接口(按 slug/version 下载 zip),但前端未提供对应的直接下载入口与安装说明。Skill 仓库应像主流 Skill 商店一样,提供多种获取/安装路径,降低使用门槛。

目标方案

在 Skill 仓库前端补充多种 Skill 获取/安装方式,至少包含:

  1. 直接下载 Zip:展示 /download API 的 curl/wget 命令或页面下载按钮;用户解压后手动放入 Agent skills 目录
  2. 对话安装:提供可复制的安装提示词,用户发给 AI 助手(Cursor、Claude 等)自动完成安装
  3. 命令行安装(可选):除 clawhub 外,展示基于 registry URL 的通用安装命令(若平台有独立 CLI 可后续扩展)

保留现有 clawhub 方式作为兼容选项,不强制移除。

用户故事

  1. 作为 Skill 使用者,我希望在仓库页面直接下载 Skill Zip 包,以便在不安装 clawhub 的环境下离线安装。
  2. 作为 Skill 使用者,我希望看到将 Zip 解压到各 Agent skills 目录(Cursor、Claude Code 等)的说明,以便正确完成手动安装。
  3. 作为 Skill 使用者,我希望复制一段提示词给 AI 助手即可完成安装,以便无需了解命令行操作。
  4. 作为仓库管理员,我希望前端安装指引覆盖多种路径,以便不同技术背景的用户都能使用 Skill 仓库。

实现决策

  • 新增或修改模块:
    • src/frontend/core/devops-repository/src/views/repoCommon/repoGuideMixin.jsskillGuideskillInstall
    • 包详情页安装区域(若与 guide 分离需同步)
  • 接口或交互:
    • 复用现有 GET .../download?slug=&version= 接口生成下载 URL/命令
    • Zip 安装说明列出常见 Agent skills 目录路径
    • 对话安装:根据当前 slug/version/registry 动态生成提示词模板
  • 数据、权限、配置:暂无(复用现有 READ 权限)
  • 技术约束:下载 URL 需带鉴权 token(与现有制品下载方式一致)

测试决策

  • 测试重点:Skill 仓库 guide 页与包详情页展示多种安装方式;直接下载链接可正常获取 zip;提示词内容包含正确的 slug/version/registry
  • 覆盖模块:devops-repository 前端 skill 相关视图
  • 可参考测试:待确认

不在范围内

  • 开发新的独立 CLI 工具
  • 修改后端 ClawHub v1 API 协议
  • 移除 clawhub 安装方式

验收标准

  • Skill 仓库使用指引包含「直接下载 Zip」方式及 curl/浏览器下载说明
  • 包详情页安装区域提供不依赖 clawhub 的下载命令或按钮
  • Zip 手动安装说明包含至少 Cursor、Claude Code 的 skills 目录路径
  • 提供可复制的「对话安装」提示词
  • 原有 clawhub 安装方式仍可用
  • 下载需鉴权场景下命令/链接格式正确

补充说明

  • 后端下载接口:ClawHubV1Controller.downloadGET /download?slug=&version=&tag=
  • 当前前端仅 clawhub:repoGuideMixin.js L1079–1186

Metadata

Metadata

Assignees

Labels

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions