fis-helper

Fullsys Cowork Marketplace

Interní marketplace pluginů pro Claude Cowork ve firmě Fullsys. Tento repozitář je zdroj pravdy — adresáře pluginů se schématem sdíleným s Claude Code — a zároveň Cowork plugin source (přidatelný přes GitHub sync do Cowork Private Marketplace).

Návrh a ověřená zjištění (formát pluginu, distribuční kanály, bezpečnost) jsou v COWORK_MARKETPLACE_RESEARCH.md. Tento README popisuje implementaci vycházející z toho návrhu.

Co repozitář obsahuje

cowork-plugins-marketplace/
├── .claude-plugin/
│   └── marketplace.json              # katalog (name, owner, plugins[]) — čte ho GitHub sync
├── plugins/                          # ZDROJ PRAVDY — adresáře pluginů
│   ├── cowork-plugin-creator/        #   nástroj na tvorbu/validaci/balení Cowork pluginů
│   └── fis-helper/                   #   ukázkový doménový plugin (FIS, MCP hranice)
├── templates/
│   └── plugin-template/              # šablona pro scaffold nového pluginu
├── tools/                            # PowerShell tooling (lokálně i v CI přes pwsh)
│   ├── New-CoworkPlugin.ps1          #   scaffold nového pluginu ze šablony
│   ├── Test-CoworkPlugin.ps1         #   validace pluginů + katalogu (exit 1 při chybě)
│   ├── Build-CoworkPlugin.ps1        #   zabalení do .plugin (ZIP) — fallback kanál
│   ├── Build-OrgPlugins.ps1          #   org-plugins payload + version.json — MDM kanál
│   └── _Common.ps1                   #   sdílené funkce
└── .github/workflows/release.yml     # CI: validace (PR/push) + packaging (tag vX.Y.Z)
# dist/ a *.plugin jsou build artefakty (mimo git — viz .gitignore)

Distribuční kanály (priorita pro Fullsys)

Kanál	Použití	Jak
A — GitHub sync (primární)	běžná interní distribuce	připojení tohoto privátního repa v Cowork org settings; auto-sync marketplace.json po merge PR. Žádné balení netřeba.
B — org-plugins/ (MDM)	povinné / řízené / offline nasazení	Build-OrgPlugins.ps1 → payload + version.json → MDM do C:\Program Files\Claude\org-plugins\
C — ZIP upload (fallback)	ad-hoc bez gitu	Build-CoworkPlugin.ps1 → .plugin → ruční upload (limit ≤ 50 MB)

Přidání repozitáře jako zdroje pluginů do Cowork (kanál A)

1. V Cowork: Organization settings → Plugins (vyžaduje roli Owner / Primary Owner).
2. Zvol GitHub sync a připoj tento privátní repozitář ladislav-filip/cowork-plugins-marketplace (veřejná repa nejsou pro org marketplace povolena).
3. Cowork načte .claude-plugin/marketplace.json a zpřístupní pluginy. Po každém merge PR do main proběhne automatický sync (~30 min) nebo lze spustit ručně.
4. Per plugin nastav instalační preferenci: Required / Installed by default / Available / Not available.

Přímý Azure DevOps git-source pro org GitHub sync není podporován — proto je vše hostováno na GitHubu (viz research, R2). Pro AzDO-only scénáře použij kanál B (org-plugins/ přes MDM).

Vytvoření nového pluginu

# 1) Scaffold ze šablony
.\tools\New-CoworkPlugin.ps1 -Name "billing-helper" -Description "Pomocník pro BILLING 2.0." -SkillName "fakturace"

# 2) Doplň skill, uprav .mcp.json, zaregistruj plugin do .claude-plugin/marketplace.json

# 3) Validace (stejná jako v CI)
.\tools\Test-CoworkPlugin.ps1 -Path .\plugins\billing-helper
.\tools\Test-CoworkPlugin.ps1 -All

# 4) (volitelně) Zabalení / org-plugins payload
.\tools\Build-CoworkPlugin.ps1 -Path .\plugins\billing-helper
.\tools\Build-OrgPlugins.ps1

Plugin cowork-plugin-creator nese stejné postupy jako skills (create-cowork-plugin, validate-cowork-plugin, package-cowork-plugin) — použitelné přímo v Coworku.

Požadavky

• Windows + PowerShell 5.1 (lokální vývoj) nebo pwsh (CI / Linux runner).
• Volitelně Claude Code CLI pro claude plugin validate --strict.
• Git přístup k privátnímu GitHub repu.

Bezpečnost (závazné principy)

• „No direct outbound calls from skills — use MCP servers." Skills popisují workflow, ale veškerý odchozí provoz k systémům Fullsys (FIS/Oracle, BILLING 2.0, NEXT WMS, RabbitMQ) jde výhradně přes interní MCP servery (HTTPS). Remote MCP přidává jen admin (managedMcpServers).
• Žádné credentials v repu — pouze expanze ${ENV_VAR} a ${CLAUDE_PLUGIN_ROOT} pro cesty.
• Žádná reálná citlivá data (PII, EIC/EAN/POD, čísla smluv, receptury, šarže, mzdy) — jen placeholdery (customer-12345, EIC 27XG000000000001, RECIPE-001, [email protected]).
• Cowork ani Code nemají podpis pluginů (#29729). Kompenzace: privátní repo + branch protection + signed commits + sha pinning v katalogu + admin kuratela + povinný PR review.

CI