Перейти к основному содержимому

Как работает наша автоматизация

Продвинутый

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

Шлюз сборки (активен)​

Каждое изменение собирается с onBrokenLinks: 'throw', поэтому мёртвая внутренняя ссылка или сломанный MDX приводят к падению сборки до слияния. Это самая ценная проверка — она обеспечивает доверие к навигации.

Рабочие процессы CI​

Файлы рабочих процессов находятся в ветке ci-workflows и активируются, как только у репозитория появляется токен с областью workflow (см. README). До этого момента сайт разворачивается из ветки gh-pages.

  • build-check — собирает каждый PR (сломанные ссылки приводят к падению). Обязательная проверка.
  • deploy — собирает и публикует на GitHub Pages при пуше в main.
  • link-check — lychee запускается еженедельно и на PR; при сломанных внешних ссылках он открывает отслеживающую задачу (метка link-rot), а не просто становится красным.

Автоматизация свежести (запланирована / поэтапно)​

  • Наблюдатель за релизами — задача по расписанию, которая опрашивает документацию/журнал изменений Anthropic и наиболее быстро меняющиеся пользовательские поверхности (приложения, голос, мобильные устройства, маркетплейс). При изменении он открывает задачу/PR с метками upstream-change + needs-verification, указывающую на вероятно затронутые страницы. Обновление пишет человек.
  • Верификатор таблицы моделей — сравнивает data/models.json с официальным списком моделей и открывает PR, когда что-то расходится. Таблица моделей показывает дату "последней проверки".
  • Проход по устаревшему контенту — отмечает изменчивые страницы, у которых lastVerified старше порогового значения.

Почему "человек в контуре"​

:::tip Автоматизировано и честно > автоматизировано и неверно ИИ, который автоматически коммитит "новости" на справочный сайт, рискует публиковать галлюцинации — противоположность надёжности. Поэтому наша автоматизация предлагает (задачи/PR); люди проверяют и сливают. См. Проверку фактов. :::

Хотите помочь с автоматизацией?​

Улучшение этих рабочих процессов — отличный продвинутый вклад — смотрите .github/workflows (в ветке ci-workflows) и Внести вклад.

Далее​