К основному содержанию
скилл CX Codex

cfe-patch-method — скилл для Claude Code: что делает и как установить

Скилл cfe-patch-method для Claude Code создаёт перехватчики методов заимствованных объектов 1С. Переносит правки на обновлённый оригинал при доработке расширений CFE.

MIT 46 установок ★ 811 обновлён 2026-10-23

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add Nikolay-Shirokov/cc-1c-skills
/plugin install 1c-skills@cc-1c-skills
Открыть на GitHub

Что делает cfe-patch-method

Скилл читает исходный метод из конфигурации и создаёт или обновляет файл перехватчика .bsl. Режимы Before и After добавляют код до или после процедуры, Instead заменяет её или функцию, а ModificationAndControl копирует тело оригинала для правки с контролем изменений. Повторный вызов для уже перехваченного метода не создаёт дубль.

Чтобы работать по логическому имени модуля, нужны заимствованный объект и доступ к исходникам базовой конфигурации. Можно передать путь к файлу .bsl вместо логического имени; тогда ConfigPath не нужен. Для проверки дрейфа служит -Check, для переноса правок на обновлённый оригинал — -Actualize. Без заимствованного объекта перехватчик создать нельзя.

Какие задачи решает

  • создать перехватчик процедуры до или после оригинального вызова
  • заменить метод или функцию с вызовом ПродолжитьВызов(...)
  • скопировать тело метода для контролируемой доработки
  • проверить дрейф или перенести правки на обновлённый оригинал

Примеры запросов агенту

  • Создай перехватчик ПриЗаписи объекта Catalog.Контрагенты.ObjectModule в режиме Before.
  • Проверь контролируемые методы расширения на дрейф с помощью -Check.
  • Актуализируй перехватчики в модуле Catalog.X.ObjectModule через -Actualize.

Как установить cfe-patch-method

1Через маркетплейс плагинов

/plugin marketplace add Nikolay-Shirokov/cc-1c-skills
/plugin install 1c-skills@cc-1c-skills

Команда ставит плагин 1c-skills целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add Nikolay-Shirokov/cc-1c-skills --skill cfe-patch-method -a claude-code

3Вручную: положить файлы

~/.claude/skills/cfe-patch-method/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/cfe-patch-method/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о cfe-patch-method

Как установить cfe-patch-method в Claude Code?

Выполни команды по порядку: /plugin marketplace add Nikolay-Shirokov/cc-1c-skills, затем /plugin install 1c-skills@cc-1c-skills.

Что делает скилл cfe-patch-method?

Создаёт перехватчик метода заимствованного объекта 1С или обновляет существующий. Также проверяет контролируемые методы и переносит правки на изменившийся оригинал.

Что нужно для создания перехватчика?

Объект должен быть заимствован в расширение. Для логического имени модуля нужен доступ к исходникам базовой конфигурации; вместо него можно передать путь к файлу .bsl.

Исходный текст

SKILL.md · MIT
---
name: cfe-patch-method
description: Генерация и актуализация перехватчика метода в расширении 1С (CFE). Используй когда нужно перехватить метод заимствованного объекта — вставить код до, после, вместо оригинала, изменить его тело (ИзменениеИКонтроль) — или актуализировать перехватчик после изменения оригинала
argument-hint: -ExtensionPath <path> -ConfigPath <path> -ModulePath "Catalog.X.ObjectModule" -MethodName "ПриЗаписи" -InterceptorType Before
allowed-tools:
  - Bash
  - Read
  - Glob
---

# /cfe-patch-method — Генерация перехватчика метода

Читает оригинал метода из конфигурации-источника и генерирует `.bsl`-перехватчик заимствованного объекта: с правильной директивой контекста, полной сигнатурой, обрамляющими инструкциями препроцессора и областями. Для `ИзменениеИКонтроль` копирует всё тело оригинала. Создаёт файл модуля, дописывает в существующий или актуализирует уже заимствованный метод.

## Предусловие

Объект должен быть заимствован в расширение (`/cfe-borrow`). Нужен доступ к исходникам базовой конфигурации (`-ConfigPath`) — оттуда читается оригинал метода. `NamePrefix` берётся из `Configuration.xml` расширения.

### Авто-определение ConfigPath

Если пользователь не указал `-ConfigPath` — попробуй определить автоматически:
1. Прочитай `.v8-project.json` из корня проекта
2. Разреши целевую базу (по имени, ветке или `default` — алгоритм из `/db-list`)
3. Если у базы есть поле `configSrc` — используй как `-ConfigPath`
4. Если `configSrc` нет — спроси у пользователя

