cc-1c-skills/hooks

Хуки: защита конфигураций на поддержке + подсказка навыков

⚠️ Экспериментально, по умолчанию выключено. Эти хуки не подключаются автоматически даже при установке плагина — их нужно включить вручную (см. «Установка» ниже). Базовая защита поддержки уже работает без хуков — встроена в сами навыки-мутаторы; хуки лишь добавляют перехват правок в обход навыков и подсказки. Фича новая, обкатывается; отзывы приветствуются.

Два хука Claude Code, которые помогают безопасно дорабатывать типовые конфигурации 1С:

• Защита от правки «на замке». Если модель пытается напрямую (инструментами Edit/Write) изменить объект типовой конфигурации, который стоит на поддержке поставщика, редактирование блокируется — иначе оно молча сломает будущие обновления вендора. В отказе сразу даётся, что делать дальше под конкретный случай (доработать в расширении или явно разрешить редактирование).
• Подсказка навыков. Когда модель работает с исходниками 1С «вручную» (читает сырой XML или правит его напрямую), хук ненавязчиво напоминает про профильный навык — и по делу: при чтении ведёт на *-info (понять структуру), при правке — на мутатор (meta-edit/form-edit/skd-edit/…). Не блокирует, подсказывает не чаще одного раза за сессию на группу и действие.

Это дополнительный слой поверх проверок, которые уже встроены в сами навыки: навыки-мутаторы и так не дадут испортить объект на поддержке. Хуки добавляют защиту для случаев, когда правят файлы в обход навыков.

Хуки — возможность только Claude Code. На других платформах их нет; там работают встроенные в навыки проверки.

Требования

Node.js 18+ (тот же, что нужен для /web-test). Команда node должна быть доступна в PATH.

Установка (ручная — фича экспериментальная)

Хуки сейчас не включаются автоматически ни одним способом установки (плагин их не объявляет в манифесте). Чтобы включить:

1. Убедитесь, что каталог hooks/ доступен в проекте. При установке плагином он уже в составе плагина — используйте путь ${CLAUDE_PLUGIN_ROOT}/hooks/.... При установке копированием навыков скопируйте hooks/ в проект, например в <проект>/.claude/hooks/, и используйте ${CLAUDE_PROJECT_DIR}/.claude/hooks/....
2. Добавьте в <проект>/.claude/settings.json (пути ниже — для варианта с копированием):

{
  "hooks": {
    "PreToolUse": [
      { "matcher": "Edit|Write|MultiEdit",
        "hooks": [{ "type": "command",
          "command": "node \"${CLAUDE_PROJECT_DIR}/.claude/hooks/support-guard.mjs\"" }] }
    ],
    "PostToolUse": [
      { "matcher": "Read|Edit|Write|MultiEdit",
        "hooks": [{ "type": "command",
          "command": "node \"${CLAUDE_PROJECT_DIR}/.claude/hooks/skill-suggester.mjs\"" }] }
    ]
  }
}

Настройка (.v8-project.json)

Поведение настраивается в файле проекта .v8-project.json — глобально и/или по конкретной базе (databases[].…, переопределяет глобальное):

Поле	Значения	По умолчанию	Что делает
editingAllowedCheck	deny / warn / off	deny	Реакция защиты: блокировать правку объекта на замке / только предупреждать / выключить проверку.
skillSuggester	on / off	on	Включает/выключает подсказки навыков.

Источник истины по состоянию поддержки — сама выгрузка конфигурации; .v8-project.json лишь настраивает реакцию.

Что делать при отказе защиты

Текст отказа сам подсказывает варианты под конкретную ситуацию. Кратко:

• Безопаснее всего — вести доработку в расширении (навыки cfe-borrow / cfe-patch-method): состояние поддержки менять не нужно, обновления вендора сохраняются.
• Либо осознанно разрешить редактирование через навык support-edit (включить редактирование объекта, снять его с поддержки или включить возможность изменения всей конфигурации). Готовую команду под ваш случай печатает сам отказ.

Проверка

node hooks/test/run.mjs

Прогоняет защиту и подсказку на реальных выгрузках и на временных тестовых данных (в test-tmp/, не попадает в git; рабочие выгрузки не затрагиваются).