DiscourseSkill.md

Разработка
1

Перенос работы из Require LLM-generated themes & plugins to be tagged as such

Мы сделали первый вариант создания файла DiscourseSkill.md

читать: DiscourseSkill.md

использовать: DiscourseSkill.json

4

На чём основывалось ваше решение при создании этого? Прямо в начале указано, что это предназначено для плагинов, тем и компонентов тем.

Но у меня сложилось впечатление, что область ревью не соответствует структуре тем. Почему javascripts/ включается только в том случае, если находится в папке assets? Почему вы ограничиваете использование settings.yml только папкой config? Обычно в темах таких папок нет.

Ирония в том, что мы обсуждаем, как сгенерированный ИИ контент может не соответствовать требованиям к качеству, а предложенное решение само по себе не вызывает большего доверия.

5

На этот крайне спорный вопрос — и учитывая, что разумно предположить, что ИИ представляет значительные риски для наших когнитивных способностей, приватности и безопасности…

Я просто хочу сказать, что я благодарен за этот инструмент, потому что он указал на ошибки в плагинах, которые я создавал с помощью LLM, и которые я не смог бы найти самостоятельно.

Именно об этом я и писал в комментарии к теме, из которой выросла эта. У меня не было технических знаний, чтобы ставить под сомнение сами результаты, а скорее их практическое применение.

К сожалению, человечество в целом сейчас не всегда использует навыки критического мышления при анализе действий или ответов, а действует на эмоциях — неосознанно, в совершенно бессознательной манере.

Это приводит нас к неверным предрассудкам о валидности или ценности чего-либо, что, если смотреть на это объективно, на самом деле улучшает данную ситуацию. Я понимаю, что это естественное явление, которое меняется, и не что-то личное.

Просто чтобы выразить свою скромную поддержку автору темы за этот инструмент.

6

Согласен. Как я уже говорил, это была первая версия, и теперь она улучшена благодаря вашей обратной связи. Мы посмотрели ещё раз, и вы оказались правы.

Добавлено в метод ревью

  • Классификация кандидата до проверки файлов:

    • Плагин
    • Тема
    • Компонент темы
    • Гибридное расширение
    • Репозиторий интеграции
    • Артефакт релиза

  • Отдельный инвентарь общего репозитория/релиза:

    • README, лицензия, журнал изменений
    • Файлы пакетов и файлы блокировок
    • Воркфлоу CI
    • Скрипты установки/Docker
    • Интеграции с внешними сервисами
    • Сгенерированные ассеты релиза
    • Отмеченные/архивные релизы
    • Соответствующие неотслеживаемые и игнорируемые файлы

  • Расширенный инвентарь плагина:

    • Каждый файл, загружаемый, регистрируемый или экспонируемый plugin.rb
    • config/routes.rb
    • db/post_migrate/
    • Представления, движки, валидаторы и middleware
    • Код административного и публичного фронтенда
    • Коннекторы, компоненты, маршруты, сервисы, шаблоны и тесты фронтенда
    • Общие, десктопные, мобильные, административные и встроенные стили
    • Фикстуры, вспомогательные файлы и браузерные/системные тесты
    • Зависимости Ruby, JavaScript, системные и зависимости от внешних сервисов
    • .discourse-compatibility
    • Ветки и воркфлоу d-compat/*
    • Заданные границы версий Discourse

  • Новый инвентарь темы/компонента темы:

    • Корневой about.json
    • Классификация component
    • Метаданные лицензии, автора, версии и совместимости
    • Заданные ассеты, цветовые схемы, скриншоты и настраиваемые параметры темы
    • Корневой settings.yml
    • Корневой locales/
    • common/, desktop/ и mobile/
    • Файлы SCSS и поддерживаемые файлы инъекции HTML
    • Корневой javascripts/
    • api-initializers/
    • Все файлы .js, .gjs и .hbs
    • Корневой stylesheets/ и импортируемые таблицы стилей
    • Корневой assets/ и все ссылки на них
    • Предпросмотр/скриншоты
    • Тесты и конфигурация линтера/сборки
    • Метаданные совместимости и ветки
    • Упакованные/экспортированные байты темы

  • Новые структурные проверки:

    • Заданный тип расширения должен соответствовать about.json и поведению при установке.
    • component: true означает компонент темы.
    • component: false или отсутствие поля означает полноценную тему.
    • Гибридные репозитории получают все применимые инвентари.
    • Неправильно размещённые или неожиданные файлы исследуются, а не игнорируются молча.
    • Отсутствие необязательных каталогов не является автоматически дефектом.
    • Рабочее дерево, архив релиза, установленное расширение, сгенерированные ассеты и публичный кандидат — это отдельные поверхности доказательств.

  • Новый чек-лист для полноценной темы:

    • Идентичность метаданных
    • Рендеринг полной темы
    • Покрытие основных страниц
    • Настройки, локали и ассеты
    • Поддерживаемые инициализаторы JavaScript/API
    • Адаптивное поведение, доступность и RTL
    • Поведение Foundation, Horizon и встроенных элементов
    • Взаимодействия с компонентами темы
    • Проверки установки, обновления, отката и совместимости

Я надеюсь, что вклад сообщества поможет улучшить Skill, а сам Skill поможет другим оценивать свою работу или, откровенно говоря, работу других до установки, если есть сомнения в качестве.

Пока что у нас 2 из 2. Ваш вклад привёл к улучшениям Skill, и @satonotdead нашёл его полезным. Спасибо за добрые слова и поддержку, @satonotdead