Agent Skills › anybackup-ai/Anybackup › sandbox-cli-overlay

sandbox-cli-overlay

GitHub

用于将 foundation-cli 注入 KWeaver sandbox 镜像。流程包括查询基础镜像、生成覆盖 Dockerfile、构建、离线导出或分发至 K8s 集群、重启 Pod 并验证 CLI 可用性，旨在保持镜像引用稳定。

deploy/deploy_package/.skills/sandbox-cli-overlay/SKILL.md anybackup-ai/Anybackup

Trigger Scenarios

需要将 CLI 工具打包进 Sandbox 镜像 KWeaver 环境镜像更新与分发修复 Sandbox 中缺失 CLI 的问题

Install

npx skills add anybackup-ai/Anybackup --skill sandbox-cli-overlay -g -y

More Options

Non-standard path

npx skills add https://github.com/anybackup-ai/Anybackup/tree/main/deploy/deploy_package/.skills/sandbox-cli-overlay -g -y

Use without installing

npx skills use anybackup-ai/Anybackup@sandbox-cli-overlay

指定 Agent (Claude Code)

npx skills add anybackup-ai/Anybackup --skill sandbox-cli-overlay -a claude-code -g -y

安装 repo 全部 skill

npx skills add anybackup-ai/Anybackup --all -g -y

预览 repo 内 skill

npx skills add anybackup-ai/Anybackup --list

SKILL.md

Frontmatter

{
    "name": "sandbox-cli-overlay",
    "description": "处理 `foundation-cli` 注入 KWeaver sandbox 镜像的完整流程。用于查询基础镜像、生成覆盖 Dockerfile、同 tag 构建、镜像离线导出或分发到目标 Kubernetes 集群、重启 sandbox pod、以及验证镜像里是否包含 CLI。"
}

Sandbox CLI Overlay

Overview

这个 skill 只解决一件事：让 KWeaver sandbox 运行的镜像里稳定带上 foundation-cli，并且尽量不改数据库里的镜像引用。

Default Workflow

先查当前 sandbox 模板实际使用的基础镜像。
查不到时，才退回显式变量，例如 sandbox_base_image。
基于当前基础镜像生成 Dockerfile：
- FROM <base-image>
- COPY foundation-cli /usr/local/bin/foundation-cli
优先采用“同名同 tag 覆盖”策略。
构建后执行镜像分发：
- 需要离线交付时，先 docker save
- 再按现场 k8s 集群实际方式导入节点运行时或推送到私有镜像仓库
重启 sandbox 相关 pod，让新镜像真正被拉起。

Guardrails

优先保留数据库中的镜像引用不变。
不要在没记录原镜像地址的情况下直接覆盖。
foundation-cli 的来源默认是发布包里的 bin/foundation-cli。
如果现场明确要求新 tag 策略，再改数据库或 runtime 配置；否则默认不要主动换 tag。
默认按标准 k8s 处理，不要先入为主使用 k3s ctr images import；只有用户明确说明现场是 k3s，才用 k3s 专属命令。