AnswersPublished15 sources
Ryddigere kodebase uten å ofre testene
Ikke rydd i testene ved å slutte å versjonsstyre dem: Skill heller mellom varige tester og engangsverktøy og resultater. Bestem separat hva som hører hjemme i kodebasen, hva som følger med en installasjon, og hva modellen trenger å lese.
Publisert avBilder generert med GPT Image 2
Research answer
Key takeaways
- Ikke rydd i testene ved å slutte å versjonsstyre dem: Skill heller mellom varige tester og engangsverktøy og resultater.
- Bestem separat hva som hører hjemme i kodebasen, hva som følger med en installasjon, og hva modellen trenger å lese.
- V4 har allerede ulike regler for dokumenter og utkast. Neste steg bør være tydeligere ansvar og livsløp, ikke flest mulig nye mapper.
- Gjennomgangen er foreløpig: Noen kilder og forumundersøkelser mangler, og ingen tester eller endringer ble kjørt eller gjennomført.
![[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
Det er lett å se mange tester og dokumenter i en kodebase og tenke at alt bør samles eller fjernes. Men ryddighet handler ikke bare om hvor mange filer som finnes. Det handler også om hvilke filer som skal vedlikeholdes, hva som følger med en installasjon, og hva en modell faktisk trenger å lese.
For V4 peker den foreløpige gjennomgangen mot et bedre mål: Behold varige kvalitetssikringer, men skill dem tydelig fra engangsmateriale og styr tilgangen til dokumentasjon etter behov.
Tester: isoler midlertidig arbeid, ikke kvalitetssikringen
V4s CI-oppsett bruker en samlet testmappe med blant annet tester av konfigurasjonskontrakter, installasjon og beskyttelse av filer. At testene ligger synlig i kodebasen, er derfor ikke i seg selv et tegn på at de er overflødige. Gjennomgangen kjørte ikke testene og vurderte heller ikke vedlikeholdsverdien til hver enkelt test.
Ignoreringsreglene utelater noen sandkasser, cacher og midlertidige filer, men nevner ikke uttrykkelig utkast eller enkelte områder for skisser og verifisering. Det betyr ikke nødvendigvis at filene der er sporet av Git: om de faktisk er lagt til i versjonskontrollen, ble ikke undersøkt.
Det er også nyttig å skille mellom oppdatering og distribusjon. Oppdateringsinngangen oppdaterer kodebasen, mens innsamlingen av distribusjonsfiler leser den valgte pakken. De er ulike grenser. At en utvikler som henter kode, kan se testene, betyr ikke at testene installeres sammen med det som kjøres.
Samtidig samler distribusjonslogikken inn vanlige filer rekursivt fra pakken og gjør dem til grunnlag for plugin-distribusjon. Det gir en mulig risiko dersom midlertidige filer legges i pakkemappen. Gjennomgangen fant ikke belegg for at dette faktisk har skjedd.
Et praktisk skille kan se slik ut:
| Type materiale | Forslag til praksis |
|---|---|
| Langsiktige regresjons-, kontrakt- og integrasjonstester | Vedlikeholdes og versjonsstyres sammen med implementasjonen, men inngår som hovedregel ikke i installasjonspakken. |
| Engangsdiagnostikk, verifiseringsskript og eksperimentelle inndata | Oppbevares lokalt som standard, i en godkjent arbeidsmappe – ikke i en mappe som distribueres. |
| Logger, dekningsdata og kjøringsresultater | Holdes atskilt fra testkoden, utelates som standard fra kildekodeinnsjekking og følger ikke med installasjonen. |
Dette er forslag, ikke regler som allerede er innført i V4.
Språkvaner bør også telle. Go sin offisielle veiledning legger testen i samme mappe som pakken som testes; det er derfor ikke et godt generelt råd å flytte alle Go-enhetstester til én felles mappe.15 V4 har allerede en samlet teststruktur i dette tilfellet, som det kan være naturlig å bygge videre på. Gjennomgangen hadde ikke tilstrekkelig offisielt kildegrunnlag til å anbefale én generell mappestruktur for Python.
Hva som bør prioriteres, avhenger av problemet: Hvis vanlige brukere skal få en ren installasjon, bør distribusjonspakken eller installasjonslisten være utgangspunktet. Hvis utviklernes kildekodetre skal bli ryddigere, kan det være aktuelt å bruke en struktur som passer språket. Å flytte testfiler løser ikke automatisk begge deler.
Dokumenter: avklar ansvar, ikke bare antall mapper
V4s regler for plassering av leveranser skiller allerede mellom analyser, beslutningslogger (ADR-er), planer og kontrakter, og sier at man skal spørre når det er uklart hvor noe hører hjemme. Samtidig angir utkastreglene en annen sti. Det tyder på at reglene for livsløpet ikke er helt samordnet. Det dokumenterer ikke hvorfor noen ender med å opprette nye mapper fra gang til gang.
En enklere modell kan ta utgangspunkt i strukturen som finnes fra før:
- Analyse: Ta vare på kilder, sammenligninger, motargumenter og det som fortsatt er ukjent. Vanlige spørsmål kan besvares direkte; ikke opprett en rapport hvis det ikke er behov for varig lagring.
- ADR: Registrer viktige beslutninger, begrunnelser og begrensninger. Ikke kopier hele analysen eller lag en parallell logg over arbeidsflyten.
- Gjennomføringsplan: Beskriv godkjenning, omfang, avhengigheter og akseptkriterier. Vis til relevante beslutninger i stedet for å gjenta hele undersøkelsen.
- Midlertidig materiale: Samle utkast, diagnostiske inndata og råresultater i et godkjent midlertidig område. En fil blir ikke en formell analyse bare fordi overskriften inneholder ordet «utkast».
- Varig driftsdokumentasjon: Ta vare på materiale som faktisk fungerer som en gjenbrukbar bruksanvisning. Én gjennomført distribusjon bør ikke automatisk føre til en ny distribusjonsmappe.
Hvor dokumentet ligger, om det versjonsstyres, om det distribueres og om modellen leser det, er fire forskjellige valg. Én felles mappe løser ikke behovet for å ta stilling til alle fire.
Hva Geoffrey Huntleys råd sier – og ikke sier
Geoffrey Huntley skriver om «back pressure» som automatiserte tilbakemeldinger på kvalitet og korrekthet rundt agenten – ikke som et argument for å fjerne testfiler.12 I en konkret veiledning om å flytte programvare mellom språk foreslår han å beskrive testatferd som spesifikasjoner før selve porteringen.
14 Det er en metode for en bestemt migreringsoppgave, ikke dokumentasjon på at alle prosjekter bør erstatte tester med tekst.
For V4 er en rimelig lærdom å bevare tilbakemeldinger som faktisk fanger feil, samtidig som man reduserer unødvendige eller engangsbaserte kontrollfiler. En spesifikasjon beskriver ønsket atferd; en test kan gi en kjørbar kontroll av om atferden er på plass. De to bør ikke behandles som utskiftbare uten en konkret vurdering.
Gjennomgangen fant ikke tilstrekkelig grunnlag for å si at Huntley har én generell regel for hvilke tester som skal versjonsstyres, hvor utkast skal ligge eller hva som skal utelates fra en distribusjon. Det er heller ikke grunnlag her for å hevde at forumdiskusjoner viser en samlet enighet. Materiale som ikke ble undersøkt, brukes ikke som dokumentasjon.
Dokumentmengde og modellens kontekst
Forskning på lange kontekster beskriver at modeller kan ha vanskeligere for å bruke informasjon som ligger midt i en lang inntekst.3 Evalueringen HELMET peker også på at evner med lange kontekster bør vurderes med flere typer oppgaver, ikke bare enkle gjenfinningsmålinger.
4
Dette gir ikke grunnlag for en fast grense for hvor mange linjer et dokument kan ha før modellen «hallusinerer». Det måler heller ikke risikoen i V4 direkte. Men det støtter en forsiktig praksis: Ikke anta at mer dokumentasjon alltid gir bedre svar.
Noen mulige grep:
- Del opp etter tema og beslutningsgrenser, i stedet for å la ett hoveddokument vokse uten ende.
- Les som standard bare delene som gjelder den aktuelle oppgaven; hent fram historisk materiale når det trengs.
- Bruk korte sammendrag som beholder kildehenvisninger, usikkerhet og uavklarte forpliktelser. Behold råmaterialet for etterprøving.
- La indekser vise vei, men unngå å kopiere hele dokumenter inn i en ny oversikt som blir en konkurrerende kilde til fakta.
- Ikke send logger og historiske rapporter inn i modellens kontekst som standard.
Et nøkternt neste steg for V4
V4 trenger ikke en ny, tung prosess. En kort regel for hele livsløpet til filer kan være nok:
- Før noe opprettes: Avklar hva materialet skal brukes til. Se om en eksisterende test eller et dokument kan utvides, i stedet for automatisk å lage et nytt.
- Før det lagres: Bestem godkjent plassering, om materialet er varig eller midlertidig, om det skal versjonsstyres, og om det skal distribueres. Hvis det er uklart, ikke finn opp en ny mappe på egen hånd.
- Før innsjekking: Se etter midlertidige resultater, sensitivt innhold, dupliserte tester og dokumenter. Ikke oppnå et ryddigere tre ved å ignorere alle testene.
- Før distribusjon: Sett en tydelig grense for installasjonsinnholdet, slik at midlertidige filer ikke følger med pakken. Behold eksisterende kontroller av sammendrag, identitet og beskyttede filer.
- Før opprydding: Ta hensyn til feilspor, aktive oppgaver og historiske henvisninger. At en oppgave er ferdig eller en fil gammel, er ikke alene tillatelse til å slette den.
Den foreløpige konklusjonen er å prioritere tydeligere grenser for midlertidige filer og distribusjonsinnhold. Deretter bør V4 samordne dokumentenes ansvar og innføre behovsstyrt lesing. Det er ikke grunnlag her for å flytte alle Go-tester, slutte å versjonsstyre varige tester eller slå sammen all dokumentasjon.
En eventuell senere endring bør som minimum kontrollere at testene fortsatt samles opp, at relevant CI fungerer, at midlertidige filer ikke havner i installasjonen, og at historiske henvisninger og uavklarte forpliktelser fortsatt kan spores.
Forbehold: Dette er en delvis gjennomgang. Kildekode og tilgjengelige regler ble undersøkt, sammen med Huntleys materiale og noen akademiske kilder. Undersøkelser av Python-anbefalinger og diskusjoner på X, Reddit, Hacker News og Lobsters ble ikke fullført. Ingen tester ble kjørt, ingen filer ble endret eller ryddet, og ingen eksisterende prosjektplan ble gjenopptatt.
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 "Ryddigere kodebase uten å ofre testene"?
Ikke rydd i testene ved å slutte å versjonsstyre dem: Skill heller mellom varige tester og engangsverktøy og resultater.
What are the key points to validate first?
Ikke rydd i testene ved å slutte å versjonsstyre dem: Skill heller mellom varige tester og engangsverktøy og resultater. Bestem separat hva som hører hjemme i kodebasen, hva som følger med en installasjon, og hva modellen trenger å lese.
What should I do next in practice?
V4 har allerede ulike regler for dokumenter og utkast. Neste steg bør være tydeligere ansvar og livsløp, ikke flest mulig nye mapper.
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