Przejdź do głównej zawartości

Zespół platformowy agentów: harness jako produkt

Zespół platformowy agentów utrzymuje wspólny harness agentów kodujących jako produkt wewnętrzny: politykę zarządzaną, wspólne skille i hooki, katalog MCP, ewaluacje harnessu, środowiska agentów i telemetrię. Publikuje poziomy usług dla zespołów produktowych, każdą zmianę harnessu przepuszcza przez bramkę ewaluacji i trzyma się z dala od zatwierdzania pull requestów zespołów produktowych.

Trzy miesiące temu zatwierdziłeś powołanie grupy platformowej. Zbudowała plugin, którego nikt nie zainstalował, plik polityki, który bez ostrzeżenia zablokował serwery MCP dwóch zespołów, i kolejkę zgłoszeń, na które odpowiedź trwa dziś jedenaście dni. Zespoły produktowe kopiują już skille do własnych repozytoriów, żeby ją obejść. Harness istnieje, ale działa jak okienko obsługi zgłoszeń, a nie jak produkt.

Ta strona jest dla CTO, który finansuje zespół, i dla tech leada, który nim kieruje albo od niego zależy. Podział odpowiedzialności i to, kiedy dedykowany zespół ma uzasadnienie, opisuje model operacyjny; tutaj chodzi o prowadzenie zespołu, który już istnieje.

  • Jednostronicową kartę zespołu (charter): misję, zakres, to, czego zespół odmawia, i poziomy usług.
  • Uporządkowany backlog dziewięciu produktów harnessu, każdy z testem „gotowe, gdy”.
  • Ten backlog przełożony na konfigurację Claude Code, Codeksa i Cursora.
  • Bramkę ewaluacji wydań harnessu w CI, z regułą decyzyjną i wskazaną osobą, która podpisuje wynik.
  • Tabelę poziomów usług i pięć metryk produktowych.
  • Pięć zasad, które nie pozwalają zespołowi platformowemu stać się bramką.

Dlaczego prowadzić harness jak produkt, a nie projekt?

Dział zatytułowany „Dlaczego prowadzić harness jak produkt, a nie projekt?”

Artefakty harnessu są stanem współdzielonym. Skill, hook, klucz polityki albo serwer MCP zmienia zachowanie każdej sesji agenta, która go wczytuje, i zmienia się dalej, bo modele, klienty i bazy kodu ruszają się pod nim. Projekt, który „wdraża harness” i się rozwiązuje, zostawia artefakt bez właściciela, który niszczeje.

Dowody na sens tej inwestycji są korelacyjne, ale spójne. Raport DORA 2025 stwierdza, że „90% of organizations have adopted at least one platform and there is a direct correlation between a high quality internal platform and an organization’s ability to unlock the value of AI” (Google Cloud, 2025-09-23). „Quality internal platforms” to także jedna z siedmiu zdolności modelu DORA AI Capabilities (Google Cloud, 2025-09-23). Stripe pokazuje, jak to wygląda w skali: jego Toolshed „currently contains nearly 500 MCP tools for internal systems and SaaS platforms we use at Stripe” (blog inżynierski Stripe, 2026-02-19), czyli jeden katalog, z którego korzysta każde uruchomienie agenta.

„Produkt” znaczy tu trzy konkretne rzeczy: zespoły produktowe mogą odmówić większości tego, co dostarczasz, każde wydanie ma wersję i da się je wycofać, a sukces mierzy się tym, co zmienia się dla tych zespołów.

Skopiuj to do podręcznika inżynierskiego i uzupełnij pola w nawiasach ostrych. Lista „czego nie robimy” jest ważniejsza niż zakres: to ją zespoły produktowe zacytują, gdy zespół platformowy zacznie wchodzić im w drogę.

