Muokkaa GitHub Copilot Chat -vastauksia

Valmis

GitHub Copilot Chat voi tuottaa vastauksia ja koodia, jotka vastaavat koodauskäytäntöjäsi ja projektivaatimuksiasi, kun siihen annetaan oikea konteksti. Sen sijaan, että lisäisit nämä tiedot toistuvasti jokaiseen keskustelukehotteeseen, voit tallentaa tämän kontekstin tiedostoihin ja sisällyttää ne automaattisesti jokaiseen keskustelupyyntöön.

On kolme päätapaa räätälöidä tekoälyvastauksia Visual Studio Code:ssa:

  • Mukautetut ohjeet: Määritä yleiset ohjeet tehtäville, kuten koodin luomiselle, koodin tarkistusten suorittamiselle tai toimitusviestien luomiselle. Niissä kuvataan, miten tehtävät tulisi suorittaa, ja niissä voidaan määritellä koodauskäytännöt, suositeltavat tekniikat, suojaussäännöt tai toimitusviestien muodot.

  • Kehotetiedostot: Määritä uudelleenkäytettävät kehotteet yleisille tehtäville. Nämä erilliset kehotteet kuvaavat, mitä tulisi tehdä, ja ne voivat sisältää telinekomponentteja, koodin tarkistusten suorittamista, vaiheittaisten oppaiden luomista tai toteutussuunnitelmien luomista.

  • Mukautetut chat-tilat: Määritä, miten chat toimii, mitä työkaluja se voi käyttää ja miten se on vuorovaikutuksessa koodikannan kanssa. Esimerkkejä ovat suunnittelutilat, joissa on vain luku -käyttöoikeus, tutkimustilat, jotka käyttävät ulkoisia resursseja, tai roolikohtaiset tilat, kuten edustakehitys.

Mukautetut ohjeet

Mukautettujen ohjeiden avulla voit kuvata ohjeita, jotka saavat vastauksia, jotka vastaavat koodauskäytäntöjäsi ja teknistä pinoasi. Sen sijaan, että tämä konteksti sisällytettäisiin manuaalisesti jokaiseen keskustelukyselyyn, mukautetut ohjeet sisällyttävät nämä tiedot automaattisesti jokaiseen keskustelupyyntöön.

Note

Mukautettuja ohjeita ei oteta huomioon koodin täydennyksessä.

Mukautettujen ohjeiden tyypit

Visual Studio Code tukee kolmea tapaa määritellä mukautettuja käskyjä:

Type Description Käyttötapaukset
.github/copilot-instructions.md Yksi Markdown-tiedosto työtilassa, sisällytetään automaattisesti kaikkiin pyyntöihin, editorien välinen tuki. Yleiset koodauskäytännöt, suositeltavat tekniikat, projektin laajuiset vaatimukset.
.instructions.md files Useita Markdown-tiedostoja glob-kuvion tuella, työtilan tai käyttäjäprofiilin tallennustilalla. Tehtäväkohtaiset ohjeet, yksityiskohtainen hallinta siitä, milloin ohjeita sovelletaan.
Visual Studio Code -asetukset Ohjeet käyttäjän/työtilan asetuksissa tiettyjä skenaarioita varten. Koodin luominen, testien luominen, toimitusviestit, kooditarkistukset, PR-kuvaukset.

Voit yhdistää nämä lähestymistavat, mutta välttää ristiriitaisia ohjeita, koska prioriteettijärjestystä ei käytetä.

Esimerkkejä mukautetuista ohjeista

Yleiset koodausohjeet:

---
applyTo: "**"
---
# Project coding standards

## Naming Conventions
- Use PascalCase for component names, interfaces, and type aliases.
- Use camelCase for variables, functions, and methods.
- Prefix private class members with underscore (_).
- Use ALL_CAPS for constants.

## Error Handling
- Use try/catch blocks for async operations.
- Implement proper error boundaries in React components.
- Always log errors with contextual information.

TypeScript- ja React-ohjeet:

---
applyTo: "**/*.ts,**/*.tsx"
---
# TypeScript and React standards

Apply the [general coding guidelines](./general-coding.instructions.md) to all code.

## TypeScript Guidelines
- Use TypeScript for all new code.
- Follow functional programming principles where possible.
- Use interfaces for data structures and type definitions.
- Prefer immutable data (const, readonly).
- Use optional chaining (?.) and nullish coalescing (??) operators.

## React Guidelines
- Use functional components with hooks.
- Follow the React hooks rules (no conditional hooks).
- Use React.FC type for components with children.
- Keep components small and focused.
- Use CSS modules for component styling.

