Publicarea unui CLI generat cu printing-press-publish

All guides

Ce face

Skill-ul printing-press-publish ia un CLI generat local și îl trimite ca pull request în repo-ul oficial printing-press-library. Creează un fork (dacă e nevoie), împinge o ramură nouă și deschide sau actualizează PR-ul. Totul se bazează pe fișierele library/<category>/<api-slug>/.printing-press.json și manifest.json ca sursă de adevăr; skill-ul nu atinge registry.json, README-urile sau cli-skills/pp-*/SKILL.md pentru că astea sunt regenerate automat după merge.

Când îmi folosește

Îl folosești când ai terminat de generat sau lustruit un CLI (de exemplu cu printing-press-polish) și vrei să-l propui pentru includerea în biblioteca publică. E pasul final de publicare, nu unul de testare sau editare locală. Skill-ul verifică mai întâi contextul invocării: dacă vine ca continuare automată din polish, oprește execuția și cere o comandă proaspătă de la tine.

Cum îl invoc / declanșez

Trebuie să-l apelezi direct, cu o comandă scrisă de tine într-un mesaj nou. Formatele acceptate sunt:

/printing-press publish notion-pp-cli
/printing-press publish notion
/printing-press publish notion --from-polish
/printing-press publish notion --skip-live-test=auth-unavailable
/printing-press publish

Flag-ul --from-polish marchează că vine dintr-o sesiune de polish anterioară (se salvează POLISH_HANDOFF=true). Flag-ul --skip-live-test=<reason> e singura cale de a sări peste testul live și acceptă doar motive concrete (auth-unavailable, outage upstream etc.). Nu inventa motive și nu combina flag-urile cu alte skill-uri.

Exemplu practic

După ce ai generat CLI-ul notion, scrii într-un mesaj nou:

/printing-press publish notion

Skill-ul detectează folderul sursă, verifică versiunea minimă 4.0.0 a binary-ului, rulează setup-ul (inclusiv determinarea _scope_dir prin git), apoi creează PR-ul. Dacă ai terminat polish-ul și vrei să publici imediat, folosești varianta cu --from-polish.

Output / unde aterizează

Rezultatul e un pull request deschis în mvanhorn/printing-press-library. PR-ul conține doar modificările din library/<category>/<api-slug>/ și manifest.json. După merge, workflow-urile din repo regenerează automat registry.json și fișierele de documentație. Poți urmări PR-ul direct pe GitHub.

Limite / gotchas

• Nu rula skill-ul ca continuare automată din printing-press-polish; cere întotdeauna o comandă proaspătă de tip /printing-press publish ....
• Orice PR care modifică registry.json sau cli-skills/pp-*/SKILL.md e respins automat de verificarea verify-library-conventions.yml.
• --skip-live-test se folosește doar pentru motive operator-aprobate; nu-l folosi pentru latență obișnuită.
• Setup-ul inițial necesită binary-ul minim 4.0.0; dacă ai o versiune mai veche, skill-ul refuză execuția.
• Pentru detalii complete despre pașii de setup și variabilele de mediu, verifică doctrina pentru detalii exacte.