package-cowork-plugin

Zabalení a distribuce pluginu pro Claude Cowork

Cowork plugin nemá kompilační build — „packaging" = zazipování adresáře do souboru .plugin (ZIP archiv). Pro většinu interních pluginů Fullsys ale balení netřeba — primární kanál je GitHub sync, který čte adresáře přímo z repozitáře.

Kdy použít

Když chceš plugin distribuovat — vybrat distribuční kanál, případně sestavit .plugin ZIP (fallback) nebo org-plugins/ payload (MDM).

Distribuční kanály (pořadí priority pro Fullsys)

Kanál	Kdy	Jak
A — GitHub sync (primární)	běžná interní distribuce	merge PR do main → Cowork Private Marketplace synchronizuje marketplace.json automaticky (~30 min). Žádné balení netřeba.
B — org-plugins/ (MDM)	povinné / řízené nasazení, offline	.\tools\Build-OrgPlugins.ps1 → payload + version.json → MDM (Intune) do C:\Program Files\Claude\org-plugins\
C — ZIP upload (fallback)	ad-hoc, bez gitu	.\tools\Build-CoworkPlugin.ps1 → .plugin → ruční upload do Private Marketplace (limit ≤ 50 MB)

Sestavení .plugin (kanál C)

Vždy nejdřív validuj (skill validate-cowork-plugin), pak zabal:

.\tools\Build-CoworkPlugin.ps1 -Path .\plugins\muj-plugin
# -> dist\muj-plugin.plugin

Skript balí do dočasné složky a teprve pak kopíruje do dist\ (kvůli oprávněním), vyloučí nečistoty a .plugin pojmenuje podle name z manifestu.

Manuálně (PowerShell ekvivalent zip)

Na Windows použij Compress-Archive (ne zip):

$plugin = ".\plugins\muj-plugin"
$tmp = Join-Path $env:TEMP "muj-plugin.zip"
Compress-Archive -Path (Join-Path $plugin '*') -DestinationPath $tmp -Force
New-Item -ItemType Directory -Force -Path .\dist | Out-Null
Move-Item $tmp .\dist\muj-plugin.plugin -Force

.plugin je obyčejný ZIP archiv obsahu adresáře pluginu (.claude-plugin/, skills/, .mcp.json jsou v kořeni archivu — ne zabalené v podsložce).

Sestavení org-plugins/ payloadu (kanál B)

.\tools\Build-OrgPlugins.ps1
# -> dist\org-plugins\<name>\ (+ version.json) pro každý plugin

version.json nese verzní string — jeho změna spustí re-sync při dalším startu Coworku. Payload nasadí MDM do C:\Program Files\Claude\org-plugins\.

Verzování

• Bumpni version v plugin.json (semver) při stabilním release.
• Pro pilotní vývoj stačí git commit SHA (každý commit = nová verze).
• Release channels (stable / latest) = dva marketplaces na různém ref/sha.

Build artefakty NEpatří do gitu

dist\ (.plugin ZIP i org-plugins/ payload) jsou build artefakty — vznikají v CI nebo lokálně a jsou v .gitignore. Zdroj pravdy je vždy adresář pluginu v plugins/.