# Karta zespołu platformowego agentów: <organizacja>, v<N>, <data>
## Misja
Sprawić, by każdemu zespołowi produktowemu dostarczanie z agentami było tanie
i bezpieczne, i udowadniać to dowodami, a nie wysiłkiem recenzentów.
## Klienci
Zespoły produktowe używające Claude Code, Codeksa lub Cursora. Bezpieczeństwo
i właściciel wydań są partnerami, nie klientami.
## Odpowiadamy za (produkty harnessu)
1. Minimum polityki: ustawienia zarządzane i wymagania dla każdego narzędzia.
2. Plugin „utwardzonej ścieżki”: wspólne skille, hooki i agenty, jeden marketplace.
3. Katalog MCP: sprawdzone serwery, zawężone poświadczenia, ścieżka zgłoszeń.
4. Ewaluacje harnessu: zestaw, który musi przejść każda zmiana harnessu.
5. Środowiska agentów: obrazy dev container i piaskownice w chmurze lub własne.
6. Telemetria: dane o użyciu, kosztach i wynikach we własnym kolektorze.
7. Kanały wersji: które wersje klientów i które modele działają w zespołach.
8. Onboarding: ścieżka pierwszego tygodnia do pierwszej przyjętej zmiany agenta.
(Tożsamości agentów prowadzimy razem z bezpieczeństwem; zob. model operacyjny.)
## Czego nie robimy
- Nie zatwierdzamy, nie blokujemy i nie recenzujemy pull requestów zespołów produktowych.
- Nie decydujemy, co sprawdzają testy i kryteria akceptacji produktu.
- Nie narzucamy żadnego elementu utwardzonej ścieżki spoza minimum polityki.
- Nie wydajemy zmiany harnessu, która nie przeszła zestawu ewaluacji.
## Minimum polityki (jedyna obowiązkowa część)
<lista kontroli wymaganych przez bezpieczeństwo: dozwolone modele, allowlista
MCP, zarządzane hooki skanujące sekrety, eksport telemetrii, limity uprawnień>
## Poziomy usług
Zob. tabelę poziomów usług; publikowane pod <URL>, raport co miesiąc.
## Wkład z zespołów
Każdy inżynier może zaproponować skill, hook lub serwer MCP pull requestem do
<repozytorium marketplace'u> razem z przypadkami ewaluacji. Odpowiadamy w <N> dni roboczych.
## Wyjątki
Zespół może zrezygnować z dowolnego elementu utwardzonej ścieżki, wpisując to do
<pliku wyjątków> z właścicielem i datą wygaśnięcia (maks. 90 dni).
## Przegląd
Co kwartał z CTO i dwoma tech leadami zespołów produktowych. Podpis: <CTO>.

Oto dziewięć produktów harnessu w kolejności, w jakiej potrzebuje ich większość organizacji. Kolumna „gotowe, gdy” to test akceptacyjny każdego z nich: bez tego dowodu pozycja nie jest skończona.

#Produkt harnessuCo dostarcza zespółGotowe, gdy
1Minimum politykiUstawienia zarządzane (Claude Code), requirements.toml (Codex), ustawienia administracyjne zespołu (Cursor) z kontrolami wymaganymi przez bezpieczeństwoMaszyna testowa z własną konfiguracją programisty nadal dostaje minimum; serwer MCP spoza listy zostaje odrzucony
2Telemetria i kosztyEksport OpenTelemetry z każdego klienta do twojego kolektora; dashboard na zespółKoszt i sesje każdego zespołu widać w ciągu doby, bez dopytywania programistów
3Kanały wersjiPrzypięty kanał klienta i dozwolone modele, proces awansu między nimiNowy model albo klient trafia do wszystkich dopiero po przejściu zestawu ewaluacji
4Ewaluacje harnessuZłote zadania z własnych repozytoriów, oceniacze, zadanie w CIKażdy pull request do harnessu pokazuje wynik względem bieżącego wydania
5Plugin utwardzonej ścieżkiJeden marketplace ze wspólnymi skillami, hookami i subagentami, wersjonowane wydaniaCo najmniej dwa zespoły używają go bez przymusu, a jego koszt kontekstu jest opublikowany
6Katalog MCPSprawdzone serwery z zawężonymi poświadczeniami per agent i formularzem zgłoszeńZgłoszenie nowego serwera dostaje odpowiedź w ramach poziomu usług, z zapisaną decyzją bezpieczeństwa
7Środowiska agentówObrazy dev container, wspólne środowiska w chmurze lub własne, z allowlistą sieciAgent startuje w czystym środowisku, które buduje i testuje repozytorium bez ręcznej konfiguracji
8OnboardingŚcieżka pierwszego tygodnia, zadania startowe, prompty działające w twojej bazie koduNowy inżynier dowozi pierwszą przyjętą zmianę agenta w docelowym czasie
9Ścieżka wkładuSzablony, przykładowe przypadki ewaluacji, dyżur recenzentówWiększość nowych skilli pochodzi od zespołów produktowych, nie od zespołu platformowego

