onescience-cli

# OneScience CLI 技能 **本技能根目录：** 与当前 `SKILL.md` 同目录。资产路径均按本技能根目录解析，不按当前工作目录猜测。 需要环境检测与远程连接细则时，读取 `./references/cli_rules.md`。 需要可渲染命令模板时，读取 `./references/cli_flow.md`。 ## 1. 职责与边界 本技能是在远端环境执行任意 `onescience` 命令的统一入口。`onescience` 命令需预先安装，本技能不检查或安装 `onescience` 工具。本技能不限制子命令范围，任何 `onescience` 支持的子命令均可透传执行。 **负责：** - 执行 `discover -> precheck（先检查计算节点 → 再检查环境）-> execute` 运行闭环 - 根据命令级别（lightweight/normal/compute）自动选择执行通道 - 轻量命令（help/list/info/config）走快速通道，跳过环境探测与检查 - 消费 `execution_mode`、`access_mode`、`execution_channel`、`hardware_profile` - 连接远端环境（参照 `onescience-installer` 的主机发现与连接方式） - 环境检查：确认当前 shell 在计算节点上、环境已加载 - 调用 `onescience` 命令执行用户请求的子命令 - 返回执行结果与状态 **不负责：** - 安装或修复 OneScience 完整环境（由 `onescience-installer` 负责） - 安装或修复 `onescience` 工具 - 计算节点申请与 SLURM 作业提交（由 `onescience-runtime` 负责） - 修改远端代码、配置或依赖 - 安装系统级组件或驱动 - 深度诊断训练/测试失败的业务原因 - 决定当前命令步骤之外的后续业务 executor 或全局工作流下一阶段 ## 2. 固定阶段 | 阶段 | 触发条件 | 目标 | 关键输出 | |------|----------|------|----------| | `discover` | 每次执行 | 命令级别判定 + 连接远端环境，收集运行目标与环境事实 | `execution_mode`、`hardware_profile`、`remote_access_info`、`command_level` | | `precheck` | 非 lightweight 级别 | 检查环境是否满足运行条件（先计算节点 → 再环境） | `env_ready`、`on_compute_node`、`precheck_outcome` | | `execute` | precheck 通过或 lightweight 快速通道 | 通过 `onescience` 命令执行用户请求的子命令 | `onescience_command`、`execution_state`、`output` | 三阶段按顺序推进，每阶段向用户实时汇报当前步骤。`lightweight` 级别跳过 precheck 直接进入 execute 快速通道。 `precheck` 发现不在计算节点时，交由 `onescience-runtime` 通过 sbatch 提交作业处理。`precheck` 发现环境未加载时，提示调用 `onescience-...