Словами самого skill
Превращает существующий продукт в письменный дизайн-контракт. В режиме репозитория он анализирует токены, темы, общие примитивы и отрендеренные маршруты локального продукта и записывает DESIGN.md в корне этого продукта; в режиме URL он восстанавливает черновик из DOM, вычисленных стилей и загруженных таблиц стилей на десктопной и мобильной ширине.
Оба режима используют один конвейер сбора доказательств — роль, значение, источник, охват, повторяемость, уверенность — и одну плоскую схему токенов, с целями экспорта css-tailwind, json-tailwind или dtcg. Значения сохраняются только если их называет управляющий источник или они проходят проверку по трём доказательствам, а документ не выпускается, пока не пройдут линтинг и экспорт. Это меняет только DESIGN.md, ничего больше.
Что он выдаёт
- Восстановленный черновик DESIGN.md, записанный в текущее рабочее пространство в режиме URL, помеченный как черновик.
- Отчёт с указанием режима и проверенного продукта или URL, использованных управляющих источников, а также конфликтов или неподтверждённых областей, исключённых из документа.
- Итоговые результаты линтинга и экспорта, которые оба должны пройти успешно, прежде чем документ будет возвращён.
Как это работает
- 01Выбор режима
Режим репозитория — когда доступен локальный репозиторий продукта, с записью DESIGN.md в его корне; режим URL — когда указан только публичный URL, с созданием восстановленного черновика в текущем рабочем пространстве.
- 02Сбор доказательств и фиксация происхождения
Каждый кандидат фиксируется с указанием источника, охвата и повторяемости до какой-либо нормализации, поэтому оба режима питают один и тот же конвейер записи.
- 03Нормализация в схему DESIGN.md
Кандидаты, которые неопределённы, локальны без контракта или не относятся к реализации, отбрасываются; остальные отображаются в каноническую плоскую схему токенов.
- 04Черновик пропускается только через валидацию
Markdown записывается только после того, как разобранный frontmatter пройдёт проверку структуры, поэтому текст никогда не пишется первым и подгоняется к YAML задним числом.
- 05Линтинг и экспорт
Сначала выполняется структурный линтинг, затем один экспорт совместимости в выбранную цель, и каждая заполненная категория должна появиться в выходных данных.
- 06Отчёт о режиме, источниках и пробелах
Отчёт называет режим и проверенный продукт или URL, использованные управляющие источники, всё исключённое как неподтверждённое, а также результаты линтинга и экспорта.