К основному содержанию
правило официальный · GitHub

update-code-from-shorthand — правило для GitHub Copilot

Превращает псевдокод и краткие заметки между маркерами в готовый код. Помогает быстро развернуть черновую логику прямо внутри целевого файла.

Установить в GitHub Copilot · Вручную: положить файлы Все способы и платформы ↓
.github/instructions/update-code-from-shorthand.instructions.md
Открыть на GitHub

Что делает update-code-from-shorthand

Правило настраивает агента на разбор черновых заметок внутри исходного кода. Вы выделяете нужный участок комментариями с маркерами start-shorthand и end-shorthand, а внутри набрасываете логику на естественном языке или псевдокодом со стрелкой ()=>. Ассистент анализирует контекст файла и заменяет черновик на корректные функции и конструкции. После генерации маркеры автоматически удаляются.

Если в запросе указано обновить файл данных вроде JSON или XML с пометкой не трогать логику кода, модель фокусируется на форматировании и добавлении новых записей. Комментарии с пометками REMOVE COMMENT или NOTE заменяются готовым рабочим кодом.

Без префикса UPDATE CODE FROM SHORTHAND в самом начале пользовательского запроса правило не сработает. Ассистент просто проигнорирует эти инструкции, поэтому точная формулировка вызова обязательна.

Какие задачи решает

  • Развернуть псевдокод ()=> в рабочий синтаксис целевого языка
  • Удалить служебные маркеры редактирования и временные комментарии после генерации
  • Дополнить файлы JSON или XML новыми данными без изменения программной логики
  • Преобразовать черновые наброски в чистовой код внутри указанного файла

Примеры запросов агенту

  • UPDATE CODE FROM SHORTHAND #file:script.js: преобразуй наброски между маркерами в рабочий код.
  • UPDATE CODE FROM SHORTHAND #file:data.json: код не меняй, только дополни файл новыми записями по существующему формату.
  • UPDATE CODE FROM SHORTHAND #file:app.ts: замени пометки REMOVE COMMENT на реализацию функций.

Как установить update-code-from-shorthand

Вручную: положить файлы

.github/instructions/update-code-from-shorthand.instructions.md

Поле applyTo задаёт, к каким файлам применять

По шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать

Вопросы о update-code-from-shorthand

Как установить update-code-from-shorthand в GitHub Copilot?

Сохраните файл правила по пути .github/instructions/update-code-from-shorthand.instructions.md в корне своего репозитория.

Что делает правило update-code-from-shorthand?

Оно находит в файле блок между маркерами start-shorthand и end-shorthand, переписывает наброски и строки вида ()=> в чистый код и удаляет сами маркеры.

Почему правило не срабатывает при обычном запросе?

Инструкции активируются строго тогда, когда запрос начинается с фразы UPDATE CODE FROM SHORTHAND. Без неё агент проигнорирует логику разбора псевдокода.

Исходный текст

update-code-from-shorthand.instructions.md · MIT
---
description: "Shorthand code will be in the file provided from the prompt or raw data in the prompt, and will be used to update the code file when the prompt has the text `UPDATE CODE FROM SHORTHAND`."
applyTo: "**/${input:file}"
---

# Update Code from Shorthand

One or more files will be provided in the prompt. For each file in the prompt, look for the markers
`${openMarker}` and `${closeMarker}`.

All the content between the edit markers may include natural language and shorthand; convert it into
valid code appropriate for the target file type and its extension.

## Role

Expert 10x software engineer. Great at problem solving and generating creative solutions when given
shorthand instructions, similar to brainstorming. The shorthand is like a hand-drawn sketch a client
gives an architect. You extract the big picture and apply expert judgment to produce a complete,
high-quality implementation.

## Rules for Updating Code File from Shorthand

- The text `${openPrompt}` at the very start of the prompt.
- The `${REQUIRED_FILE}` following the `${openPrompt}`.
- Edit markers in the code file or prompt - like:

```text
 ${openMarker} 
 ()=> shorthand code 
 ${closeMarker}
```

- Use the shorthand to edit, or sometimes essentially create the contents of a code file.
- If any comment has the text `REMOVE COMMENT`, `NOTE`, or similar within the comment, that
**comment** is to be removed; and in all probability that line will need the correct syntax,
function, method, or blocks of code.
- If any text, following the file name implies `no need to edit code`, then in all probability this
is to update a data file i.e. `JSON` or `XML` and means the edits should be focused on formatting
the data.
- If any text, following the file name implies `no need to edit code` and `add data`, then in all
probability this is to update a data file i.e. `JSON` or `XML` and means the edits should be focused
on formatting and adding additional data matching the existing format of the data file.

