union-skills Skill 技能

技能简介

union-skills 是一套为 Union.ai 打造的 Agent Skills 合集，共包含 5 个 Agent Skill 与 2 个 MCP 服务器（flyte-docs、flyte-cluster），面向各类 Agent 运行框架打包分发。这一套技能会同时引导「Agent」和「人」一起完成 Union.ai 的自助式部署：从在 AWS 上置备 EKS、S3、ECR 与 IAM，到连接集群、在本地运行受追踪的工作流，再到调试一个起不来的数据面。

它的一大设计原则是安全可控：每一条会创建云资源的命令都是一个显式的审批关卡，每一个必须在终端与 Union.ai 界面之间传递的值都被标记为「人工交接点」，从而让自动化与人机协作边界清晰。

核心能力

• 全套自助部署引导：覆盖在 AWS 上端到端置备 EKS、S3、ECR 与 IAM 的完整流程，Agent 与用户逐步协作完成。
• 集群连接与工作流运行：指导用户连接自己的集群，并在本地运行受追踪的工作流。
• 数据面健康诊断：提供针对「起不来的数据面」的调试技能，帮助定位与修复部署问题。
• 双 MCP 服务器：内置 flyte-docs（把搜索查询发往 Union 运营的端点）与 flyte-cluster（获取用户 Union.ai 组织的控制面访问权限）两个可被 Agent 调用的工具型服务器。
• 多框架自动安装：CLI 自动探测本机已装配的 Agent 框架，并把技能复制进各自的 skills 目录。
• 审批关卡设计：所有创建云资源的命令都是显式审批点，杜绝 Agent 擅自变更云环境。
• 跨框架标准路径：支持 ~/.agents/skills/ 这一跨框架标准位置，供 Codex、Hermes 等遵循该约定的框架读取。
• 一行安装与卸载：安装与卸载均为一条命令，支持 --dry-run 预演。

安装配置

1. 一行安装（推荐）：执行 uvx union-skills install，CLI 会自动探测本机已装配的框架并复制技能。
2. pip 安装后安装技能：执行 pip install union-skills，然后运行 union-skills install。
3. 指定目标框架：用 --target 指定，例如 union-skills install --target claude --target hermes；各框架目录分别为 ~/.claude/skills/（Claude Code）、~/.hermes/skills/（Hermes）、~/.config/opencode/skills/（opencode）、~/.pi/agent/skills/（pi）、~/.agents/skills/（跨框架标准位置）。
4. 项目级安装：加 --project 装到当前仓库；或 --dir ./somewhere/skills 装到任意目录；--dry-run 先看会改什么。
5. 安装 MCP 服务器：union-skills mcp install 会通过 claude mcp add-json / codex mcp add 添加两个 MCP 服务器，因此 PATH 中需要有对应 CLI；也可先 --dry-run 预演，union-skills mcp uninstall 卸载。

使用步骤

1. 安装技能：运行 uvx union-skills install，让它自动探测并把 5 个技能复制到各框架目录。
2. 确认技能清单：运行 union-skills list 查看打包的技能，union-skills path 打印插件根目录。
3. （可选）安装 MCP 服务器：运行 union-skills mcp install 添加 flyte-docs 与 flyte-cluster，注意 flyte-cluster 需要 uv 并登录 Union.ai。
4. 启动自助部署引导：在 Agent 中触发 Union.ai 自助部署技能，按引导逐条执行置备命令，每条云资源创建命令都需你显式批准。
5. 连接集群并运行工作流：按技能引导连接你的集群，并在本地运行受追踪的工作流。
6. 诊断数据面问题：若数据面起不来，调用对应的调试技能定位问题；完成后可用 union-skills uninstall 卸载。

适用场景

• 首次在 AWS 上部署 Union.ai：希望有引导式、可审批的自助部署流程，而不是对照文档手动敲命令。
• 配置新集群并跑通首个工作流：从连接集群到本地运行受追踪工作流的完整入门。
• 排查数据面启动失败：数据面起不来时，用专门的调试技能快速定位。
• 在多种 Agent 框架间统一技能：同时在 Claude Code、Hermes、opencode、pi 等框架中复用同一套技能。
• 让 Agent 获取 Flyte 文档与集群控制面：通过 flyte-docs 与 flyte-cluster 两个 MCP 服务器为 Agent 提供文档检索与集群访问能力。

适用人群

在 AWS 上部署与运维 Union.ai / Flyte 的平台工程师与数据基础设施团队；使用 Claude Code、Codex、Hermes、opencode、pi 等多种 Agent 框架的开发者；以及希望在云资源变更上保留人工审批关卡的运维与安全负责人。

工作原理

union-skills 以 Agent Skills 规范组织内容，每个技能是一份可被 Agent 读取与执行的指令集合。union-skills install 会先读取本机环境，判断装了哪些框架，再把技能复制进对应框架的 skills 目录；安装过程把「创建云资源」的每条命令设为显式审批关卡，把需要在终端与 Union.ai 界面之间传递的值标为人工交接点，从而在自动化推进与人工把关之间取得平衡。两个 MCP 服务器则是 Agent 可调用的「工具」而非静态说明：flyte-docs 把搜索查询转发到 Union 运营的端点，flyte-cluster 通过控制面访问你的 Union.ai 组织（需要 uv 与登录）。由于 Union.ai 与开源 Flyte 使用同一套 SDK 与 CLI，这两个服务器因此沿用了 flyte 命名。

官方链接

• PyPI 主页：https://pypi.org/project/union-skills/
• GitHub 仓库：https://github.com/unionai-oss/union-skills