用途
ln-031-vps-host-runtime 是一个 L3 Worker 技能，类别为 0XX Shared / Infrastructure。它用于在单台 VPS 主机上安装、验证或更新所有项目环境共用的共享 VPS 层，包括软件包、${BOT_USER}、Node/nvm、Claude Code、Codex、MCP、市场克隆/插件、Codex 信任条目以及系统级 agent-update 定时器。
主要能力
该技能覆盖以下共享主机运行时表面：
- apt 软件包
- GitHub CLI 和 GitLab CLI
- ${BOT_USER} 的存在性与 SSH 所有权
- AppArmor/bubblewrap 可用性
- ${BOT_USER} 下的 Node 24
- Claude Code 和 Codex CLI
- 可选的 MCP 服务器
- Codex 配置创建与当前 ${PROJECT_DIR} 信任块
- skills 市场克隆与选定插件
- /usr/local/bin/agent-update、agent-update.service、agent-update.timer、/var/lib/agent-update、/var/log/agent-update.log
使用方式
该技能提供三种模式：
- install_or_reconcile：安装缺失的共享主机运行时并更新幂等表面。
- verify_or_update：验证现有主机，应用安全更新，添加当前项目信任块。
- verify_only：仅检测，不做任何变更。
输入包括 mode、VPS 连接、${BOT_USER}、${PROJECT_DIR}、${AGENT_SKILLS_*}、选定插件、可选的 dry_run、可选的 runId、可选的 summaryArtifactPath。输出为 vps-host-runtime 摘要，包含状态、变更、警告、阻塞项、验证和工件路径。如果提供了 summaryArtifactPath，则将相同的摘要 JSON 写入该路径；如果未提供，则内联返回摘要并写入独立的运行范围路径。当 runId 缺失时，生成独立的 run_id。
工作流分为五个阶段：
- 预检：验证渲染变量、SSH 访问、root 权限和 dry_run 门控。证据包括 SSH 连接结果、主机操作系统、选定模式、缺失变量。
- 基础主机：使用 vps_base_install.md，负责 apt 软件包、GitHub CLI 和 GitLab CLI、${BOT_USER} 存在性与 SSH 所有权、AppArmor/bubblewrap 可用性。verify_only 报告漂移和计划命令，但不运行安装程序。
- 代理运行时：使用 agent_runtime_install.md，负责 ${BOT_USER} 下的 Node 24、Claude Code 和 Codex CLI、可选 MCP 服务器、Codex 配置创建与当前 ${PROJECT_DIR} 信任块、skills 市场克隆与选定插件。不覆盖现有认证文件。缺少 claude 或 codex 登录是阻塞项或警告，而不是自动伪造成功。
- 共享更新器：安装或验证 /usr/local/bin/agent-update、agent-update.service、agent-update.timer、/var/lib/agent-update、/var/log/agent-update.log。仅在模式要求且对主机安全时进行冒烟运行。
- 摘要：写入 vps-host-runtime 摘要工件，包含已安装/已更新/已跳过的表面、软件包和 CLI 版本、认证健康、市场/插件健康、当前项目信任块状态、阻塞项和警告。
适用场景
适用于需要在单台 VPS 主机上为 Claude Code、Codex、MCP 和市场插件安装、验证或更新共享 VPS 主机运行时的场景。
限制
- 同一 VPS 上可安全重复运行。
- 现有共享认证永不覆盖。
- 现有项目环境不会重启，除非通过文档化的更新器行为。
- dry_run=true 和 verify_only 不修改远程状态。
- 可选插件需要显式选择；默认为 agile-workflow。
- 文件路径（shared/、../ln-030-vps-bootstrap/references/）相对于 skills 仓库根目录。如果不在当前工作目录找到，则定位此 SKILL.md 目录并向上移动一级以找到仓库根目录。
- 必须阅读 shared/references/worker_runtime_contract.md、shared/references/coordinator_summary_contract.md、shared/references/vps_runtime_contract.md、../ln-030-vps-bootstrap/references/scope_layers.md、../ln-030-vps-bootstrap/references/vps_base_install.md、../ln-030-vps-bootstrap/references/agent_runtime_install.md、../ln-030-vps-bootstrap/references/substitution_rules.md。
完成定义
- 必需输入和 SSH/root 访问已验证或报告为阻塞项。
- 基础软件包和平台 CLI 已安装、更新或验证。
- ${BOT_USER} 存在，具有预期的 SSH 所有权和登录 shell。
- Node、Claude Code 和 Codex 版本在 ${BOT_USER} 下已验证。
- 当前 ${PROJECT_DIR} Codex 信任块存在或报告为计划漂移。
- 市场克隆和选定插件已验证。
- agent-update.service 和 agent-update.timer 已安装或验证。
- dry_run=true / verify_only 未执行任何变更。
- 已写入结构化的 vps-host-runtime 摘要工件。
版本：1.0.0，最后更新：2026-05-05。