AgentSkillsCN

mxl-project-scaffold

当用户请求准备 MaxwellLink 输入文件时，此技能会从可直接复制的模板中搭建一个新的 `projects/YYYY-MM-DD-NAME/` 文件夹，并提供基础验证功能。

SKILL.md
--- frontmatter
name: mxl-project-scaffold
description: This skill should be used when users ask to prepare MaxwellLink input files; it scaffolds a new `projects/YYYY-MM-DD-NAME/` folder from copy-ready templates and provides basic validation.

MaxwellLink project scaffolding (inputs under projects/)

Create a new project folder

  • •Name the project using the convention YYYY-MM-DD-NAME under projects/.
  • •Copy a ready-to-run template from skills/mxl-project-scaffold/assets/templates/ into the new project directory.

Use the scaffolding script

  • •List available templates:
    • •python skills/mxl-project-scaffold/scripts/mxl_scaffold_project.py --list
  • •Create a project:
    • •python skills/mxl-project-scaffold/scripts/mxl_scaffold_project.py --template meep-tls-embedded --name tls-coherent-meep-2d-vacuum
  • •Edit the generated config.json and README.md before running.

Validate a project

  • •Run:
    • •python skills/mxl-project-scaffold/scripts/mxl_validate_project.py projects/YYYY-MM-DD-NAME
  • •Fix any reported schema/type issues before launching long jobs.

Template catalog

  • •meep-tls-embedded: Meep FDTD + embedded TLS, writes tls_history.csv
  • •meep-tls-socket-unix: Meep FDTD + TLS driver over UNIX socket (local multi-process)
  • •singlemode-tls-socket-tcp: SingleModeSimulation + TLS over TCP (fast socket workflow)
  • •laser-tls-embedded: LaserDrivenSimulation + embedded TLS (prescribed field)
  • •slurm-meep-tls-tcp: SLURM two-step main+driver jobs over TCP (multi-node pattern), writes tcp_host_port_info.txt