前言¶

日常运维里，查一台机器的状态、重启服务、拉几行日志，往往要在本机开终端、记 IP 和账号，或在文档和脚本之间来回切换。把「连上服务器、执行标准运维动作」写进 Agent 的 Skill，对话里说明目标和主机即可，由 Agent 按固定流程走 SSH 与封装脚本，减少重复敲命令。

下面介绍 SkillHub 上的社区 Skill「服务器连接测试」（坐标 @user_739922d6/server-ops，版本 1.0.0），以及安装方式与典型用法。

这是什么¶

「服务器连接测试」是面向服务器运维操作的 Agent Skill：通过 SSH 连接远程主机，支持启动、停止、重启、状态查询、日志查看等能力；Skill 元数据中还写明适用场景包括日常管理、故障排查、服务维护与批量操作，认证方式为 SSH Key 或密码。

• 出品与维护：社区来源（community），发布者为 user_739922d6
• 分类：it-ops-security
• SkillHub 页面：https://www.skillhub.cn/skills/user_739922d6/server-ops
• 标签：requires_api_key=false（无需额外 API Key）
• 公开数据（以 SkillHub 抓取为准）：评分 100000，下载 968，安装 0

Skill 包内 SKILL.md 的 name 字段为 server-ops，与 SkillHub 展示名「服务器连接测试」并存；安装与引用时使用坐标 @user_739922d6/server-ops。

核心功能¶

以下能力均来自 Skill 包内 SKILL.md 与 scripts/server-ops.py 的说明，经 skillhub install 下载的 1.0.0 包核对。

运行依赖¶

Skill 声明依赖本机二进制：ssh、scp、ssh-keygen。封装脚本为 Python 3，使用 paramiko、scp 库建立连接与传文件；包内未附带 requirements.txt，若直接运行脚本，需自行安装对应 Python 依赖。

单主机操作¶

通过 scripts/server-ops.py 子命令完成：

常用参数包括 --host、--user；服务相关命令需 --service。可与 ~/.ssh/config 中的 Host 别名配合（例如 --host server-prod）。

批量操作¶

支持 servers.txt（每行 主机,用户），使用 batch status、batch restart 等并行处理多台机器。

Agent 侧行为¶

启用 Skill 后，Agent 按 SKILL.md 中的流程组织操作：先确认 SSH 可达，再调用上述命令或等价 SSH 操作；需要细节时可读取包内 references/ 下的 Linux 命令、systemd 与日志路径说明。

安装与启用¶

1、安装 SkillHub CLI（若尚未安装）¶

command -v skillhub && skillhub --version

未安装时可执行官方安装脚本（完整安装含 CLI 与默认 Skill）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

仅安装 CLI：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

2、安装本 Skill 到当前 Agent 的 skills 目录¶

SkillHub 要求安装时指定 --dir，且目录必须是当前 Agent 会扫描的 skills 路径，否则默认装到 ./skills/ 可能无法被识别。

Cursor 常用路径：

skillhub install @user_739922d6/server-ops --dir ~/.cursor/skills/

Claude Code：

skillhub install @user_739922d6/server-ops --dir ~/.claude/skills/

Codex（用户级或项目级二选一）：

skillhub install @user_739922d6/server-ops --dir ~/.codex/skills/
# 或项目下的 .agents/skills/

也可按 SkillHub 页面提示，让 AI 根据 https://skillhub.cn/install/skillhub.md 完成安装，坐标仍为 @user_739922d6/server-ops。

安装成功后，本机会出现类似路径：…/skills/@user_739922d6/server-ops/（具体目录取决于 --dir）。部分 Agent 需重启或重新加载会话后才能加载新 Skill。

典型用法¶

连接与冒烟测试¶

先做密钥分发与连通性检查（Skill 快速开始中的示例）：

ssh-copy-id user@192.168.1.100
ssh user@192.168.1.100 "echo connected"

进入 Skill 安装目录后，用封装脚本查询状态（将 IP、用户换成你的环境）：

cd ~/.cursor/skills/@user_739922d6/server-ops
python scripts/server-ops.py status --host 192.168.1.100 --user admin

服务与日志¶

python scripts/server-ops.py restart --host 192.168.1.100 --user admin --service nginx
python scripts/server-ops.py logs --host 192.168.1.100 --user admin --service nginx --lines 100

在对话中使用¶

在 Cursor 等已启用该 Skill 的客户端中，可用自然语言描述意图，例如「在 192.168.1.100 上查看 nginx 是否在跑并拉最近 50 行错误日志」。Agent 应依据 SKILL.md 选择 status、logs 等步骤，并在失败时对照文档中的错误码说明（如 CONNECTION_FAILED）排查 SSH 与权限问题。

适用场景与注意¶

适合谁

• 需要在 Agent 会话里反复做 SSH 运维、又不想每次手写一长串命令的开发者或运维
• 已具备 SSH 密钥或密码访问权限，希望在对话中统一「查状态 / 启停服务 / 看日志 / 传文件」的团队

限制与注意

• 所有操作落在真实远程主机上，生产环境务必遵守 Skill 文档中的安全建议：优先密钥认证、最小权限、审计与超时；生产访问宜经跳板机。
• 脚本对未知主机密钥使用 AutoAddPolicy()，在严格合规环境中需自行评估是否接受。
• 远程命令与服务管理依赖目标机上的 systemd 等环境；Command not found 等错误需先在远端安装工具或调整路径。
• 公开 SkillHub 数据中的「安装 0」只反映平台统计，不代表本机未安装；以你本机 skillhub install 与 Agent 是否加载为准。

结尾¶

「服务器连接测试」把 SSH 运维动作收敛进标准 Skill 与 server-ops.py 接口，适合在 Cursor、Claude Code、Codex 等支持 Skill 目录的客户端里，用对话驱动状态查询、服务启停和日志查看。获取与更新请以 SkillHub 为准：

• 页面：https://www.skillhub.cn/skills/user_739922d6/server-ops
• API 入口（资料中的官方地址）：https://api.skillhub.cn/user_739922d6/server-ops