Przejdź do głównej zawartości

Codex w Slacku i Linearze: delegowanie issue do zadań w chmurze

Integracje Codex ze Slackiem i Linearem uruchamiają zadanie Codex w chmurze po wzmiance @Codex w wątku Slacka, delegowaniu issue z Lineara do Codex albo regule triażu w Linearze, a postęp i wyniki publikują w tym wątku lub issue. Praca odbywa się w chmurowym środowisku Codex, więc wynik jest tyle wart, ile jego testy i bramki pull requesta.

Klient zgłasza na #support, że faktury PDF pokazują zły podatek dla adresów w Kanadzie. PM zakłada issue w Linearze, inżynier bierze je dwa dni później i przez pierwszą godzinę szuka właściwego pliku. Ta strona jest dla programisty, który chce, żeby taki błąd wracał jako przetestowany pull request, i dla tech leada, który decyduje, które issue wolno delegować i kto zatwierdza wynik.

  • Kolejność konfiguracji obu integracji, która omija najczęstszą cichą awarię: brak pasującego środowiska chmurowego.
  • Pięć promptów do skopiowania: zawężona poprawka ze Slacka, wątek „najpierw zbadaj” w Slacku, szablon issue w Linearze, które Codex jest w stanie domknąć, para komentarzy „zbadaj, potem popraw” oraz prompt dla lokalnego MCP Lineara.
  • Politykę reguł triażu: które issue Codex może przejmować i kto pozostaje odpowiedzialny.
  • Ścieżkę weryfikacji, która dowodzi, że delegowana zmiana działa, bez czytania całego diffu.

Jak wiadomość na Slacku lub issue w Linearze staje się pull requestem

Dział zatytułowany „Jak wiadomość na Slacku lub issue w Linearze staje się pull requestem”

Obie integracje zasilają ten sam mechanizm. Wzmianka lub delegowanie tworzy zadanie Codex w chmurze (dokumentacja OpenAI nazywa je „cloud chat”), Codex wybiera środowisko chmurowe pasujące do repozytorium wskazanego w prośbie, agent pracuje w tym kontenerze, a Codex odpowiada w wątku lub issue, podając postęp i link do zadania. Z zadania otwierasz pull request jak z każdego innego wyniku Codex w chmurze.

Punkt wejściaKto uruchamiaJaki kontekst czyta CodexNajlepszy do
@Codex na kanale lub w wątku SlackaKażdy na kanale, do którego dodano aplikacjęWiadomość i historię wątkuBłędy zgłoszone w rozmowie, szybkie analizy
Delegowanie issue z Lineara do CodexKażdy, kto może przypisywać w zespoleTytuł, opis i komentarze issueDobrze opisane tickety z kryteriami akceptacji
@Codex w komentarzu w LinearzeKażdy przy issue, także gdy właścicielem jest człowiekIssue i wątek komentarzyProśba o analizę lub drugie podejście
Reguła triażu w Linearze delegująca do CodexAutomatycznie, dla każdego pasującego issueJak przy delegowaniuLiczne klasy błędów o niskim ryzyku
MCP Lineara w sesji lokalnejTy, w Codex CLI, rozszerzeniu IDE lub aplikacji desktopowejIssue, które agent sam pobierzeLokalna praca zaczynająca się od ticketu

Te szczegóły produktu pochodzą ze stron OpenAI o Slacku, Linearze i chmurze w wersji z 2026-08-28. Serwis nie był osiągalny do ponownego sprawdzenia 2026-09-26, więc nazwy menu potwierdź we własnym workspace.

Skonfiguruj środowisko chmurowe przed którąkolwiek integracją

Dział zatytułowany „Skonfiguruj środowisko chmurowe przed którąkolwiek integracją”

