workflow-engine-mapper

HeshamFS

Mis à jour 2 days ago

7 vues

Designaiapiautomation

À propos

Cette compétence aide les développeurs de matériaux computationnels à mapper leurs tâches sur des moteurs de workflow appropriés tels qu'atomate2, jobflow ou AiiDA. Elle guide les décisions concernant la structuration de campagnes reproductibles, les DAG, les stratégies de redémarrage et les enregistrements de provenance. Utilisez-la lors de la migration de scripts ad hoc vers des workflows gérés ou lors de la conception de nouvelles campagnes computationnelles.

Installation rapide

Claude Code

Recommandé

Principal

npx skills add HeshamFS/materials-simulation-skills -a claude-code

Commande PluginAlternatif

/plugin add https://github.com/HeshamFS/materials-simulation-skills

Git CloneAlternatif

git clone https://github.com/HeshamFS/materials-simulation-skills.git ~/.claude/skills/workflow-engine-mapper

Copiez et collez cette commande dans Claude Code pour installer cette compétence

Documentation

Workflow Engine Mapper

Goal

Choose the smallest workflow structure that preserves reproducibility, restartability, and provenance for a materials simulation task.

Requirements

Python 3.10+
No external dependencies
Works on Linux, macOS, and Windows

Inputs to Gather

Input	Description	Example
Task	Workflow purpose	`VASP relax-static-DOS for 200 structures`
Code	Main simulation engine	`vasp`, `qe`, `lammps`, `ase`
Runs	Approximate number of calculations	`200`
Provenance	Whether audit trail matters	`true`
Restart	Whether jobs may resume after failure	`true`
HPC	Whether remote scheduler is required	`true`

Decision Guidance

Use one-off scripts for fewer than 5 local exploratory runs.
Use jobflow/atomate2 when the workflow is Python-native and Materials Project style input sets are useful.
Use AiiDA when provenance, database-backed records, and remote execution are central.
Use pyiron when interactive atomistic workflows, notebooks, and job management are the primary user surface.

Script Outputs

scripts/workflow_engine_mapper.py emits:

recommended_engine
dag_pattern
provenance_requirements
restart_strategy
storage_layout
migration_triggers

Workflow

python3 skills/simulation-workflow/workflow-engine-mapper/scripts/workflow_engine_mapper.py \
  --task "relax static dos for 200 oxides" \
  --code vasp \
  --runs 200 \
  --needs-provenance \
  --needs-restart \
  --hpc \
  --json

Use the output to scaffold the workflow before writing engine-specific code.

Error Handling

If the task has too few details, choose the conservative pattern and ask for engine, run count, and restart needs before implementation.

Limitations

The skill does not replace the official APIs of atomate2, jobflow, AiiDA, or pyiron; it selects and explains the workflow shape.

Security

The script accepts only scalar CLI inputs and booleans.
It does not connect to remote services or submit jobs.
The skill uses Bash only to run the bundled script.

References

See references/workflow_engines.md for engine selection heuristics.

Version History

1.0.0: Initial workflow engine mapping skill.

Dépôt GitHub

HeshamFS/materials-simulation-skills

Chemin: skills/simulation-workflow/workflow-engine-mapper

agent-skillsagentscli-toolscomputational-sciencellmmaterials-science

Compétences associées

executing-plans

Design

Utilisez la compétence executing-plans lorsque vous disposez d'un plan de mise en œuvre complet à exécuter par lots contrôlés avec des points de contrôle de revue. Elle charge et examine le plan de manière critique, puis exécute les tâches par petits lots (3 tâches par défaut) tout en rapportant la progression entre chaque lot pour une revue par l'architecte. Cela garantit une mise en œuvre systématique avec des points de contrôle de qualité intégrés.

Voir la compétence

requesting-code-review

Design

Cette compétence délègue un sous-agent réviseur de code pour analyser les modifications apportées au code par rapport aux exigences avant de poursuivre. Elle doit être utilisée après avoir terminé des tâches, implémenté des fonctionnalités majeures, ou avant une fusion vers la branche principale. La revue aide à détecter précocement les problèmes en comparant l'implémentation actuelle avec le plan initial.

Voir la compétence

connect-mcp-server

Design

Cette compétence fournit un guide complet permettant aux développeurs de connecter des serveurs MCP à Claude Code via les transports HTTP, stdio ou SSE. Elle couvre l'installation, la configuration, l'authentification et la sécurité pour intégrer des services externes tels que GitHub, Notion et des API personnalisées. Utilisez-la lors de la configuration d'intégrations MCP, de la configuration d'outils externes ou du travail avec le Protocole de Contexte de Modèle de Claude.

Voir la compétence

web-cli-teleport

Design

Cette compétence aide les développeurs à choisir entre les interfaces Web et CLI de Claude Code en fonction de l'analyse des tâches, puis permet une téléportation transparente des sessions entre ces environnements. Elle optimise le flux de travail en gérant l'état et le contexte de la session lors du passage entre le web, la CLI ou le mobile. Utilisez-la pour des projets complexes nécessitant différents outils à diverses étapes.

Voir la compétence