Files
mimocode-1c-skills/README.md
T

4.6 KiB
Raw Blame History

MiMoCode 1C Skills

Набор навыков для MiMoCode-агента, помогающий работать с расширениями 1С:Предприятие 8.3. Адаптирован из 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/  # Сборник знаний по проекту

Установка

# Копирование в проект
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

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)