labring/sealos-skills

Sealos Skills

从你的 AI agent 将项目部署到 Sealos Cloud。

Sealos Skills 是一个以插件为先的技能包，专注于 Sealos Cloud 的开发和部署。它帮助 AI agent 检查项目、准备缺失的部署产物、连接 Sealos Cloud 数据库和对象存储用于开发、构建或复用容器镜像、将应用发布到 Sealos Cloud，并在本地只读画布中查看已部署的资源。

推荐的 Codex 路径是原生 Codex 插件安装。跨主机插件安装、skills.sh 以及仅上下文的扩展主机（如 Gemini CLI 和 Qwen Code）都使用相同的根 skills/* 源。

快速开始

推荐：在 Codex 中安装

将此仓库添加为 Codex marketplace，然后安装 Sealos 插件：

codex plugin marketplace add labring/sealos-skills
codex plugin add sealos@sealos

一次 Sealos 插件安装即可从根 skills/ 安装 deploy、database、S3、canvas、app-builder 以及配套的云原生技能：sealos-deploy、sealos-database、sealos-s3、sealos-canvas、sealos-app-builder、cloud-native-readiness、dockerfile-skill 和 docker-to-sealos。

为了兼容性和本地 Codex 测试，使用以下命令安装相同的插件：

npx plugins add https://github.com/labring/sealos-skills --target codex

在 Codex 中安装后，从 Codex 使用该插件：

- Codex CLI： 输入 $sealos
- Codex App： 点击聊天输入框左下角的 + 按钮，选择 Plugins，然后选择 Sealos

在 Codex App 中选择 Sealos 插件

Codex 示例：

$sealos deploy this repo to Sealos Cloud
$sealos deploy /path/to/project
$sealos deploy https://github.com/labring-sigs/kite
$sealos create a cloud Postgres database for this repo and wire DATABASE_URL
$sealos create private S3 object storage for uploads and wire env vars

在 Claude Code 中安装

将此仓库添加为 Claude Code marketplace，然后安装 Sealos 插件：

claude plugin marketplace add labring/sealos-skills
claude plugin install sealos@sealos

为了与跨主机插件安装器兼容，使用以下命令安装相同的插件：

npx plugins add https://github.com/labring/sealos-skills --target claude-code

如果你在机器上只使用一个检测到的 agent 工具，可以让 plugins 选择目标：

npx plugins add https://github.com/labring/sealos-skills
在 Claude Code 中安装后，使用 /sealos：

/sealos deploy this repo to Sealos Cloud
/sealos deploy /path/to/project
/sealos deploy https://github.com/labring-sigs/kite
/sealos create a cloud Postgres database for this repo and wire DATABASE_URL
/sealos create private S3 object storage for uploads and wire env vars

在 Qoder 中测试

从仓库根目录构建 Qoder 插件包：

python3 scripts/package-qoder-plugin.py

将 dist/sealos-1.2.5.zip 导入 Qoder。该包暴露了与 Codex 插件相同的八个根级技能，并提供 /sealos 作为其命令入口点。

Qoder 示例：

/sealos deploy this repo to Sealos Cloud
/sealos create a cloud Postgres database for this repo and wire DATABASE_URL
/sealos create private S3 object storage for uploads and wire env vars
/sealos show the resources created by the last deployment

在 DeepSeek Harness 中安装

此仓库是基于相同根 skills/ 源的 dsh profile 包。在 npx @deepseek-ai/dsh web 正常工作后，将其安装到相同的 web profile 中（pnpm 必须在 PATH 上）：

npx @deepseek-ai/dsh plugin --profile web add github:labring/sealos-skills
npx @deepseek-ai/dsh web

本地检出：

npx @deepseek-ai/dsh plugin --profile web add /path/to/sealos-skills

八个根技能会出现在会话技能目录中。让 agent 部署到 Sealos Cloud；它会通过 skill 工具加载 sealos-deploy（以及所需的同级技能），然后通过 bash 运行 kubectl / sealos-cli。

默认 bash 沙箱会阻止对工作区之外的写入。登录会写入 ~/.sealos/kubeconfig，因此这些命令需要 sandbox_permissions: danger-full-access。

其他支持的 AI 工具

| 工具 | 安装 | 用法 |
| --- | --- | --- |
| Codex CLI / Codex App | codex plugin marketplace add labring/sealos-skills 然后 codex plugin add sealos@sealos | 在 Codex CLI 中使用 $sealos，或在 Codex App 中使用 + → Plugins → Sealos |
| Claude Code | claude plugin marketplace add labring/sealos-skills 然后 claude plugin install sealos@sealos | /sealos |
| Claude Code 兼容路径 | npx plugins add https://github.com/labring/sealos-skills --target claude-code | /sealos |
| Qoder | 使用 python3 scripts/package-qoder-plugin.py 构建，然后导入 ZIP | /sealos 或自动技能选择 |
| DeepSeek Harness | npx @deepseek-ai/dsh plugin --profile web add github:labring/sealos-skills | 让 agent 使用 Sealos 技能；没有 /sealos 斜杠命令 |
| OpenClaw / ClawHub | clawhub install labring/sealos-skills | 宿主命令暴露取决于 ClawHub 运行时 |
| CodeBuddy | /plugin marketplace add labring/sealos-skills | 宿主命令暴露取决于 CodeBuddy 运行时 |
| Gemini CLI | gemini extensions install https://github.com/labring/sealos-skills | 仅上下文扩展；让 Gemini 使用 Sealos Skills |
| Qwen Code | qwen extensions install https://github.com/labring/sealos-skills | 仅上下文扩展；要求 Qwen 使用 Sealos Skills |
| Amp / Kimi / 通用仓库导入器 | 导入 https://github.com/labring/sealos-skills.git | 取决于宿主 |

Gemini CLI 和 Qwen Code 清单通过 CLAUDE.md 提供仓库上下文；它们不声称支持斜杠命令。

替代方案：作为 skills.sh 技能包安装

如果你的 agent 直接使用 skills.sh，请使用以下命令安装同一个技能包：

npx skills add labring/sealos-skills

然后直接运行部署技能：

/sealos-deploy
/sealos-deploy /path/to/project
/sealos-deploy https://github.com/labring-sigs/kite
/sealos-database create a cloud Postgres database for this repo and wire DATABASE_URL
/sealos-s3 create private object storage for uploads and wire env vars

在项目已部署且 .sealos/state.json 包含经过验证的 last_deploy 运行时证据后，通过你安装的插件入口点使用 sealos-canvas 技能，以获得本地只读视图。Canvas 保持由插件包中介，因为它消费经过验证的部署状态。

/sealos-deploy、/sealos-database 和 /sealos-s3 是直接的 skills.sh 技能条目。插件用法应通过 Codex 中的 $sealos 或 Claude Code 中的 /sealos 进行。

为什么使用该插件

对于 Codex、Claude Code 和 Qoder，优先选择插件安装，因为它：

- 将所有 Sealos 技能作为一个受管理的包安装
- 在受支持的 agent 工具中暴露相同的技能
- 将插件元数据、徽标、提示、命令和功能保持在一起
- 避免维护一份单独的打包技能副本

插件分发

Codex 集成遵循 OpenAI 的 Codex 插件构建指南：

- .codex-plugin/plugin.json 包含插件标识、发现元数据、界面文案、默认提示、品牌元数据，以及相对于仓库根目录的资源路径。
- .agents/plugins/marketplace.json 注册此仓库本地插件，用于本地 Codex 市场测试。
- .claude-plugin/plugin.json 和 .claude-plugin/marketplace.json 定义与 Claude Code 兼容的插件接口。
- .qoder-plugin/plugin.json 定义 Qoder 插件接口，并显式暴露全部八个 Codex 技能。
- qoder.md 提供 Qoder 级别的路由和安全说明，而不复制技能实现。
- distribution/platforms.json 记录平台支持声明和证据。
- marketplaces/README.md 负责市场规则，并防止命令支持方面的过度声明。
- scripts/validate-codex-plugin.py 验证 Codex 清单、Claude Code 元数据、仓库市场、平台注册表和资源路径。
- scripts/package-qoder-plugin.py 构建一个与 Qoder 兼容的 ZIP，插件清单位于归档根目录。
- skills//SKILL.md 仍然是唯一的技能来源；不要添加第二份打包的技能副本。
- package.json、cordis.patch.yml 和 index.js 将同一个根技能树注册为 DeepSeek Harness 配置文件包。

在发布或推送清单变更之前，验证插件元数据：

python3 scripts/validate-codex-plugin.py
python3 -m json.tool .codex-plugin/plugin.json >/dev/null
python3 -m json.tool plugin.json >/dev/null
python3 -m json.tool .agents/plugins/marketplace.json >/dev/null
python3 -m json.tool marketplace.json >/dev/null
python3 -m json.tool .claude-plugin/plugin.json >/dev/null
python3 -m json.tool .claude-plugin/marketplace.json >/dev/null
python3 -m json.tool .qoder-plugin/plugin.json >/dev/null
python3 -m json.tool distribution/platforms.json >/dev/null

设置的工作原理

你只需要一个兼容插件或兼容 skills.sh 的 AI 代理，以及一个要部署的项目。

在部署、数据库和对象存储流程中，Sealos Skills 将：

- 检查 Docker 和 kubectl 等工具是否可用
- 在需要时引导用户完成 Sealos 登录
- 使用 sealos-cli 进行 Sealos Cloud 数据库创建、连接详情和数据库操作
- 使用 sealos-cli s3 进行 Sealos 对象存储桶、凭证、配额检查、对象操作和预签名 URL
- 使用或帮助准备容器镜像仓库路径，例如 Docker Hub 或 GHCR

对于实际部署，你仍然需要一个 Sealos Cloud 账户以及对容器镜像仓库的访问权限，但这些不需要在技能启动前完全设置好。对于数据库和对象存储工作，你需要一个 Sealos Cloud 账户以及一个可以创建所需资源的工作区。

Sealos Deploy 处理的内容

在典型部署中，代理将：

- 评估项目结构和运行时需求
- 复用现有镜像或在需要时构建一个
- 生成 Sealos 模板
- 部署并验证上线
- 在报告应用可用之前，验证实际的 Sealos App URL、日志、Web 应用的登录/设置流程以及资源占用情况

当检测到现有部署时，后续运行可以切换到就地更新流程。

Sealos Database 处理的内容

对于需要云数据库的本地项目或 Devbox，代理将：

- 检测数据库信号，例如 DATABASE_URL、Prisma、Drizzle、MongoDB、MySQL 或 Redis
- 使用 sealos-cli database 列出、创建、检查并连接 Sealos Cloud 数据库
- 仅写入所需的本地环境变量键，而不在聊天中暴露机密
- 通过迁移、内省或启动检查验证应用的真实数据库路径
- 仅在确认后管理公共访问

Sealos S3 处理的内容

对于需要 S3 兼容对象存储的本地项目或 Devbox，代理将：

- 检测对象存储信号，例如 S3 环境变量键、AWS SDK 使用、MinIO、上传路径或预签名 URL 代码
- 使用来自 zjy365/sealos-cli#28 的 sealos-cli s3 列出、创建、检查并更新对象存储桶
- 仅在需要时初始化 S3 凭证，并将访问密钥排除在聊天之外
- 为 bucket、endpoint、access key、secret key、region 和 path-style 设置接入所需的最小本地环境变量键
- 使用项目的真实存储路径验证上传、列出、下载、删除或预签名 URL 行为
- 仅在确认后才将 bucket 设为公开或轮换凭证

Sealos Canvas 处理的内容

对于已由 Sealos Deploy 部署的仓库，agent 将：

1. 读取 .sealos/state.json 以定位已部署的应用。
2. 使用只读的 kubectl get 命令查询 Sealos 命名空间。
3. 启动一个临时的 127.0.0.1 canvas UI。
4. 输出并打开本地 UI 地址以供检查。

如果项目尚未部署，Sealos Canvas 会停止并引导用户先部署项目。

包含的技能

该插件和 skills.sh 包暴露相同的技能源：

- sealos-deploy — 将本地或 GitHub 项目部署到 Sealos Cloud
- sealos-database — 为开发创建、连接和操作 Sealos Cloud 数据库
- sealos-s3 — 创建 bucket、连接凭证、检查配额，以及操作 Sealos S3 兼容对象存储
- sealos-canvas — 在本地只读 canvas UI 中查看已部署的 Sealos 资源
- sealos-app-builder — 通过 SDK 集成构建 Sealos Desktop 应用
- cloud-native-readiness — 评估部署就绪情况
- dockerfile-skill — 生成生产就绪的 Dockerfile
- docker-to-sealos — 将 Docker Compose 服务转换为 Sealos 模板

仓库

skills/ 是 Sealos deploy、Sealos canvas 以及部署流程中使用的支持性技能的唯一事实来源。同一个根级 skills 目录服务于 skills.sh 安装以及本仓库中的每个插件或扩展清单。

重要的分发文件：

- .codex-plugin/plugin.json — Codex 插件清单
- .agents/plugins/marketplace.json — 本地 Codex 市场条目
- .claude-plugin/plugin.json — 兼容 Claude Code 的插件清单
- .qoder-plugin/plugin.json — Qoder 插件清单
- qoder.md — Qoder 插件路由和安全说明
- marketplace.json 和 .claude-plugin/marketplace.json — 兼容 Claude 的市场条目
- .codebuddy-plugin/marketplace.json — CodeBuddy 市场条目
- gemini-extension.json — Gemini CLI 上下文扩展
- qwen-extension.json — Qwen Code 上下文扩展
- openclaw.plugin.json — OpenClaw / ClawHub 包指针
- package.json、cordis.patch.yml 和 index.js — DeepSeek Harness 配置文件包；在 ctx.skills 上注册根 skills/
- commands/sealos.md — 兼容宿主机的 /sealos 插件命令入口
- distribution/platforms.json — 平台支持注册表
- marketplaces/README.md — 市场规则与支持声明归属
- scripts/validate-codex-plugin.py — Codex 插件验证
- scripts/package-qoder-plugin.py — Qoder ZIP 打包工具

不要添加第二份打包的技能副本。根目录 skills/* 是所有安装路径的唯一技能来源。

许可证

MIT