Bez używalnego środowiska obie integracje zawodzą po cichu: Codex odpisuje, że żadne środowisko nie pasuje, albo pracuje w niewłaściwym. Najpierw zbuduj środowisko i upewnij się, że uruchamia ono twoje testy, bo to testy czynią delegowaną zmianę weryfikowalną. Skrypty setup, cache, sekrety i politykę dostępu agenta do internetu opisuje strona Środowiska chmurowe Codex.

  1. Połącz GitHuba z Codex i utwórz co najmniej jedno środowisko chmurowe dla każdego repozytorium, do którego chcesz delegować. Sprawdź, że jedno zadanie uruchomione z interfejsu webowego Codex przechodzi testy na zielono.
  2. Wpisz polecenia testów, lintera i sprawdzania typów do pliku AGENTS.md w repozytorium, żeby każde zadanie w chmurze uruchamiało je bez przypominania. Zobacz AGENTS.md dla Codex.
  3. W ustawieniach Codex otwórz Connectors i zainstaluj aplikację Slack dla swojego workspace.
  4. Dodaj @Codex do kanałów, na których delegowanie jest dozwolone. Slack zaproponuje dodanie aplikacji, gdy ktoś pierwszy raz wspomni ją na nowym kanale.
  5. Na tej samej stronie Connectors zainstaluj Codex for Linear.
  6. Połącz konto Lineara, wspominając @Codex w komentarzu pod dowolnym issue.

Wspomnij @Codex z prośbą na dowolnym kanale lub w wątku, gdzie aplikacja jest obecna. Codex reaguje na wiadomość na znak, że ją przyjął, uruchamia zadanie w chmurze i odpowiada linkiem. Po zakończeniu zadania publikuje wynik w wątku, chyba że administrator workspace ograniczył aplikację do publikowania samych linków.

Codex czyta cały wątek, więc nie musisz ponownie wklejać tracebacku. Nie odgadnie natomiast repozytorium, pliku ani definicji ukończenia. Podaj wszystkie trzy w wiadomości, w której go wspominasz.

Przy zgłoszeniu z kanału supportu poproś najpierw o ustalenia, a dopiero potem o poprawkę. Wątek zawiera wtedy analizę, którą zespół może sprawdzić, zanim powstanie jakikolwiek kod, a poprawkę zatwierdzasz w tej samej rozmowie.

Codex wybiera środowisko najlepiej pasujące do prośby. Gdy podasz repozytorium, użyje środowiska, które je zawiera. Gdy prośba jest niejednoznaczna, wraca do środowiska, którego używałeś ostatnio. Gdy nic nie pasuje, zamiast zaczynać pracę odpisuje z instrukcją. Żeby poprawić zły wybór, odpowiedz w wątku, podając właściwe środowisko, np. acme/billing-api (staging), i ponownie wspomnij @Codex.

Najtańszy nawyk to zawsze podawać owner/repo w pierwszej wiadomości. Powrót do „ostatnio używanego” środowiska jest poprawny w zespołach z jednym repozytorium, a błędny we wszystkich pozostałych.

Deleguj issue do Codex tak, jak przypisujesz je koledze z zespołu, a Codex będzie publikował w nim postęp i wyniki. Pomaga tu model samego Lineara: „issues can only be assigned to humans, and only delegated to agents”, więc issue zachowuje ludzkiego assignee, który odpowiada za wynik, a pracę wykonuje Codex (Linear, „Our approach to building the Agent Interaction SDK”, 2025-08-01). Trzymaj się tego wzorca. To ludzki assignee zatwierdza wynik.

Issue, które Codex jest w stanie domknąć, ma ten sam kształt co issue dla nowej osoby w zespole: oczekiwane i faktyczne zachowanie, miejsce w kodzie i testowalną definicję ukończenia.

Wspomnij @Codex w komentarzu, gdy issue ma już właściciela albo gdy chcesz analizy przed kodem. Kolejne komentarze kontynuują to samo zadanie.

Kieruj nowe issue do Codex regułami triażu w Linearze

Dział zatytułowany „Kieruj nowe issue do Codex regułami triażu w Linearze”