## Параметры

| Параметр | Описание | По умолчанию |
|----------|----------|--------------|
| `ExtensionPath` | Путь к расширению (обязат.) | — |
| `ConfigPath` | Путь к конфигурации-источнику | обязат., кроме случая, когда `ModulePath` — путь к файлу |
| `ModulePath` | Логическое имя (`Тип.Имя.Модуль`) **или** путь к файлу модуля `.bsl` | обязат. для генерации |
| `MethodName` | Имя перехватываемого метода | обязат. для генерации |
| `InterceptorType` | `Before` / `After` / `Instead` / `ModificationAndControl` | обязат. для генерации |
| `Check` | Проверить контролируемые методы на дрейф (только отчёт) | — |
| `Actualize` | Актуализировать дрейфнувшие контролируемые методы | — |

## Формат ModulePath

| ModulePath | Файл |
|------------|------|
| `Catalog.X.ObjectModule` | `Catalogs/X/Ext/ObjectModule.bsl` |
| `Catalog.X.ManagerModule` | `Catalogs/X/Ext/ManagerModule.bsl` |
| `Catalog.X.Form.Y` | `Catalogs/X/Forms/Y/Ext/Form/Module.bsl` |
| `CommonModule.X` | `CommonModules/X/Ext/Module.bsl` |
| `CommonForm.X` | `CommonForms/X/Ext/Form/Module.bsl` |
| `Document.X.ObjectModule` | `Documents/X/Ext/ObjectModule.bsl` |
| `Document.X.Form.Y` | `Documents/X/Forms/Y/Ext/Form/Module.bsl` |

Аналогично для Report, DataProcessor, InformationRegister и других типов.

Вместо логического имени в `ModulePath` можно передать **путь к файлу** модуля-источника `.bsl` — тогда `-ConfigPath` указывать не нужно (оригинал читается прямо из этого файла). Путь модуля расширения определяется от типовой папки в пути автоматически.

## Типы перехвата

| InterceptorType | Декоратор | Назначение | Применим к |
|-----------------|-----------|------------|------------|
| `Before` | `&Перед` | Код до вызова оригинального метода | процедуры |
| `After` | `&После` | Код после вызова оригинального метода | процедуры |
| `Instead` | `&Вместо` | Замена метода; в теле — скаффолд `ПродолжитьВызов(...)` | процедуры и функции |
| `ModificationAndControl` | `&ИзменениеИКонтроль` | Копия тела оригинала для правки маркерами `#Вставка`/`#Удаление` | процедуры и функции |

## Маркеры `#Вставка` / `#Удаление` (для `ModificationAndControl`)

`&ИзменениеИКонтроль` вставляет в перехватчик **копию тела оригинала**. Дальше отредактируй тело под свою доработку, **помечая каждое изменение** — платформа так отличает твою правку от неизменного оригинала:

- **Добавляешь код** → оберни его `#Вставка` … `#КонецВставки`.
- **Удаляешь код оригинала** → оберни удаляемые строки `#Удаление` … `#КонецУдаления`, но сами строки **оставь между маркерами** (платформа сверяет их с оригиналом).
- **Заменяешь** → `#Удаление` старое `#КонецУдаления` сразу за ним `#Вставка` новое `#КонецВставки`.

Пример:
```bsl
&ИзменениеИКонтроль("ПриЗаписи")
Процедура Расш_ПриЗаписи(Отказ)
	СуммаДокумента = РассчитатьСумму();
#Вставка
	// доработка: округляем
	СуммаДокумента = Окр(СуммаДокумента, 2);
#КонецВставки
#Удаление
	Записать();
#КонецУдаления
#Вставка
	ЗаписатьСПроверкой(Отказ);
#КонецВставки
КонецПроцедуры
```

Правила:
- Маркеры — на **отдельной строке с 0-й колонки** (без отступа), даже внутри отступов и текста запроса (`|…`).
- **Незамеченные (unmarked) строки должны совпадать с оригиналом дословно** — это и есть «контроль». Дословно — включая комментарии, регистр и пробелы внутри строки (`Х = Х + 1` ≠ `Х=Х+1`); свободны только отступ и пустые строки. Если оригинал в конфигурации-источнике изменится, unmarked-контекст разойдётся → метод потребует актуализации (см. ниже; проверить пачкой — `-Check`).
- Меняешь только свои `#Вставка`/`#Удаление`; чужой оригинал не трогай.

## Актуализация

После изменения оригинала в конфигурации-источнике перехватчик `&ИзменениеИКонтроль` может рассинхронизироваться — unmarked-контекст разойдётся с новым оригиналом. Платформа при загрузке об этом молчит, поэтому актуализируй сам:

- **Проверить** — `-Check`: отчёт по всем контролируемым методам расширения, ничего не пишет (`exit 1`, если есть дрейф или конфликт).
- **Актуализировать** — `-Actualize`: переносит правки (`#Вставка`/`#Удаление`) на новый оригинал по всему расширению. Сузить область: `-ModulePath` — один модуль, `+ -MethodName` — один метод. Для одного метода то же делает повторный вызов с `-InterceptorType ModificationAndControl`.

Статусы в выводе:

- `[АКТУАЛЕН]` — оригинал не менялся, правок нет;
- `[АКТУАЛИЗИРОВАН]` — тело обновлено по новому оригиналу, правки сохранены (в выводе — сводка);
- `[АКТУАЛИЗИРОВАН-ЧАСТИЧНО]` — часть правок не удалось разместить (якорь изменился в новом оригинале). Они помечены `// [РЕСИНК-КОНФЛИКТ]` в модуле и не потеряны; путь к merge-воркспейсу — в выводе (начни с `index.md`, дальше по каждому конфликту его `conflict.md`, размести блоки вручную в `.bsl` расширения);
- `[ПЕРЕНЕСЕНО В ОСНОВНУЮ]` — правка уже есть в новом оригинале (вставленный код внесён вендором) или удаляемый блок уже вырезан. Правка неактуальна — убирается из тела, дублировать/конфликтовать не нужно. Если так со всеми правками метода — перехватчик можно удалить. `-Check` этим не роняет `exit`.

Повторный вызов `Before`/`After`/`Instead` для уже перехваченного метода дубль не создаёт (`[ПРОПУЩЕН]`).

`-Check` смотрит исходники. Вердикт платформы — уже после загрузки в базу: `/db-cfe-admin check`.

## Команда

```powershell
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/cfe-patch-method.ps1" -ExtensionPath src\cfe\extname -ConfigPath src\cf -ModulePath "Catalog.Контрагенты.ObjectModule" -MethodName "ПриЗаписи" -InterceptorType Before
```

## Примеры

```powershell
# Код перед записью
... -ExtensionPath src\cfe\extname -ConfigPath src\cf -ModulePath "Catalog.Контрагенты.ObjectModule" -MethodName "ПриЗаписи" -InterceptorType Before

# Перехват После на форме
... -ExtensionPath src\cfe\extname -ConfigPath src\cf -ModulePath "Document.Заказ.Form.ФормаДокумента" -MethodName "ПослеЗаписиНаСервере" -InterceptorType After

# Замена функции (ПродолжитьВызов)
... -ExtensionPath src\cfe\extname -ConfigPath src\cf -ModulePath "CommonModule.ОбщийМодуль" -MethodName "ПолучитьДанные" -InterceptorType Instead

# ИзменениеИКонтроль — копия тела для правки маркерами
... -ExtensionPath src\cfe\extname -ConfigPath src\cf -ModulePath "Document.РеализацияТоваров.ObjectModule" -MethodName "ОбработкаПроведения" -InterceptorType ModificationAndControl

# ModulePath как путь к файлу модуля-источника (без -ConfigPath)
... -ExtensionPath src\cfe\extname -ModulePath "src\cf\CommonModules\ОбщийМодуль\Ext\Module.bsl" -MethodName "ПолучитьДанные" -InterceptorType Instead

# Проверить все контролируемые методы расширения на дрейф
... -ExtensionPath src\cfe\extname -ConfigPath src\cf -Check

# Актуализировать дрейфнувшие контролируемые методы пачкой
... -ExtensionPath src\cfe\extname -ConfigPath src\cf -Actualize
```

## Верификация

```
/cfe-validate <ExtensionPath> -ConfigPath <ConfigPath>
```

© Nikolay Shirokov · MIT · Nikolay-Shirokov/cc-1c-skills

Похожие скиллы

