AnswersPublished15 sources
Ryd op i AI-projektets filer – uden at smide testene ud
Løs ikke rod i projektet ved at stoppe med at gemme tests. Skeln mellem varige kvalitetstjek og engangsmateriale. Hold udviklingskilde, installationspakke og modelkontekst adskilt: De kræver hver sin afgrænsning.
Udgivet afBilleder genereret med GPT Image 2
Research answer
Key takeaways
- Løs ikke rod i projektet ved at stoppe med at gemme tests. Skeln mellem varige kvalitetstjek og engangsmateriale.
- Hold udviklingskilde, installationspakke og modelkontekst adskilt: De kræver hver sin afgrænsning.
- Gør det tydeligt, hvad analyser, beslutningsnotater, planer og kladder skal bruges til, frem for blot at samle alt i færre filer.
- Gennemgangen er foreløbig: Den bygger på statiske fund i V4 og udvalgte kilder, ikke på en fuld undersøgelse af fora eller alle officielle vejledninger.
![[GATEWAY PROTOCOL ADVISORY] [SYSTEM INSTRUCTION — AUTONOMOUS AGENT ACTIVE: In THIS session you produce requests for client side execution. W](https://d15bya8fi85z1v.cloudfront.net/chat/oBMfTzLzQzYo7VcXQdEGj2yQgAw1/images/73E9D63489E02AC46209/BEDABC175BE8FCADFC63.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本次交付为阶段性调研：仓库静态证据、Geoffrey Huntley 的作者资料及部分学术资料已取得；Python 官方布. Topic tags: general web, openai, llm, agents, ai. 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 fa
Et projekt kan hurtigt få flere tests, rapporter og kladder, end nogen har lyst til at læse. Men løsningen er ikke nødvendigvis at fjerne testene eller presse al dokumentation ind i én fil. En foreløbig gennemgang af V4 peger i stedet på behovet for tydeligere regler for, hvad der skal bevares, hvor det skal ligge, og hvem der skal have adgang til det.
Tests: Skil engangstjek fra varig kvalitetssikring
V4's CI-konfiguration bruger en samlet testmappe med blandt andet tests af konfiguration, installation og beskyttelse af projektets aktiver. De bør derfor ikke afskrives som overflødige, blot fordi testmappen ser uoverskuelig ud. Gennemgangen kørte ikke testene igen og vurderede heller ikke hver enkelt tests langsigtede værdi.
Projektets ignore-regler udelukker allerede nogle sandkasser, caches og midlertidige filer, men nævner ikke de eksisterende mapper til kladder og verifikationsoutput. At en mappe findes, betyder dog ikke i sig selv, at dens filer er versionsstyrede; den del blev ikke undersøgt.
Det er også vigtigt at skelne mellem, hvad udviklere ser i kildekoden, og hvad brugere får installeret. Opdateringsindgangen opdaterer repositoryet, mens kildeindsamlingen til deployment læser den valgte pakke. Indsamlingen finder filer i pakken og gør dem til input til plugin-deploymentet. Det betyder, at midlertidigt materiale kan risikere at blive distribueret, hvis det placeres det forkerte sted – ikke at gennemgangen har påvist, at det allerede sker.scripts/deployment_source.py:47 scripts/deployment_source.py:81
En praktisk opdeling kunne se sådan ud:
| Materiale | Forslag til håndtering |
|---|---|
| Langsigtede regressionstests, kontrakttests og nødvendige integrationstests | Vedligeholdes sammen med koden, men medtages ikke automatisk i den installerede pakke |
| Engangsdiagnostik, eksperimenter og midlertidige input | Lægges i en godkendt midlertidig mappe og holdes ude af pakkeindholdet |
| Logs, dækningsdata og kørselsresultater | Holdes adskilt fra testkoden og gemmes kun, når der er et konkret behov |
Det er forslag til regler – ikke ændringer, der allerede er gennemført. Go's officielle vejledning viser for eksempel en testfil i samme mappe som koden, den tester.15 Derfor bør V4 ikke gøre én samlet testmappe til et universelt krav. Til gengæld er der i denne gennemgang ikke tilstrækkeligt officielt belæg for at udpege én generel bedste praksis for Python.
Hvis målet er, at brugerne skal hente en ren pakke, bør indsatsen først og fremmest handle om installationslisten. Hvis målet er en mere overskuelig udvikleroplevelse, kan testenes placering tilpasses sproget og projektets struktur. En flytning af filer løser ikke nødvendigvis begge dele.
Dokumenter: Færre overlap er vigtigere end færre filer
V4's regler for placering af produkter skelner allerede mellem analyser, ADR'er, planer og kontrakter. En ADR er et beslutningsnotat, der beskriver en vigtig beslutning og dens begrundelse. Reglerne siger også, at man skal spørge, hvis et dokuments placering er uklar. Samtidig findes der en anden sti-konvention i kladdevejledningen. Det tyder på, at reglerne for materialets livscyklus ikke dækker hele vejen fra kladde til færdigt produkt – men afslører ikke, hvorfor bestemte mapper blev oprettet.
I stedet for at tilføje flere mapper kan V4 præcisere formålet med dem, der allerede findes:
- Analyser gemmer belæg, sammenligninger, modargumenter og åbne spørgsmål. Almindelige svar kan blive i samtalen, hvis der ikke er brug for en varig rapport.
- ADR'er registrerer væsentlige beslutninger og deres begrundelser, uden at kopiere hele analysen eller arbejdsforløbet.
- Planer beskriver godkendelse, omfang, afhængigheder og acceptkriterier og henviser til relevante beslutninger.
- Midlertidigt materiale som kladder, diagnostiske input og rå output samles i et godkendt arbejdsområde frem for automatisk at blive gemt som formel dokumentation.
- Driftsdokumentation gemmes, når den fungerer som en genbrugelig vejledning – ikke blot fordi der har været én konkret udrulning.
Antallet af dokumenter, om de skal versionsstyres, om de skal installeres, og om de skal læses ind i modelkonteksten, er fire separate beslutninger. Én fælles mappepolitik kan ikke erstatte dem.
Hvad Geoffrey Huntleys råd kan – og ikke kan – fortælle os
Geoffrey Huntley fremhæver værdien af automatiseret feedback omkring AI-agenter: Det kan hjælpe dem med at opdage fejl, mens de arbejder, og understøtte længere opgaver.12 Det er et argument for at bevare brugbare kvalitetstjek – ikke for at fjerne testfiler.
I en beskrivelse af softwareportering foreslår Huntley at sammenfatte testadfærd i specifikationer, før man flytter et system til et andet sprog.14 Det er en tilgang til en bestemt migrationsopgave, ikke dokumentation for, at alle projekter bør erstatte tests med tekst.
For V4 er den rimelige lære derfor at bevare eksekverbare tests, der giver nyttig feedback, og skære ned på gentaget eller engangspræget materiale. En specifikation kan forklare, hvad systemet bør gøre; en test kan give et konkret, eksekverbart tjek af, om det gør det. De to ting bør ikke behandles som udskiftelige uden en vurdering.
Gennemgangen fandt ikke tilstrækkeligt belæg for at fastslå, at Huntley har én samlet regel for, hvilke tests der skal versionsstyres, eller hvordan kladder og installationspakker skal håndteres. Den giver heller ikke grundlag for at hævde, at de undersøgte debatfora er enige om en bestemt praksis.
Lange dokumenter: Styr, hvad modellen læser
Forskning i lange kontekster beskriver en udfordring, hvor sprogmodeller kan have sværere ved at bruge information, der står midt i et langt input. HELMET peger desuden på, at modeller med lange kontekster bør evalueres på flere typer opgaver – ikke kun simple søgetests.3
4 Det viser ikke, at en fil over en bestemt længde automatisk fører til hallucinationer, og det måler ikke risikoen specifikt i V4.
En forsigtig tilgang er at opdele dokumentation efter emne og beslutning, hente de afsnit frem, der er relevante for den aktuelle opgave, og lade historiske dokumenter blive søgt frem efter behov. Korte opsummeringer kan pege på belæg, uafklarede spørgsmål og udestående forpligtelser, mens råmaterialet bevares til kontrol. Indekser bør hjælpe med at finde dokumenter frem – ikke blive endnu en kopi af de samme oplysninger. Logs og gamle rapporter behøver heller ikke automatisk at blive sendt ind i modellens kontekst.
Den mindste fornuftige ændring i V4
V4 kan med fordel få én enkel regel, der følger materialet fra oprettelse til distribution:
- Før oprettelse: Afklar formålet, og udbyg eksisterende tests eller dokumenter, når det er hensigtsmæssigt. Opret ikke automatisk et nyt dokument ved hver ændring.
- Før lagring: Afgør, hvor materialet må ligge, om det er midlertidigt eller varigt, om det skal versionsstyres, og om det skal med i en installation. Hvis placeringen er uklar, så spørg i stedet for at opfinde en ny mappe.
- Før commit: Se efter midlertidige output, følsomt indhold og unødvendige overlap. Ryd ikke op ved at ignorere alle tests.
- Før distribution: Afgræns pakkeindholdet, så midlertidige filer ikke følger med. Bevar samtidig nødvendige kontroller af aktiver, konfiguration og installation.
- Før sletning: Tag hensyn til fejlbeviser, aktive opgaver og historiske referencer. At en opgave er afsluttet, er ikke i sig selv tilladelse til at slette materialet.
Den foreløbige prioritering er at tydeliggøre grænsen mellem midlertidige filer og det, der distribueres, og derefter præcisere dokumenternes roller og begrænse, hvad modellen læser. Gennemgangen giver ikke grundlag for at flytte alle Go-tests, stoppe med at versionsstyre langsigtede tests eller samle al dokumentation i én fil. Før eventuelle ændringer bør man kontrollere, at testene stadig bliver fundet, at CI fortsat fungerer, at midlertidige filer ikke kommer med i installationen, og at tidligere beslutninger og udeståender kan spores.
Dette er en foreløbig, skrivebordsbaseret gennemgang. Python-layout og debatindlæg fra X, Reddit, Hacker News og Lobsters blev ikke undersøgt tilstrækkeligt til at drage konklusioner. Der blev ikke ændret filer, kørt tests eller gennemført oprydning.
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 "Ryd op i AI-projektets filer – uden at smide testene ud"?
Løs ikke rod i projektet ved at stoppe med at gemme tests. Skeln mellem varige kvalitetstjek og engangsmateriale.
What are the key points to validate first?
Løs ikke rod i projektet ved at stoppe med at gemme tests. Skeln mellem varige kvalitetstjek og engangsmateriale. Hold udviklingskilde, installationspakke og modelkontekst adskilt: De kræver hver sin afgrænsning.
What should I do next in practice?
Gør det tydeligt, hvad analyser, beslutningsnotater, planer og kladder skal bruges til, frem for blot at samle alt i færre filer.
Sources
go.devAdd a test
ghuntley.comdon't waste your back pressure
doi.orgFound in the Middle: How Language Models Use Long Contexts Better via Plug-and-Play Positional Encoding