Traitement d'image
Effectue un traitement déterministe sur des images existantes : redimensionnement/recadrage/rembourrage/conversion de format/compression/filigrane/coins arrondis/collage/vignettes. Toutes les opérations passent par
skills/shared/scripts/image_ops.py(Pillow pur), pas de script improvisé.
Entrée
- Un ou plusieurs chemins de fichiers image existants (png/jpg/webp et autres formats supportés par Pillow)
- Opération cible et paramètres (dimensions, ratio, qualité, texte du filigrane, mode de collage, etc.)
Sortie
- Fichier(s) image traité(s) (chemin spécifié par l'utilisateur ou par défaut dans
outputs/nom_du_sujet/) - Chaque commande affiche
✅ chemin (largeur x hauteur, taille KB);infoaffiche du json
Limites (distinction claire avec les compétences card-*)
- card-quote / card-xiaohongshu / poster-hero / comparison-card = conception et rendu de nouvelles images (HTML → capture d'écran)
- image-editing = traitement d'images existantes, pas de conception visuelle, pas de génération de contenu, uniquement des manipulations au niveau pixel
- Besoin de "générer une image à partir de données/texte" → utiliser chart/infographic/card-* ; cette compétence ne traite que des fichiers image prêts
Étapes d'exécution
- Vérifier que les images d'entrée existent, clarifier l'opération cible et les paramètres
- Exécuter la sous-commande correspondante de
image_ops.pydepuis la racine du projet (voir ci-dessous) - Si nécessaire, consulter
references/platform-sizes.mdpour obtenir les ratios/pixels recommandés pour la plateforme - Retourner le chemin de sortie et les dimensions ; les opérations multiples peuvent être chaînées (par ex. resize puis compress)
Référence rapide des commandes
Le chemin du script est toujours skills/shared/scripts/image_ops.py, toutes les commandes supportent -h pour voir les paramètres.
# Redimensionnement : par largeur/hauteur/pourcentage, --keep-ratio pour mise à l'échelle proportionnelle dans la boîte sans distorsion
python skills/shared/scripts/image_ops.py resize -i in.jpg -o out.jpg --width 1080
python skills/shared/scripts/image_ops.py resize -i in.jpg -o out.jpg --percent 50
python skills/shared/scripts/image_ops.py resize -i in.jpg -o out.jpg --width 1080 --height 1440 --keep-ratio
# Recadrage : par boîte de coordonnées ou centré à des dimensions spécifiques
python skills/shared/scripts/image_ops.py crop -i in.jpg -o out.jpg --box 100,50,900,650
python skills/shared/scripts/image_ops.py crop -i in.jpg -o out.jpg --width 1080 --height 1080
# Rembourrage pour atteindre un ratio cible (cœur de l'adaptation aux réseaux sociaux) : pad toute image en 1:1 / 9:16 / 16:9
python skills/shared/scripts/image_ops.py pad -i in.jpg -o out.png --ratio 9:16 --background "#ffffff"
python skills/shared/scripts/image_ops.py pad -i in.jpg -o out.png --ratio 1:1 --background "20,20,30"
# Conversion de format png/jpg/webp
python skills/shared/scripts/image_ops.py convert -i in.png -o out.webp --format webp --quality 85
# Compression : qualité fixe ou approche de la taille de fichier maximale (jpg/webp)
python skills/shared/scripts/image_ops.py compress -i in.jpg -o out.jpg --quality 80
python skills/shared/scripts/image_ops.py compress -i in.jpg -o out.jpg --max-kb 200
# Filigrane : texte (position/opacité/taille/couleur, recherche automatique de police chinoise système) ou image (coin inférieur droit, etc.)
python skills/shared/scripts/image_ops.py watermark -i in.jpg -o out.png --text "@nom_utilisateur" --position bottom-right --opacity 0.5 --size 40
python skills/shared/scripts/image_ops.py watermark -i in.jpg -o out.png --image logo.png --position bottom-right --scale 0.3 --opacity 0.8
# Coins arrondis (sortie png transparent) ; --radius-percent 50 donne un cercle
python skills/shared/scripts/image_ops.py round -i in.jpg -o out.png --radius 60
python skills/shared/scripts/image_ops.py round -i avatar.jpg -o out.png --radius-percent 50
# Collage multi-image : horizontal/vertical/grille NxM (colonnes x lignes), --cell-width/height pour cellules uniformes
python skills/shared/scripts/image_ops.py collage -i a.jpg b.jpg c.jpg -o out.jpg --mode horizontal --gap 12
python skills/shared/scripts/image_ops.py collage -i 1.jpg 2.jpg 3.jpg 4.jpg -o out.jpg --grid 2x2 --gap 10 --cell-width 540 --cell-height 540
# Vignette (pixel du côté le plus long)
python skills/shared/scripts/image_ops.py thumbnail -i in.jpg -o thumb.jpg --size 256
# Lecture des informations de l'image (json : dimensions/format/ratio/taille/canal alpha)
python skills/shared/scripts/image_ops.py info -i in.jpg
Connaissances du domaine : dimensions recommandées par plateforme
Les recommandations courantes pour les plateformes se trouvent dans references/platform-sizes.md. Aide-mémoire fréquent :
- Xiaohongshu (小红书) portrait : 1080×1440 (3:4) ; Xiaohongshu vidéo/portrait poster : 1080×1920 (9:16)
- WeChat Moments (朋友圈) image unique / carré générique : 1:1 (ex. 1080×1080)
- Couverture horizontale / citation : 16:9 (ex. 1920×1080) ; en-tête compte officiel WeChat 900×383
- Image associée Weibo : 1:1 ou 4:3 ; couverture Douyin/WeChat Channels : 9:16 (1080×1920)
Approche d'adaptation : privilégier pad (remplissage sans rogner le contenu, sans déformation) pour préserver l'image complète ; si une image pleine sans bordure est souhaitée, utiliser crop centré pour recadrer au ratio cible ; si seule une réduction de volume est nécessaire, utiliser resize/compress.
Sensibilité au profil
- Avec profil : le texte du filigrane par défaut utilise le nom de compte/handle ; le ratio de sortie par défaut correspond à la plateforme principale de l'utilisateur (par ex. compte Xiaohongshu par défaut 1080×1440)
- Sans profil : exécution selon les paramètres explicites de l'utilisateur, le ratio par défaut conserve celui de l'image d'origine, le filigrane nécessite que l'utilisateur fournisse le texte
Dépendances et gestion des erreurs
- Dépendance : Pillow (déjà installé,
python -c "import PIL"disponible), bibliothèque standard pure sans autre dépendance tierce - Vérifications intégrées dans le script : fichier inexistant / boîte de recadrage hors limites / ratio ou couleur invalide → code de sortie 2 et affichage de
ERROR: - Si la police chinoise système n'est pas trouvée, dégradation vers la police par défaut de PIL avec
WARN, possibilité d'utiliser--fontpour spécifier - Auto-test :
python skills/shared/scripts/image_ops.py --selftest