# MiMoCode 1C Skills

Набор навыков для MiMoCode-агента, помогающий работать с расширениями 1С:Предприятие 8.3. Адаптирован из [cc-1c-skills](https://github.com/Nikolay-Shirokov/cc-1c-skills) (MIT) с добавлением специфических знаний по проекту.

## Источники формирования знаний

### Основные
- **cc-1c-skills** (github.com/Nikolay-Shirokov/cc-1c-skills) — 72 навыка для AI-агентов 1С-разработки. Python-скрипты для Linux, PowerShell для Windows
- **1С:Предприятие 8.3** — платформа, XML-форматы выгрузки, управляемые формы
- **EDT-выгрузка ЗГУ** — /netfolder-51/CMSCH/8ZikBudg-CMSCH/ — референс конфигурации ЗарплатаИКадрыГосударственногоУчреждения

### Практические знания (из проекта)
- XML-формат расширений 1С: namespace, InternalInfo, TabularSection, Form.xml
- Ограничения расширений: только простые типы (Number, xs:string) для атрибутов DataProcessor
- Заимствование справочников через cfe-borrow → доступ к CatalogRef в расширениях
- ibcmd через Docker: обход проблем с кириллическими путями
- Сборка .cfe: ibcmd config import/export/save через Docker
- Уникальные UUID: всегда uuid.uuid4(), никогда захардкоженные

### Кодировка кириллицы в BSL
3 надёжных способа:
1. `write` tool → `scp` (самый надёжный)
2. `perl -CSD -pi -e` на сервере
3. Bytes-операции в Python (`open(file, 'rb')`)
НЕЛЬЗЯ: Python `\uXXXX` escapes для BSL

## Структура репозитория

```
.claude/skills/        # Навыки cc-1c-skills (оригинал)
├── cfe-validate/      # Валидация расширения
├── cfe-build/         # Сборка .cfe
├── form-info/         # Анализ Form.xml
├── meta-compile/      # Генерация метаданных из JSON
├── db-create/         # Создание базы данных
├── db-run/            # Запуск 1С
├── cfe-borrow/        # Заимствование объектов
└── ...                # 16+ навыков

.mimocode/skills/      # Адаптированные под MiMoCode
├── cfe-validate/
├── cfe-build/
├── form-info/
├── meta-compile/
├── db-create/
├── db-run/
├── cfe-borrow/
└── 1c-dev-reference/  # Сборник знаний по проекту
```

## Установка

```bash
# Копирование в проект
cp -r .claude/skills/ /path/to/project/.claude/skills/
cp -r .mimocode/skills/ /path/to/project/.mimocode/skills/

# Или клонирование репозитория
git clone https://gitea/.../mimocode-1c-skills.git tools/mimocode-1c-skills
cp -r tools/mimocode-1c-skills/.claude/skills/ .claude/skills/
cp -r tools/mimocode-1c-skills/.mimocode/skills/ .mimocode/skills/
```

## Использование

### Через skill tool
```
/skill cfe-validate
/skill form-info
/skill cfe-build
```

### Через bash
```bash
python3 .claude/skills/cfe-validate/scripts/cfe-validate.py -ExtensionPath /path/to/extension -Detailed
```

## Навыки

| Навык | Назначение | Скрипт |
|-------|-----------|--------|
| cfe-validate | Валидация расширения перед сборкой | Python |
| cfe-build | Сборка .cfe, git push | Python |
| cfe-borrow | Заимствование объектов из конфигурации | Python |
| cfe-diff | Сравнение версий расширения | Python |
| cfe-patch-method | Перехват методов | Python |
| form-info | Анализ структуры Form.xml | Python |
| form-edit | Добавление элементов в форму | Python |
| form-validate | Валидация формы | Python |
| meta-compile | Создание метаданных из JSON | Python |
| meta-info | Анализ объекта метаданных | Python |
| db-create | Создание информационной базы | Python |
| db-run | Запуск 1С | Python |
| 1c-dev-reference | Сборник знаний по 1С-разработке | MD |

## Лицензия

MIT (наследуется от cc-1c-skills)