
Optimaliser GitHub Copilot for ditt prosjekt 🚀
By Anders Olsen Sandvik on
Note: Denne artikkelen er basert på en melding jeg delte internt på Slack om hvordan man kan optimalisere GitHub Copilot for sitt prosjekt.
Hei! 👋 Mange av oss bruker GitHub Copilot i hverdagen, men visste du at du kan gjøre KI-assistenten mye smartere for akkurat ditt prosjekt?
Hva er .github/copilot-instructions.md?
Dette er en fil du kan legge til i prosjektet ditt som gir Copilot ekstra kontekst. Alt du skriver her blir sendt med på alle spørsmålene du stiller, og utvider konteksten KI-en jobber med.
Praktiske eksempler
Kodestil og konvensjoner:
- Alle API-endepunkter skal følge RESTful konvensjoner
- Bruk snake_case for databasefelter og tabellnavn
- Logg alltid med strukturert logging (f.eks. winston), ikke
console.log
- Feilhåndtering skal alltid bruke egne Error-klasser
- Bruk miljøvariabler for konfigurasjon, aldri hardkodede verdier
Domenekunnskap:
- AFP = Avtalefestet Pensjon (et pensjonsprodukt)
- NOTP = Ny Offentlig Tjenestepensjon
- Regulering = Årlig justering av pensjonsytelser i tråd med lønns- og prisvekst.
Tekniske valg:
- Vi bruker SPK Design System og Tailwind
- Testing gjøres med Jest, ikke Mocha
- Database: Microsoft SQL Server
- Alle datoer håndteres i Europe/Oslo tidssone med ISO 8601 format
KI-oppførsel:
- Svar kort og presist uten unødvendige bekreftelser
- Bruk norske kommentarer i kode som håndterer norske fagbegreper
- Bruk JSDOC på alle funksjoner og metoder over fire linjer
Hvorfor er dette nyttig?
- ✅ Konsistente kodeforslag som matcher din kodebase
- ✅ Færre forslag som bruker feil rammeverk eller biblioteker
- ✅ Bedre forståelse av fagterminologi og domenekonsepter
- ✅ Spar tid ved å slippe å forklare samme ting om og om igjen
Kom i gang
- Opprett
.github/copilot-instructions.md
i rotmappen til prosjektet - Legg til relevant kontekst for ditt team/prosjekt
- Commit og push - ferdig! 🎉
Copilot vil nå automatisk ta hensyn til denne konteksten i alle svar.
Eksempel fra et av våre prosjekter
I self-service-repo har vi for eksempel lagt til:
Generelle retningslinjer:
- Unngå unødvendige unnskyldninger eller bekreftende utsagn
- Svar pragmatisk og fokuser på oppgaven
- Tenk kritisk hvis du får beskjed om at du tar feil
Kodestandarder:
- Bruk camelCase for variabler og funksjoner i TypeScript/JavaScript
- Bruk kebab-case i YAML-filer
- Bruk PascalCase for komponenter
- Bruk UPPER_CASE for miljøvariabler
- Maks 100 tegn per linje
- Alltid bruk SHA med versjon-kommentar når du refererer til GitHub Actions
- Alltid bruk Maven Wrapper for Maven-kommandoer
Testing:
- Test alltid den faktiske implementasjonen, ikke kopier av koden
- Legg testressurser i separate filer, ikke inline tekst-blokker
Dette sikrer at Copilot foreslår kode som følger prosjektets standarder og beste praksis.
Oppsummering
Ved å lage en .github/copilot-instructions.md
fil kan du gi Copilot viktig kontekst om ditt prosjekt som:
- Kodestandarder og konvensjoner
- Domenespesifikk terminologi
- Teknologivalg og arkitektur
- Ønsket oppførsel fra KI-assistenten
Resultatet er mer presise og relevante kodeforslag som sparer deg for tid og reduserer feilkilder.
Har du spørsmål eller tips til hva som fungerer godt i deres prosjekter? Del gjerne! 💬