{"meta":{"title":"Настраиваемые навыки","intro":"Навыки — это многоразовые модули подсказок, расширяющие возможности Copilot. Загружайте навыки из каталогов, чтобы дать Copilot специализированные способности для конкретных областей или рабочих процессов.","product":"GitHub Copilot","breadcrumbs":[{"href":"/ru/enterprise-cloud@latest/copilot","title":"GitHub Copilot"},{"href":"/ru/enterprise-cloud@latest/copilot/how-tos","title":"Инструкции"},{"href":"/ru/enterprise-cloud@latest/copilot/how-tos/copilot-sdk","title":"Второй пилот SDK"},{"href":"/ru/enterprise-cloud@latest/copilot/how-tos/copilot-sdk/features","title":"Возможности"},{"href":"/ru/enterprise-cloud@latest/copilot/how-tos/copilot-sdk/features/skills","title":"Skills"}],"documentType":"article"},"body":"# Настраиваемые навыки\n\nНавыки — это многоразовые модули подсказок, расширяющие возможности Copilot. Загружайте навыки из каталогов, чтобы дать Copilot специализированные способности для конкретных областей или рабочих процессов.\n\n\n\n\n\n## Обзор\n\nНавык — это именованный каталог, содержащий файл `SKILL.md` — документ markdown, который предоставляет инструкции Copilot. При загрузке содержимое навыка вводится в контекст сессии.\n\nНавыки позволяют вам:\n\n* Экспертиза в области упаковки в повторно используемые модули\n* Делитесь специализированными поведением между проектами\n* Организовывать сложные конфигурации агентов\n* Включать/отключать возможности за сессию\n\n## Навыки загрузки\n\nПри создании сессии указывайте каталоги, содержащие навыки:\n\n
\n
TypeScript
\n\n```typescript\nimport { CopilotClient } from \"@github/copilot-sdk\";\n\nconst client = new CopilotClient();\nconst session = await client.createSession({\n model: \"gpt-5.4\",\n skillDirectories: [\n \"./skills/code-review\",\n \"./skills/documentation\",\n ],\n onPermissionRequest: async () => ({ kind: \"approve-once\" }),\n});\n\n// Copilot now has access to skills in those directories\nawait session.sendAndWait({ prompt: \"Review this code for security issues\" });\n```\n\n
\n\n
Python
\n\n```python\nfrom copilot import CopilotClient, PermissionDecisionApproveOnce\n\nasync def main():\n client = CopilotClient()\n await client.start()\n\n session = await client.create_session(\n on_permission_request=lambda req, inv: PermissionDecisionApproveOnce(),\n model=\"gpt-5.4\",\n skill_directories=[\n \"./skills/code-review\",\n \"./skills/documentation\",\n ],\n )\n\n # Copilot now has access to skills in those directories\n await session.send_and_wait(\"Review this code for security issues\")\n\n await client.stop()\n```\n\n
\n\n
Go
\n\n```golang\npackage main\n\nimport (\n \"context\"\n \"log\"\n copilot \"github.com/github/copilot-sdk/go\"\n \"github.com/github/copilot-sdk/go/rpc\"\n)\n\nfunc main() {\n ctx := context.Background()\n client := copilot.NewClient(nil)\n if err := client.Start(ctx); err != nil {\n log.Fatal(err)\n }\n defer client.Stop()\n\n session, err := client.CreateSession(ctx, &copilot.SessionConfig{\n Model: \"gpt-5.4\",\n SkillDirectories: []string{\n \"./skills/code-review\",\n \"./skills/documentation\",\n },\n OnPermissionRequest: func(req copilot.PermissionRequest, inv copilot.PermissionInvocation) (rpc.PermissionDecision, error) {\n return &rpc.PermissionDecisionApproveOnce{}, nil\n },\n })\n if err != nil {\n log.Fatal(err)\n }\n\n // Copilot now has access to skills in those directories\n _, err = session.SendAndWait(ctx, copilot.MessageOptions{\n Prompt: \"Review this code for security issues\",\n })\n if err != nil {\n log.Fatal(err)\n }\n}\n```\n\n
\n\n
.NET
\n\n```csharp\nusing GitHub.Copilot;\nusing GitHub.Copilot.Rpc;\n\nawait using var client = new CopilotClient();\nawait using var session = await client.CreateSessionAsync(new SessionConfig\n{\n Model = \"gpt-5.4\",\n SkillDirectories = new List\n {\n \"./skills/code-review\",\n \"./skills/documentation\",\n },\n OnPermissionRequest = (req, inv) =>\n Task.FromResult(PermissionDecision.ApproveOnce()),\n});\n\n// Copilot now has access to skills in those directories\nawait session.SendAndWaitAsync(new MessageOptions\n{\n Prompt = \"Review this code for security issues\"\n});\n```\n\n
\n\n
Java
\n\n```java\nimport com.github.copilot.CopilotClient;\nimport com.github.copilot.rpc.*;\nimport java.util.List;\n\ntry (var client = new CopilotClient()) {\n client.start().get();\n\n var session = client.createSession(\n new SessionConfig()\n .setModel(\"gpt-5.4\")\n .setSkillDirectories(List.of(\n \"./skills/code-review\",\n \"./skills/documentation\"\n ))\n .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)\n ).get();\n\n // Copilot now has access to skills in those directories\n session.sendAndWait(new MessageOptions()\n .setPrompt(\"Review this code for security issues\")\n ).get();\n}\n```\n\n
\n\n
\n\n## Навыки отключения\n\nОтключите определённые навыки, сохраняя активность других:\n\n
\n
TypeScript
\n\n```typescript\nconst session = await client.createSession({\n skillDirectories: [\"./skills\"],\n disabledSkills: [\"experimental-feature\", \"deprecated-tool\"],\n});\n```\n\n
\n\n
Python
\n\n```python\nfrom copilot.session import PermissionHandler\n\nsession = await client.create_session(\n on_permission_request=PermissionHandler.approve_all,\n skill_directories=[\"./skills\"],\n disabled_skills=[\"experimental-feature\", \"deprecated-tool\"],\n)\n```\n\n
\n\n
Go
\n\n```golang\nsession, _ := client.CreateSession(context.Background(), &copilot.SessionConfig{\n SkillDirectories: []string{\"./skills\"},\n DisabledSkills: []string{\"experimental-feature\", \"deprecated-tool\"},\n})\n```\n\n
\n\n
.NET
\n\n```csharp\nvar session = await client.CreateSessionAsync(new SessionConfig\n{\n SkillDirectories = new List { \"./skills\" },\n DisabledSkills = new List { \"experimental-feature\", \"deprecated-tool\" },\n});\n```\n\n
\n\n
Java
\n\n\n\n```java\nimport com.github.copilot.rpc.*;\nimport java.util.List;\n\nvar session = client.createSession(\n new SessionConfig()\n .setSkillDirectories(List.of(\"./skills\"))\n .setDisabledSkills(List.of(\"experimental-feature\", \"deprecated-tool\"))\n .setOnPermissionRequest(PermissionHandler.APPROVE_ALL)\n).get();\n```\n\n
\n\n
\n\n## Структура каталога навыков\n\nКаждый навык представляет собой именованный подкаталог, содержащий `SKILL.md` файл:\n\n```text\nskills/\n├── code-review/\n│ └── SKILL.md\n└── documentation/\n └── SKILL.md\n```\n\nОпция указывает `skillDirectories` на родительский каталог (например, `./skills`). CLI обнаруживает все `SKILL.md` файлы в немедленных подкаталогах.\n\n### формат SKILL.md\n\nФайл `SKILL.md` — это документ markdown с опциональной YAML-фронтматерью:\n\n```markdown\n---\nname: code-review\ndescription: Specialized code review capabilities\n---\n\n# Code Review Guidelines\n\nWhen reviewing code, always check for:\n\n1. **Security vulnerabilities** - SQL injection, XSS, etc.\n2. **Performance issues** - N+1 queries, memory leaks\n3. **Code style** - Consistent formatting, naming conventions\n4. **Test coverage** - Are critical paths tested?\n\nProvide specific line-number references and suggested fixes.\n```\n\nФронтматтерные поля:\n\n* **`name`**: Идентификатор навыка (используется для `disabledSkills` выборочного отключения). Если оно опущено, используется имя каталога.\n* **`description`**: Краткое описание того, что делает навык.\n\nТело markdown содержит инструкции, которые вводятся в контекст сессии при загрузке навыка.\n\n## Варианты конфигурации\n\n### Поля навыков SessionConfig\n\n| Язык | Поле | Тип | Description |\n| ------- | ------------------- | -------------- | ----------------------------- |\n| Node.js | `skillDirectories` | `string[]` | Каталоги для загрузки навыков |\n| Node.js | `disabledSkills` | `string[]` | Навыки для отключения |\n| Python | `skill_directories` | `list[str]` | Каталоги для загрузки навыков |\n| Python | `disabled_skills` | `list[str]` | Навыки для отключения |\n| Go | `SkillDirectories` | `[]string` | Каталоги для загрузки навыков |\n| Go | `DisabledSkills` | `[]string` | Навыки для отключения |\n| .NET | `SkillDirectories` | `List` | Каталоги для загрузки навыков |\n| .NET | `DisabledSkills` | `List` | Навыки для отключения |\n\n## Лучшие практики\n\n1. **Организовать по домену** — сгруппировать связанные навыки вместе (например, `skills/security/`, `skills/testing/`)\n\n2. **Используйте frontmatter** — включите `name``description` и включите в YAML frontmatter для ясности\n\n3. **Зависимости документов** — обратите внимание на любые инструменты или MCP-серверы, требуемые для навыка\n\n4. **Проверяйте навыки по отдельности** — проверяйте работу навыков перед их объединением\n\n5. **Используйте относительные пути** — Сохраняйте навыки в разных условиях\n\n## Объединение с другими особенностями\n\n### Навыки + кастомные агенты\n\nНавыки, `skills` указанные в поле агента, с энтузиазмом **заранее загружаются** — их полное содержание внедряется в контекст агента при запуске, так что агент получает доступ к инструкциям навыков без необходимости вызывать инструмент навыков. Названия навыков решаются на уровне `skillDirectories`сессии.\n\n```typescript\nconst session = await client.createSession({\n skillDirectories: [\"./skills/security\"],\n customAgents: [{\n name: \"security-auditor\",\n description: \"Security-focused code reviewer\",\n prompt: \"Focus on OWASP Top 10 vulnerabilities\",\n skills: [\"security-scan\", \"dependency-check\"],\n }],\n onPermissionRequest: async () => ({ kind: \"approve-once\" }),\n});\n```\n\n> \\[!NOTE]\n> Навыки — это опция по выбору — если `skills` их опускают, контент навыков не вводится. Субагенты не наследуют навыки от родителя; Вы должны указывать их явно для каждого агента.\n\n### Навыки + MCP-серверы\n\nНавыки могут дополнять возможности MCP-сервера:\n\n```typescript\nconst session = await client.createSession({\n skillDirectories: [\"./skills/database\"],\n mcpServers: {\n postgres: {\n type: \"local\",\n command: \"npx\",\n args: [\"-y\", \"@modelcontextprotocol/server-postgres\"],\n tools: [\"*\"],\n },\n },\n onPermissionRequest: async () => ({ kind: \"approve-once\" }),\n});\n```\n\n## Troubleshooting\n\n### Навыки не загружаются\n\n1. **Существует путь проверки** — убедитесь, что путь в каталоге навыков правильный и содержит подкаталоги с `SKILL.md` файлами\n2. **Проверьте права** — убедитесь, что SDK может читать каталог\n3. **Проверьте SKILL.md формат** — убедитесь, что markdown хорошо сформирован и любой YAML-фронтматтер использует корректный синтаксис\n4. **Включить отладочный лог** — настройте `logLevel: \"debug\"` на просмотр логов загрузки навыков\n\n### Конфликты навыков\n\nЕсли несколько навыков дают противоречивые инструкции:\n\n* Используйте `disabledSkills` для исключения конфликтующих навыков\n* Реорганизуйте каталоги навыков, чтобы избежать пересечений\n\n## См. также\n\n* [Создайте своё первое приложение на базе Copilot](/ru/enterprise-cloud@latest/copilot/how-tos/copilot-sdk/getting-started#create-custom-agents) — определите специализированные ИИ-персоны\n* [Создайте своё первое приложение на базе Copilot](/ru/enterprise-cloud@latest/copilot/how-tos/copilot-sdk/getting-started#step-4-add-a-custom-tool) — Создавайте свои собственные инструменты\n* [Использование MCP-серверов с SDK GitHub Copilot](/ru/enterprise-cloud@latest/copilot/how-tos/copilot-sdk/features/mcp) — Подключите внешних поставщиков инструментов"}