Communitygithub.com

trailofbits/modern-cpp

Guide le code C++ vers les idiomes modernes (C++20/23/26). À utiliser lors de l'écriture de nouveau code C++, de la modernisation de code existant ou du travail sur du C++ critique pour la sécurité. Remplace les pointeurs bruts par des pointeurs intelligents, SFINAE par des concepts, printf par std::print, les codes d'erreur par std::expected.

Qu'est-ce que modern-cpp ?

Ce skill, développé par Trail of Bits, est un guide complet pour écrire du C++ moderne en utilisant les idiomes C++20, C++23 et C++26. Il se concentre sur les motifs de conception qui éliminent les classes de vulnérabilités et réduisent le code répétitif, avec un accent particulier sur la sécurité. Idéal pour les développeurs travaillant sur du code neuf, la modernisation de bases de code anciennes, ou le développement de logiciels critiques pour la sécurité. Le skill fournit un arbre de décision, une classification des fonctionnalités en quatre niveaux de maturité (de "utilisable aujourd'hui" à "à surveiller"), et des tables de migration des anti-patrons vers des solutions modernes. Il inclut également une référence rapide pour le renforcement du compilateur, avec des drapeaux essentiels pour GCC et Clang, et des recommandations pour l'utilisation de libc++ durci et de sanitizers dans l'intégration continue. Les développeurs y trouveront des listes de contrôle des meilleures pratiques, des rationalisations à rejeter, et des liens vers des références détaillées pour chaque fonctionnalité majeure.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/trailofbits/skills/tree/main/plugins/modern-cpp/skills/modern-cpp

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

C++ Moderne

Guide pour écrire du C++ moderne avec les idiomes C++20, C++23 et C++26. Se concentre sur les motifs qui éliminent les classes de vulnérabilités et réduisent le code répétitif, avec un accent sur la sécurité de Trail of Bits.

Quand utiliser ce skill

  • Écrire de nouvelles fonctions, classes ou bibliothèques C++
  • Moderniser du code C++ existant (motifs antérieurs à C++20)
  • Choisir entre les approches anciennes et modernes
  • Travailler sur du C++ critique pour la sécurité ou la sûreté
  • Réviser du code C++ pour l'adoption d'idiomes modernes

Quand NE PAS utiliser ce skill

  • L'utilisateur demande explicitement une norme plus ancienne : Respectez les contraintes (systèmes embarqués, ABI héritée)
  • Code C pur : Ce skill est spécifique au C++
  • Questions sur le système de build : La configuration de CMake, Meson, Bazel est hors du cadre
  • Projets non C++ : Bases de code mixtes où le C++ n'est pas prédominant

Anti-patrons à éviter

À éviterUtiliser à la placePourquoi
new/deletestd::make_unique, std::make_sharedÉlimine les fuites, les doubles libérations
Pointeurs bruts propriétairesstd::unique_ptr, std::shared_ptrSémantique de propriété RAII
Tableaux C (int arr[N])std::array<int, N>Connaissance des bornes, sémantique de valeur
Paramètres pointeur + longueurstd::span<T>Non propriétaire, vérification des bornes
printf / sprintfstd::format, std::printType-safe, pas de débordement de tampon
Casts de style C (int)xstatic_cast<int>(x)Intention explicite, vérifiable
Constantes #defineVariables constexprDe portée, typées, débogables
SFINAE / enable_ifConcepts + requiresContraintes et erreurs lisibles
Codes d'erreur + paramètres de sortiestd::expected<T, E>Composable, type-safe
unionstd::variantType-safe, pas de UB silencieux
mutex.lock()/unlock() brutsstd::scoped_lockException-safe, pas de blocage
std::threadstd::jthreadAuto-jointure, support des jetons d'arrêt
Macro assert()contract_assert (C++26)Visible par les outils, configurable
CRTP manuelDeducing this (C++23)Plus simple, pas de code répétitif de template
Génération de code par macroRéflexion (C++26)Zéro surcoût, composable

Voir anti-patterns.md pour le tableau complet (30+ motifs).

Arbre de décision

