התאמת תגובות GitHub Copilot Chat

  • 6 דקות

GitHub Copilot Chat יכול לייצר תגובות וקוד שמתאימים לפרקטיקות הקידוד ולדרישות הפרויקט שלך כאשר מקבלים את ההקשר הנכון. במקום להוסיף את המידע הזה שוב ושוב בכל בקשת צ'אט, אתה יכול לאחסן את ההקשר הזה בקבצים ולכלול אותו באופן אוטומטי בכל בקשת צ'אט.

ישנן שלוש דרכים עיקריות להתאים תגובות בינה מלאכותית ב-Visual Studio Code:

  • הוראות מותאמות אישית: הגדר הנחיות נפוצות למשימות כמו יצירת קוד, ביצוע סקירות קוד או יצירת הודעות commit . אלה מתארים כיצד יש לבצע משימות ויכולים לציין שיטות קידוד, טכנולוגיות מועדפות, כללי אבטחה או פורמטים של הודעות ביצוע.

  • קבצי בקשה: הגדר בקשות לשימוש חוזר עבור משימות נפוצות. הנחיות עצמאיות אלו מתארות מה צריך לעשות ויכולות לכלול רכיבי פיגומים, ביצוע סקירות קוד, יצירת מדריכים שלב אחר שלב או יצירת תוכניות יישום.

  • מצבי צ'אט מותאמים אישית: הגדר כיצד הצ'אט פועל, באילו כלים הוא יכול להשתמש וכיצד הוא מקיים אינטראקציה עם בסיס הקוד. דוגמאות כוללות מצבי תכנון עם גישה לקריאה בלבד, מצבי מחקר הניגשים למשאבים חיצוניים או מצבים ספציפיים לתפקיד כמו פיתוח חזיתי.

הוראות מותאמות אישית

הוראות מותאמות אישית מאפשרות לך לתאר הנחיות שמקבלות תגובות התואמות את שיטות הקידוד הספציפיות שלך ואת המחסנית הטכנולוגית שלך. במקום לכלול את ההקשר הזה באופן ידני בכל שאילתת צ'אט, הוראות מותאמות אישית משלבות מידע זה באופן אוטומטי בכל בקשת צ'אט.

Note

הוראות מותאמות אישית אינן נלקחות בחשבון עבור השלמת קוד.

סוגי הוראות מותאמות אישית

Visual Studio Code תומך בשלוש דרכים להגדיר הוראות מותאמות אישית:

Type Description מקרי שימוש
.github/copilot-instructions.md קובץ Markdown יחיד בסביבת העבודה, כלול אוטומטית בכל הבקשות, תמיכה בעורכים צולבים. שיטות קידוד כלליות, טכנולוגיות מועדפות, דרישות ברחבי הפרויקט.
.instructions.md files קבצי Markdown מרובים עם תמיכה בדפוס גלוב, סביבת עבודה או אחסון פרופיל משתמש. הוראות ספציפיות למשימה, שליטה פרטנית על מתי ההוראות חלות.
הגדרות Visual Studio Code הוראות בהגדרות משתמש/סביבת עבודה עבור תרחישים ספציפיים. יצירת קוד, יצירת בדיקות, הודעות Commit , סקירות קוד, תיאורי יחסי ציבור.

באפשרותך לשלב גישות אלה, אך הימנע מהוראות סותרות מכיוון שלא מוחל סדר עדיפות.

דוגמאות להוראות מותאמות אישית

הנחיות קידוד כלליות:

---
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 ו-React:

---
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.

השתמש בקובץ .github/copilot-instructions.md

אחסן הוראות מותאמות אישית בקובץ .github/copilot-instructions.md בבסיס סביבת העבודה שלך כדי לתאר שיטות קידוד, טכנולוגיות מועדפות ודרישות פרויקט. הוראות אלה חלות רק על סביבת העבודה והן כלולות באופן אוטומטי בכל בקשת צ'אט.

