@delta-infra/cli 1.0.75 → 1.0.77

package/skills/delta-shared/SKILL.md

@@ -1,95 +1,95 @@
----
-name: delta-shared
-description: "delta-cli 全局共享规则：配置/认证检查、安全红线、错误处理、sandbox 销毁。"
----
-
-# delta-cli 共享规则
-
-指导 AI 使用 `delta-cli` 的通用规则。核心原则：**只检查、不猜测、不泄露密钥**。
-
-## 执行任何操作之前
-
-1. 确认服务端地址：
-   ```bash
-   delta-cli config show
-   ```
-2. 确认认证状态：
-   ```bash
-   delta-cli auth status
-   ```
-
-- 若 `auth status` 显示 `method: token`，**直接执行目标命令**，不要重复登录或初始化配置。
-- 若显示 `method: none`，或操作返回 `error.type: auth` / `permission`，才进入下面的“补全配置”流程。
-
-## 补全配置
-
-缺少服务端地址或凭证时，**向用户询问一次**，然后用 flag 初始化：
-
-```bash
-delta-cli config init --base-url <server-url> --token <token>
-```
-
-不要用交互式 `config init`（无 flag），避免在 stdin 不可用时卡住。
-
-### 信息来源优先级
-
-1. 环境变量：`DELTA_INFRA_BASE_URL`、`DELTA_INFRA_TOKEN`
-2. `~/.delta-infra/config.json` 中的 `base_url` / `token`
-3. 默认值：仅 `base_url` 有内部默认值
-4. 以上都缺失时，**必须询问用户**，禁止虚构
-
-### 运行时凭证
-
-CLI 使用 `token` 发送请求头 `Authorization: Bearer <token>`，并自动从 JWT 中提取 `uid` 作为 `X-User-Uid`。
-
-## 安全红线
-
-- **禁止输出密钥**：`token` 不得出现在日志、消息、终端。
-- **禁止自己拼 URL / 构造 HTTP 请求**：所有请求都走 `delta-cli`。
-- **不要主动安装 CLI**：如果用户说没装，建议他去 README 或 install.sh，不要自己选安装方式。
-- **写入/删除操作前确认意图**：`sandbox kill`、`sandbox finish`、`sandbox write` 等必须告诉用户影响。
-- `~/.delta-infra/config.json` 权限为 `0600`，不要手动放宽。
-- **sandbox 必须销毁**：调用 `sandbox create` 后，当前任务结束前必须调用 `sandbox kill`。server 端无自动清理，不销毁 = 永久占用 GPU；即使出错也不得跳过。
-
-## JSON 输出约定
-
-```json
-{"ok":true,"data":{...}}
-{"ok":false,"error":{"type":"auth","message":"...","hint":"..."}}
-```
-
-AI Agent 解析规则：
-- 始终检查 `ok`，不要只看 exit code。
-- `error.type` 是稳定分支字段：`auth`, `permission`, `not_found`, `validation`, `network`, `api`, `internal`。
-- `error.hint` 可展示给用户。
-
-## 退出码约定
-
-| Type | Exit Code | 场景 |
-|------|-----------|------|
-| validation | 2 | flag / 参数错误 |
-| auth | 3 | 未认证或认证失败 |
-| permission | 4 | 权限不足 |
-| not_found | 5 | sandbox/file 不存在 |
-| network | 6 | DNS、超时、连接失败 |
-| api | 7 | 服务端非 2xx |
-| internal | 10 | 客户端内部错误 |
-
-## 升级检查
-
-完成用户请求后，如果 JSON 中有 `_notice.update`，可建议：
-
-```bash
-delta-cli upgrade
-```
-
-## 常见恢复
-
-| 错误 / 现象 | 恢复动作 |
-|-------------|----------|
-| `error.type: auth` / `method: none` | 询问用户后执行 `config init --base-url <url> --token <token>` |
-| `error.type: permission` | 确认当前认证是否有权限；必要时换 token |
-| `error.type: not_found` | 检查 `sandbox_id` / path |
-| `error.type: network` | 检查 `base_url` 和网络连通性 |
-| `error.type: validation` | 检查必填 flag 和参数格式 |
-| 配置文件解析失败 | 检查 `~/.delta-infra/config.json` 是否为有效 JSON |
+---
+name: delta-shared
+description: "delta-cli 全局共享规则：配置/认证检查、安全红线、错误处理、sandbox 销毁。"
+---
+
+# delta-cli 共享规则
+
+指导 AI 使用 `delta-cli` 的通用规则。核心原则：**只检查、不猜测、不泄露密钥**。
+
+## 执行任何操作之前
+
+1. 确认服务端地址：
+   ```bash
+   delta-cli config show
+   ```
+2. 确认认证状态：
+   ```bash
+   delta-cli auth status
+   ```
+
+- 若 `auth status` 显示 `method: token`，**直接执行目标命令**，不要重复登录或初始化配置。
+- 若显示 `method: none`，或操作返回 `error.type: auth` / `permission`，才进入下面的“补全配置”流程。
+
+## 补全配置
+
+缺少服务端地址或凭证时，**向用户询问一次**，然后用 flag 初始化：
+
+```bash
+delta-cli config init --base-url <server-url> --token <token>
+```
+
+不要用交互式 `config init`（无 flag），避免在 stdin 不可用时卡住。
+
+### 信息来源优先级
+
+1. 环境变量：`DELTA_INFRA_BASE_URL`、`DELTA_INFRA_TOKEN`
+2. `~/.delta-infra/config.json` 中的 `base_url` / `token`
+3. 默认值：仅 `base_url` 有内部默认值
+4. 以上都缺失时，**必须询问用户**，禁止虚构
+
+### 运行时凭证
+
+CLI 使用 `token` 发送请求头 `Authorization: Bearer <token>`，并自动从 JWT 中提取 `uid` 作为 `X-User-Uid`。
+
+## 安全红线
+
+- **禁止输出密钥**：`token` 不得出现在日志、消息、终端。
+- **禁止自己拼 URL / 构造 HTTP 请求**：所有请求都走 `delta-cli`。
+- **不要主动安装 CLI**：如果用户说没装，建议他去 README 或 install.sh，不要自己选安装方式。
+- **写入/删除操作前确认意图**：`sandbox kill`、`sandbox finish`、`sandbox write` 等必须告诉用户影响。
+- `~/.delta-infra/config.json` 权限为 `0600`，不要手动放宽。
+- **sandbox 必须销毁**：调用 `sandbox create` 后，当前任务结束前必须调用 `sandbox kill`。server 端无自动清理，不销毁 = 永久占用 GPU；即使出错也不得跳过。
+
+## JSON 输出约定
+
+```json
+{"ok":true,"data":{...}}
+{"ok":false,"error":{"type":"auth","message":"...","hint":"..."}}
+```
+
+AI Agent 解析规则：
+- 始终检查 `ok`，不要只看 exit code。
+- `error.type` 是稳定分支字段：`auth`, `permission`, `not_found`, `validation`, `network`, `api`, `internal`。
+- `error.hint` 可展示给用户。
+
+## 退出码约定
+
+| Type | Exit Code | 场景 |
+|------|-----------|------|
+| validation | 2 | flag / 参数错误 |
+| auth | 3 | 未认证或认证失败 |
+| permission | 4 | 权限不足 |
+| not_found | 5 | sandbox/file 不存在 |
+| network | 6 | DNS、超时、连接失败 |
+| api | 7 | 服务端非 2xx |
+| internal | 10 | 客户端内部错误 |
+
+## 升级检查
+
+完成用户请求后，如果 JSON 中有 `_notice.update`，可建议：
+
+```bash
+delta-cli upgrade
+```
+
+## 常见恢复
+
+| 错误 / 现象 | 恢复动作 |
+|-------------|----------|
+| `error.type: auth` / `method: none` | 询问用户后执行 `config init --base-url <url> --token <token>` |
+| `error.type: permission` | 确认当前认证是否有权限；必要时换 token |
+| `error.type: not_found` | 检查 `sandbox_id` / path |
+| `error.type: network` | 检查 `base_url` 和网络连通性 |
+| `error.type: validation` | 检查必填 flag 和参数格式 |
+| 配置文件解析失败 | 检查 `~/.delta-infra/config.json` 是否为有效 JSON |

package/skills/delta-shared/agents/openai.yaml

@@ -1,4 +1,4 @@
-interface:
-  display_name: "Delta CLI ?????"
-  short_description: "?? Delta CLI ??????????????????"
-  default_prompt: "?? $delta-shared ???? Delta CLI ????????"
+interface:
+  display_name: "Delta CLI 共享规则"
+  short_description: "处理 Delta CLI 的配置、认证、错误与安全边界"
+  default_prompt: "使用 $delta-shared 检查并处理 Delta CLI 的配置或认证问题。"

package/skills/gsasii/SKILL.md

@@ -1,37 +1,42 @@
----
-name: gsasii
-description: 当用户要求使用真实 CIF 模拟粉末 XRD/中子衍射，或使用真实粉末数据、仪器参数与相模型执行 GSAS-II Rietveld 精修时使用。所有实时请求只走 Delta CLI wrapper；禁止伪造 CIF、粉末数据或仪器文件。
----
-
-# GSAS-II 服务
-
-## 强制规则
-
-- 第一个且唯一实时执行工具是 `python_repl`，通过
-  `$SKILLS_ROOT/delta-science/scripts/invoke.py`，tool=`gsasii`。
-- `python_repl` 工具参数只能包含 `code`，禁止 `deps/dependencies/packages`。
-- 禁止 Bash、目录/路径探测、字面 CLI 命令、直接 HTTP 和本地 GSAS-II。
-- 业务结果直接位于 `r["native"]`，禁止 `native.data`。
-- 输入不是 CIF 时先由 pymatgen 成功转换；精修必须有真实 powder data、真实
-  instrument parameters 和真实 phase CIF，任何失败都不得用合成数据补齐。
-
-## operation 选择
-
-- `health`：明确检查服务状态，无 body。
-- `powder-simulate`：最小有界请求包含 `cif`、`phase_name`、`radiation:"CuKa"`、
-  `t_min/t_max/t_step`、profile/reflection 开关和上限；`t_step` 与 `n_points` 二选一。
-- `powder-refine`：包含 `powder_data`、`powder_format`、
-  `instrument_parameters`、`phases:[{name,cif}]`、`refinement_mode:"rietveld"`、
-  `refinement_steps`、`max_cycles` 和有界输出上限。
-
-完整最小 payload 与字段见同级 `references/endpoints.md`。`pawley`/`lebail` 在当前
-服务未实现时原样报告，不改成 rietveld。长 profile/reflections/project 不在最终答复
-展开，只报告点数、范围、残差、警告和用户要求的有界字段。
-
-## 调用与完成
-
-在一个 `python_repl` 中用 `subprocess.run(..., shell=False)` 调 wrapper，使用
-`--data-json`（health 省略），校验退出码、`ok=true`、`transport="delta-cli"`，
-显式打印从 native 投影的有界 JSON。成功后立即
-`step_finish(status="done", summary=<同一 JSON>)`；失败则 `status="failed"`。
-只调用一次，不调试打印，不自动重试。
+---
+name: gsasii
+description: 当用户要求使用真实 CIF 模拟粉末 XRD/中子衍射，或使用真实粉末数据、仪器参数与相模型执行 GSAS-II Rietveld 精修时使用。所有实时请求只走 Delta CLI wrapper；禁止伪造 CIF、粉末数据或仪器文件。
+metadata:
+  allowed-tools:
+    - read_file
+    - python_repl
+    - step_finish
+---
+
+# GSAS-II 服务
+
+## 强制规则
+
+- 第一个且唯一实时执行工具是 `python_repl`，通过
+  `$SKILLS_ROOT/delta-science/scripts/invoke.py`，tool=`gsasii`。
+- `python_repl` 工具参数只能包含 `code`，禁止 `deps/dependencies/packages`。
+- 禁止 Bash、目录/路径探测、字面 CLI 命令、直接 HTTP 和本地 GSAS-II。
+- 业务结果直接位于 `r["native"]`，禁止 `native.data`。
+- 输入不是 CIF 时先由 pymatgen 成功转换；精修必须有真实 powder data、真实
+  instrument parameters 和真实 phase CIF，任何失败都不得用合成数据补齐。
+
+## operation 选择
+
+- `health`：明确检查服务状态，无 body。
+- `powder-simulate`：最小有界请求包含 `cif`、`phase_name`、`radiation:"CuKa"`、
+  `t_min/t_max/t_step`、profile/reflection 开关和上限；`t_step` 与 `n_points` 二选一。
+- `powder-refine`：包含 `powder_data`、`powder_format`、
+  `instrument_parameters`、`phases:[{name,cif}]`、`refinement_mode:"rietveld"`、
+  `refinement_steps`、`max_cycles` 和有界输出上限。
+
+完整最小 payload 与字段见同级 `references/endpoints.md`。`pawley`/`lebail` 在当前
+服务未实现时原样报告，不改成 rietveld。长 profile/reflections/project 不在最终答复
+展开，只报告点数、范围、残差、警告和用户要求的有界字段。
+
+## 调用与完成
+
+在一个 `python_repl` 中用 `subprocess.run(..., shell=False)` 调 wrapper，使用
+`--data-json`（health 省略），校验退出码、`ok=true`、`transport="delta-cli"`，
+显式打印从 native 投影的有界 JSON。成功后立即
+`step_finish(status="done", summary=<同一 JSON>)`；失败则 `status="failed"`。
+只调用一次，不调试打印，不自动重试。

