mirror of https://github.com/Nikolay-Shirokov/cc-1c-skills.git synced 2026-06-26 06:54:38 +03:00

Files

T

Nick Shirokov 378b19b59f refactor(hooks): предметная диагностика гарда по причине + README для читателя

- support-guard: вместо общего списка всех вариантов — текст под конкретную
  причину отказа (decideSupport.code: capability-off | locked | not-removed),
  с подставленным реальным путём и точными командами support-edit. Понятно
  модели вне контекста: что за состояние и что именно сделать.
- support-state: decideSupport возвращает code (дискриминатор причины).
- README: переписан для читателя — убраны отсылки к внутренней реализации
  (§-нумерация, декодер, разбор common/); назначение, установка, настройка
  (.v8-project.json), что делать при отказе, проверка.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

2026-06-20 19:36:55 +03:00

5.3 KiB

Raw Blame History

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

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

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

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

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

Требования

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

Установка

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

Если навыки установлены как плагин (/plugin install 1c-skills@cc-1c-skills), хуки подключаются сами — настраивать ничего не нужно.

Вручную (при установке копированием папки навыков)

Копирование .claude/skills/ хуки не переносит. Чтобы включить их:

Скопируйте каталог hooks/ в проект, например в <проект>/.claude/hooks/.
Добавьте в <проект>/.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|Grep|Glob|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; рабочие выгрузки не затрагиваются).

5.3 KiB Raw Blame History