Tożsamości i poświadczeń agentów celowo nie ma na tej liście. Zespół platformowy wykonuje pracę, ale rozliczalne jest bezpieczeństwo; procedurę opisuje strona tożsamość agentów, poświadczenia i sekrety.

W jakiej kolejności nowy zespół platformowy powinien to budować?

Dział zatytułowany „W jakiej kolejności nowy zespół platformowy powinien to budować?”
  1. Tygodnie 1–3: minimum polityki i telemetria. Dostarcz je razem: bez telemetrii nie ocenisz, czy cokolwiek późniejszego jest używane, a bez minimum bezpieczeństwo nie pozwoli niczego poszerzyć.

  2. Tygodnie 3–6: kanały wersji i zestaw ewaluacji. Zbierz 20–40 złotych zadań z rzeczywistej, scalonej pracy w dwóch lub trzech repozytoriach, każde z oceniaczem (zwykle z testami samego repozytorium). Uruchom je na bieżącym kliencie i modelu, żeby ustalić punkt odniesienia. Ten zakres to robocza liczba tego przewodnika, a nie opublikowany benchmark.

  3. Tygodnie 6–10: plugin utwardzonej ścieżki. Zacznij od dwóch lub trzech skilli, które zespoły już kopiują między repozytoriami; istniejący nawyk przyjmuje się szybciej niż nowy pomysł.

  4. Tygodnie 8–12: katalog MCP i środowiska. Najpierw sprawdź serwery, które zespoły już uruchamiają na prywatnych tokenach; każdy z nich jest dziś ryzykiem związanym z poświadczeniami.

  5. Od 12. tygodnia: onboarding i ścieżka wkładu. Opublikuj pierwszy raport poziomów usług i zaproś zespoły do współtworzenia.

Jak backlog przekłada się na Claude Code, Codeksa i Cursora

Dział zatytułowany „Jak backlog przekłada się na Claude Code, Codeksa i Cursora”

Backlog jest niezależny od narzędzia, konfiguracja już nie. Sekcja team/ każdego narzędzia opisuje jego wdrożenie szczegółowo: Claude Code dla zespołów, Codex dla zespołów i Cursor dla zespołów. Porównanie polityk obok siebie znajdziesz w artykule jedna polityka dla wszystkich agentów kodujących.

Minimum polityki, kanały i telemetria żyją w ustawieniach zarządzanych, dostarczanych jako managed-settings.json, przez MDM albo jako ustawienia zarządzane z serwera w konsoli claude.ai (Team i Enterprise). Ustawienia zarządzane mają pierwszeństwo przed każdym innym poziomem.

{
"autoUpdatesChannel": "stable",
"availableModels": ["opus", "sonnet"],
"enforceAvailableModels": true,
"allowManagedHooksOnly": true,
"allowManagedMcpServersOnly": true,
"extraKnownMarketplaces": {
"acme-plugins": { "source": { "source": "github", "repo": "acme/acme-plugins" } }
},
"enabledPlugins": { "acme-harness@acme-plugins": true },
"env": {
"CLAUDE_CODE_ENABLE_TELEMETRY": "1",
"OTEL_METRICS_EXPORTER": "otlp",
"OTEL_LOGS_EXPORTER": "otlp",
"OTEL_EXPORTER_OTLP_PROTOCOL": "grpc",
"OTEL_EXPORTER_OTLP_ENDPOINT": "http://otel-collector.acme.internal:4317"
}
}