### When to Apply Instructions and Rules

- This is only relevant when the text `${openPrompt}` is at the start of the prompt.
  - If the text `${openPrompt}` is not at the start of the prompt, discard these instructions for
  that prompt.
- The `${REQUIRED_FILE}` will have two markers:
  1. Opening `${openMarker}`
  2. Closing `${closeMarker}`
  - Call these `edit markers`.
- The content between the edit markers determines what to update in the `${REQUIRED_FILE}` or other
referenced files.
- After applying the updates, remove the `${openMarker}` and `${closeMarker}` lines from the
affected file(s).

#### Prompt Back Following Rules

```bash
[user]
> Edit the code file ${REQUIRED_FILE}.
[agent]
> Did you mean to prepend the prompt with "${openPrompt}"?
[user]
> ${openMarker} - edit the code file ${REQUIRED_FILE}.
```

## Remember to

- Remove all occurrences of the openMarker or `${language:comment} start-shorthand`.
  - e.g. `// start-shorthand`.
- Remove all occurrences of the closeMarker or `${language:comment} end-shorthand`.
  - e.g. `// end-shorthand`.

## Shorthand Key

- **`()=>`** = 90% comment and 10% pseudo code blocks of mixed languages.
  - When lines have `()=>` as the starting set of characters, use your **role** to determine a
solution for the goal.

## Variables

- REQUIRED_FILE = `${input:file}`;
- openPrompt = "UPDATE CODE FROM SHORTHAND";
- language:comment = "Single or multi-line comment of programming language.";
- openMarker = "${language:comment} start-shorthand";
- closeMarker = "${language:comment} end-shorthand";

## Use Example

### Prompt Input

```bash
[user prompt]
UPDATE CODE FROM SHORTHAND 
#file:script.js 
Use #file:index.html:94-99 to see where converted
markdown to html will be parsed `id="a"`.
```

### Code File

```js
// script.js
// Parse markdown file, applying HTML to render output.

var file = "file.md";
var xhttp = new XMLHttpRequest();
xhttp.onreadystatechange = function() {
 if (this.readyState == 4 && this.status == 200) {
  let data = this.responseText;
  let a = document.getElementById("a");
  let output = "";
  // start-shorthand
  ()=> let apply_html_to_parsed_markdown = (md) => {
   ()=> md.forEach(line => {
    // Depending on line data use a regex to insert html so markdown is converted to html
    ()=> output += line.replace(/^(regex to add html elements from markdonw line)(.*)$/g, $1$1);
   });
   // Output the converted file from markdown to html.
   return output;
  };
  ()=>a.innerHTML = apply_html_to_parsed_markdown(data);
  // end-shorthand
 }
};
xhttp.open("GET", file, true);
xhttp.send();
```

© github · MIT · github/awesome-copilot

Похожие правила IDE

Все правила IDE по теме «Настройка агента: память, контекст, субагенты» →

Из того же набора928

Весь набор →
vue Правило задаёт Copilot стандарты Vue 3: Composition API, <script setup>, реактивность, Pinia и Vue Router. Пригодится, когда агент пишет компоненты в вашем стиле. ★ 40 451звёзд репо vsixtoolkit Направляет GitHub Copilot при создании расширений VSIX через библиотеку Community.VisualStudio.Toolkit. Задаёт совместимость с .NET Framework 4.8 и правила потоков. ★ 40 451звёзд репо use-cliche-data-in-docs Правило помогает писать документацию и примеры с вымышленными данными вместо значений из конфигов, скриптов и запросов. Пригодится при создании и правке документации. ★ 40 451звёзд репо update-docs-on-code-change Правило для GitHub Copilot, которое напоминает обновлять README.md и документацию, когда меняется код. Пригодится, если доки у вас отстают от реальности. ★ 40 451звёзд репо typespec-m365-copilot Правило подсказывает, как описывать агентов и API-плагины Microsoft 365 Copilot на TypeSpec. Срабатывает при работе с файлами .tsp. ★ 40 451звёзд репо typescript-mcp-server Правило подсказывает Copilot, как писать MCP-серверы на TypeScript SDK: классы, схемы на zod, транспорты и типовые ошибки. ★ 40 451звёзд репо terraform Набор инструкций для GitHub Copilot, который задаёт стандарты написания манифестов **/*.tf. Он следит за безопасностью секретов, структурой модулей и форматированием кода. ★ 40 451звёзд репо terraform-sap-btp Правило задаёт рекомендации для Terraform-кода в SAP BTP: от структуры модулей до управления состоянием. Пригодится при создании и проверке инфраструктурных конфигураций. ★ 40 451звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой