hpc-toolchains
Build, review, debug, and stabilize HPC compiler and build-toolchain workflows. Use when choosing compiler families such as GCC, Clang, or oneAPI; configuring CMake, `find_package`, or toolchain files; aligning BLAS or LAPACK or MPI stacks; using environment modules or Spack; or repairing ABI, link, and build-system failures.
- License 许可
- MIT
- 最近更新
- 2026-11-09
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- hpc-toolchains
- risk
- low
- domain
- high-performance-computing
- source
- { "commit": "4ea8069188", "license": "MIT", "repository": "SciMate-AI/HPC-Skills", "imported_at": "2026-09-20" }
- license
- MIT
- version
- 1.0.0
- category
- high-performance-computing
- platforms
- [ "claude-code", "cursor", "codex", "gemini", "antigravity", "copilot" ]
- subdomain
- general
- description
- Build, review, debug, and stabilize HPC compiler and build-toolchain workflows. Use when choosing compiler families such as GCC, Clang, or oneAPI; configuring CMake, `find_package`, or toolchain files; aligning BLAS or LAPACK or MPI stacks; using environment modules or Spack; or repairing ABI, link, and build-system failures.
02 资源文件 14
- 脚本assets/templates/build-smoke-slurm.sh699 B
- 脚本assets/templates/configure-gcc-openmpi.sh459 B
- 资产文件assets/templates/minimal-cmake-project/CMakeLists.txt254 B
- 资产文件assets/templates/minimal-cmake-project/main.cpp319 B
- 资产文件assets/templates/spack-env-minimal.yaml91 B
- 参考文档references/blas-lapack-mpi-consistency.md970 B
- 参考文档references/build-type-and-abi-hygiene.md1.2 KB
- 参考文档references/cmake-and-find-package-playbook.md1.4 KB
- 参考文档references/compiler-family-selection.md1.4 KB
- 参考文档references/configure-and-build-matrix.md1.2 KB
- 参考文档references/error-pattern-dictionary.md1.5 KB
- 参考文档references/error-recovery.md1.1 KB
- 参考文档references/modules-and-spack-playbook.md1.0 KB
- 参考文档references/toolchain-files-and-presets.md1.0 KB
03 SKILL.md 正文
HPC Toolchains
Treat the toolchain as a coherent stack. Pick the compiler family, MPI family, math libraries, and build system together before tuning application-specific flags.
Start
- Read
references/compiler-family-selection.mdbefore choosing GCC, Clang, or vendor compilers. - Read
references/configure-and-build-matrix.mdwhen deciding between CMake, Make, Ninja, or wrapper-driven builds. - Read
references/cmake-and-find-package-playbook.mdwhen writing or repairingCMakeLists.txt,find_package, imported targets, or cache variables. - Read
references/toolchain-files-and-presets.mdwhen the build depends on reusable compiler, MPI, or site configuration. - Read
references/build-type-and-abi-hygiene.mdwhen debugging release versus debug mismatches, C++ standard mismatches, symbol issues, or ABI drift. - Read
references/blas-lapack-mpi-consistency.mdwhen linking against BLAS, LAPACK, ScaLAPACK, MPI, or vendor math stacks. - Read
references/modules-and-spack-playbook.mdwhen using environment modules, compiler wrappers, external packages, or Spack environments. - Read
references/error-recovery.mdwhen configure, compile, link, or runtime-loader failures occur.
Work sequence
- Decide the stack boundary first:
- site-provided modules
- Spack environment
- container image
- user-local source build
- Pick one compiler family and keep the full dependency graph aligned to it.
- Decide how dependencies are discovered:
- wrapper compilers
find_packagepkg-config- explicit include and library paths only as a last resort
- Keep build directories, cache state, and install prefixes separated by toolchain.
- Record the exact configure command before tuning warning or optimization flags.
Guardrails
- Do not mix compiler and MPI families casually across one build tree.
- Do not patch over a bad discovery path with many ad hoc include and library flags.
- Do not treat ABI, C++ standard, and release or debug mode as cosmetic metadata.
- Do not let one dependency come from a different module stack unless the site explicitly supports that mix.
Additional References
Load these on demand:
references/cmake-and-find-package-playbook.mdfor imported-target and cache-variable disciplinereferences/toolchain-files-and-presets.mdfor reusable site or cluster build configurationreferences/build-type-and-abi-hygiene.mdfor symbol, ABI, and optimization mismatchesreferences/blas-lapack-mpi-consistency.mdfor math-library and MPI stack alignmentreferences/modules-and-spack-playbook.mdfor module and Spack-based reproducibilityreferences/error-pattern-dictionary.mdfor fast matching of common toolchain failure classes
Reusable Templates
Use assets/templates/ when a concrete starting point is faster than rebuilding the build stack from scratch, especially:
minimal-cmake-project/CMakeLists.txtminimal-cmake-project/main.cppconfigure-gcc-openmpi.shbuild-smoke-slurm.shspack-env-minimal.yaml
Outputs
Summarize:
- chosen compiler and MPI family
- dependency-discovery method
- build-system strategy
- math-library and ABI alignment decisions
- the exact failure phase if the workflow is being repaired
04 同仓库更多 Skills
dei-assessment
Assess diversity, equity, and inclusion with metrics. TRIGGERS - Use when user needs help with dei-assessment related tasks.
dei-action-plan
Create DEI action plans with goals and initiatives. TRIGGERS - Use when user needs help with dei-action-plan related tasks.
culture-fit-assessment
Design culture add assessment processes. TRIGGERS - Use when user needs help with culture-fit-assessment related tasks.
cowork-to-code-bridge
Use an already-installed, independently verified cowork-to-code bridge to run narrowly approved actions on the user's own macOS, Linux, or WSL2 machine through a local file queue.
counter-offer-response
Draft counter-offer responses for retention. TRIGGERS - Use when user needs help with counter-offer-response related tasks.
continuous-feedback-system
Design continuous feedback systems. TRIGGERS - Use when user needs help with continuous-feedback-system related tasks.