Každodenná práca

Kontextové súbory

Kontextový súbor je AGENTS.md alebo CLAUDE.md v koreňovom priečinku Projektu. Elowen pridá jeho obsah do pokynov modelu, keď v tomto Projekte začne konverzácia.

Používajte ich na pokyny, ktoré platia pre prácu v danom Projekte, napríklad konvencie kódu alebo príkazy testov. Na opakovane použiteľné postupy naprieč konverzáciami slúžia Skilly.

Kde kontextové súbory platia

Kontextové súbory sa načítavajú automaticky. Žiadne nastavenie ich nezapína ručne.

Vlastný chat administrátora číta súbor Projektu, v ktorom konverzácia beží. Na webe zmeníte Projekt konverzácie výberom Projektu v hlavičke chatu; v CLI ho prepína /project (/cd presúva len vlastný priečinok terminálu). Nová konverzácia na webe začína vo Vašom predvolenom Projekte, teda v prvom podľa poradia Projektov. Konverzácia na hostiteľovi, ktorá Projekt neuvádza, použije zaregistrovaný Projekt, do ktorého patrí jej pracovný adresár.
Spravované Projekty fungujú rovnako. Súbor sa číta z priečinka Projektu vnútri jeho prostredia. Zastavené prostredie sa kvôli čítaniu nespúšťa; konverzácia sa potom otvorí bez súboru.
Účet chatbota číta súbor jediného Projektu, ku ktorému je viazaný, a nič iné. Tak získava chatbot svoju personu zo svojho Projektu. Čokoľvek v tomto súbore sa dostane do promptu, s ktorým sa rozprávajú návštevníci webu, preto doň nedávajte súkromné poznámky.

Súbor s pokynmi sa pri štarte číta len z koreňového priečinka Projektu: súbor v priečinku nad Projektom sa nenačíta nikdy a pracovný adresár mimo všetkých zaregistrovaných Projektov nenačíta nič. Pri prepojenom Git worktree zaregistrovaného Projektu je koreňom najvyšší priečinok tohto worktree, takže súbory pochádzajú z checkoutu, v ktorom konverzácia pracuje. Pokyny pre konkrétny priečinok kódu patria do modulov pokynov, ktoré sa čítajú, keď Elowen s týmito súbormi pracuje.

Kontextové súbory sa čítajú pre vlastný chat administrátora, pre delegovaných sub-agentov spustených z tohto chatu (vrátane forkov a vnorených sub-agentov) a pre účet chatbota. Pre ostatné účty sa nenačítavajú, rovnako ako v zdieľaných kanáloch platforiem, ako je Teams alebo Discord.

Čo do kontextového súboru patrí

V koreni Projektu použite jeden z týchto presných názvov súborov:

AGENTS.override.md
AGENTS.md (alebo AGENTS.MD)
CLAUDE.md (alebo CLAUDE.MD)

Keď existuje niekoľko, načíta sa len prvý v tomto poradí. Súbor väčší ako 256 KiB sa nenačíta vôbec.

Elowen pridá obsah do pokynov modelu. Kontextový súbor nevytvára Projekt, nemení pracovný adresár ani neudeľuje prístup k nástrojom, súborom či iným zdrojom. Existujúce oprávnenia účtu platia ďalej.

Rozdelenie pokynov do modulov

Dlhý koreňový súbor zaťažuje každú konverzáciu v Projekte. Nechajte v ňom len to, čo platí vždy, a zvyšok presuňte do modulov: súborov Markdown v priečinku .elowen/rules vrátane jeho podpriečinkov. Modul uvádza v hlavičke súbory, ku ktorým patrí:

---
paths:
  - "src/api/**/*.ts"
  - "tests/api/**/*.ts"
---
# API rules
- Validate endpoint inputs.
- Update the contract tests.

Elowen tento modul pripojí, keď číta, zapisuje alebo upravuje súbor zodpovedajúci niektorému zo vzorov, a to od ďalšieho kroku modelu v danom ťahu. Vzory používajú *, ** a ? a niekoľko vzorov znamená alternatívy. Modul bez hlavičky je bezpodmienečný a pripojí sa ku koreňovému súboru na začiatku konverzácie.

Pokyny pre jeden priečinok patria do AGENTS.md tohto priečinka, napríklad src/payments/AGENTS.md. Pripojí sa, keď Elowen pracuje so súborom v tomto priečinku alebo pod ním, a nikdy nenahradí koreňový súbor, ktorý už je na mieste.

Moduly fungujú ako zvyšok konverzácie. Pripojený modul zostáva v histórii konverzácie, reštart ho nepripojí dvakrát a po zhrnutí konverzácie sa môže pripojiť znova, keď Elowen nabudúce pracuje so zodpovedajúcim súborom. Keď sa súbor modulu zmení, Elowen pripojí nový obsah pri ďalšom zásahu do zodpovedajúceho súboru a označí ho ako náhradu staršej verzie. Na pozadí sa nič nesleduje, takže zmena sa do konverzácie nikdy nedostane sama.

Model dostane presne text modulu bez hlavičky, označený súborom, z ktorého pochádza. Modul, ktorý sa nepodarí načítať, sa zapíše do logu služby a nikdy ho nenahradí iný, širší:

Modul s neplatnou hlavičkou alebo s iným kľúčom než paths sa nenačíta vôbec.
Modul nad 256 KiB sa odmietne celý. Pokyny sa nikdy neskracujú.
Modul, ktorý odkazom mieri mimo Projekt, sa odmietne.
Cesty sa rozpoznávajú len pri práci so súbormi. Zmienka o ceste v správe, výpis priečinka alebo spustenie príkazu v shelli modul nepripojí.

Kedy sa zmeny prejavia

Koreňový súbor sa číta raz pri zostavení konverzácie a pre všetky ďalšie správy zostáva rovnaký. Pokyny modelu sú tak medzi správami totožné, čo udržiava odpovede rýchle a lacnejšie.

Úprava koreňového súboru sa prejaví, až sa konverzácia znova zostaví: v novej konverzácii, po prepnutí modelu, po reštarte Elowen alebo keď je konverzácia asi 30 minút nečinná. Úprava modulu alebo vnoreného AGENTS.md sa prejaví pri ďalšom zásahu do zodpovedajúceho súboru v tej istej konverzácii.

Ak pokyny chýbajú, skontrolujte, či súbor leží v koreňovom priečinku Projektu s presným názvom zo zoznamu vyššie, či konverzácia beží v tomto Projekte a či ide o vlastný chat administrátora alebo chatbota viazaného na tento Projekt. Pri module overte, či cesta v jeho hlavičke zodpovedá súboru, s ktorým sa pracuje, a či modul leží v .elowen/rules.

Súvisiace: Projekty, prostredia a GitHub