Фиксация промежуточных результатов
Превращать рабочий текст, включая результат LLM или AI-агента, из временного ответа в сохранённый Markdown-артефакт: выбрать понятные имя и место файла, сохранить результат, открыть файл заново и убедиться, что ожидаемый результат доступен из него. Структурировать текст заголовками, списками, ссылками, таблицами и блоками кода так, чтобы файл одинаково читался человеком и агентом.
Этот навык подтверждает, что результат зафиксирован в файле и структурно читаем. Проверка истинности, качества и соответствия критериям приёмки относится к HS-AI-005-VERIFY.
Тренажёр навыка
Понять.
Сделать.
Подтвердить.
Что нужно уметь
Превращать рабочий текст, включая результат LLM или AI-агента, из временного ответа в сохранённый Markdown-артефакт: выбрать понятные имя и место файла, сохранить результат, открыть файл заново и убедиться, что ожидаемый результат доступен из него. Структурировать текст заголовками, списками, ссылками, таблицами и блоками кода так, чтобы файл одинаково читался человеком и агентом.
Этот навык подтверждает, что результат зафиксирован в файле и структурно читаем. Проверка истинности, качества и соответствия критериям приёмки относится к HS-AI-005-VERIFY.
Составляющие навыка
- Размещение — выбрать понятные имя и место Markdown-файла.
- Фиксация — перенести рабочий текст из временного ответа в сохранённый артефакт.
- Структурирование — использовать заголовки, списки, ссылки, таблицы и блоки кода по назначению.
- Повторное открытие — убедиться, что ожидаемый результат доступен и читаем из файла.
- Передача контекста — дать человеку или новой сессии агента извлечь из файла нужные сведения без обращения к исходному чату.
Как закрепить
Что понадобится: доступ к обычному текстовому файлу и редактору.
Получить от LLM неструктурированный результат с решением, ограничениями и таблицей данных. Сохранить его в осмысленно названный .md-файл, открыть файл заново и убедиться, что ожидаемые разделы доступны из него. Затем попросить новую сессию агента извлечь из файла конкретное решение, ограничение и значение из таблицы.
Как проверить перенос
Получить сырой ответ LLM со связанным текстом, списком, ссылкой и таблицей. Без готового шаблона сохранить его как Markdown-артефакт и открыть файл заново. Другой человек и новая сессия агента должны найти файл и одинаково восстановить из него структуру и ключевые элементы результата.
Результат, а не ощущение
Evidence
освоения
- сохранённый в понятном месте осмысленно названный
.md-файл; - подтверждение повторного открытия сохранённого файла;
- осмысленная иерархия заголовков;
- корректные списки, ссылки или таблицы;
- отсутствие декоративной разметки, мешающей смыслу;
- одинаковое извлечение ключевых элементов другим человеком и новой сессией агента.
Антипаттерны
Типовые ошибки
- считать ответ в чате сохранённым рабочим артефактом;
- поверить сообщению агента о записи файла, не открыв сохранённый результат;
- перепутать наличие результата в файле с проверкой его правильности;
- использование внешнего вида вместо смысловой иерархии заголовков;
- пропущенные или незакрытые маркеры блоков кода;
- ручные пробелы и переносы вместо списков, таблиц и явных секций;
- слишком широкая таблица, которую трудно читать и изменять;
- декоративная разметка, скрывающая решения, ограничения и источники.