package/skills/gsasii/agents/openai.yaml

@@ -1,4 +1,4 @@
-interface:
-  display_name: "GSAS-II ????"
-  short_description: "?? Delta CLI ???????????????"
-  default_prompt: "?? $gsasii ??????????????"
+interface:
+  display_name: "GSAS-II 衍射分析"
+  short_description: "通过 Delta CLI 进行粉末衍射模拟或 Rietveld 精修"
+  default_prompt: "使用 $gsasii 完成这项粉末衍射模拟或精修任务。"

package/skills/gsasii/references/endpoints.md

@@ -1,130 +1,130 @@
-# GSAS-II Endpoint Reference
-
-All paths are relative to `http://111.2.199.31:52317/api/v1`.
-
-## Health
-
-`GET /chem/gsasii/health`
-
-Key response fields in `data`: `status`, `service`, `gsasii_available`,
-`metadata`, and `limits`.
-
-Use this before long simulations/refinements. A healthy service should report
-`data.status == "ok"` and `data.gsasii_available == true`.
-
-## Powder Simulation
-
-`POST /chem/gsasii/powder/simulate`
-
-```json
-{
-  "cif": "<CIF text>",
-  "phase_name": "phase",
-  "instrument_parameters": "<GSAS-II instrument parameter text>",
-  "histogram_name": "simulation",
-  "t_min": 10.0,
-  "t_max": 80.0,
-  "t_step": 0.02,
-  "include_profile": true,
-  "max_profile_points": 1000,
-  "include_reflections": true,
-  "max_reflections": 1000,
-  "return_refined_cif": false,
-  "return_project": false
-}
-```
-
-Use either `t_step` or `n_points`, not both. Optional fields include
-`wavelength`, `radiation`, `scale`, `include_profile`, `max_profile_points`,
-`include_reflections`, `max_reflections`, `return_refined_cif`, and
-`return_project`.
-
-The response includes `profile` points with `x`, `y_calc`, optional background,
-bounded `reflections` with hkl/d-spacing/2theta where available, and metadata.
-If `return_project` is true, `project_base64` contains the GSAS-II `.gpx`
-project. If `return_refined_cif` is true, `refined_cif` contains exported CIF
-text for pymatgen handoff when GSAS-II supports export for the phase.
-
-Notes:
-
-- `cif` should be valid CIF text. If the input is POSCAR/JSON/CSSR/XSF, use
-  `/chem/pymatgen/structure/convert` first with `output_format: "cif"`.
-- `instrument_parameters` should be GSAS-II instrument parameter text such as
-  `INST_XRY.PRM` when instrument-specific simulation is needed.
-- For quick simulation only, `instrument_parameters` may be omitted. The service
-  then generates a simple CW X-ray instrument model from `wavelength` or
-  `radiation` (`CuKa` by default; also supports aliases such as `MoKa`, `CoKa`,
-  `CrKa`, and explicit numeric wavelength).
-- Refinement still requires real `instrument_parameters`.
-- `max_profile_points` controls response sampling. Use small values for smoke
-  tests and larger values for profile comparison.
-- Older deployed gateway images may require `max_profile_points >= 10`.
-
-## Powder Refinement
-
-`POST /chem/gsasii/powder/refine`
-
-```json
-{
-  "powder_data": "<two-column or three-column powder data text>",
-  "powder_format": "xy",
-  "instrument_parameters": "<GSAS-II instrument parameter text>",
-  "phases": [
-    {"name": "phase", "cif": "<CIF text>"}
-  ],
-  "refinement_mode": "rietveld",
-  "refinement_steps": [],
-  "max_cycles": 3,
-  "histogram_name": "powder",
-  "include_profile": true,
-  "max_profile_points": 1000,
-  "include_reflections": true,
-  "max_reflections": 1000,
-  "return_refined_cif": false,
-  "return_project": false
-}
-```
-
-Supported `powder_format` values: `xy`, `xye`, `fxye`, `gsas`, and `csv`.
-
-`refinement_mode: "rietveld"` is currently implemented. `pawley` and `lebail`
-return a clear not-implemented response until the service wires the
-mode-specific GSAS-II setup.
-
-The response includes fit `residuals` when available, phase summaries, sampled
-profile points, bounded `reflections`, warnings, optional `refined_cif`, and
-the optional `.gpx` project.
-
-Notes:
-
-- Use `xy` for simple whitespace-delimited `x y` rows, `xye` for `x y esd`,
-  `csv` for numeric comma-separated rows, or `gsas`/`fxye` for GSAS-like powder
-  formats.
-- `max_cycles: 0` is useful for project-construction smoke tests. Increase it
-  only when the powder data, phase model, instrument file, and refinement steps
-  are realistic.
-- `refinement_steps` is passed to `G2Project.do_refinements`. Keep recipes
-  incremental and inspect `warnings`, `residuals`, and `lst` output.
-- Refinement may return `valid: false` with partial phase/profile information
-  if GSAS-II constructed the project but a refinement step failed.
-
-## Recommended Integration Scripts
-
-From this skill's `scripts/` directory:
-
-```bash
-python3 scripts/smoke_gsasii.py
-```
-
-Runs health, PbSO4 powder simulation, and project-return smoke tests.
-
-```bash
-python3 scripts/workflow_pymatgen_gsasii.py
-```
-
-Runs the cross-service workflow:
-
-```text
-pymatgen summary/symmetry -> pymatgen CIF conversion -> GSAS-II simulation
--> profile comparison -> GSAS-II refinement -> pymatgen final check
-```
+# GSAS-II Endpoint Reference
+
+All paths are relative to `http://111.2.199.31:52317/api/v1`.
+
+## Health
+
+`GET /chem/gsasii/health`
+
+Key response fields in `data`: `status`, `service`, `gsasii_available`,
+`metadata`, and `limits`.
+
+Use this before long simulations/refinements. A healthy service should report
+`data.status == "ok"` and `data.gsasii_available == true`.
+
+## Powder Simulation
+
+`POST /chem/gsasii/powder/simulate`
+
+```json
+{
+  "cif": "<CIF text>",
+  "phase_name": "phase",
+  "instrument_parameters": "<GSAS-II instrument parameter text>",
+  "histogram_name": "simulation",
+  "t_min": 10.0,
+  "t_max": 80.0,
+  "t_step": 0.02,
+  "include_profile": true,
+  "max_profile_points": 1000,
+  "include_reflections": true,
+  "max_reflections": 1000,
+  "return_refined_cif": false,
+  "return_project": false
+}
+```
+
+Use either `t_step` or `n_points`, not both. Optional fields include
+`wavelength`, `radiation`, `scale`, `include_profile`, `max_profile_points`,
+`include_reflections`, `max_reflections`, `return_refined_cif`, and
+`return_project`.
+
+The response includes `profile` points with `x`, `y_calc`, optional background,
+bounded `reflections` with hkl/d-spacing/2theta where available, and metadata.
+If `return_project` is true, `project_base64` contains the GSAS-II `.gpx`
+project. If `return_refined_cif` is true, `refined_cif` contains exported CIF
+text for pymatgen handoff when GSAS-II supports export for the phase.
+
+Notes:
+
+- `cif` should be valid CIF text. If the input is POSCAR/JSON/CSSR/XSF, use
+  `/chem/pymatgen/structure/convert` first with `output_format: "cif"`.
+- `instrument_parameters` should be GSAS-II instrument parameter text such as
+  `INST_XRY.PRM` when instrument-specific simulation is needed.
+- For quick simulation only, `instrument_parameters` may be omitted. The service
+  then generates a simple CW X-ray instrument model from `wavelength` or
+  `radiation` (`CuKa` by default; also supports aliases such as `MoKa`, `CoKa`,
+  `CrKa`, and explicit numeric wavelength).
+- Refinement still requires real `instrument_parameters`.
+- `max_profile_points` controls response sampling. Use small values for smoke
+  tests and larger values for profile comparison.
+- Older deployed gateway images may require `max_profile_points >= 10`.
+
+## Powder Refinement
+
+`POST /chem/gsasii/powder/refine`
+
+```json
+{
+  "powder_data": "<two-column or three-column powder data text>",
+  "powder_format": "xy",
+  "instrument_parameters": "<GSAS-II instrument parameter text>",
+  "phases": [
+    {"name": "phase", "cif": "<CIF text>"}
+  ],
+  "refinement_mode": "rietveld",
+  "refinement_steps": [],
+  "max_cycles": 3,
+  "histogram_name": "powder",
+  "include_profile": true,
+  "max_profile_points": 1000,
+  "include_reflections": true,
+  "max_reflections": 1000,
+  "return_refined_cif": false,
+  "return_project": false
+}
+```
+
+Supported `powder_format` values: `xy`, `xye`, `fxye`, `gsas`, and `csv`.
+
+`refinement_mode: "rietveld"` is currently implemented. `pawley` and `lebail`
+return a clear not-implemented response until the service wires the
+mode-specific GSAS-II setup.
+
+The response includes fit `residuals` when available, phase summaries, sampled
+profile points, bounded `reflections`, warnings, optional `refined_cif`, and
+the optional `.gpx` project.
+
+Notes:
+
+- Use `xy` for simple whitespace-delimited `x y` rows, `xye` for `x y esd`,
+  `csv` for numeric comma-separated rows, or `gsas`/`fxye` for GSAS-like powder
+  formats.
+- `max_cycles: 0` is useful for project-construction smoke tests. Increase it
+  only when the powder data, phase model, instrument file, and refinement steps
+  are realistic.
+- `refinement_steps` is passed to `G2Project.do_refinements`. Keep recipes
+  incremental and inspect `warnings`, `residuals`, and `lst` output.
+- Refinement may return `valid: false` with partial phase/profile information
+  if GSAS-II constructed the project but a refinement step failed.
+
+## Recommended Integration Scripts
+
+From this skill's `scripts/` directory:
+
+```bash
+python3 scripts/smoke_gsasii.py
+```
+
+Runs health, PbSO4 powder simulation, and project-return smoke tests.
+
+```bash
+python3 scripts/workflow_pymatgen_gsasii.py
+```
+
+Runs the cross-service workflow:
+
+```text
+pymatgen summary/symmetry -> pymatgen CIF conversion -> GSAS-II simulation
+-> profile comparison -> GSAS-II refinement -> pymatgen final check
+```

