Skill agenta kampanii: marża po zwrotach, nie ROAS

Skill „rozliczenie-kampanii” liczy marżę każdej kampanii sklepu wielokanałowego po zwrotach, prowizjach, płatnościach, wysyłce i reklamie, a pobierzecie go za darmo z GitHuba. Kampania może pobić rekord przychodu i mieć najwyższy zwrot z wydatków na reklamę (ROAS), a i tak prawie nic nie zarobić. Taki rachunek składa się dziś z trzech paneli i jednego arkusza księgowej, więc zarząd zna marżę kampanii z opóźnieniem. Skill robi ten rachunek na eksporcie miesiąca i kładzie go obok ROAS. Repozytorium: moja-firma-handel na GitHubie.

To pakiet branżowy otwartej paczki moja-firma. Rdzeń paczki opisujemy w osobnym tekście: moja-firma, otwarte skille AI dla polskiej firmy.

Co robi skill, a czego nie zrobi

Skill to procedura w formacie Agent Skills, zapisana w jednym pliku SKILL.md. Czyta trzy pliki: plan kampanii z kosztem reklamy, zamówienia z miesiąca i zwroty. Potem pracuje w sześciu krokach.

1. Grupuje zamówienia według kampanii. Zamówienia bez oznaczenia kampanii pokazuje osobno jako „bez kampanii”.
2. Dla każdej grupy liczy zamówienia, zwroty, przychód netto, zwroty netto, koszt towaru po zwrotach, prowizje, opłaty za płatności, wysyłkę, obsługę zwrotów i koszt reklamy.
3. Liczy marżę po wszystkich tych kosztach i marżę procentową od przychodu po zwrotach. ROAS liczy od przychodu przed zwrotami, tak jak pokazuje go panel reklamowy.
4. Oznacza kampanie: „rekord przychodu, słaba marża”, „na minusie” i „do wzmocnienia”. Progi są zapisane jawnie, więc marketing może je zmienić.
5. Przy oznaczonych kampaniach wskazuje dwie największe pozycje kosztu poza towarem. Gdy zwroty są wysokie, podaje produkt, który wraca najczęściej.
6. Przygotowuje rekomendację: co wzmocnić, co ograniczyć, co sprawdzić. Każdą propozycję uzasadnia liczbami i mówi, kto decyduje.

Zwrot skill przypisuje do kampanii po numerze zamówienia, a nie po dacie. To ważne, bo zwroty z jednego miesiąca spływają przez cały następny. Skill liczy kodem na plikach i przy każdej sumie podaje, ilu wierszy dotyczy. Na koniec oddaje tabelę, oznaczenia, rekomendację i plik XLSX.

Decyzje zostają przy ludziach. Marketing zarządza budżetem reklamowym i wyłącza kampanie. Zarząd decyduje o kampanii bez marży, którą firma chce utrzymać dla zasięgu. Skill niczego nie wyłącza, nie przesuwa budżetu, nie wysyła wiadomości i nie zmienia rekordów w systemach. Proponuje.

Gdzie zwykła automatyzacja się myli

Najczęstszy błąd siedzi w kalendarzu. Zwroty z kwietnia spływają przez cały maj. Gdyby rozliczyć kampanię marketplace 5 maja, widać by było 14 z 50 zwrotów i marżę 4 055,20 zł, czyli 5,3%. Po zamknięciu okna zwrotów zostaje z tego 827,93 zł.

Reguła, która 5 maja automatycznie dołożyłaby budżet „rentownej” kampanii, dołożyłaby go do kampanii, która niemal nic nie zarobiła. Panel reklamowy tego nie pokaże, bo zwrotów nie widzi. ROAS tej kampanii wynosi 22,61 i nie zmienia się po żadnym zwrocie.

W wyniku kontrolnym jest jeszcze jeden test. Pod koniec maja wracają dwie kosiarki uszkodzone w transporcie, których nie da się sprzedać ponownie. Po ich dopisaniu marża tej samej kampanii spada do −105,07 zł, czyli −0,2%. ROAS zostaje 22,61. Dwie paczki zamieniają rekordową kampanię w stratną.

Drugi warunek dotyczy danych. Jeśli zamówienia w Waszym eksporcie nie mają oznaczenia kampanii, a ten sam produkt nosi inny indeks w każdym kanale, skill policzy marżę starannie, ale na złych przypisaniach. Najpierw jedno oznaczenie kampanii w zamówieniu i jeden indeks produktu, potem agent.

Co jest w repozytorium

• Procedura skills/rozliczenie-kampanii/SKILL.md w wersji 0.1.0, na licencji MIT.
• Dane ćwiczeniowe w katalogu dane-cwiczeniowe/: kampanie.csv, kampanie.xlsx, zamowienia.csv, zamowienia.xlsx, zwroty.csv, zwroty.xlsx. Pliki CSV i XLSX mają tę samą treść. Opisują fikcyjny sklep ogrodowy: kwiecień 2026, pięć kampanii, 1015 zamówień i 88 zwrotów.
• Wynik kontrolny w pliku WYNIK-KONTROLNY.md: liczby policzone niezależnie z tych samych plików i krok z rzeczywistością, czyli jedna zmiana w danych z oczekiwanym wynikiem.
• Paczki ZIP dla poszczególnych narzędzi w zakładce Releases: najnowsze wydanie. Te same paczki zbuduje skrypt scripts/build.mjs.

