wiki-agents-md

wiki-agents-md — официальный навык Microsoft для подготовки AGENTS.md, то есть контекстных файлов, предназначенных не для читателя README, а для coding agent. Его задача — превратить устройство конкретной папки репозитория в короткий и проверяемый рабочий контекст: где лежит код, как его собирать и тестировать, какие соглашения соблюдать и какие границы нельзя пересекать. Навык рекомендует начинать с команды запуска и сборки, потому что это самая часто используемая часть такого файла. Перед записью команд нужно прочитать реальные package.json, Makefile, CI-конфигурации и другие manifests, а не придумывать npm-скрипты или предполагать структуру проекта. Сценарий применения начинается с проверки места назначения. Для каждой папки AGENTS.md должен быть создан только если такого файла ещё нет. Существующий файл нельзя перезаписывать: его нужно пропустить и явно сообщить путь. Это правило распространяется на корень, src, lib, app, tests, api, пакеты монорепозитория и каталоги с собственным build manifest. Одновременно навык исключает node_modules, .git, dist, build, out, target, vendor, виртуальные окружения, кэш и другой сгенерированный или сторонний код. Благодаря этому результат не превращается в массовую перегенерацию инструкций поверх ручного контекста. Полезный AGENTS.md собирается из шести подтверждаемых областей. В разделе Build & Run фиксируются точные команды с флагами; в Testing — используемый test runner, команды полного и выборочного запуска и ожидаемое состояние перед commit. Project Structure описывает действующие каталоги, точки входа и место для новых изменений. Code Style выводится из нескольких реальных исходников: стиль имён, порядок импортов, организацию модулей и обработку ошибок. Git Workflow добавляется только при наличии доказательств вроде commitlint, шаблонов pull request или CI-правил. Boundaries делятся на Always do, Ask first и Never do: это позволяет агенту понимать не только допустимое действие, но и момент, когда требуется решение человека. Навык не разрешает заполнять пропуски фантазией. Если в проекте нет отдельной технологии, инструмента или соглашения, соответствующий раздел не нужно выдумывать. Перед генерацией следует просканировать папку, прочитать конфигурацию и несколько исходных файлов, затем сопоставить описание с реальной архитектурой. Особенно важны ограничения на секреты, зависимости, миграции, CI/CD и публичные API: их следует формулировать только там, где проект действительно задаёт такие границы. Практический результат — локальный файл, который помогает агенту быстрее выбрать правильную команду и безопасный участок работы, не подменяя документацию проекта и не стирая существующие решения.