acme/acme-plugins to repozytorium marketplace’u zespołu platformowego, a acme-harness jego plugin. Zmienne telemetrii umieść w ustawieniach zarządzanych albo użytkownika. Od v2.1.282 (kanał latest) Claude Code ignoruje zmienne eksportu telemetrii w bloku env projektowego .claude/settings.json; na stable 2.1.274 plik projektu nadal może je ustawić, więc tylko ustawień zarządzanych repozytorium nie nadpisze na żadnym z kanałów. Metryki obejmują claude_code.cost.usage, claude_code.token.usage i claude_code.session.count.

Kanały: przypnij stable (2.1.274 w dniu 2026-09-26; latest miał 2.1.283), a latest włączaj tylko grupie kanarkowej.

Środowiska: środowiska self-hosted (beta dla Team i Enterprise, claude --environment ccpool_…) czytają ustawienia zarządzane z serwera oraz — jeśli jest jednym ze stosowanych źródeł zarządzanych — plik ustawień zarządzanych z obrazu runnera. Na maszynie wirtualnej zarządzanej przez Anthropic obowiązują tylko ustawienia zarządzane z serwera, a pluginy włączone przez repozytorium nie są instalowane. Zobacz też konfigurację dev containera i przewodnik po bramce LLM.

Koszt kontekstu: claude plugin details acme-harness wypisuje inwentarz komponentów pluginu i przewidywany koszt w tokenach. Publikuj tę liczbę z każdym wydaniem.

Jak udowodnić, że wydanie harnessu nie pogarsza pracy agentów?

Dział zatytułowany „Jak udowodnić, że wydanie harnessu nie pogarsza pracy agentów?”

Każda zmiana harnessu (edycja skilla, hook, klucz polityki, wersja klienta czy model) zmienia zachowanie każdego agenta, więc przed wydaniem przechodzi przez zestaw ewaluacji. Zespół platformowy podpisuje wynik ewaluacji, a nie lekturę diffa.

Zestaw ma trzy warstwy:

  • Złote zadania z twojej scalonej pracy, każde z deterministycznym oceniaczem: testami repozytorium, sprawdzeniem typów, bramką lintera albo funkcją dopasowania (fitness function). One decydują o wydaniu.
  • Sprawdzenia oceniane przez model tam, gdzie testy nie sięgają, np. czy skill do code review znalazł podrzucony defekt. Informują o decyzji, a człowiek sprawdza ich próbkę.
  • Telemetria kanarkowa po wydaniu: koszt na sesję i prośby o wycofanie z grupy kanarkowej.

