Документация с двуязычной синхронизацией

★ 7.0 · documentation

Написание и обновление документации — это скилл для Claude Code, который управляет системой документирования проекта clice: структурой страниц, контрактом синхронизации английских и китайских переводов и pixi-командами для автоматической генерации и проверки. Берут, когда нужно отредактировать страницы в docs/ не сломав сгенерированные регионы, когда zh-страница разъехалась с en-оригиналом и check-doc-translations падает, когда после изменения фикстур или схемы конфига нужно обновить документацию командой pixi, или когда надо подготовить машинный черновик перевода через DeepSeek API. Скилл описывает разметку дерева docs/en/ и docs/zh/, правила сегментной изоморфности (одинаковая структура блоков, идентичные code-блоки и HTML-комментарии в обоих деревьях), формат метаданных в docs/meta/translations/ и полный цикл работы: edit → report → update → format → record → commit. Ключевые команды: pixi run update-feature-docs, check-doc-translations, report-doc-translations, record-doc-translations, review-doc-translations. Направление — редактирование и синхронизация документации, а не генерация кода или написание тестов (для этого — скилл write-tests). Подойдёт для работы с репозиторием clice, где docs/ ведётся по этому контракту; не подходит как универсальное руководство по документированию произвольных проектов.