mirror of
https://github.com/Nikolay-Shirokov/cc-1c-skills.git
synced 2026-09-15 22:35:23 +03:00
Nick ShirokovandClaude Opus 4.8
717f3d8cc5
Раздел разросся; ужал до сути (черновик, не обратим, теряет молча). Исправлен устаревший факт: CommandInterface и ConditionalAppearance (без scope) теперь поддерживаются (эмитятся), не валят скрипт. Падение — только CA со scope / design-time диаграммы-планировщики / неизвестный элемент / не-Form root. Убраны детали реализации (disable-model-invocation — во фронтматтере) и нишевый абзац про GroupList. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
49 lines
3.1 KiB
Markdown
49 lines
3.1 KiB
Markdown
---
|
|
name: form-decompile
|
|
description: Декомпиляция управляемой формы 1С (Form.xml) в JSON-черновик в формате form-compile. Используй для scaffold новой формы по образцу или структурного рефакторинга. Не для точечных правок
|
|
argument-hint: <FormPath> [-OutputPath <out.json>]
|
|
disable-model-invocation: true
|
|
allowed-tools:
|
|
- Bash
|
|
- Read
|
|
- Write
|
|
- Glob
|
|
---
|
|
|
|
# /form-decompile — JSON-черновик из Form.xml управляемой формы
|
|
|
|
Читает Form.xml и эмитит компактный JSON в формате `form-compile`. **Результат — черновик**, а не обратимое представление: см. раздел «Что получаешь».
|
|
|
|
## Когда использовать
|
|
|
|
- **Scaffold новой формы по образцу** — взять существующую форму, получить JSON, поправить и скомпилировать в новую.
|
|
- **Структурный рефакторинг** — перебрать дерево элементов, реквизиты, команды.
|
|
|
|
## Когда **не** использовать
|
|
|
|
- **Точечные правки готовой формы** (добавить элемент, реквизит, команду) → `/form-edit`. Цикл «декомпиляция → правка JSON → компиляция» переписывает форму целиком, может терять непокрытые конструкции и даёт большой diff. `/form-edit` правит адресно.
|
|
|
|
## Параметры
|
|
|
|
| Параметр | Описание |
|
|
|----------|----------|
|
|
| `FormPath` | Путь к Form.xml (обязательный) |
|
|
| `OutputPath` | Путь к выходному JSON. Если не задан — JSON в stdout |
|
|
|
|
```powershell
|
|
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/form-decompile.ps1" -FormPath "<Form.xml>" -OutputPath "<out.json>"
|
|
```
|
|
|
|
## Что получаешь
|
|
|
|
JSON-черновик в формате `/form-compile` — **не полное обратимое представление**: раундтрип `xml → json → xml` не гарантируется, часть конструкций DSL не покрывает и **теряет молча**.
|
|
|
|
Критичные конструкции (`ConditionalAppearance` со scope, design-time диаграммы/планировщики на реквизите, неизвестный тип элемента, не-Form root) → скрипт падает с ненулевым кодом и сообщением в stderr; для правок такой формы — `/form-edit`.
|
|
|
|
## Workflow
|
|
|
|
1. `/form-decompile <Form.xml> -OutputPath draft.json` — получить черновик.
|
|
2. Поправить JSON под задачу.
|
|
3. `/form-compile -JsonPath draft.json -OutputPath new/Form.xml` — собрать обратно.
|
|
4. `/form-validate` + `/form-info` — проверить результат.
|