wiki-page-writer

Wiki Page Writer — workflow Microsoft для подготовки подробных технических страниц с доказательной глубиной, Mermaid-диаграммами и citations на исходный код. Его задача — объяснить конкретный компонент, систему или feature от причин к реализации, а не заполнить wiki общими формулировками. Поэтому перед написанием сначала определяется область документации, аудитория и бюджет по объёму, а затем собирается фактический контекст исходного репозитория. Первый обязательный шаг — разрешить источник кода. Нужно проверить git remote origin, получить или подтвердить URL репозитория, определить default branch и не продолжать, пока не ясно, будут ли citations ссылаться на удалённый репозиторий или на локальные пути. При remote-источнике ссылки должны указывать на конкретный файл и строки в ветке; для local-only допускаются локальные citations с путём и строкой. Это ограничивает риск приписать системе поведение только по имени файла или заменить отсутствующие доказательства предположением. Анализ должен проходить по реальным code paths: читаются связанные файлы, функции, классы, алгоритмы, зависимости и поток данных. Каждый нетривиальный тезис получает источник, а факт из кода отделяется от inference. Если доказательства не найдены, источник предписывает явно оставить пометку Unknown с путём для проверки. После анализа страница строится в порядке Overview, Architecture, Components, Data Flow, Implementation, References и Related Pages; крупные разделы начинают с summary table, а структурированные сведения помещаются в таблицы с отдельной колонкой Source. Для VitePress-совместимой страницы требуется frontmatter с title и однострочным description. Для диаграмм skill задаёт масштаб 3–5 Mermaid-блоков по сложности, минимум два разных типа, dark-mode цвета узлов и линий, а для sequenceDiagram — autonumber. Сразу после каждого блока помещается комментарий с источниками; нельзя использовать <br/>. Диаграммы должны показывать структуру, поведение, состояние или поток данных, который подтверждён прочитанным кодом, а не декоративно увеличивать объём страницы. Кросс-ссылки ведут на связанные wiki pages относительными Markdown-путями и по возможности двунаправленно. В Related Pages перечисляются связи с соседними страницами; для компонентов, API и конфигураций таблица содержит linked citation. Вне code fences нужно экранировать generic-типы, Mermaid должен оставаться совместимым с VitePress, а итоговая проверка должна подтвердить существование путей, корректность имён и рендеримость диаграмм. Ограничение навыка принципиальное: он не позволяет честно написать доказательную wiki без разрешённого контекста репозитория, прочитанных реализаций и проверяемых строк. Он не заменяет code review, тестирование или аудит безопасности, не разрешает выдумывать компоненты при отсутствии исходников и не делает ссылку на внешний репозиторий доказательством сама по себе. Результат нужно валидировать против фактической ветки и поддерживать при изменении кода.