Ghid operator pentru Template Creator

Ce face

template-creator creează sau actualizează un skill personal reutilizabil de tip artifact-template pentru Codex, pornind de la un fișier Office de referință: .docx, .pptx sau .xlsx.

Scopul lui este fidelitatea. Dacă ai un document, o prezentare sau un workbook care arată exact cum vrei să arate artifacte viitoare similare, skill-ul împachetează acel fișier ca referință internă a template-ului. Utilizările viitoare pot porni de la structura reală, nu de la o descriere aproximativă.

Template-urile gestionate sunt personale. Skill-ul nu creează pluginuri, nu modifică pluginuri instalate sau bundled cache-uri, nu publică în marketplace-uri și nu partajează template-uri cu un workspace. Pentru sharing, template-ul trebuie ulterior împachetat într-un plugin printr-un workflow separat.

All guides

Când îmi folosește

Folosește template-creator când vrei să transformi un fișier Office existent într-un template personal reutilizabil pentru artifacte viitoare.

Cazuri bune:

• ai un .docx și vrei un template pentru documente similare;
• ai un .pptx și vrei ca prezentările viitoare să pornească de la același layout;
• ai un .xlsx și vrei să reutilizezi structura unui workbook;
• vrei să editezi sau să actualizezi explicit un singur skill personal de tip artifact-template deja pasat.

Nu îl folosi pentru creare one-off dintr-un template existent. Acolo folosești template-ul, nu creezi sau modifici template-ul în sine.

La creare, dacă există deja un template cu nume similar, skill-ul creează unul nou cu nume numerotat. Nu suprascrie implicit template-uri existente. Civilizat, aproape suspect.

Cum îl invoc / declanșez

Declanșatorul explicit este $template-creator.

Se poate declanșa și natural când ceri să creezi un template folosind, din sau bazat pe un document Word, PowerPoint sau Excel atașat. Se aplică și când ceri explicit să editezi sau să actualizezi un skill pasat care este deja artifact-template.

Pentru creare, trebuie furnizat exact un fișier de referință .docx, .pptx sau .xlsx, cu excepția cazului în care ceri explicit batch. Pentru batch, workflow-ul se rulează separat pentru fiecare fișier.

Pentru update, trebuie pasat exact un singur artifact-template țintă. Skill-ul nu alege “cel mai apropiat” template după nume. Dacă ținta pasată este plugin-backed sau nu este un template personal direct gestionabil, skill-ul trebuie să se oprească și să explice limita.

Exemplu practic

Exemplu natural:

“$template-creator creează un template din prezentarea atașată pentru status updates lunare.”

Workflow-ul inferă un nume scurt de afișare, o descriere de folosire și tipul artifactului. Apoi creează preview.png înainte de împachetare:

• pentru DOCX: randare prin Documents și folosirea primei pagini ca preview;
• pentru PPTX: randare prin Presentations și folosirea primului slide ca preview;
• pentru XLSX: randarea zonei folosite din primul sheet vizibil și ne-gol.

Preview-ul trebuie inspectat vizual. Dacă este gol, tăiat, corupt sau nereprezentativ, procesul se oprește. Un template cu preview stricat este o capcană cu ambalaj frumos.

La update, dacă schimbi conținutul referinței sau aspectul vizual, se lucrează pe o copie temporară, se generează un preview nou și se inspectează din nou. Dacă schimbi doar display name-ul, descrierea sau instrucțiunile, referința și preview-ul existente se păstrează, dacă nu ai cerut explicit altceva.

Output / unde aterizează

Rezultatul este un skill personal de template în zona personală de skills Codex.

După creare sau update, directorul rezultat trebuie verificat să conțină:

• SKILL.md;
• artifact-template.json;
• agents/openai.yaml;
• assets/reference.<ext>;
• assets/preview.png.

Răspunsul final al skill-ului include instrucțiuni de găsire în Template Gallery, instrucțiunea de folosire prin tag-uirea skill-ului returnat și o directivă de card:

::artifact-template{skill_name="{skillName}" skill_directory="{skillPath}" display_name="{displayName}" artifact_kind="{kind}"}

Valorile reale trebuie să vină din rezultatul verificat al scriptului, nu din presupuneri. Pentru batch, blocul de răspuns se repetă separat pentru fiecare template creat sau actualizat.

Limite / gotchas

Skill-ul gestionează doar template-uri personale. Nu creează, modifică, publică sau încarcă pluginuri. Nu modifică marketplace-uri, cache-uri bundled sau template-uri plugin-backed.

Nu caută și nu descarcă template-uri remote. Nu creează request.json sau alte fișiere intermediare de request; inputurile sunt transmise direct către workflow-ul de creare sau update. Nu șterge și nu sanitizează referința păstrată, pentru că fidelitatea template-ului depinde de păstrarea fișierului sursă.

La update, păstrează numele folderului skill-ului și orice fișier sau comportament pe care nu ai cerut explicit să-l schimbe. Dacă se schimbă referința, preview-ul, display name-ul sau descrierea, valorile neschimbate trebuie păstrate explicit. Workflow-ul validează tipul template-ului existent, păstrează fișierele suplimentare deținute de skill și înlocuiește pachetul atomic fără să schimbe numele skill-ului.

Nu adaugă generare de pachete Artifact.md și nu modifică metadate globale sau protocoale. Asta aparține altor workflow-uri, nu acestui bisturiu.