claude plugin eval uruchamia przypadki ewaluacji pluginu (evals/**/case.yaml albo prompt.md z graders/*.md), a gdy plugin daje się rozwiązać, dodaje ramię bazowe bez pluginu, więc widzisz różnicę, jaką plugin wnosi. W CI:

Okno terminala
# Zadanie CI przy każdym pull requeście do repozytorium marketplace'u
claude plugin eval ./plugins/acme-harness \
--trust-plugin --runs 3 --threshold 0.8 \
--max-cost-usd 25 --no-publish --json eval-results.json

--threshold kończy się kodem 1, jeśli którykolwiek przypadek wypadnie poniżej progu; --max-cost-usd przerywa bieg przy limicie i zwraca częściowe wyniki (kod 2). --trust-plugin wykonuje kod pluginu z uprawnieniami użytkownika joba (tekst pomocy porównuje go do --dangerously-skip-permissions), więc uruchamiaj ten job tylko dla gałęzi w repozytorium marketplace’u, nigdy dla forków, na jednorazowym runnerze, którego jedynym sekretem jest klucz ewaluacyjny z limitem wydatków. Oceniacz LLM domyślnie używa Haiku; zmienisz go przez --judge-model. Wszystkie flagi sprawdzone w Claude Code 2.1.283.

Reguła decyzyjna. Wpisz ją do karty przed pierwszym wydaniem: wydanie harnessu wchodzi, gdy odsetek zaliczonych złotych zadań nie spadł względem bieżącego wydania w żadnym repozytorium z zestawu, a koszt na zaliczone zadanie nie wzrósł ponad uzgodniony margines. Podpisuje lider zespołu platformowego; bezpieczeństwo współpodpisuje wszystko, co dotyka minimum polityki. Metody budowy zestawu opisują ewaluacje agentów kodujących i sprawdzenia oceniane przez model.

Jakie poziomy usług zespół platformowy powinien obiecać zespołom produktowym?

Dział zatytułowany „Jakie poziomy usług zespół platformowy powinien obiecać zespołom produktowym?”

Poziomy usług zamieniają „zespół platformowy jest wolny” w liczbę. Opublikuj je, raportuj co miesiąc i pozwól zespołom produktowym eskalować naruszenie do CTO. Wartości to punkty startowe tego przewodnika, a nie branżowy benchmark; skoryguj je po pierwszym miesiącu danych.

UsługaJak mierzonaCel startowy
Zgłoszenie do harnessu (nowy skill, serwer MCP, zmiana polityki)Czas od zgłoszenia do decyzji: tak, nie albo termin3 dni robocze
Recenzja wkładuCzas od pull requestu zespołu produktowego do marketplace’u do scalenia lub konkretnej informacji zwrotnej2 dni robocze
Zepsuty wspólny hook lub skillCzas od pierwszego zgłoszenia do wycofania na każdej maszynie4 godziny
Unieważnienie tożsamości agenta (z bezpieczeństwem)Czas od zgłoszenia incydentu do unieważnienia poświadczenia15 minut
Nowa wersja klienta lub modeluCzas od wydania u dostawcy do decyzji „oceniony, awansowany lub wstrzymany”5 dni roboczych
Obraz środowiskaOdsetek sesji agentów startujących w czystym, budującym się środowisku95%

Ćwicz wiersze o wycofaniu i unieważnieniu: raz na kwartał zepsuj hook na gałęzi kanarkowej i zmierz, ile trwa dotarcie poprawki do każdego programisty; mechanikę wydań opisuje zarządzanie wspólnymi hookami.

Jak nie dopuścić, by zespół platformowy stał się bramką?

Dział zatytułowany „Jak nie dopuścić, by zespół platformowy stał się bramką?”

Zespół platformowy staje się bramką w chwili, gdy zespoły produktowe czekają na niego, żeby dowieźć pracę produktową. Zapobiega temu pięć sprawdzalnych zasad.

  1. Oddziel minimum polityki od utwardzonej ścieżki. Obowiązkowe jest tylko minimum, a za jego treść odpowiada bezpieczeństwo. Wszystko inne to oferta; jeśli skill trzeba narzucić, nie jest jeszcze wystarczająco dobry.

  2. Nigdy nie stawaj na ścieżce code review produktu. Zespołu platformowego nie ma w CODEOWNERS repozytoriów produktowych ani w ochronie gałęzi. Recenzuje wyłącznie zmiany harnessu. Code review zmian produktowych opisuje kolejka code review.

  3. Przyjmuj wkład z przypadkami ewaluacji, a nie prośby o zgodę. Zespół, który chce nowego skilla, otwiera pull request do marketplace’u ze skillem i dwoma lub trzema przypadkami ewaluacji, a zespół platformowy ocenia go na podstawie wyniku ewaluacji w ramach poziomu usług.

  4. Dopuszczaj wyjątki z datą wygaśnięcia. Zespół może zastąpić skill lub hook z utwardzonej ścieżki własnym, jeśli zapisze właściciela i datę wygaśnięcia. Każdy wyjątek to luka w produkcie i pozycja w backlogu platformy.

  5. Publikuj kolejkę. Wiek zgłoszeń, czas recenzji wkładu i otwarte wyjątki stoją obok poziomów usług. Widoczną kolejkę ktoś naprawia.

Jak mierzyć zespół platformowy agentów jak produkt?

Dział zatytułowany „Jak mierzyć zespół platformowy agentów jak produkt?”

Mierz to, co zmienia się dla zespołów produktowych, a nie to, co produkuje zespół platformowy: liczba wydanych skilli to wynik pracy, tych pięć metryk to efekty. Kanoniczne definicje metryk dla całej organizacji zawiera strona frameworki metryk.

MetrykaDefinicjaDlaczego ma znaczenie
Dobrowolna adopcjaOdsetek aktywnych sesji agentów, które wczytują plugin utwardzonej ścieżki tam, gdzie nie jest włączany przymusowoJedyny uczciwy sygnał, że utwardzona ścieżka jest lepsza od alternatyw
Czas do pierwszej przyjętej zmiany agentaDni od pierwszej sesji nowego inżyniera do jego pierwszej scalonej zmiany napisanej przez agenta, która przeszła wszystkie bramkiMierzy łącznie onboarding i środowiska
Wskaźnik forkówLiczba wspólnych skilli lub hooków skopiowanych do repozytoriów produktowych i zmodyfikowanychKażdy fork to brakująca funkcja albo niedotrzymany poziom usług
Incydenty wywołane przez harnessIncydenty, których postmortem wskazuje wspólny skill, hook, politykę lub środowiskoJakość wydań samej platformy
Koszt na przyjętą zmianęWydatki na agentów podzielone przez scalone zmiany napisane przez agentów, które przeszły wszystkie bramki, per zesp󳣹czy telemetrię z efektami; zob. zarządzanie kosztami

Raportuj je per zespół, nigdy per osoba. Telemetria, która rankinguje ludzi, staje się celem w ocenach pracy, a potem inwigilacją; jak trzymać ją z dala od ocen, opisuje strona ścieżki kariery i oceny pracy.

Prompty do skopiowania dla zespołu platformowego agentów

Dział zatytułowany „Prompty do skopiowania dla zespołu platformowego agentów”

Uruchom je w Claude Code, Codeksie lub Cursorze. Działają tak samo we wszystkich trzech narzędziach.

Co psuje się w zespole platformowym agentów i jak to naprawić

Dział zatytułowany „Co psuje się w zespole platformowym agentów i jak to naprawić”

Zespół platformowy staje się bramką code review. Pull requesty produktowe czekają na zgodę platformy, bo „to oni odpowiadają za agentów”. Naprawa: usuń zespół platformowy z CODEOWNERS repozytoriów produktowych, przypomnij listę „czego nie robimy” i zamień ręczne sprawdzenie w hook albo przypadek ewaluacji.

Nikt nie korzysta z utwardzonej ścieżki. Zespół zbudował to, co jego zdaniem było potrzebne. Naprawa: uruchom pierwszy prompt powyżej, przebuduj plugin wokół trzech najczęściej kopiowanych skilli i przez miesiąc mierz dobrowolną adopcję, zanim zbudujesz coś więcej.

Zmiana minimum polityki psuje pracę zespołów bez ostrzeżenia. Aktualizacja allowlisty odrzuca serwer MCP, od którego zależą dwa zespoły. Naprawa: wycofaj zmianę tym samym kanałem, dodaj grupę kanarkową, która dostaje zmiany minimum tydzień wcześniej, i zapowiadaj je z datą.

Plugin zjada okno kontekstu. Ulubiony skill każdego zespołu trafił do wspólnego pluginu i każda sesja zaczyna się od tysięcy tokenów opisów. Naprawa: publikuj przewidywany koszt w tokenach przy każdym wydaniu (claude plugin details w Claude Code), ustal budżet i wydziel rzadko używane skille do opcjonalnego pluginu.

Aktualizacja modelu lub klienta wchodzi przed ewaluacjami. Nowa wartość domyślna przychodzi z automatyczną aktualizacją i zachowanie agentów w całej organizacji zmienia się z dnia na dzień. Naprawa: przypnij kanał i dozwolone modele w polityce zarządzanej, a poziom usług dla kanałów wersji uczyń jedyną drogą awansu. Aktualne wartości domyślne są w hubie modeli.

Telemetria zamienia się w ranking. Ktoś eksportuje liczbę tokenów per osoba do oceny pracy. Naprawa: agreguj dane do poziomu zespołu w kolektorze, ogranicz dostęp do surowych danych do zespołu platformowego i bezpieczeństwa, a to ograniczenie wpisz do karty.

Na ścieżce CTO ta strona następuje po polityce zarządzanej, która definiuje minimum polityki, i prowadzi do zarządzania kosztami, które nakłada budżety na zbieraną teraz telemetrię.

Edytuj stronę

Ostatnia aktualizacja:

Cytuj tę stronę — https://developertoolkit.ai/pl/org/platform-team/, developertoolkit.ai