Käytä .github/copilot-instructions.md-tiedostoa

Tallenna mukautetut ohjeet .github/copilot-instructions.md työtilan pääkansioon tiedostoon, jossa kuvataan koodauskäytäntöjä, ensisijaisia tekniikoita ja projektivaatimuksia. Nämä ohjeet koskevat vain työtilaa, ja ne sisällytetään automaattisesti jokaiseen chat-pyyntöön.

Asennuksen vaiheet:

  1. Varmista, että github.copilot.chat.codeGeneration.useInstructionFiles on päällä (oletuksena päällä uusimmissa Visual Studio Code-versioissa).
  2. Luo .github/copilot-instructions.md työtilan pääkäyttäjänä.
  3. Kuvaile ohjeet luonnollisella kielellä ja Markdown-muodossa.

Note

Tämä tiedosto toimii Visual Studio Code, Visual Studio ja GitHub.com.

Käytä .instructions.md-tiedostoja

Luo useita .instructions.md tiedostoja tietyille tehtäville, ohjelmointikielille, kehyksille tai projektityypeille. Näitä voidaan käyttää automaattisesti tiedostomallien perusteella tai liittää manuaalisesti chat-kehotteisiin.

Tiedostojen sijainnit:

  • Työtilan tiedostot: Tallennetaan kansioon .github/instructions , käytettävissä vain työtilassa.
  • User files: Tallennettu Visual Studio Code-profiiliin, saatavilla useille työtiloille ja synkronoitu Settings Syncin kautta.

Tiedoston rakenne:

---
description: "Brief description of the instructions file"
applyTo: "**/*.ts,**/*.tsx"  # Glob pattern for automatic application
---
# Instructions content in Markdown format

Luo ja käytä ohjetiedostoja:

  1. Suorita Chat: New Instructions File komentopaletista.
  2. Valitse työtila tai käyttäjän sijainti.
  3. Kirjoita nimi ja tekijän ohjeet Markdowniin.
  4. Käytä Chat: Configure Instructions olemassa olevien tiedostojen muokkaamiseen.

Manuaalinen kiinnitys:

  • Chat-näkymässä: Lisää kontekstiohjeita >
  • Komentopaletti: Chat: Attach Instructions

Automaattinen sovellus: Käytä applyTo metatietoja glob-kuvioiden kanssa (** kaikille pyynnöille, tietyt mallit kohdennetulle sovellukselle)

Mukautettujen ohjeiden määrittäminen asetuksissa

Määritä mukautetut ohjeet Visual Studio Code -asetuksissa tiettyihin tilanteisiin:

Scenario Setting
Koodin luominen github.copilot.chat.codeGeneration.instructions
Testin sukupolvi github.copilot.chat.testGeneration.instructions
Koodin tarkistus github.copilot.chat.reviewSelection.instructions
Viestien toimittaminen github.copilot.chat.commitMessageGeneration.instructions
PR-otsikot/kuvaukset github.copilot.chat.pullRequestDescriptionGeneration.instructions

Määritä ohjeet tekstinä tai viittaavat ulkoisiin tiedostoihin:

"github.copilot.chat.codeGeneration.instructions": [
  {
    "text": "Always add a comment: 'Generated by Copilot'."
  },
  {
    "text": "In TypeScript always use underscore for private field names."
  },
  {
    "file": "general.instructions.md"
  },
  {
    "file": "db.instructions.md"
  }
]

Mukautettujen ohjeiden parhaat käytännöt

  • Pidä ohjeet ytimekkäinä: Jokaisen ohjeen tulee olla yksi, yksinkertainen lause.
  • Vältä ulkoisia viittauksia: Älä viittaa ulkoisiin koodausstandardeihin tai resursseihin.
  • Järjestä aiheen mukaan: Jaa ohjeet useisiin tiedostoihin organisoinnin parantamiseksi.
  • Ota tiimin jakaminen käyttöön: Tallenna ohjeet versioohjattuihin tiedostoihin tiimiyhteistyötä varten.
  • Käytä kohdennettua sovellusta: Hyödynnä applyTo tiedostokohtaisten ohjeiden ominaisuutta.
  • Viittaa tehokkaasti: Viittaa mukautettuihin ohjeisiin kehotetiedostoissa päällekkäisyyksien välttämiseksi.

Kehotetiedostot

Kehotetiedostot ovat uudelleenkäytettäviä, itsenäisiä tehtäväkehotteita, jotka tallennetaan tiedostoina .prompt.md . Toisin kuin mukautetut käskyt — jotka kuvaavat miten GitHub Copilot pitäisi vastata — kehotetiedostot kuvaavat mitä tulisi tehdä tiettyä tehtävää varten. Ajat ne tilauksesta sen sijaan, että ne automaattisesti pätevät jokaiseen pyyntöön.

