Ce que fait ce skill
Considère un deck comme une construction, pas un document :
| Artefact | Rôle |
|---|---|
template.pptx | la chaîne d'outils — ses diapositives sont le catalogue d'archétypes. Toujours requis. |
deck.mdx | la source — le seul fichier que quiconque édite |
assets/*.svg | l'art généré, également source — contenu uniquement, pas de design |
deck.pptx | l'artefact de construction — régénéré entièrement à chaque fois |
deck.pdf + aperçus de pages | ce qu'une personne regarde vraiment — le seul endroit où la mise en page apparaît |
Chaque diapositive de sortie est un clone d'une diapositive du modèle avec son contenu échangé, donc le design du modèle survit octet par octet. Rien n'est mis en page à partir de zéro.
Moteur : scripts/deck.py (invoquer avec un chemin absolu).
Recoloration (n'importe quel pptx ; pour un deck construit, recolorer template.pptx et reconstruire) : scripts/ppt_keycolor_changer.py, procédure et préréglages dans references/recolor.md — découvrir, mapper par luminosité, confirmer, remplacer, vérifier.
Directives permanentes
- Ne jamais construire sans modèle de référence. Il n'y a pas de design de deck intégré ni de solution de repli. Si l'utilisateur ne vous a pas donné de
.pptx, arrêtez-vous et demandez-en un — n'assemblez pas les diapositives d'une autre manière, ne proposez pas de deck générique, ne fabriquez pas de modèle. Le moteur le refuse aussi, mais la demande vous appartient, avant tout travail. - Le fichier source est
deck.mdx, jamaisdeck.md. Il est compilé, pas lu. Le moteur rejette toute autre extension. - Cataloguer avant d'écrire. Ne rédigez jamais
deck.mdxà partir d'une supposition sur le modèle. Exécutezcataloget écrivez en fonction des identifiants d'emplacement qu'il affiche. - Ne jamais modifier manuellement le pptx de sortie. Il est régénéré lors de la prochaine construction. Les corrections vont dans
deck.mdx. - Exécutez
checkavantbuild, et montrez les avertissements à l'utilisateur. Les avertissements de débordement sont ce qui sépare un texte surchargé d'une diapositive que personne ne peut lire. - La visibilité décide, pas la propreté.
| transparentest correct lorsque le contenu de l'image reste lisible sur la diapositive ;checkindique quand ce n'est pas le cas, et un panneau derrière l'image est la meilleure réponse dans ce cas. Ne cherchez pas la transparence parce que cela semble plus propre. - Ne jamais rogner le contenu sans le dire.
checksignale le pourcentage ; répétez-le à l'utilisateur et proposez| fit. Une image qui perd la moitié d'elle-même est le même défaut qu'une ligne de tableau qui tombe de la diapositive. - Ne jamais écrire manuellement l'art d'un emplacement d'image en binaire. Écrivez le SVG pour que le deck reste reproductible à partir du texte. Un PNG collé par quelqu'un ne peut pas être régénéré, recoloré, ou examiné dans un diff.
- Un deck est lu par des personnes, donc regardez-le. Lorsqu'un moteur de rendu est disponible, terminez par
render, pasbuild— la vérification de la mise en page et les aperçus de pages sont le seul endroit où les collisions de texte apparaissent. Si aucun moteur de rendu n'est disponible, dites-le clairement dans le rapport au lieu d'impliquer que la mise en page a été vérifiée. - Ne jamais inventer un archétype. Si aucune diapositive du modèle ne correspond au contenu, dites-le et demandez si vous devez remodeler le contenu ou étendre le modèle — n'approximativez pas.
- Signalez les avertissements que vous avez choisi d'ignorer. Un avertissement de débordement que vous avez jugé acceptable fait toujours partie du rapport final — c'est l'utilisateur qui verra la diapositive.
- Les graphiques sont en lecture seule. Dites-le clairement lorsque l'archétype choisi en contient un ; les chiffres du modèle sont fournis à moins que l'utilisateur ne modifie le graphique dans PowerPoint.
Processus
Étape 0 · Obtenir le modèle de référence
Demandez le .pptx avant toute autre chose si vous n'en avez pas :
"레퍼런스 템플릿 pptx를 주세요. deck-builder는 템플릿 슬라이드를 복제하는 방식이라, 템플릿 없이는 만들 수 있는 슬라이드가 없습니다."
Ne continuez pas sur la base d'une description d'un modèle, d'un deck d'apparence similaire, ou d'une promesse d'en fournir un plus tard.
Étape 1 · Cataloguer le modèle
python3 /abs/path/scripts/deck.py catalog \
--template "template.pptx" --output "deck.catalog.md"
Affiche chaque archétype sous forme de @s1…@sN avec ses emplacements, ce que le modèle montre actuellement, et une estimation de capacité. Lisez-le avant toute autre chose.
Étape 2 · Mapper le contenu sur les archétypes
Demandez le contenu à l'utilisateur si vous ne l'avez pas. Ensuite, avant d'écrire du md, montrez un plan d'une ligne par diapositive :
1. @s1 표지 — 제목 + 부제
2. @s3 요약 — 불릿 3개 + 한 줄 결론
3. @s7 숫자 — 표 4행
Obtenez un accord sur le plan. Un mauvais choix d'archétype est l'erreur coûteuse, pas un mauvais libellé.
Étape 3 · Écrire deck.mdx
---
template: template.pptx
template_hash: 5f84440a3521 # du catalogue — ancre le deck à la structure du modèle
output: deck.pptx
---
## @s3
title: 분기 요약
text1:
- 응답 p99 **2.1s → 340ms**
- 배포 실패율 12% → 0.4%
table1:
| 지표 | 이전 | 이후 |
| p99 | 2.1s | 340ms |
pic1: assets/arch.svg
notes: 숫자의 출처를 먼저 말할 것
text5: !drop
Les images acceptent un mode d'ajustement — | fit conserve l'image entière, le défaut fill la rogne — et | transparent supprime l'arrière-plan d'un PNG. Les emplacements que vous omettez conservent le contenu du modèle.
La syntaxe complète — formes des emplacements, !drop, notes:, emphase en ligne, niveaux de plan, et ce que template_hash protège — se trouve dans references/mdx-syntax.md. Lisez-la avant d'écrire la première diapositive.
Étape 3b · Générer l'art nécessaire au deck
Écrivez l'art d'un emplacement d'image en .svg, dans les couleurs du modèle et à la taille en points exacte du cadre — toutes deux imprimées par catalog. Il devient une source comme le reste du deck et est pixellisé en PNG lors de la construction.
Règles, justification et exemple concret : references/generated-art.md.
Étape 4 · Vérifier
python3 /abs/path/scripts/deck.py check --deck deck.mdx
Les erreurs doivent être corrigées. Les avertissements sont des jugements à prendre — exposez chacun d'eux, y compris ceux que vous décidez d'ignorer.
| Ce qu'il mesure | Par rapport à |
|---|---|
| Un tableau ou du texte qui dépasse de la diapositive | le bord de la diapositive — une erreur, nommant les lignes perdues |
| Une ligne trop large pour un emplacement que le modèle maintient sur une seule ligne | le cadre de cet emplacement, en em, de sorte que le hangul n'est pas compté comme du latin |
| Un emplacement contenant beaucoup moins que ce que le modèle y place | le volume propre du modèle — le cadre a été dessiné pour cela et la diapositive ouvre un trou |
| Du texte qui descend plus bas que le design ne le place | le propre nombre de lignes du modèle et ce qui se trouve en dessous |
| Perte de recadrage, dpi effectif, écarts de palette, bordures d'images collées | le cadre, l'écran et la palette du modèle |
| Texte sur une image | les pixels réellement derrière : 3:1 pour les grands caractères, 4.5:1 pour le corps |
Une image dessinée après les mots qu'elle recouvre est une erreur — ils finissent derrière l'image.
Chaque estimation ici est calibrée par rapport au propre contenu du modèle plutôt qu'à une valeur absolue, car la plupart des cadres sont dessinés pour contenir du texte qui se coupe déjà. Les marges inférieures à environ une ligne sont au-delà de ce qu'une estimation statique peut résoudre : seule l'Étape 6 les règle.
Étape 5 · Construire
python3 /abs/path/scripts/deck.py build --deck deck.mdx [--output out.pptx] [--strict]
Le même deck.mdx produit toujours un pptx octet pour octet identique.
Étape 6 · Rendre et regarder
python3 /abs/path/scripts/deck.py render --deck deck.mdx
Construit, convertit via LibreOffice, écrit des aperçus PNG de chaque page, et vérifie la géométrie rendue — overlap (deux cadres de texte se chevauchent), bunched (les lignes à l'intérieur d'un cadre sont plus proches que la norme de ce cadre, donc le texte a dépassé sa boîte), off-slide (le moteur de rendu l'a coupé). Propre signifie propre : la vérification compare entre les cadres et mesure l'interlignage par rapport à la médiane de chaque cadre, donc les polices CJK dont la boîte em dépasse une ligne à 100% ne la font pas échouer.
render indique d'abord quelles polices du modèle le moteur de rendu ne possède pas. Une police substituée refait chaque ligne, donc tant qu'elles ne sont pas installées, les sauts de ligne de l'aperçu sont ceux de la police de substitution, pas du deck — la solution est d'installer la police, pas de raccourcir les mots. Le pptx lui-même nomme toujours les bonnes polices.
Lisez les aperçus pour la mise en page, pas pour l'espacement. LibreOffice rembourre la jonction entre CJK et latin par défaut, donc 평균 42분 s'affiche comme 평균 42 분 dans l'aperçu tandis que le pptx contient la chaîne originale. Vérifiez <a:t> dans le fichier construit avant de traiter l'espacement comme un défaut.
Le moteur de rendu est soffice dans le PATH ou DECK_RENDER_DOCKER=<image>. Avec ni l'un ni l'autre, render refuse plutôt que de prétendre que la mise en page a été vérifiée — dites-le et revenez à build.
Modèle de sortie
Rapport après une construction :
빌드 완료 — <출력 경로>
슬라이드 <N>개 · 템플릿 <이름> · 이미지 <M>개 삽입
렌더 검사 — 겹침 0건 (또는: 3페이지 제목이 본문과 겹칩니다)
아키타입 사용
@s1 ×1 표지
@s3 ×4 본문
확인 필요
· 3번 슬라이드 title 58자 (프레임 ~39자/줄) — 두 줄로 넘어갑니다
· 5번 슬라이드 chart1 — 차트 수치는 템플릿 값 그대로입니다
다음 수정은 deck.mdx만 고치고 다시 build 하세요. 출력 pptx는 손대면 날아갑니다.
Ce que fait Claude / Ce que vous faites
| Claude | Vous |
|---|---|
| Demande le pptx de référence, refuse de continuer sans | Fournit le modèle — obligatoire — et le contenu brut |
Exécute catalog, lit le plan des emplacements | Révise la liste des archétypes |
| Propose le plan archétype par diapositive | Approuve ou réorganise le plan |
Écrit et révise deck.mdx | Édite deck.mdx directement quand vous préférez |
Exécute check, rapporte chaque avertissement | Décide si un avertissement de débordement est important |
Exécute render, regarde les aperçus, rapporte les collisions | Ouvre le pptx, édite les graphiques si nécessaire |
Limitations
Les six qui changent ce que vous pouvez promettre :
| Limite | Conséquence |
|---|---|
| Aucune nouvelle mise en page | Chaque diapositive est un clone. Le contenu sans archétype nécessite d'étendre le modèle dans PowerPoint — dites-le plutôt que d'approximer. |
| Un modèle est obligatoire | Pas de design intégré, pas de solution de repli. |
| Les graphiques ne sont pas modifiables | build laisse les chiffres du modèle. Utilisez un SVG dans un emplacement d'image. |
| Les cadres ne bougent jamais | Écrivez court et l'espace reste ; check le signale, seul le modèle peut le fermer. |
| La vérité de la mise en page nécessite un moteur de rendu | check estime et ne peut pas résoudre les marges inférieures à une ligne. Seul render voit ce qui entre en collision. |
| La lisibilité est en PNG uniquement | Le texte sur un fond JPEG ou SVG n'est pas noté ; les couleurs de texte héritées sont laissées intactes. |
Tableau complet, et quelle étape détecte chacune : references/limits.md.
Compétences associées
write:plans(objectif du document) — développer le contenu avant de le mapper sur les diapositivesthink:untangle-thoughts— transformer des notes éparses en la structure diapositive par diapositive dont l'Étape 2 a besoin