Workflow integracji ze Slack i Linear

Klient zgłasza błąd na kanale wsparcia Slack. Twój product manager tworzy issue w Linear. Inżynier dokonuje triażu, przypisuje, tworzy branch, pisze poprawkę, otwiera PR, prosi o recenzję, merguje i wdraża. To siedem przekazań i minimum dwa dni, jeśli wszystko przebiega gładko. Dzięki integracjom Codex PM przypisuje issue w Linear do Codex, Codex tworzy zadanie chmurowe, bada błąd, proponuje poprawkę i publikuje link do ukończonego zadania — wszystko bez dotykania bazy kodu przez inżyniera.

Co wyniesiesz z tej lekcji

• Działające workflow integracji ze Slack i Linear do delegowania zadań kodowania
• Prompty zoptymalizowane pod każdą powierzchnię integracji (kontekst Slack vs kontekst issue Linear)
• Wzorzec automatyzacji triażu z użyciem reguł triażu Linear z Codex
• Konfiguracja MCP do uzyskiwania dostępu do issues Linear z lokalnych sesji Codex

Workflow

Integracja ze Slack

Integracja ze Slack pozwala każdemu w zespole delegować zadania kodowania przez wzmiankowanie @Codex na kanale lub w wątku. Codex tworzy zadanie chmurowe, pracuje w twoim repozytorium i publikuje wyniki z powrotem do wątku.

Konfiguracja

1. Skonfiguruj zadania chmurowe Codex na chatgpt.com/codex z połączonym kontem GitHub i co najmniej jednym środowiskiem.
2. Przejdź do ustawień Codex i zainstaluj aplikację Slack dla swojego workspace.
3. Dodaj @Codex do kanałów, na których chcesz delegować pracę.

Delegowanie ze Slack

Wskazówka

Gotowa wiadomość Slack do naprawy błędu:

@Codex The user profile update endpoint returns 200 but does not persist changes to the database. The issue is in the billing-api repo. Investigate the PUT /api/users/:id/profile handler, find the bug, fix it, and add a regression test.

Codex czyta wiadomość i historię wątku w poszukiwaniu kontekstu, wybiera najlepiej pasujące środowisko i uruchamia zadanie chmurowe. Gdy zakończy, Codex publikuje wyniki i link do zadania w wątku.

Kluczowe zachowania:

• Codex używa historii wątku jako kontekstu, więc wcześniejsze wiadomości w wątku dostarczają tła. Podsumuj kluczowe szczegóły w najnowszej wiadomości, aby nic nie zostało pominięte.
• Określ repozytorium, jeśli masz wiele środowisk: @Codex fix this in acme/billing-api.
• Jeśli Codex wybierze złe środowisko, odpowiedz w wątku: “Please run this in acme/billing-api (production)” i wzmiankuj @Codex ponownie.

Wzorce Slack, które dobrze działają

Triaż błędów z kanałów wsparcia:

@Codex A customer reports that invoice PDFs show the wrong tax rate when the billing address is in Canada. Investigate the PDF generation in acme/billing-api, find where the tax calculation happens, and check if Canadian tax rates are handled correctly. Report your findings but do not fix yet.

Szybkie zapytania analityczne:

@Codex How does the webhook retry logic work in acme/payment-service? I need to understand the retry schedule and failure handling before we change it.

Kontynuacja w tym samym wątku:

@Codex Based on your analysis, go ahead and fix the Canadian tax rate issue. Add tests covering US, Canadian, and EU tax calculations.

Integracja z Linear

Integracja z Linear pozwala przypisywać issues do Codex lub wzmiankować @Codex w komentarzach. Codex działa jak członek zespołu — podejmuje issue, pracuje w zadaniu chmurowym i publikuje aktualizacje postępu z powrotem do issue.

Konfiguracja

1. Skonfiguruj zadania chmurowe Codex z połączonym kontem GitHub i co najmniej jednym środowiskiem.
2. Przejdź do ustawień Codex i zainstaluj Codex for Linear dla swojego workspace.
3. Połącz swoje konto Linear wzmiankując @Codex w komentarzu dowolnego issue Linear.

Przypisywanie issues do Codex

Najprostszy workflow: przypisz issue Linear do Codex dokładnie tak, jak przypisałbyś je do kolegi z zespołu. Codex rozpoczyna pracę i publikuje aktualizacje w zakładce Activity issue.

Wskazówka

Pisanie issues Linear dla Codex:

Pisz issue tak, jakbyś przypisywał je juniorskiemu deweloperowi, który ma dostęp do bazy kodu, ale nie ma wiedzy instytucjonalnej. Bądź konkretny w kwestii:

• Jakie powinno być oczekiwane zachowanie
• Jakie jest obecne (błędne) zachowanie
• Która część bazy kodu jest istotna
• Jak wygląda “done” (włącznie z testami)

Przykładowy tytuł issue: “Fix: Canadian tax rate not applied to invoice PDFs”

Przykładowy opis issue:

When a customer's billing address is in Canada, invoice PDFs should apply the 13% HST rate. Currently, they apply the US default rate of 0%.

Expected: Invoice PDF for Canadian customer shows 13% HST
Actual: Invoice PDF shows 0% tax

Relevant code: src/services/pdf/invoice-generator.ts, src/services/tax/calculator.ts
Done when: Canadian tax rate is applied correctly, unit tests cover CA/US/EU rates, existing tests still pass.

Automatyczny triaż z regułami Linear

Dla zespołów o dużym przepływie pracy skonfiguruj reguły triażu Linear, aby automatycznie przypisywać kwalifikujące się issues do Codex:

1. W Linear przejdź do Settings > Your Teams > wybierz swój zespół
2. Otwórz Workflow settings > Triage > włącz
3. Utwórz regułę triażu: Delegate > Codex

Teraz issues, które wchodzą do triażu, są automatycznie przypisywane do Codex. Reguła może filtrować po etykiecie, priorytecie lub innych właściwościach, więc możesz kierować do Codex tylko określone typy issues (na przykład issues oznaczone “bug” z priorytetem “Low” lub “Medium”).

Uwaga

Automatyczne delegowanie triażu działa najlepiej dla dobrze zdefiniowanych, samodzielnych zadań. Złożone funkcje, decyzje architektoniczne i zmiany między serwisami powinny nadal trafiać do ludzkich inżynierów. Zacznij od kierowania do Codex tylko issues z etykietą “bug” i rozszerzaj w miarę budowania zaufania.

Wzmiankowanie @Codex w komentarzach

W przypadku issues już przypisanych do człowieka możesz nadal poprosić Codex o pomoc, wzmiankując go w wątku komentarzy:

@Codex Investigate the root cause of this issue. Check the webhook handler in src/routes/webhooks.ts and the retry logic in src/services/retry.ts. Report what you find but do not make changes yet.

Po odpowiedzi Codex kontynuuj w tym samym wątku:

@Codex Good analysis. Go ahead and implement the fix. Use the approach you described in option 2 (exponential backoff with jitter).

Lokalny dostęp do Linear przez MCP

Jeśli pracujesz w Codex App, CLI lub rozszerzeniu IDE i chcesz odwoływać się do issues Linear podczas lokalnego developmentu, skonfiguruj serwer Linear MCP:

codex mcp add linear --url https://mcp.linear.app/mcp

Lub dodaj ręcznie do ~/.codex/config.toml:

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

Następnie zaloguj się: codex mcp login linear

Z podłączonym Linear MCP możesz odwoływać się do issues w lokalnych promptach:

Look up Linear issue ENG-1234. Read the description and implement the fix it describes. Follow the acceptance criteria listed in the issue.

Gdy coś się nie uda

Codex wybiera złe środowisko w Slack. Gdy masz wiele środowisk, Codex wybiera to, które najlepiej pasuje do twojego zapytania. Jeśli wybierze źle, odpowiedz podając konkretne środowisko: @Codex Please run this in acme/billing-api (staging).

Opis issue Linear jest zbyt ogólnikowy. Jeśli issue mówi “fix the bug” bez kontekstu, Codex będzie miał trudności ze znalezieniem odpowiedniego kodu. Pisz issues z konkretnymi ścieżkami plików, oczekiwanym vs rzeczywistym zachowaniem i krokami reprodukcji. Codex czyta pełną treść issue, więc więcej szczegółów oznacza lepsze wyniki.

@Codex nie odpowiada w Slack lub Linear. Zweryfikuj, czy integracja jest zainstalowana w ustawieniach twojego workspace. Dla Slack upewnij się, że @Codex został dodany do kanału. Dla Linear zweryfikuj, czy twoje konto jest połączone, wzmiankując @Codex w dowolnym komentarzu issue.

Zadanie chmurowe kończy się, ale kod nie uwzględnia ostatnich zmian. Zadania chmurowe działają na domyślnej gałęzi w mapie repozytoriów twojego środowiska. Jeśli poprawka musi dotyczyć gałęzi funkcji, określ to w wiadomości. Dla issues Linear Codex używa domyślnej gałęzi pierwszego repozytorium w środowisku.

Ograniczenia Slack Enterprise limitują odpowiedzi Codex. Niektóre workspace Enterprise ograniczają Codex w publikowaniu pełnych odpowiedzi w wątkach (aby zapobiec ekspozycji kodu). W takich przypadkach Codex publikuje tylko link do zadania. Twój administrator kontroluje to ustawienie w ustawieniach workspace ChatGPT.

Co dalej

Automatyzacja zadań zaplanowanych Połącz integracje z automatyzacjami dla w pełni zautomatyzowanych workflow

Workflow automatyzacji PR Zautomatyzuj cykl życia PR wynikający z zadań chmurowych Codex