Que faites-vous ?
|
+-- Écrire du nouveau code C++ ?
|   +-- Utiliser les idiomes modernes par défaut (C++20/23)
|   +-- Choisir la norme la plus récente supportée par votre compilateur
|   +-- Voir les Niveaux de fonctionnalités ci-dessous
|
+-- Moderniser du code existant ?
|   +-- Commencer par les remplacements du Niveau 1 (C++20/23)
|   +-- Prioriser par impact sur la sécurité (mémoire > types > style)
|   +-- Voir anti-patterns.md pour la table de migration
|
+-- Code critique pour la sécurité ?
|   +-- Activer les drapeaux de durcissement du compilateur (voir ci-dessous)
|   +-- Activer le mode durci de libc++
|   +-- Exécuter les sanitizers dans l'IC
|   +-- Voir safe-idioms.md et compiler-hardening.md
|
+-- Utiliser des fonctionnalités C++26 ?
    +-- Réflexion : OUI, planifiez pour cela (GCC 16+)
    +-- Contrats : avec prudence, pour les nouvelles frontières d'API
    +-- std::execution : attendez la maturité de l'écosystème
    +-- Voir cpp26-features.md

Niveaux de fonctionnalités

Les fonctionnalités sont classées par utilisabilité pratique aujourd'hui, pas par version de norme.

Niveau 1 : Utiliser aujourd'hui (C++20/23, support solide du compilateur)

FonctionnalitéRemplaceNorme
Concepts + requiresSFINAE, enable_ifC++20
Ranges + vuesBoucles d'itérateurs brutesC++20
std::span<T>Pointeur + longueurC++20
std::formatsprintf, chaînes iostreamC++20
Comparaison à trois voies <=>Opérateurs de comparaison manuelsC++20
std::jthreadstd::thread + jointure manuelleC++20
Initialisateurs désignésInitialisation de struct positionnelleC++20
std::expected<T,E>Codes d'erreur, exceptions aux frontièresC++23
std::print / std::printlnprintf, std::cout <<C++23
Deducing thisCRTP, duplication const/non-constC++23
std::flat_mapstd::map pour usage intensif en lectureC++23
std::optional monadiqueVérifications if imbriquées sur les optionalsC++23

Voir cpp20-features.md et cpp23-features.md.

Niveau 2 : Déployer maintenant (pas de mise à jour de norme nécessaire)

Ceux-ci améliorent la sécurité sans changer votre version de norme C++ :

  • Drapeaux de durcissement du compilateur — -D_FORTIFY_SOURCE=3, -fstack-protector-strong, -ftrivial-auto-var-init=zero
  • libc++ durci — -D_LIBCPP_HARDENING_MODE=_LIBCPP_HARDENING_MODE_FAST pour environ 0,3 % de surcoût de vérification des bornes
  • Sanitizers dans l'IC — ASan + UBSan comme minimum ; TSan pour le code concurrent
  • Drapeaux d'avertissement — -Wall -Wextra -Wpedantic -Werror

Voir compiler-hardening.md.

Niveau 3 : Planifier (C++26, vaut la peine de se restructurer autour)

La réflexion est la fonctionnalité C++26 la plus transformatrice. Elle élimine :

  • Le code répétitif de sérialisation (une fonction générique remplace le to_json par structure)
  • Les générateurs de code (codegen protobuf, Qt MOC)
  • Les hacks d'enregistrement par macros et de conversion énumération-texte

GCC 16 (avril 2026) a fusionné la réflexion. Planifiez le nouveau code pour en bénéficier.

Niveau 4 : Surveiller (C++26, nécessite maturation)

  • Contrats (pre/post/contract_assert) — Meilleurs que assert(), mais pas de support pour les fonctions virtuelles et support limité du compilateur. Adoptez avec prudence pour les nouvelles frontières d'API.
  • std::execution (émetteurs/récepteurs) — Framework asynchrone puissant, mais courbe d'apprentissage abrupte, aucun ordonnanceur fourni, et documentation pauvre. Attendez la maturité de l'écosystème.

Voir cpp26-features.md.

Référence rapide pour le durcissement du compilateur

Drapeaux essentiels (GCC + Clang)

