Работа с проекти с множество хранилища
На тази страница
Урокът е актуализиран на 3 ноември 2026 г. въз основа на документацията на Codex Cloud: множество хранилища вече съществуват заедно в среда на Codex Cloud (старият адрес codex.openai.com вече не е входната точка). Източник: Codex Cloud.
Управление на сложността на разпределените архитектури
Съвременните проекти често обхващат множество хранилища: фронтенд, бекенд, споделена библиотека, платежна услуга. Всяко от тях има собствен жизнен цикъл, CI пайплайн и поддържащи екипи. Тази настройка работи перфектно – докато промяна не премине границите на хранилищата. Тук Codex променя правилата на играта: той може да работи едновременно в множество хранилища.
Реалната цена на промяна, засягаща няколко компонента
Помислете за рутинна задача: добавяте поле към API отговор в бекенд хранилището. След това трябва да актуализирате API клиента във фронтенд хранилището, споделените типове в общото хранилище, документацията в docs хранилището и интеграционните тестове в e2e хранилището. Нито една от тези четири задачи не е трудна сама по себе си. Заедно те означават четири превключвания на контекста, четири клона, четири pull request-а и четири шанса да забравите нещо. На практика документацията или e2e тестовете се пропускат и проблемът изплува отново три седмици по-късно като бъг, който никой не може да проследи до първоначалния комит.
Координиране на множество хранилища
В Codex Cloud една среда може да обедини множество GitHub хранилища: Вие ги избирате при създаването на средата, Codex настройва техните зависимости и инструменти, и всяка задача, стартирана в тази среда, работи върху целия набор. Вашият промпт след това описва промяната като цяло, вместо да изолира фрагменти:
"In the backend repo (api-service):
- Add a GET /api/v2/products endpoint with pagination
In the frontend repo (web-app):
- Update the API client to use the new endpoint
- Add pagination to the ProductList component"
Codex прилага промените във всяко хранилище и отваря координирани pull request-и. Разпространението на споделен тип следва същата логика, с едно допълнително изискване, което трябва да посочите изрично: уверете се, че компилацията е успешна във всяко засегнато хранилище. Без тази инструкция ще откриете грешката в типа в CI на мобилното хранилище два часа след като сте обединили всичко останало.
"The Product type in shared-types/src/product.ts has been
modified (added tags: string[] field).
Update all usages in:
- api-service: routes and services that use Product
- web-app: components that display a Product
- mobile-app: screens that display a Product
Ensure each repo compiles without errors."
Конфигуриране на AGENTS.md в монорепозитори
Ако Вашият проект е монорепозитори (Turborepo, Nx, Lerna), логиката се обръща: пакетите споделят едно единствено дърво с файлове, а йерархията на файловете AGENTS.md носи разликите между тях. Кореновият файл описва общата структура и правила, които важат навсякъде:
# AGENTS.md (monorepo root)
## Structure
Turborepo monorepo with the following packages:
- packages/api — Fastify backend
- packages/web — Next.js frontend
- packages/shared — Shared types and utilities
- packages/e2e — Playwright end-to-end tests
## Rules
- Changes to packages/shared MUST be followed by a build
of all dependent packages
- Global build command: `turbo run build`
- Global test command: `turbo run test`
Всеки под-пакет след това надгражда тази основа със собствените си конвенции, без никога да повтаря онова, което вече е в кореновия файл:
# packages/api/AGENTS.md
## Backend API
- Framework: Fastify
- Validation: Zod (schemas in src/schemas/)
- Types from packages/shared are imported via @myorg/shared
- Every new route requires a test in __tests__/
Два референтни работни потока, засягащи няколко компонента
Първият обхваща функция, която преминава през цялата верига. Обърнете внимание на четвъртата инструкция: връзката между pull request-ите може да изглежда по избор, но именно тя позволява на ревизора на фронтенд хранилището да разбере защо съществува този бутон, без да търси съответния бекенд PR.
"New feature: favorites system.
1. shared-types: Add the Favorite type
2. api-service: CRUD /api/favorites with auth
3. web-app: Heart button on product cards
4. Create a PR in each repo with links
to the other repos' PRs in the description"
Вторият обхваща мигриране на версиониран API. Тук редът на стъпките не е козметичен: той гарантира, че никой клиент няма да остане изоставен по средата на миграцията, като v2 е на място, а v1 все още е активен през целия прозорец за миграция на потребителите.
"API v1 /users is deprecated. Create v2:
1. api-service: Add v2 routes with the new format
2. api-service: Mark v1 routes as deprecated (header)
3. web-app: Migrate all calls from v1 to v2
4. mobile-app: Migrate all calls from v1 to v2
5. docs: Update the API documentation"
Какво Codex не може да направи за Вас
Codex работи хранилище по хранилище, в отделни пясъчници. Той не може да стартира две хранилища заедно: например, не можете да стартирате едновременно бекенда и фронтенда за реален интеграционен тест. За тестове между хранилища последователността остава ръчна:
- Обединете индивидуалните PR-и
- Стартирайте интеграционните тестове от Вашия CI/CD пайплайн
- Използвайте Codex, за да поправите всички открити проблеми
С други думи, Codex гарантира съгласуваност на написания код, но никога съгласуваност на работещата система. Вашият CI/CD остава крайният арбитър и предпазливостта диктува, че не трябва да разполагате серия от координирани PR-и, докато той не произнесе своята присъда.
Ключови изводи
- Codex може да създава координирани PR-и в множество хранилища
- Споделените типове са идеален случай на употреба за работни потоци с множество хранилища
- Конфигурирайте AGENTS.md във всеки пакет на монорепозитори
- Интеграционните тестове между хранилища все още трябва да бъдат проверени в CI/CD
- Документирайте зависимостите между хранилищата в AGENTS.md