package/skills/lammps/SKILL.md

@@ -1,34 +1,39 @@
----
-name: lammps
-description: 当用户要求检查 LAMMPS 服务、运行部署自带的有界 LJ melt 示例，或使用明确的 LAMMPS input/data/force-field 配置执行分子动力学、最小化并读取 thermo/log/dump/data 输出时使用。所有实时调用只走 Delta CLI；成功执行不代表物理收敛或生产可用。
----
-
-# LAMMPS 服务
-
-## 强制规则
-
-- 第一个且唯一实时执行工具是 `python_repl`，通过
-  `$SKILLS_ROOT/delta-science/scripts/invoke.py`，tool=`lammps`。
-- `python_repl` 工具参数只能包含 `code`，禁止 `deps/dependencies/packages`。
-- 禁止 Bash、路径探测、字面 CLI 命令、直接 HTTP、本地 LAMMPS 和本地回归替代。
-- 业务结果是 `r["native"]`，禁止 `native.data` 或把外层 envelope 交给 `run`。
-- LAMMPS 不从化学式、CIF 或 POSCAR 自动推断 data、原子类型、势函数与边界条件。
-
-## operation 选择
-
-- `health`：明确健康检查，无 body。
-- `lj-melt-example`：返回部署自带的精确 `native["request"]`，本身不执行模拟。
-- `run`：只接受前一步已验证的 `native["request"]`，或用户明确提供的
-  `input_script`、相对路径 `files`、timeout 与有界输出设置。
-
-用户说“用最小示例测试 LAMMPS”时，在同一个 `python_repl` 中严格执行两次依赖调用：
-先 `lj-melt-example`，再把其 `request` 原样作为 `run` 的 `--data-json`。不增加 health、
-日志探测或本地可执行文件检查。普通明确 run 只调用一次。
-
-最终只逐字复制当前 native 的 `last_thermo`、final step/temperature/total energy、
-warnings 和用户要求的输出文件摘要。禁止能量除以原子数、换算单位、替换步数或推断
-收敛性/稳定性。详细 run schema 见 `references/endpoints.md`。
-
-显式打印有界 JSON 后立即调用
-`step_finish(status="done", summary=<同一 JSON>)` 恰好一次；失败或 timeout 调用
-`step_finish(status="failed", summary=<原始错误短摘要>)`，禁止重试和后续工具。
+---
+name: lammps
+description: 当用户要求检查 LAMMPS 服务、运行部署自带的有界 LJ melt 示例，或使用明确的 LAMMPS input/data/force-field 配置执行分子动力学、最小化并读取 thermo/log/dump/data 输出时使用。所有实时调用只走 Delta CLI；成功执行不代表物理收敛或生产可用。
+metadata:
+  allowed-tools:
+    - read_file
+    - python_repl
+    - step_finish
+---
+
+# LAMMPS 服务
+
+## 强制规则
+
+- 第一个且唯一实时执行工具是 `python_repl`，通过
+  `$SKILLS_ROOT/delta-science/scripts/invoke.py`，tool=`lammps`。
+- `python_repl` 工具参数只能包含 `code`，禁止 `deps/dependencies/packages`。
+- 禁止 Bash、路径探测、字面 CLI 命令、直接 HTTP、本地 LAMMPS 和本地回归替代。
+- 业务结果是 `r["native"]`，禁止 `native.data` 或把外层 envelope 交给 `run`。
+- LAMMPS 不从化学式、CIF 或 POSCAR 自动推断 data、原子类型、势函数与边界条件。
+
+## operation 选择
+
+- `health`：明确健康检查，无 body。
+- `lj-melt-example`：返回部署自带的精确 `native["request"]`，本身不执行模拟。
+- `run`：只接受前一步已验证的 `native["request"]`，或用户明确提供的
+  `input_script`、相对路径 `files`、timeout 与有界输出设置。
+
+用户说“用最小示例测试 LAMMPS”时，在同一个 `python_repl` 中严格执行两次依赖调用：
+先 `lj-melt-example`，再把其 `request` 原样作为 `run` 的 `--data-json`。不增加 health、
+日志探测或本地可执行文件检查。普通明确 run 只调用一次。
+
+最终只逐字复制当前 native 的 `last_thermo`、final step/temperature/total energy、
+warnings 和用户要求的输出文件摘要。禁止能量除以原子数、换算单位、替换步数或推断
+收敛性/稳定性。详细 run schema 见 `references/endpoints.md`。
+
+显式打印有界 JSON 后立即调用
+`step_finish(status="done", summary=<同一 JSON>)` 恰好一次；失败或 timeout 调用
+`step_finish(status="failed", summary=<原始错误短摘要>)`，禁止重试和后续工具。

package/skills/lammps/agents/openai.yaml

@@ -1,4 +1,4 @@
-interface:
-  display_name: "LAMMPS ?????"
-  short_description: "?? Delta CLI ?????????????????"
-  default_prompt: "?? $lammps ???????????????????"
+interface:
+  display_name: "LAMMPS 分子动力学"
+  short_description: "通过 Delta CLI 运行有界分子动力学和能量最小化"
+  default_prompt: "使用 $lammps 运行这项分子动力学任务并报告关键结果。"