MiMoCode
99 lines
4.6 KiB
Markdown
99 lines
4.6 KiB
Markdown
# 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)
|