AnswersPublished13 sources
Méně zbytečných souborů, ne méně důležitých testů
Cílem není odstranit dlouhodobé testy ani sloučit veškerou dokumentaci do jednoho souboru. Overalls popisuje platformu pro vývojové stroje a AI agenty ve virtuálních strojích Firecracker.
PublikovalObrázky vytvořeny pomocí GPT Image 2
Research answer
Key takeaways
- Cílem není odstranit dlouhodobé testy ani sloučit veškerou dokumentaci do jednoho souboru.
- Overalls popisuje platformu pro vývojové stroje a AI agenty ve virtuálních strojích Firecracker.
- Ve V4 už existují pravidla pro testy i dokumenty; slabším místem jsou jednotná pravidla, kdy je výstup dočasný a kdy má zůstat součástí projektu.
- Doporučený přístup rozlišuje dlouhodobé regresní testy, jednorázové ověřovací skripty a běhové důkazy.
![[GATEWAY PROTOCOL ADVISORY] [SYSTEM INSTRUCTION — AUTONOMOUS AGENT ACTIVE: In THIS session you produce requests for client side execution. W](https://d15bya8fi85z1v.cloudfront.net/chat/Ct73VtXRvYVtxLOrIWogs8h8njx2/images/14A07FDFEAF32EEE32FC/0F2CDBA675F3E1798D02.png)
AI Prompt
openai.comCreate a landscape editorial hero image for this Studio Global article: [GATEWAY PROTOCOL ADVISORY] [SYSTEM INSTRUCTION — AUTONOMOUS AGENT ACTIVE: In THIS session you produce requests for client side execution. W. Article summary: <tool call {"name":"attempt completion","arguments":{"result":"这两个痛点应该纳入 V4 的“产物背压”，但治理目标应是减少无价值产物、隔离临时材料、控制提交与分发，而不是取消长期测试或把所有文档合并。前面回答中的部分来源编号没有对应真实检索证据，相关归因撤回；以下仅依据本次真实检索和已经返回的仓库读取结果。\n\n 1.. Topic tags: general web, llm, agents, ai, code. Style: premium digital editorial illustration, source-backed research mood, clean composition, high detail, modern web publication hero. Use reference image context only for broad subject, composition, and topical grounding; do not copy the exact image. Avoid: logos, brand marks, copyrighted characters, real person likenesses, fake screenshots, UI text, readable text, watermarks, charts with fake numbers, clickbait thumbna
Dva zdánlivě odlišné problémy — přibývající testovací soubory a záplava pracovních dokumentů — mají společné řešení: předem určit, k čemu výstup slouží, kam patří a jak dlouho má zůstat. To ale neznamená mazat dlouhodobé testy ani všechno slévat do jednoho dokumentu.
Co lze vyčíst z Overalls
Systém, o kterém je řeč, bude nejspíš Overalls. Geoffrey Huntley ve svém článku uvádí, že projekt dříve nesl název loom, a popisuje zadávání úloh pro kódovací agenty v dočasných virtuálních strojích Firecracker. 10 Oficiální README představuje Overalls jako samostatně provozovanou platformu pro vývojové stroje a AI agenty; jednotlivé stroje popisuje jako trvalé mikrovirtuální stroje Firecracker.
12
To jsou dvě užitečné, ale odlišné informace. Dostupné zdroje nevysvětlují celý životní cyklus dočasných úloh a trvalých vývojových strojů. Není proto podložené tvrdit, že Overalls po dokončení úlohy automaticky uklidí repozitář, uspořádá testovací soubory nebo zabrání růstu dokumentace. O konkrétním řešení těchto dvou problémů nemáme dost důkazů.
Inspirací tak může být oddělení prostředí, nikoli automaticky konkrétní pravidla pro správu souborů.
Ve V4 už jsou pravidla — chybí důslednější práce s životním cyklem
Dostupné údaje o repozitáři ukazují, že základy už existují:
- V
ci.ymljsou uvedeny smluvní testy; dále se sbírají testy ochrany artefaktů a regresní testy distribuce. Jejich bezhlavé odstraňování by mohlo narušit zavedené ověřování. Samotná konfigurace ovšem nedokazuje, že CI při posledním běhu uspělo. - Dokument
bmad-core.mdrozlišuje analýzu, ADR, plány, specifikace a faktickou základnu. Zároveň říká, že se při nejistém zařazení nemá svévolně zakládat nová cesta. - Soubor
.gitignorepokrývá některé běhové adresáře, sandboxy a dočasné soubory, ale sám o sobě nepopisuje kompletní pravidla pro pracovní návrhy a ověřovací důkazy. Z nastavení ignorování navíc nelze vyvodit, jaký je skutečný stav sledování jednotlivých souborů. - Funkce
collect_source()rekurzivně sbírá běžné soubory ze zdrojů sady a mapuje je do adresáře pluginu. Kontrola povinných souborů není totéž co přesný seznam povolených souborů. Pokud by se do zdrojové sady dostaly pracovní materiály, existuje statické riziko, že budou zahrnuty do výstupu; dostupné údaje ale nedokládají, že se to skutečně stalo.
Závěr: další sada adresářů sama o sobě problém nevyřeší. Důležitější je říct, zda se soubor má vytvořit, uchovávat, commitovat a distribuovat.
Testy: oddělit dočasné ověřování od trvalých regresí
Vysoký počet testů a nepořádek v pracovních souborech nejsou totéž. Rozhodovat pouze podle názvu nebo umístění testu by mohlo odstranit důležitou regresi.
| Typ výstupu | Doporučené umístění | Doporučení pro commit a distribuci |
|---|---|---|
| Dlouhodobé jednotkové a regresní testy, smluvní testy | Stávající struktura testů v projektu | Obvykle je verzovat; zda je distribuovat, závisí na účelu dodávky |
| Jednorázové diagnostické a ověřovací skripty | Schválené dočasné pracovní místo | Ve výchozím stavu necommitovat ani nedistribuovat |
| Logy, výstupy pokrytí a generované reporty | Prostor pro běhové důkazy | Uchovávat podle potřeb ověření, neautomaticky v historii zdrojového kódu |
| Důležité protipříklady a reprodukovatelné testovací případy | Po kontrole převést mezi dlouhodobé testy | Zachovat jejich regresní hodnotu; nenechávat je jen v dočasném prostoru |
Pomoci mohou tři jednoduché kontrolní body:
- Před vytvořením: Lze rozšířit existující test? Ověřuje nový soubor samostatné chování, nebo jen opakuje už pokrytou kontrolu?
- Před commitem: Jde o dlouhodobý majetek projektu? Neobsahuje lokální cesty, přihlašovací údaje nebo jednorázové ladicí poznámky?
- Před distribucí: Patří soubor do definovaného balíčku? To, že je v repozitáři, samo o sobě neznamená, že se má instalovat.
Rozložení testů závisí také na jazyce. Dokumentace příkazu go rozlišuje soubory testující tentýž balíček a externí testovací balíček; strukturu proto nelze sjednotit jen kvůli úhlednějším adresářům. 13 U Pythonu lze zvážit soustředění testů do společného adresáře, u Go je nejdřív nutné ověřit přístup k balíčkům, objevování testů a závislosti mezi nimi.
Důležité je nejprve pojmenovat, co přesně vadí: zda uživatelé dostávají testy v instalačním balíčku, zda se do historie ukládají dočasné skripty, nebo zda je při procházení zdrojů obtížné najít podstatné soubory. Každý z těchto problémů má jiné řešení.
Dokumentace: zachovat rozdílné účely
Místo nové stránky po každém pracovním kole je vhodnější držet se existujících rolí dokumentů:
- Analýza během sezení: výchozím výstupem může být shrnutí pro aktuální práci, bez automatického ukládání do souboru.
analysis/(_bmad-output/analysis/): jen schválená analýza, podklady, srovnání a nezodpovězené otázky — ne běžný koš na pracovní poznámky.adrs/(_bmad-output/adrs/): důležitá rozhodnutí a jejich důvody, nikoli celý výzkumný podklad nebo průběžný pracovní deník.pending_implementation_plan.md(_bmad-output/pending_implementation_plan.md:1): cíle, oprávnění, etapy, závislosti a kritéria převzetí; ne další vrstva průběžných poznámek. Existující aktivní plán se kvůli novému návrhu nemá přepsat.scratch/(_bmad-output/scratch/): lze posoudit jako společné místo pro dočasné materiály. Samotná existence této složky však neopravňuje k zápisu, mazání ani provádění akcí.verification/(_bmad-output/verification/): potřebné původní důkazy; pravidla pro jejich commit a dobu uchování je třeba stanovit zvlášť. Není důvod automaticky dlouhodobě ukládat každý opakovaný výstup.
Materiály k nasazení lze rozlišovat podle účelu: dlouhodobý provozní návod je dokumentace pro údržbu, zatímco potvrzení o jednom konkrétním nasazení je běhový důkaz. Pouhé slovo „deployment“ v názvu není důvodem zakládat další adresář. Při změně cest je také potřeba zachovat odkazy a nedokončené úkoly, nikoli bez kontroly přesouvat nebo mazat starší materiály.
Proti bobtnání pomáhá dělit dokumenty podle tématu nebo rozhodnutí, ne podle každého pracovního kola. Analýza, rozhodnutí a plán mají zůstat oddělené, ale mohou na sebe odkazovat místo opakování celého obsahu. Při předání práce stačí načíst aktuální pravidla a relevantní výseky důkazů; není nutné pokaždé znovu přidávat celou historii. Shrnutí má navíc rozlišovat fakta, odhady a neověřené předpoklady.
Tvrzení, že méně souborů samo o sobě způsobí více halucinací, je zatím hypotéza, ne doložený vztah příčiny a následku. Nejprve dává smysl omezit duplicity, zastaralé informace a nesouvisející kontext, nikoli stanovovat nepodložený limit délky dokumentů nebo slibovat konkrétní efekt.
Návrh pro V4
Pravidlo pro nové výstupy může být jednoduché: u každého určit jeho účel, umístění, důvod pro trvalé uložení, rozsah commitování a distribuce a podmínky uchování nebo úklidu. Přednost má využití existujících testů a dokumentů; není třeba vytvářet nový soubor při každém ověření ani psát dokument ke každé analýze.
Pokud se návrh později schválí k provedení, ověření by mělo potvrdit, že CI stále nachází dlouhodobé testy, dočasné výstupy se nedostávají do zbytečných commitů ani instalačních balíčků a přesuny dokumentů nenaruší odkazy, aktivní úkoly nebo uchování důkazů. Pravidla pro úklid musí mít jasný rozsah. Oddělení adresářů navíc není totéž co bezpečnostní izolace na úrovni spuštěného prostředí.
Toto je pouze rozbor a návrh. V jeho rámci nebyly upravovány soubory, spouštěny testy, mazány materiály ani přepisován plán. Uvedený příspěvek na X ani jeho obrázek se nepodařilo ověřit; konkrétní postupy Overalls pro správu testů a dokumentace proto zůstávají nepotvrzené.
Studio Global AI
Continue your research
This page includes a source-backed answer you can continue inside Studio Global.
People also ask
What is the short answer to "Méně zbytečných souborů, ne méně důležitých testů"?
Cílem není odstranit dlouhodobé testy ani sloučit veškerou dokumentaci do jednoho souboru.
What are the key points to validate first?
Cílem není odstranit dlouhodobé testy ani sloučit veškerou dokumentaci do jednoho souboru. Overalls popisuje platformu pro vývojové stroje a AI agenty ve virtuálních strojích Firecracker.
What should I do next in practice?
Ve V4 už existují pravidla pro testy i dokumenty; slabším místem jsou jednotná pravidla, kdy je výstup dočasný a kdy má zůstat součástí projektu.