Всё по теме «1С» →
price-check ilyautov Скилл price-check считает валовую маржу по товарам и строит три сценарных среза цены — текущая, рост и снижение — с учётом статуса НДС. Расчёт маржи ведёт через процесс скилла margin-analyzer. CX Codex +1 ★ 38звёзд репо month-end-prep ilyautov Скилл month-end-prep проводит собственника через закрытие месяца: сверяет данные 1С/МойСклад с зачислениями эквайринга и банком, находит операции без статьи, дубли и пропавшую первичку, затем пишет ОПиУ-сводку и выгружает xlsx с PDF. CX Codex +1 ★ 38звёзд репо 1c-rest-mcp theYahia MCP-сервер 1c-rest-mcp подключает ИИ-агента к данным 1С через OData 3.0. Подходит для чтения и изменения каталогов, документов и регистров. CX Codex +1 ★ 13звёзд репо Yzel — 1C:Enterprise Aiyo28 Yzel — 1C:Enterprise — MCP-сервер для Claude Code, который подключает AI-ассистента к базам 1С:Предприятие через OData v3. Работает с локальными инсталляциями и 1С:Fresh. CX Codex +1 ★ 9звёзд репо refactor-method-complexity-reduce официальный github Скилл refactor-method-complexity-reduce рефакторит выбранный метод, снижая когнитивную сложность через вынос логики в хелперы. Подходит для длинных ветвлений и вложенных условий. CX Codex +1 9 992установок java-refactoring-extract-method официальный github Скилл java-refactoring-extract-method помогает выделять связные блоки из сложных Java-методов в отдельные методы. Подходит, когда нужно упростить код и сохранить его поведение. CX Codex +1 9 284установок

Из того же набора81

Весь набор →
img-grid Скилл img-grid накладывает измерительную сетку на скриншоты печатных форм и макетов. Помогает рассчитать пропорции колонок перед сборкой табличного документа. CX Codex +1 46установок erf-init Скилл erf-init для Claude Code и Codex, который раскладывает пустой внешний отчёт 1С по XML-исходникам. Запускается, когда новый отчёт нужно начать с чистого листа, а не копировать старый. CX Codex +1 46установок erf-dump Скилл erf-dump декомпилирует внешние отчёты 1С формата ERF в набор исходников XML. Сохраняет ссылочные типы конфигурации при выгрузке. CX Codex +1 46установок epf-validate Скилл epf-validate проверяет XML-исходники внешних обработок 1С (EPF) и внешних отчётов (ERF) на структурные ошибки. Пригодится после создания или изменения обработки, чтобы не пропустить проблемы до сборки. CX Codex +1 46установок cf-edit Скилл cf-edit для Claude Code точечно редактирует Configuration.xml в выгрузках 1С: свойства, объекты, роли по умолчанию, панели и начальную страницу. CX Codex +1 46установок subsystem-validate Скилл subsystem-validate проверяет корректность XML-файла подсистемы из выгрузки конфигурации 1С. Запускает PowerShell-скрипт, который находит структурные ошибки. CX Codex +1 45установок subsystem-edit Скилл subsystem-edit меняет состав и свойства подсистемы 1С в XML. Подходит для добавления объектов, дочерних подсистем и точечных правок. CX Codex +1 45установок subsystem-compile Скилл subsystem-compile генерирует XML-исходники подсистемы 1С из JSON-определения и регистрирует её в конфигурации. CX Codex +1 45установок

Ещё в каталоге

fsecure-internet-security-patch-activator-malware reason-machines fsecure-internet-security-patch-activator-malware — скилл для Claude Code с образцом вредоносного репозитория, маскирующегося под патч F-Secure. Показывает, как распознавать фальшивые активаторы и кряки антивирусов. CX Codex +1 113установок k7-total-security-unlock-patch-security-analysis reason-machines Скилл k7-total-security-unlock-patch-security-analysis разбирает репозитории, которые выдают себя за средство защиты, а на деле распространяют кряки и обходят лицензию. Даёт методику проверки и готовые Python-функции для оценки риска. CX Codex +1 123установок BMAD Method daffy0208 Скилл BMAD Method связывает бизнес-модель продукта с решениями по архитектуре, затратам и масштабированию. Пригодится при запуске продукта, пересмотре архитектуры или выборе между разработкой и готовым сервисом. CX Codex +1 149установок patch-creation Piebald-AI Скилл patch-creation помогает создавать и регистрировать патчи для утилиты tweakcc, модифицирующей сборку Claude Code. Пригодится при добавлении кастомных настроек и твиков. CX Codex +1 ★ 2 619звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой