Współpraca zespołowa i współdzielona konfiguracja

Przepływy zespołowe standaryzują użycie Codex wśród programistów poprzez zacommitowaną konfigurację projektu, współdzieloną hierarchię AGENTS.md i umiejętności zacommitowane w repozytorium, dzięki czemu każda sesja zaczyna się od tej samej linii bazowej zamiast osobistych ustawień. Dedykowana funkcja Team Config rozszerza tę ideę na poziom organizacji. Listy onboardingowe i współdzielone biblioteki promptów zamieniają osobne sesje w skoordynowaną pracę zespołu.

Twój zespół ośmiu programistów ma każdy własną konfigurację Codex. Jeden używa approval_policy = "never" z pełnym dostępem. Drugi ma ścisły tryb read-only. Trzeci ma skonfigurowanych pięć serwerów MCP, których nikt inny nie używa. Gdy dzielą się promptami lub przepływami pracy, dostają zupełnie różne wyniki. Konfiguracja zespołowa rozwiązuje to, ustanawiając współdzieloną linię bazową przy zachowaniu indywidualnej elastyczności.

Co zyskujesz dzięki współdzielonej konfiguracji zespołowej

• Strategia wdrożenia Team Config z użyciem współdzielonych config.toml, reguł i umiejętności
• Konwencje AGENTS.md, które działają dla zespołów od 5 do 50 programistów
• Wzorce współpracy przy udostępnianiu promptów, umiejętności i przepływów pracy przeglądu
• Szablony onboardingowe, które pozwalają nowym członkom zespołu być produktywnymi z Codex w jeden dzień

Współdzielona i projektowa konfiguracja

Codex czyta konfigurację z wielu warstw. Najprostszy sposób na ustandaryzowanie pojedynczego repozytorium to zacommitowanie konfiguracji, reguł i umiejętności o zasięgu projektu obok twojego kodu:

Typ	Ścieżka	Przeznaczenie
Config	.codex/config.toml	Tryb sandboxa, model, polityka zatwierdzania, serwery MCP
Reguły	.codex/rules/	Które polecenia Codex może uruchamiać poza sandboxem
Umiejętności	.agents/skills/	Współdzielone umiejętności dostępne dla wszystkich członków zespołu

Notatka

Te zacommitowane do repozytorium ścieżki obejmują jeden projekt. Do standaryzacji w obrębie całej organizacji Codex udostępnia też dedykowaną funkcję Team Config, która współdzieli config.toml, rules/ i skills/ centralnie, bez powielania ich w każdym repozytorium. Poniższe pliki o zasięgu projektu to lekki odpowiednik na poziomie pojedynczego repozytorium.

Konfiguracja na poziomie projektu

Zacommituj .codex/config.toml do swojego repozytorium:

# .codex/config.toml -- Shared team defaults
# Przenośna baza; profilu Sol użyj dla ról, które mają do niego dostęp.
model = "gpt-5.6-terra"
approval_policy = "on-request"
sandbox_mode = "workspace-write"

# Shared MCP servers
[mcp_servers.linear]
url = "https://mcp.linear.app/mcp"

# Disable web search for security-sensitive projects
web_search = "disabled"

Zacommitowany .codex/config.toml stoi wyżej niż profil i konfiguracja osobista, więc ustanawia linię bazową zespołu. Tylko flagi CLI i -c key=value nadpisują go dla danego uruchomienia; warstwa --profile jest niżej niż konfiguracja projektu. Jeśli projekt jest niezaufany, Codex pomija warstwy .codex/ i wraca do profilu, konfiguracji osobistej, systemowej i wbudowanej.

Prompt: Wygeneruj konfigurację zespołową

“Analyze this repository’s structure and create a .codex/config.toml that: sets workspace-write sandbox mode, configures the Linear MCP server, enables shell_snapshot for faster commands, and sets the review model to gpt-5.6-sol. Also create a rules file that allows npm, pnpm, git, and make commands but prompts for anything else.”

Gdy wkleisz wygenerowany plik, zweryfikuj dwa klucze: shell_snapshot należy do tabeli [features] ([features], a potem shell_snapshot = true), a nie jest kluczem najwyższego poziomu, a nadpisanie /review to klucz najwyższego poziomu review_model.

Utrzymuj model bazowy zgodny z uprawnieniami docelowego zespołu: Free i Go udostępniają Terra, a kwalifikujący się użytkownicy Plus, Pro, Business i Enterprise mogą wybrać Sol, Terra lub Luna. Administrator zarządzanego workspace’u może zawęzić dostęp zależnie od roli, dlatego model Sol do przeglądu traktuj jako opcjonalny profil, a nie uniwersalne ustawienie domyślne.

Współdzielone konwencje AGENTS.md

Dla zespołów ustrukturyzuj swoją hierarchię AGENTS.md:

AGENTS.md                           # Konwencje obowiązujące w całym repozytorium
  |-- packages/api/AGENTS.md        # Konwencje zespołu API
  |-- packages/web/AGENTS.md        # Konwencje zespołu frontendowego
  |-- services/payments/AGENTS.md   # Konwencje zespołu płatności

Co umieścić w głównym AGENTS.md

# Team Conventions

## Code Style
- Use TypeScript strict mode for all new files
- Follow the error handling patterns in src/lib/errors.ts
- All API routes must have OpenAPI annotations

## Workflow
- Run pnpm lint && pnpm test before committing
- New endpoints need integration tests in tests/integration/
- Database changes need a migration file in migrations/

## Review
- Security-sensitive changes require two human reviewers
- Performance changes need benchmark results in the PR description

Co umieścić w AGENTS.md na poziomie pakietu

packages/api/AGENTS.md

## API-Specific Rules
- Use the centralized error handler, never throw raw errors
- Rate limiting must be added to all public endpoints
- Authentication middleware is in src/middleware/auth.ts
- Test utilities are in tests/utils/api-helpers.ts

Współdzielone umiejętności

Twórz ogólnozespołowe umiejętności w .agents/skills/ w katalogu głównym repozytorium:

---
name: pr-ready
description: Prepare the current changes for a pull request by running
  all checks, fixing issues, and generating a PR description.
---

# PR Readiness Check

1. Run pnpm lint and fix any issues
2. Run pnpm test and fix any failures
3. Run pnpm type-check and fix any errors
4. Generate a PR description with:
   - Summary of changes
   - Testing approach
   - Breaking changes (if any)
5. Report the results

Członkowie zespołu wywołują ją za pomocą $pr-ready na dowolnej powierzchni Codex.

Onboarding nowych członków zespołu

Utwórz listę kontrolną onboardingową:

1. Zainstaluj aplikację desktopową ChatGPT i Codex CLI
2. Uruchom codex login, aby uwierzytelnić się w przestrzeni roboczej ChatGPT swojego zespołu
3. Sklonuj repozytorium (które zawiera .codex/config.toml i AGENTS.md)
4. Zainstaluj zalecane serwery MCP: codex mcp add linear --url https://mcp.linear.app/mcp
5. Uruchom zadanie testowe: codex "Summarize the current instructions and list available skills"
6. Przejrzyj bibliotekę promptów zespołu dla typowych przepływów pracy

Prompt: Weryfikacja onboardingu

“Verify my Codex setup: check that AGENTS.md is loaded correctly, list all configured MCP servers, verify the sandbox mode is workspace-write, and run pnpm test to confirm the development environment works. Report any issues.”

Wzorce współpracy

Biblioteki promptów

Utrzymuj kolekcję sprawdzonych promptów w swoim repozytorium:

.github/codex/prompts/
  review.md          # PR review prompt
  fix-ci.md          # CI failure auto-fix
  migration.md       # Database migration template
  security-scan.md   # Security audit prompt

Odwoływuj się do nich w GitHub Actions lub udostępniaj w dokumentacji zespołowej.

Udostępnianie umiejętności

Umiejętności zacommitowane w .agents/skills/ są dostępne dla wszystkich w zespole. Dla osobistych umiejętności użyj ~/.agents/skills/. Dla umiejętności obowiązujących w całej organizacji, wdróż do /etc/codex/skills/ za pomocą zarządzania konfiguracją.

Gdzie zawodzi konfiguracja zespołowa

• Konfiguracja zespołowa koliduje z osobistą: Zacommitowany .codex/config.toml ma pierwszeństwo przed profilem i konfiguracją osobistą. Wyżej są tylko flagi CLI/-c. Dla niezaufanego projektu warstwy projektowe są pomijane. Najpierw sprawdź zaufanie i jednorazowe nadpisania CLI.
• AGENTS.md za duży: Łączny rozmiar wszystkich plików AGENTS.md jest domyślnie ograniczony do 32KB. Podziel wytyczne na zagnieżdżone pliki i w razie potrzeby zwiększ project_doc_max_bytes.
• Nowy członek zespołu dostaje inne wyniki: Sprawdź, czy ma skonfigurowane te same serwery MCP i czy jego osobista konfiguracja nie nadpisuje krytycznych ustawień zespołowych.
• Umiejętności nie pojawiają się: Umiejętności muszą znajdować się w katalogach .agents/skills/. Codex skanuje od bieżącego katalogu w górę do katalogu głównego repozytorium. Zrestartuj Codex, jeśli nowo dodana umiejętność się nie pojawia.

Kolejne kroki w konfiguracji zespołowej

• Inżynieria promptów — Pisz prompty, które działają w całym zespole
• Strategie przeglądu — Standaryzuj praktyki przeglądu
• Zarządzanie korporacyjne — Skaluj konfigurację zespołową do poziomu organizacji