Reguła triażu zamienia delegowanie z decyzji w ustawienie domyślne, więc jest polityką, a nie wygodą. Zacznij wąsko i rozszerzaj regułę dopiero wtedy, gdy delegowane pull requesty konsekwentnie przechodzą review.

  1. W Linearze otwórz ustawienia zespołu i włącz Triage.
  2. W sekcji Triage rules dodaj regułę, której akcja deleguje do Codex.
  3. Dodaj filtry, żeby reguła łapała tylko klasę pracy, którą powierzasz Codex, np. etykietę bug i priorytet Low lub Medium.
  4. Załóż testowe issue pasujące do reguły i sprawdź, że Codex je podejmuje i publikuje w nim wpis.
Kieruj do Codex regułąZostaw człowiekowi
Powtarzalne błędy w jednej usłudze, dla których opiszesz padający testFunkcje wymagające decyzji produktowej
Podbicia zależności i małe refaktoryzacje w pełni pokryte testamiZmiany przekraczające granice usług lub schematu
Poprawki tekstów, konfiguracji i ostrzeżeń linteraWszystko, co dotyka uwierzytelniania, logiki rozliczeń lub usuwania danych
Issue z wypisaną listą „Done when”Issue z jednolinijkowym opisem

Weryfikuj delegowaną pracę bez czytania każdej linii

Dział zatytułowany „Weryfikuj delegowaną pracę bez czytania każdej linii”

Pull request ze Slacka lub Lineara przechodzi te same bramki co każda inna zmiana i to one, a nie lektura linia po linii, są dowodem. Skonfiguruj je raz, a review stanie się sprawdzeniem dowodów.

  1. Kryteria akceptacji w prośbie. Lista „Done when” w issue lub wiadomości na Slacku to kontrakt. Recenzent porównuje każdy punkt z podsumowaniem zadania i testami, a nie z diffem.
  2. Testy uruchomione w zadaniu w chmurze. Ponieważ AGENTS.md wskazuje polecenia testów, agent je uruchamia, a podsumowanie zadania powinno mówić, czy testy się wykonały i przeszły. Podsumowanie bez przebiegu testów oznacza nieudane zadanie, niezależnie od wyglądu diffu.
  3. CI na pull requeście. Te same wymagane checki co przy pull requeście od człowieka: testy, linter, sprawdzanie typów i skan bezpieczeństwa. Delegowane pull requesty nie mają wyjątków.
  4. Automatyczne review. Skomentuj pull request @codex review albo włącz automatyczne review, żeby drugi agent sprawdził zmianę pod kątem twoich reguł review. Zobacz Code review z Codex.
  5. Ludzkie zatwierdzenie na podstawie dowodów. Assignee w Linearze albo osoba, która prosiła na Slacku, zatwierdza pull request po przeczytaniu podsumowania, wyniku testów i uwag z review. Kod czyta tylko tam, gdzie review zgłasza wątpliwość albo zmiana dotyka ryzykownej ścieżki.

Żeby odtworzyć wynik lokalnie przed zatwierdzeniem, pobierz diff zadania przez Codex CLI (codex cloud jest w wersji 0.157.1 oznaczone jako eksperymentalne):

Okno terminala
codex cloud list --limit 5 # znajdź identyfikator zadania
codex cloud diff TASK_ID # pokaż unified diff
codex cloud apply TASK_ID # nałóż zmiany na drzewo robocze, potem uruchom testy

Zastąp TASK_ID identyfikatorem z codex cloud list albo z linku do zadania w Slacku lub Linearze.

Daj lokalnym sesjom Codex kontekst z Lineara i Slacka przez MCP

Dział zatytułowany „Daj lokalnym sesjom Codex kontekst z Lineara i Slacka przez MCP”

Opisane wyżej integracje działają w chmurze. Gdy pracujesz lokalnie w Codex CLI, rozszerzeniu IDE lub aplikacji desktopowej, podłącz oficjalny zdalny serwer MCP Lineara, żeby agent sam czytał issue i komentarze, zamiast żebyś je wklejał. Uruchom w terminalu:

Okno terminala
codex mcp add linear --url https://mcp.linear.app/mcp
codex mcp login linear

Albo dodaj serwer do ~/.codex/config.toml, a potem uruchom codex mcp login linear:

[mcp_servers.linear]
url = "https://mcp.linear.app/mcp"

Kuratorowana wtyczka instaluje ten sam serwer jednym poleceniem: codex plugin add linear@openai-api-curated. Nazwę marketplace openai-api-curated wypisuje codex plugin list w wersji 0.157.1. Siostrzana wtyczka slack@openai-api-curated podłącza zdalny serwer MCP Slacka (https://mcp.slack.com/mcp), dzięki czemu lokalna sesja może czytać i streszczać kanał. Konfigurację MCP w ogóle opisuje Konfiguracja MCP w Codex, a Integracja MCP z Jira i Linear porównuje serwery trackerów zadań w różnych narzędziach.

Codex nie reaguje na wzmiankę. Aplikacji brakuje na kanale, instalacja w workspace jest niepełna albo połączenie ze Slackiem, GitHubem lub Linearem nie zostało potwierdzone. Przy brakującym połączeniu Codex zwykle odpisuje linkiem do ponownego połączenia. Naprawa: dodaj @Codex do kanału, sprawdź Connectors w ustawieniach Codex, a w Linearze wspomnij @Codex raz w dowolnym komentarzu, żeby połączyć konto.

Codex pracuje w złym środowisku. Prośba nie wskazywała repozytorium, więc Codex użył ostatniego środowiska. Naprawa: odpowiedz w wątku, podając właściwe owner/repo i środowisko, ponownie wspomnij @Codex i odrzuć pierwsze zadanie.

Poprawka trafia na zły branch. Zadanie w chmurze może wystartować z innego brancha, niż zamierzałeś, a to, którego brancha użyje, zależy od środowiska. Naprawa: podaj branch w prośbie („apply this on release/2026-10”) i przed zatwierdzeniem sprawdź branch bazowy pull requesta.

Pull request przechodzi CI, ale mija się z celem. Issue nie miało testowalnej definicji ukończenia, więc Codex spełnił dosłowne brzmienie. Naprawa: zamknij pull request, przepisz issue z listą „Done when” i deleguj ponownie. Powtarzające się przypadki traktuj jako problem szablonu issue, a nie modelu.

Kontekst ginie w długim wątku. Codex czyta historię, ale kluczowy szczegół może być 50 wiadomości wyżej. Naprawa: powtórz repozytorium, objaw i kryteria akceptacji w wiadomości, w której wspominasz @Codex.

Reguła triażu zasypuje Codex issue, których nie domknie. Reguła łapie zbyt szeroko. Naprawa: wyłącz regułę, zawęź ją etykietą i priorytetem, włącz ponownie. Przed kolejnym rozszerzeniem przejrzyj ostatnią partię delegowanych pull requestów.

Zadanie z reguły triażu pada dla części zgłaszających. Zadania uruchomione regułą działają na koncie autora issue, które może nie mieć dostępu do repozytorium. Naprawa: nadaj tej osobie w Codex dostęp do środowiska albo zakładaj takie issue z konta, które go ma.

Tekst klienta na kanale supportu próbuje sterować agentem. Wszystko w wątku jest wejściem zadania, łącznie z wklejoną wiadomością „ignore previous instructions”. Naprawa: nie włączaj agentowi dostępu do internetu w środowisku, jeśli zadanie go nie wymaga, trzymaj sekrety poza fazą agenta i pozwól decydować o merge’u wyłącznie CI i bramkom review.

Fragmenty kodu pojawiają się na kanale, na którym nie powinny. Domyślnie Codex publikuje wyniki w wątku. Naprawa: poproś administratora workspace o ograniczenie aplikacji Slack do publikowania samych linków do zadań, a resztę kontroli danych znajdziesz w Zarządzanie Codex w firmie.