onescience-runsite

输入获取方式

本技能支持两种输入方式：

1. 上下文 handoff（默认）：从调用方传入的 step_handoff 获取任务信息。
2. 文件 handoff（autonomous_mode）：从 .onescience/handoff/step_{step_id}.yaml 读取任务信息。执行后，将结果写入 .onescience/handoff/step_{step_id}_result.yaml。

启动时优先检查 .onescience/handoff/ 目录是否存在对应的交接文件；若存在则使用文件模式，否则使用上下文模式。

文件交接格式参见 skills/onescience-orchestrator/references/file_handoff_contract.md。

OneScience 运行站点

onescience-runsite 是独立的配置工作流。它只负责把用户的运行位置、调度方式、接入方式、账号信息和资源提示整理成项目根目录的 onescience.json，然后把交接信息交回调用它的技能；若没有明确调用方，交回 onescience-orchestrator 让其规划下一步。

先读哪个

强制先读 references/runsite_interaction_flow.md，并按其中的分支顺序推进。不要一次性并行读取所有参考文件，也不要在没有命中分支前加载本地、远程、检查和契约等全部文档。

执行顺序必须是：

1. 先检查 ./onescience.json。
2. 按 runsite_interaction_flow.md 判断分支：存在且完整、存在但不完整、不存在。
3. 只读取当前分支需要的一个工作流文件。
4. 若当前分支还需要字段含义或交接格式，再读取 runsite_contract.md。

任务	读取
入口顺序、分支判断、中文补问顺序	references/runsite_interaction_flow.md
职责边界、字段含义、交接格式	references/runsite_contract.md
检查、复用或修改已有 onescience.json	references/check_existing_config.md
创建本地配置	references/local_runsite.md
创建远程配置，包含 SSH 或 SCnet	references/remote_runsite.md

补问硬规则

预配置免交互（Autonomous Mode）

当上游 step_handoff.execution_flags.autonomous_mode 为 true 时：

1. 若 onescience.json 已存在且完整，直接验证并使用，不触发任何补问流程。
2. 若 onescience.json 缺失或不完整，按以下优先级自动处理：
   • 检测本地环境（GPU/CUDA、conda 等）是否可用 → 自动生成本地配置（run_site=local），不向用户提问。
   • 若本地不支持但存在 .onescience/default_remote.json 预配置文件 → 读取并使用。
   • 若必须使用远程环境但配置信息不完整 → 返回 status: blocked 并输出缺失字段清单（不进入逐字段补问流程）。
3. 禁止在 autonomous_mode 下向用户发起任何交互式提问。

标准补问规则（默认模式）

• 不允许只说“请提供 SSH 信息”“请提供 SCnet 信息”“请提供 cluster 信息”。
• 需要用户提供信息时，必须逐一列出字段名、含义、是否可留空或默认值。
• 可以逐字段一问一答，也可以给出一个字段清单让用户一次性填写；但字段清单必须完整。
• 远程配置必须分阶段补问：先让用户在 SSH 和 SCnet 中选择一种接入方式；用户选定后，立刻只补问该接入方式的连接信息并完成连接验证；连接信息完成后，才询问是否使用 Slurm。
• 远程执行必须补齐 SSH 信息；如果用户选择 SCnet，先补问 SCnet 连接字段并验证登录，再补问 SSH 连接字段并验证 SSH，然后才询问是否使用 Slurm。
• 如果用户选择 SCnet，只能先补问 SCnet 连接字段；不要同时补问 SSH 字段或 Slurm 集群资源字段。SCnet 验证完成后，再单独补问 SSH 字段。
• 如果用户选择 SSH，只能先补问 SSH 连接字段；不要同时补问 Slurm 集群资源字段。
• 只有用户明确选择使用 Slurm 后，才补问 Slurm 集群资源字段。
• 已有 onescience.json 不完整时，必须先根据 run_site、execution_mode、access_mode 判断哪些配置块是必填，再只补问这些必填块中缺失的字段；补问时仍必须列出每个缺失字段。
• 远程连接验证失败后，要求用户重新提交信息时，也必须列出对应接入方式需要重新提供的字段。
• 只要 run_site=remote，都必须校验并补齐 SSH 字段：host/别名、hostname、port、user、identity_file、remote_work_dir。
• 只要 run_site=remote 且 access_mode=scnet，都必须额外校验并补齐 SCnet 字段：SCNET_ACCESS_KEY、SCNET_SECRET_KEY、SCNET_USER、region、remote_work_dir。
• 只要 execution_mode=slurm，都必须校验并补齐 Slurm 字段：partition、nodes、gpus_per_node、cpus_per_task、memory、time_limit、gpu_type、ntasks_per_node。
• 用户提供完整运行信息后，必须检测对应运行平台加速器类型：本地直接/本地 Slurm 检测本机；远程 SSH 直接/远程 SSH Slurm 通过已验证 SSH Host 别名检测远程。若未检测出，先询问用户确认 dcu 还是 gpu，再生成配置。