-Wall -Wextra -Wpedantic -Werror
-D_FORTIFY_SOURCE=3
-fstack-protector-strong
-fstack-clash-protection
-ftrivial-auto-var-init=zero
-fPIE -pie
-Wl,-z,relro,-z,now

Spécifique à Clang

-Wunsafe-buffer-usage

libc++ durci (Clang/libc++ uniquement)

-D_LIBCPP_HARDENING_MODE=_LIBCPP_HARDENING_MODE_FAST

Google a déployé cela dans Chrome et sa flotte de serveurs : environ 0,3 % de surcoût, plus de 1000 bogues trouvés, réduction de 30 % des segfaults en production.

Voir compiler-hardening.md pour le guide complet.

Rationalisations à rejeter

RationalisationPourquoi c'est faux
"Ça compile sans avertissements"Les avertissements dépendent des drapeaux activés. Ajoutez -Wall -Wextra -Wpedantic.
"ASan est trop lent pour la production"Utilisez GWP-ASan pour la détection basée sur l'échantillonnage en production (~0 % de surcoût).
"Nous n'utilisons que des conteneurs sûrs"L'invalidation d'itérateur et l'accès non vérifié à optional sont toujours exploitables.
"Les pointeurs intelligents sont plus lents"std::unique_ptr a un surcoût nul par rapport aux pointeurs bruts. Mesurez avant d'affirmer.
"Notre code n'a pas de bogues mémoire"Google a trouvé plus de 1000 bogues en activant libc++ durci. Tout le monde aussi.
"Les fonctionnalités C++26 ne sont pas encore disponibles"Les fonctionnalités C++20/23 le sont. Les drapeaux de durcissement fonctionnent sur n'importe quelle norme. Commencez là.
"Le C++ moderne est plus difficile à lire"std::expected est plus lisible que de vérifier des codes d'erreur sur 5 paramètres de sortie.

Liste de contrôle des meilleures pratiques

  • Utiliser des pointeurs intelligents pour la propriété, les pointeurs bruts uniquement pour l'observation non propriétaire
  • Préférer std::span à pointeur + longueur pour les paramètres de fonction
  • Utiliser std::expected pour les fonctions qui peuvent échouer avec des erreurs typées
  • Contraindre les templates avec des concepts, pas SFINAE
  • Activer les drapeaux de durcissement du compilateur et libc++ durci dans toutes les constructions
  • Exécuter ASan + UBSan dans l'IC ; ajouter TSan pour le code concurrent
  • Utiliser constexpr / consteval quand c'est possible (sans UB par conception)
  • Marquer les fonctions [[nodiscard]] lorsque ignorer la valeur de retour est probablement un bogue
  • Préférer la sémantique de valeur ; utiliser std::variant au lieu de union, enum class au lieu de enum
  • Initialiser toutes les variables à la déclaration

Lire ensuite

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

trailofbits/address-sanitizer

AddressSanitizer detects memory errors during fuzzing. Use when fuzzing C/C++ code to find buffer overflows and use-after-free bugs.

trailofbits/aflpp

AFL++ is a fork of AFL with better fuzzing performance and advanced features. Use for multi-core fuzzing of C/C++ projects.

trailofbits/agentic-actions-auditor

Audits GitHub Actions workflows for security vulnerabilities in AI agent integrations including Claude Code Action, Gemini CLI, OpenAI Codex, and GitHub AI Inference. Detects attack vectors where attacker-controlled input reaches AI agents running in CI/CD pipelines, including env var intermediary patterns, direct expression injection, dangerous sandbox configurations, and wildcard user allowlists. Use when reviewing workflow files that invoke AI coding agents, auditing CI/CD pipeline security for prompt injection risks, or evaluating agentic action configurations.

trailofbits/algorand-vulnerability-scanner

Scans Algorand smart contracts for 11 common vulnerabilities including rekeying attacks, unchecked transaction fees, missing field validations, and access control issues. Use when auditing Algorand projects (TEAL/PyTeal).

trailofbits/ask-questions-if-underspecified

Clarify requirements before implementing. Use when serious doubts arise.

trailofbits/atheris

Atheris is a coverage-guided Python fuzzer based on libFuzzer. Use for fuzzing pure Python code and Python C extensions.

