问题陈述
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 获取/安装方式,至少包含:
- 直接下载 Zip:展示
/download API 的 curl/wget 命令或页面下载按钮;用户解压后手动放入 Agent skills 目录
- 对话安装:提供可复制的安装提示词,用户发给 AI 助手(Cursor、Claude 等)自动完成安装
- 命令行安装(可选):除 clawhub 外,展示基于 registry URL 的通用安装命令(若平台有独立 CLI 可后续扩展)
保留现有 clawhub 方式作为兼容选项,不强制移除。
用户故事
- 作为 Skill 使用者,我希望在仓库页面直接下载 Skill Zip 包,以便在不安装 clawhub 的环境下离线安装。
- 作为 Skill 使用者,我希望看到将 Zip 解压到各 Agent skills 目录(Cursor、Claude Code 等)的说明,以便正确完成手动安装。
- 作为 Skill 使用者,我希望复制一段提示词给 AI 助手即可完成安装,以便无需了解命令行操作。
- 作为仓库管理员,我希望前端安装指引覆盖多种路径,以便不同技术背景的用户都能使用 Skill 仓库。
实现决策
- 新增或修改模块:
src/frontend/core/devops-repository/src/views/repoCommon/repoGuideMixin.js(skillGuide、skillInstall)
- 包详情页安装区域(若与 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 安装方式
验收标准
补充说明
- 后端下载接口:
ClawHubV1Controller.download → GET /download?slug=&version=&tag=
- 当前前端仅 clawhub:
repoGuideMixin.js L1079–1186
问题陈述
Skill 仓库前端「使用指引」与包详情页的安装说明目前仅展示
clawhub v0.11.0CLI 方式(npm i -g clawhub+clawhub install)。用户若无法或不愿安装 Node.js/npm 及 clawhub,则无法从 UI 获知如何获取 Skill 制品。后端已实现 ClawHub v1
/download接口(按 slug/version 下载 zip),但前端未提供对应的直接下载入口与安装说明。Skill 仓库应像主流 Skill 商店一样,提供多种获取/安装路径,降低使用门槛。目标方案
在 Skill 仓库前端补充多种 Skill 获取/安装方式,至少包含:
/downloadAPI 的 curl/wget 命令或页面下载按钮;用户解压后手动放入 Agent skills 目录保留现有 clawhub 方式作为兼容选项,不强制移除。
用户故事
实现决策
src/frontend/core/devops-repository/src/views/repoCommon/repoGuideMixin.js(skillGuide、skillInstall)GET .../download?slug=&version=接口生成下载 URL/命令测试决策
不在范围内
验收标准
补充说明
ClawHubV1Controller.download→GET /download?slug=&version=&tag=repoGuideMixin.jsL1079–1186