Optimaliser GitHub Copilot for ditt prosjekt 🚀

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

  1. Opprett .github/copilot-instructions.md i rotmappen til prosjektet
  2. Legg til relevant kontekst for ditt team/prosjekt
  3. 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! 💬


Be notified of new posts. Subscribe to the RSS feed.