| name | 1c-docs |
| description | Этот скилл следует использовать, когда пользователь просит "создать документацию 1C", "задокументировать код 1C", "написать документацию", "сгенерировать документацию для AI", "создать пользовательское руководство" или нуждается в генерации технической или пользовательской документации для кода 1C |
Обзор
Автономный скилл для генерации документации кода 1C. Работает независимо от основного воркфлоу 1c-feature-dev — можно запустить на любом модуле, объекте метаданных или доработке.
Типы документации
- Техническая (для AI/нейросетей) — структурированная документация: архитектурные решения, потоки данных, API-контракты, ответственности модулей
- Пользовательская — руководства для конечных пользователей: пошаговые инструкции, описание интерфейса, сценарии
Процесс
Шаг 1: Определение конфигурации
- Прочитай
CLAUDE.md целевого проекта (корень проекта)
- Найди секцию
## Documentation (или ## Документация)
- Извлеки параметры:
documentation-types — какие типы генерировать (по умолчанию: [technical, user])documentation-technical-path — путь для технической документации (по умолчанию: docs/technical/)documentation-user-path — путь для пользовательской документации (по умолчанию: docs/user/)
- Если секция отсутствует — спроси пользователя напрямую:
- «Какие типы документации нужны: техническая (для AI), пользовательская или обе?»
- «Куда сохранить техническую документацию? (по умолчанию:
docs/technical/)»
- «Куда сохранить пользовательскую документацию? (по умолчанию:
docs/user/)»
Шаг 2: Определение области документирования
Начальный запрос: $ARGUMENTS
- Если пользователь указал конкретные файлы/модули/объекты — используй их
- Если указана задача из
.tasks/ — прочитай её артефакты (01-requirements.md через 07-summary.md)
- Если запрос общий («задокументируй модуль X») — уточни:
- Какой объект метаданных или модуль
- Нужна документация на всё или на конкретные процедуры
- Есть ли контекст (зачем, для кого)
Шаг 3: Исследование кода
- Запусти агента
1c-code-explorer с фокусом на область документирования
- Передай: список файлов/модулей для анализа
- Фокус: структура, API, зависимости, потоки данных
- Прочитай ключевые файлы, возвращённые агентом
Шаг 4: Генерация документации
- Запусти агента
1c-code-documenter:
- Передай: результаты исследования, список файлов, тип(ы) документации, пути для сохранения
- Если нужны оба типа — агент генерирует оба в одном запуске
- Проверь результат: файлы созданы, содержание соответствует области
Шаг 5: Валидация и сохранение
- Представь сгенерированную документацию пользователю
- Спроси: «Документация готова. Нужны ли правки?»
- При необходимости — запусти агента повторно с уточнениями
- Подтверди сохранение файлов:
- Техническая:
{documentation-technical-path}/{имя}.md
- Пользовательская:
{documentation-user-path}/{имя}.md