Na własnych danych potrzebujecie trzech eksportów. Z platformy sklepowej, marketplace albo integratora: numer zamówienia, data, kanał, oznaczenie kampanii, indeks, wartość netto, prowizja, opłata za płatność i koszt wysyłki. Z ERP: koszt towaru na zamówieniu. Z obsługi zwrotów: numer zamówienia, wartość zwrotu, czy towar wrócił do sprzedaży i koszt obsługi. Plan kampanii z kosztem reklamy zwykle prowadzi marketing w arkuszu. Kolumny mogą nazywać się po Waszemu, bo skill pokaże przypisanie i zapyta, gdy coś jest niejednoznaczne.

Jak zainstalować skill

Przepisy krok po kroku na blogu pokazują budowę tego agenta od zera, z klikaniem w menu i wklejaniem instrukcji. Skill daje gotową procedurę, więc zostaje Wam instalacja i sprawdzenie wyniku. Nazwy menu zmieniają się często, więc w razie różnic sprawdźcie dokumentację narzędzia.

Anthropic Claude. W Claude Code wpiszcie dwa polecenia:

/plugin marketplace add majchrzycki-com/moja-firma
/plugin install moja-firma-handel@moja-firma

W aplikacji Claude dodajcie plik ZIP z wydania jako umiejętność w ustawieniach. Budowa od zera: agent kampanii w Claude krok po kroku.

Microsoft 365 Copilot. W Copilot Cowork wybierzcie Dostosuj, potem Umiejętności i Dodaj, a następnie zaimportujcie SKILL.md. W Agent Builderze wklejcie tekst z dist/instrukcje/rozliczenie-kampanii.md do pola instrukcji. Budowa od zera: agent kampanii w Microsoft 365 Copilot.

OpenAI ChatGPT. Wklejcie ten sam plik z dist/instrukcje/ do instrukcji projektu albo GPT. W OpenAI Codex skopiujcie katalog skilla do katalogu skilli. Budowa od zera: agent kampanii w ChatGPT.

Google Gemini. Otwórzcie Customize, potem Skills, Create i Upload, i wskażcie katalog procedury albo plik ZIP. Google zastępuje Gemy skillami, więc nowego agenta nie budujcie już jako Gema. Przepis dla tej platformy pokazuje wersję z Gemem: agent kampanii w Gemini. Weźcie z niego dane i sposób sprawdzenia wyniku, a procedurę wgrajcie jako skill.

OpenClaw. Skopiujcie katalog skills/rozliczenie-kampanii/ do katalogu skilli OpenClaw. Osobnego przepisu dla tej platformy nie ma.

Jak sprawdzić skill, zanim użyjecie prawdziwych danych

Dodajcie pliki ćwiczeniowe do wiedzy agenta albo załączcie je do rozmowy. Potem napiszcie:

Rozlicz kampanie z kwietnia 2026 według instrukcji projektu. Licz kodem na załączonych plikach.

Porównajcie odpowiedź z plikiem WYNIK-KONTROLNY.md. Trzy liczby mówią najwięcej:

• kampania marketplace KMP-02 ma ROAS 22,61 i marżę 827,93 zł, czyli 1,3%, i dostaje oznaczenie „rekord przychodu, słaba marża”,
• kampania w mediach społecznościowych KMP-03 wychodzi na minusie: −275,68 zł,
• przy KMP-02 skill wskazuje kosiarkę elektryczną 40 cm: 25 z 50 zwrotów tej kampanii i 11 212,50 zł zwróconej wartości.

Jeśli KMP-02 wychodzi z marżą kilku tysięcy złotych, agent prawdopodobnie pominął część zwrotów z maja. Albo nie połączył ich z zamówieniami po numerze.

Stan testów opisujemy dokładnie. Procedurę sprawdziliśmy 2.11.2026 w Anthropic Claude na danych ćwiczeniowych i liczby zgodziły się z wynikiem kontrolnym. W Microsoft 365 Copilot, OpenAI ChatGPT i Google Gemini procedury nie testowaliśmy. Nie testowaliśmy jej też na prawdziwych danych firmy. Dlatego wynik kontrolny jest Waszym pierwszym sprawdzianem w każdym narzędziu.

Skill to jeden z dwunastu agentów

Darmowy poradnik „Handel wielokanałowy jako jeden system” rozkłada drogę sklepu na dziesięć etapów, od kliknięcia do rozliczonej marży. Opisuje dwunastu agentów, którzy pracują na jednym modelu firmy, i pięć liczb dla zarządu. Agent kampanii pracuje w etapie 01, czyli przy ruchu, koszyku i zamówieniu.

Mapa serii daje też uczciwą przestrogę. Agent kampanii kusi najbardziej, ale nie zawsze warto od niego zaczynać. Jeśli stany między kanałami rozjeżdżają się o godzinę, część zamówień i tak wróci jako sprzedaż ponad stan. Wtedy najpierw jeden stan i jedna karta produktu.

Całą rozkładówkę znajdziecie we wpisie handel wielokanałowy jako jeden system, a pozostałe teksty branży w filarze handel wielokanałowy. Skille dla innych branż zbiera filar skille AI dla firmy.

Od czego zacząć w poniedziałek

Zainstalujcie skill i uruchomcie go na danych ćwiczeniowych. Gdy liczby zgodzą się z wynikiem kontrolnym, weźcie ostatnią zakończoną kampanię z własnego sklepu. Najpierw przepuśćcie eksport przez procedurę kontrola-danych z rdzenia moja-firma. Pierwszy tydzień puśćcie agenta obok normalnej pracy jednej osoby i porównujcie wyniki. Wynik zawsze sprawdza osoba, która za niego odpowiada.