שלבי הגדרה:

  1. בדוק ש-github.copilot.chat.codeGeneration.useInstructionFiles מופעל (מופעל כברירת מחדל בגרסאות האחרונות של Visual Studio Code).
  2. צור .github/copilot-instructions.md בשורש סביבת העבודה.
  3. תאר הוראות באמצעות שפה טבעית ופורמט Markdown.

Note

קובץ זה פועל על פני Visual Studio Code, Visual Studio ו-GitHub.com.

שימוש בקבצי .instructions.md

צור קבצים מרובים .instructions.md עבור משימות ספציפיות, שפות תכנות, מסגרות או סוגי פרוייקטים. ניתן להחיל אותם באופן אוטומטי על סמך דפוסי קבצים או לצרף אותם באופן ידני להנחיות צ'אט.

מיקומי קבצים:

  • קובצי סביבת עבודה: מאוחסנים בתיקייה .github/instructions , זמינים רק בתוך סביבת העבודה.
  • User files: מאוחסנים בפרופיל Visual Studio Code, זמינים במספר מרחב עבודה ומסונכרן דרך סנכרון הגדרות.

מבנה הקובץ:

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

צור והשתמש בקבצי הוראות:

  1. הפעל Chat: New Instructions File מלוח הפקודות.
  2. בחר סביבת עבודה או מיקום משתמש.
  3. הזן שם והוראות מחבר ב-Markdown.
  4. השתמש לעריכת Chat: Configure Instructions קבצים קיימים.

קובץ מצורף ידני:

  • בתצוגת צ'אט: הוספת הוראות הקשר >
  • לוח פקודות: Chat: Attach Instructions

יישום אוטומטי: השתמש במטא applyTo נתונים עם דפוסי כדור (** לכל הבקשות, דפוסים ספציפיים ליישום ממוקד)

ציון הוראות מותאמות אישית בהגדרות

הגדר הוראות מותאמות אישית בהגדרות Visual Studio Code לתרחישים מסוימים:

Scenario Setting
יצירת קוד github.copilot.chat.codeGeneration.instructions
יצירת מבחן github.copilot.chat.testGeneration.instructions
סקירת קוד github.copilot.chat.reviewSelection.instructions
בצע הודעות github.copilot.chat.commitMessageGeneration.instructions
כותרות/תיאורי יחסי ציבור github.copilot.chat.pullRequestDescriptionGeneration.instructions

הגדר הוראות כטקסט או הפניה לקבצים חיצוניים:

"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"
  }
]

שיטות מומלצות להוראות מותאמות אישית

  • שמור על הוראות תמציתיות: כל הוראה צריכה להיות הצהרה אחת ופשוטה.
  • הימנע מהפניות חיצוניות: אל תתייחס לתקני קידוד או למשאבים חיצוניים.
  • ארגן לפי נושא: פצל הוראות לקבצים מרובים לארגון טוב יותר.
  • אפשר שיתוף צוות: אחסן הוראות בקבצים הנשלטים על-ידי גירסאות לשיתוף פעולה בצוות.
  • השתמש ביישום ייעודי: מנף applyTo את המאפיין לקבלת הוראות ספציפיות לקובץ.
  • הפניה יעילה: הפניה להוראות מותאמות אישית בקבצים המנחים כדי למנוע כפילויות.

הצגת בקשה לקבצים

קבצי ההנחיות ניתנים לשימוש חוזר, פקודות משימה עצמאיות נשמרות כקבצים .prompt.md . בניגוד להוראות מותאמות אישית — שמתארות איך GitHub Copilot אמור להגיב — קבצי ההנאה מתארים what שיש לבצע עבור משימה מסוימת. אתה מריץ אותם לפי דרישה במקום שהן יחולו אוטומטית על כל בקשה.