Prompt-tiedostot sopivat hyvin toistuviin vibe-koodauksen työnkulkuihin: uuden komponentin rakentamiseen, tuotevaatimusdokumentin ensimmäisen luonnoksen tuottamiseen, koodin tarkistuspassin suorittamiseen tai session aloittamiseen, kun projektikonteksti on jo ladattu.

Luo kehotetiedosto

Tallenna kehotetiedostot työtilasi .github/prompts/ kansioon. Tiedoston nimi muuttuu kehotteen nimeksi.

Tiedoston rakenne:

---
mode: "ask"
description: "Generate a product requirements document for a new feature"
---
# Generate a PRD

Create a product requirements document for the described feature.

Include the following sections:
- Product summary
- Target audience
- Core features (prioritized by must-have / should-have / could-have)
- Out of scope
- Technical requirements

Feature description: ${input:Feature description}

Suorita kehotetiedosto

  • Komentopaletti: Suorita Chat: Run Prompt ja valitse tiedosto.
  • Chat-syöte: Kirjoita # Chat-näkymä ja valitse kehotetiedosto nimellä.

Kehotetiedostot tukevat mode arvoja , editask, ja agent. He voivat myös viitata mukautettuihin ohjetiedostoihisi Markdown-linkkisyntaksin avulla välttääkseen sisällön päällekkäisyyksiä tiedostojen välillä.

Mukautetut chat-tilat

Mukautetut chat-tilat antavat sinun määrittää, miten GitHub Copilot Chat -paneeli toimii tiettyä työnkulkua varten. Määrittelet, mitkä työkalut ovat käytettävissä, miten tekoäly toimii koodipohjasi kanssa ja mikä rooli sen tulisi näytellä — ilman että muokkaat omia ohjeitasi.

Tunnelmakoodauksessa tämä on erityisen hyödyllistä suunnitteluvaiheen ja rakennusvaiheen erottamisessa. Suunnittelutila voi rajoittaa GitHub Copilot vain luku -analyysiin, jolloin se ehdottaa suunnitelmia ilman muutoksia, kun taas toteutustila avaa täydet muokkaustyökalut.

Luo oma chat-tila

Tallenna .github/chatmodes/ omat chat-tilan tiedostot työtilasi kansioon.

Tiedoston rakenne:

---
description: "Plan mode: read-only analysis and architecture decisions"
tools: []
---
You are a software architect in planning mode. Analyze the codebase, identify patterns, suggest designs, and answer questions — but do not make any code changes.

Yleiset chat-tilan asetukset vibe-koodaukseen:

Menetelmä Työkalut Käyttötapaus
Suunnittelu Ei mitään (vain luku) Arkkitehtuurin päätökset, ominaisuuksien suunnittelu, PRD-arviointi
Research-toiminto Verkkohaku Kirjastojen tutkiminen, lähestymistapojen vertailu
Toteuttaminen Täysi työkalun käyttö Koodin kirjoittaminen ja muokkaaminen, komentojen suorittaminen
Tarkastele Vain lukuoikeus Koodin tarkastus, turvallisuusauditointi, suorituskyvyn tarkistus

Käytä mukautettua chat-tilaa

Valitse tila chat-tilan valitsimesta Chat View -työkalupalkista. Tila jatkuu koko session ajan, kunnes vaihdat.

Summary

GitHub Copilot -vastausten räätälöinti antaa sinun muokata tekoälyapua juuri sinun työnkulullesi sopivaksi. Mukautetut ohjeet — käyttäen .github/copilot-instructions.md-tiedostoja, .instructions.md-tiedostoja tai Visual Studio Code-asetuksia — määrittelevät miten GitHub Copilot vastaa, koodaten koodauskäytännöt, standardit ja mieltymyksesi. Prompt-tiedostot määrittelevät, mitä toistuville tehtäville tulisi tehdä, tarjoten uudelleenkäytettäviä kehotteita, joita voit suorittaa tarpeen mukaan. Mukautetut chat-tilat säätävät keskustelusession toimintaa, jolloin voit vaihtaa suunnittelun, tutkimuksen, toteutuksen ja tarkistustyönkulujen välillä muuttamatta taustalla olevia ohjeita. Yhdessä nämä kolme työkalua auttavat sinua rakentamaan johdonmukaisen tunnelmakoodausympäristön, jossa GitHub Copilot ymmärtää projektisi alusta alkaen.