Kontekst globalny powinien znajdować się poza APC
APC to przenośna warstwa kontekstu. APX to lokalna warstwa runtime.
Aby zachować ich sprawność, przestrzegaj jednej zasady. Jeśli coś musi przetrwać świeże sklonowanie, umieść to w APC. Jeśli coś zależy od konkretnego użytkownika, maszyny lub procesu, trzymaj to poza APC.
Projekty rosną, a za nimi idzie pokusa. Możesz chcieć dodać jeszcze jedno ustawienie lub lokalną ścieżkę. Jeśli nie będziesz rygorystyczny, Twoje repozytorium stanie się wysypiskiem danych maszynowych. To sprawia, że repozytorium staje się kruche.
APC przechowuje znaczenie należące do projektu. Jest to wspólny kontrakt, który niesie ze sobą repozytorium.
Dobra zawartość APC obejmuje:
- Tożsamość projektu
- Role agentów
- Możliwe do ponownego wykorzystania umiejętności
- Wyselekcjonowana pamięć projektu
- Wskazówki MCP na poziomie projektu
- Instrukcje dla całego repozytorium w AGENTS.md
Współpracownik lub nowa maszyna powinni odczytać te fakty natychmiast po wykonaniu operacji checkout.
Kontekst globalny jest inny. Należy on do użytkownika lub stacji roboczej.
Przykłady kontekstu globalnego:
- Klucze API
- Preferencje edytora
- Lokalne aliasy
- Ścieżki narzędzi specyficzne dla maszyny
- Prywatna pamięć runtime
- Cache
- Transkrypcje sesji
- Logi wiadomości
APX utrzymuje ten stan lokalnie. Przechowuje stan runtime pod ~/.apx/. Dzięki temu projekt pozostaje możliwy do udostępnienia.
Mieszanie tych warstw powoduje trzy problemy:
- Łamie się przenośność. Trudno ufać repozytorium, które zależy od lokalnej konfiguracji.
- Przeglądy stają się zaszumione. Pull requesty powinny pokazywać decyzje projektowe, a nie bagaż stacji roboczej.
- Wyciek sekretów. Przechowywanie lokalnych szczegółów ułatwia przypadkowe zatwierdzenie niewłaściwych plików.
Zanim dodasz ustawienie, zadaj sobie pytanie: Czy inny współtwórca potrzebowałby tego natychmiast po sklonowaniu?
Jeśli tak, użyj APC.
- Agent recenzujący dla każdego klona? APC.
- Osobisty klucz API? Nie APC.
- Decyzja projektowa dotycząca uprawnień? APC.
- Lokalna ścieżka do przeglądarki? Nie APC.
- Wspólna wskazówka MCP? APC.
- Cache uruchomienia? Nie APC.
Ta zasada sprawia, że automatyzacja jest trwała. APC daje Ci przenośne znaczenie. APX daje Ci lokalny stan.
Dbaj o wyraźną granicę. Dzięki temu Twój stos technologiczny będzie łatwiejszy do debugowania, udostępniania i przenoszenia między narzędziami.
Używaj APC dla kontekstu, który podróżuje wraz z repozytorium. Jeśli jest on osobisty lub tymczasowy, trzymaj go lokalnie.
Źródło: https://dev.to/agentprojectcontext/global-context-belongs-outside-apc-4fg8
Opcjonalna społeczność edukacyjna: https://t.me/GyaanSetuAi