environment-setup
Configurer les variables d'environnement pour les environnements de développement, staging et production
La gestion des variables d'environnement sur plusieurs environnements est sujette aux erreurs et prend du temps. Cette skill fournit des modèles et les meilleures pratiques pour les fichiers .env, la validation de configuration TypeScript et la gestion des environnement Docker afin que vous puissiez configurer correctement les environnements dès la première fois.
تنزيل ZIP المهارة
رفع في Claude
اذهب إلى Settings → Capabilities → Skills → Upload skill
فعّل وابدأ الاستخدام
اختبرها
استخدام "environment-setup". Créer un modèle .env pour une API Node.js
النتيجة المتوقعة:
Généré .env.example avec des sections pour Application, Base de données, Redis, Authentification, Email (SMTP), APIs externes (Stripe), AWS, Monitoring (Sentry) et Feature Flags. Chaque section inclut des commentaires expliquant le but de la variable.
استخدام "environment-setup". Ajouter la validation d'environnement avec Zod
النتيجة المتوقعة:
Créé config/env.ts avec un schéma Zod qui valide que DATABASE_URL est une URL valide, les secrets JWT font au moins 32 caractères, SMTP_PORT est un nombre et LOG_LEVEL est l'un des suivants : error/warn/info/debug. Lance des erreurs descriptives en cas d'échec de validation.
استخدام "environment-setup". Générer des règles .gitignore pour les fichiers d'environnement
النتيجة المتوقعة:
Ajouté des règles pour éviter de commiter les fichiers .env : .env, .env.local, .env.*.local et .env.production. Créé le contenu du .gitignore prêt à copier dans le projet.
التدقيق الأمني
مخاطر متوسطةThis skill is a documentation/education resource that provides templates and best practices for environment configuration. Static analysis flagged many patterns (credential examples, dotenv usage, environment variable access) but these are all placeholder examples in documentation, not actual executable code. The skill declares Read Write Edit Bash permissions, which is appropriate for configuration management. No malicious intent detected - all flagged patterns are legitimate documentation content. Users should be aware this skill can modify configuration files.
مشكلات متوسطة المخاطر (2)
مشكلات منخفضة المخاطر (2)
عوامل الخطر
🔑 متغيرات البيئة (5)
⚙️ الأوامر الخارجية (1)
الأنماط المكتشفة
درجة الجودة
ماذا يمكنك بناءه
Initialiser la configuration d'environnement pour un nouveau projet
Configurer une structure complète de configuration d'environnement incluant .env.example, la validation TypeScript et les configs par environnement pour assurer une configuration cohérente au sein de votre équipe.
Migrer une configuration legacy vers une gestion d'environnement typée
Remplacer l'accès ad-hoc process.env par des schémas Zod validés et une gestion centralisée de la configuration pour une fiabilité et une sécurité typée améliorées.
Préparer la configuration de déploiement en production
Créer des modèles d'environnement spécifiques à la production avec interpolation de variables pour l'injection de secrets depuis les pipelines CI/CD ou les gestionnaires de secrets.
جرّب هذه الموجهات
J'ai besoin d'un modèle .env.example pour une application Node.js qui utilise PostgreSQL, Redis et envoie des emails via SMTP. Incluez les variables courantes pour l'authentification, le pooling de base de données et les feature flags.
Ajoutez la validation Zod à notre config/index.ts existante pour garantir que toutes les variables d'environnement requises sont présentes et correctement formatées au démarrage. Incluez la gestion des erreurs avec des messages clairs.
Créez un docker-compose.yml avec des configurations d'environnement séparées pour le développement et la production. Utilisez env_file pour le développement local et les variables d'environnement pour la production. Incluez les services PostgreSQL et Redis.
Configurez la gestion d'environnement qui supporte AWS Secrets Manager pour l'injection d'identifiants en production tout en utilisant des fichiers .env locaux en développement. Incluez la validation pour les deux scénarios.
أفضل الممارسات
- Utilisez toujours .env.example comme modèle commité montrant les variables requises sans les secrets réels
- Implémentez la validation au runtime avec Zod au démarrage de l'application pour détecter les configurations manquantes tôt
- Utilisez des fichiers de configuration spécifiques à l'environnement pour garder la logique spécifique à chaque environnement organisée et maintenable
تجنب
- Ne commitez pas les fichiers .env avec de vrais identifiants dans le contrôle de version
- Évitez d'accéder directement aux variables d'environnement dans le code ; utilisez un module de configuration centralisé
- N'utilisez pas de valeurs par défaut faibles pour les secrets ; exigez une configuration explicite en production