trailofbits/audit-augmentation

Augments Trailmark code graphs with external audit findings from SARIF static analysis results and weAudit annotation files. Maps findings to graph nodes by file and line overlap, creates severity-based subgraphs, and enables cross-referencing findings with pre-analysis data (blast radius, taint, etc.). Use when projecting SARIF results onto a code graph, overlaying weAudit annotations, cross-referencing Semgrep or CodeQL findings with call graph data, or visualizing audit findings in the context of code structure.

trailofbits/audit-context-building

Enables ultra-granular, line-by-line code analysis to build deep architectural context before vulnerability or bug finding.

trailofbits/audit-prep-assistant

Prepares codebases for security review using Trail of Bits' checklist. Helps set review goals, runs static analysis tools, increases test coverage, removes dead code, ensures accessibility, and generates documentation (flowcharts, user stories, inline comments).

trailofbits/burpsuite-project-parser

Searches and explores Burp Suite project files (.burp) from the command line. Use when searching response headers or bodies with regex patterns, extracting security audit findings, dumping proxy history or site map data, or analyzing HTTP traffic captured in a Burp project.

trailofbits/cairo-vulnerability-scanner

Scans Cairo/StarkNet smart contracts for 6 critical vulnerabilities including felt252 arithmetic overflow, L1-L2 messaging issues, address conversion problems, and signature replay. Use when auditing StarkNet projects.

trailofbits/cargo-fuzz

cargo-fuzz is the de facto fuzzing tool for Rust projects using Cargo. Use for fuzzing Rust code with libFuzzer backend.

trailofbits/chrome-mcp-troubleshooting

Diagnose and fix Claude in Chrome MCP extension connectivity issues. Use when mcp__claude-in-chrome__* tools fail, return "Browser extension is not connected", or behave erratically.

trailofbits/claude-in-chrome-troubleshooting

Diagnose and fix Claude in Chrome MCP extension connectivity issues. Use when mcp__claude-in-chrome__* tools fail, return "Browser extension is not connected", or behave erratically.

trailofbits/code-improver

Runs an autonomous review-and-fix improvement loop over any code target — a skill, plugin, module, or directory — using a reviewer the user names: any installed skill or agent. Keeps a cross-round findings ledger, escalates when fixes stop converging, and guards scope mechanically. Use when asked to 'improve this code until review passes', 'run an improvement loop with <reviewer>', or to iterate review-and-fix with a specific reviewer. For skills prefer the skill-improver entry; for a branch prefer pr-improver.

trailofbits/code-maturity-assessor

Systematic code maturity assessment using Trail of Bits' 9-category framework. Analyzes codebase for arithmetic safety, auditing practices, access controls, complexity, decentralization, documentation, MEV risks, low-level code, and testing. Produces professional scorecard with evidence-based ratings and actionable recommendations.

trailofbits/codeql

Scans a codebase for security vulnerabilities using CodeQL's interprocedural data flow and taint tracking analysis. Triggers on "run codeql", "codeql scan", "codeql analysis", "build codeql database", or "find vulnerabilities with codeql". Supports "run all" (security-and-quality + security-experimental suites) and "important only" (high-precision security findings) scan modes. Also handles creating data extension models and processing CodeQL SARIF output.

trailofbits/constant-time-analysis

Detects timing side-channel vulnerabilities in cryptographic code. Use when implementing or reviewing crypto code, encountering division on secrets, secret-dependent branches, or constant-time programming questions in C, C++, Go, Rust, Swift, Java, Kotlin, C#, PHP, JavaScript, TypeScript, Python, or Ruby.

trailofbits/constant-time-testing

Constant-time testing detects timing side channels in cryptographic code. Use when auditing crypto implementations for timing vulnerabilities.

trailofbits/cosmos-vulnerability-scanner

Scans Cosmos SDK blockchain modules and CosmWasm contracts for consensus-critical vulnerabilities — chain halts, fund loss, state divergence. 25 core + 16 IBC + 10 EVM + 3 CosmWasm patterns. Use when auditing custom x/ modules, reviewing IBC integrations, or assessing pre-launch chain security. Updated for SDK v0.53.x.

Skills associés