קבצי הנחיה מתאימים מאוד לתהליכי עבודה חוזרים בתהליכי קידוד עם אווירה חזרתית: התקנת רכיב חדש, יצירת טיוטה ראשונה של מסמך דרישות מוצר, הרצת סקירת קוד, או פתיחת סשן עם הקשר הפרויקט כבר טעון.

צור קובץ הנחיה

אחסן קבצי הפקודות בתיקייה .github/prompts/ שבסביבת העבודה שלך. שם הקובץ הופך לשם ההנחיה.

מבנה הקובץ:

---
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}

הרץ קובץ הנחיה

  • פלטת פקודות: הרץ Chat: Run Prompt ובחר את הקובץ.
  • קלט צ'אט: הקלד # בתצוגת הצ'אט ובחר את קובץ ההודעה לפי שם.

קבצי הנחיה תומכים mode בערכים של ask, edit, ו- agent. הם גם יכולים להתייחס לקבצי הוראות מותאמים אישית באמצעות תחביר קישור Markdown כדי למנוע שכפול תוכן בין קבצים.

מצבי צ'אט מותאמים אישית

מצבי צ'אט מותאמים אישית מאפשרים להגדיר כיצד פאנל GitHub Copilot Chat פועל עבור זרימת עבודה מסוימת. אתה מגדיר אילו כלים זמינים, איך הבינה המלאכותית מתקשרת עם בסיס הקוד שלך, ואיזה תפקיד היא צריכה למלא — מבלי לשנות את ההוראות המותאמות שלך.

לקידוד ויב, זה שימושי במיוחד להפרדת שלב התכנון משלב הבנייה . מצב תכנון יכול להגביל את GitHub Copilot לניתוח קריאה בלבד, כך שהוא מציע עיצובים ללא שינויים, בעוד שמצב יישום פותח כלי עריכה מלאים.

צור מצב צ'אט מותאם אישית

אחסן קבצי מצב צ'אט מותאמים בתיקייה .github/chatmodes/ שבסביבת העבודה שלך.

מבנה הקובץ:

---
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.

הגדרות נפוצות של מצב צ'אט לקידוד וייב:

מצב כלים מקרה שימוש
תכנון אין (לקריאה בלבד) החלטות ארכיטקטורה, עיצוב תכונות, סקירת PRD
מחקר חיפוש באינטרנט חקירת ספריות, השוואת גישות
הטמעה גישה מלאה לכלים כתיבה ועריכת קוד, הרצת פקודות
סקור לקריאה בלבד בדיקת קוד, בדיקת אבטחה, בדיקת ביצועים

השתמש במצב צ'אט מותאם אישית

בחר את המצב מתוך בחירת מצבי הצ'אט בסרגל הכלים של תצוגת הצ'אט. המצב נשאר לאורך הסשן עד שאתה מחליף.

Summary

התאמת תגובות GitHub Copilot מאפשרת לך לעצב את הסיוע ב-AI כך שיתאים לתהליך העבודה הספציפי שלך. הוראות מותאמות אישית — באמצעות קבצי .github/copilot-instructions.md, קבצי .instructions.md, או הגדרות Visual Studio Code — מגדירות איך GitHub Copilot אמורות להגיב, ולקודד את שיטות הקידוד שלך, הסטנדרטים וההעדפות שלך. קבצי ההנחיה מגדירים מה צריך לעשות עבור משימות חוזרות, ונותנים לך פקודות רב-פעמיות שתוכל להריץ לפי דרישה. מצבי צ'אט מותאמים אישית מגדירים את אופן פעולת סשן הצ'אט, ומאפשרים לך לעבור בין תכנון, מחקר, יישום וסקירה של תהליכי עבודה מבלי לשנות את ההוראות הבסיסיות שלך. ביחד, שלושת הכלים האלה עוזרים לך לבנות סביבת קידוד עקבית שבה GitHub Copilot מבין את הפרויקט שלך מההתחלה.