From 6e458bf0b8284fc94ef44d9f2a5be01aec34063d Mon Sep 17 00:00:00 2001 From: Nick Shirokov Date: Sat, 20 Jun 2026 20:40:46 +0300 Subject: [PATCH] =?UTF-8?q?chore(hooks):=20=D1=81=D0=B4=D0=B5=D0=BB=D0=B0?= =?UTF-8?q?=D1=82=D1=8C=20=D1=85=D1=83=D0=BA=D0=B8=20=D0=BE=D0=BF=D1=82-?= =?UTF-8?q?=D0=B8=D0=BD=20(=D1=8D=D0=BA=D1=81=D0=BF=D0=B5=D1=80=D0=B8?= =?UTF-8?q?=D0=BC=D0=B5=D0=BD=D1=82=D0=B0=D0=BB=D1=8C=D0=BD=D0=BE)=20+=20?= =?UTF-8?q?=D0=B4=D0=BE=D0=BA=D0=B8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - plugin.json: убран ключ hooks → плагин больше НЕ подключает хуки автоматически. Базовая защита поддержки (§1B в навыках) остаётся on-by-default; хуки — опциональный слой поверх (перехват правок мимо навыков + суфлёр), включается вручную. - hooks/README.md: помечено «экспериментально, по умолчанию выключено»; раздел установки переписан под ручное включение. - docs/v8-project-guide.md: добавлен флаг skillSuggester (глоб. + по базе) и секция про опциональные хуки. Co-Authored-By: Claude Opus 4.8 --- .claude-plugin/plugin.json | 3 +-- docs/v8-project-guide.md | 10 ++++++++++ hooks/README.md | 21 ++++++++++++--------- 3 files changed, 23 insertions(+), 11 deletions(-) diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index a1637501..bfd1da56 100644 --- a/.claude-plugin/plugin.json +++ b/.claude-plugin/plugin.json @@ -27,6 +27,5 @@ "testing", "test-automation" ], - "skills": "./.claude/skills/", - "hooks": "./hooks/hooks.json" + "skills": "./.claude/skills/" } diff --git a/docs/v8-project-guide.md b/docs/v8-project-guide.md index f8bfe8ab..24e0d243 100644 --- a/docs/v8-project-guide.md +++ b/docs/v8-project-guide.md @@ -58,6 +58,7 @@ | `databases` | array | да | — | Список баз данных | `/db-list add` | | `default` | string | нет | — | `id` базы по умолчанию | `/db-list` | | `editingAllowedCheck` | `"deny"`/`"warn"`/`"off"` | нет | `deny` | Глобальная реакция support-guard на правку объектов на замке (см. ниже) | Руками | +| `skillSuggester` | `"on"`/`"off"` | нет | `on` | Подсказки навыков от хука skill-suggester (только если хук включён, см. ниже) | Руками | | `webPath` | string | нет | `tools/apache24` | Каталог Apache HTTP Server | Руками | | `ffmpegPath` | string | нет | `tools/ffmpeg/bin/ffmpeg.exe` | Путь к ffmpeg | Руками | | `tts` | object | нет | Edge TTS, DmitryNeural | Настройки озвучки видео | Руками | @@ -78,6 +79,7 @@ | `branches` | string[] | нет | Git-ветки или glob-паттерны (`release/*`, `feature/*`) | Руками | | `configSrc` | string | нет | Каталог XML-выгрузки конфигурации | Руками | | `editingAllowedCheck` | `"deny"`/`"warn"`/`"off"` | нет | Override реакции support-guard для этой базы (см. ниже) | Руками | +| `skillSuggester` | `"on"`/`"off"` | нет | Override подсказок навыков для этой базы (см. ниже) | Руками | | `webUrl` | string | нет | URL веб-клиента для `/web-test` | Руками | ### Support-guard и `editingAllowedCheck` @@ -91,6 +93,14 @@ Триггер проверки — наличие `ParentConfigurations.bin` (конфигурация на поддержке), а не регистрация в `.v8-project.json`. Поле лишь меняет реакцию. Берётся `databases[].editingAllowedCheck` базы, чей `configSrc` охватывает редактируемый путь; иначе — корневое `editingAllowedCheck`; иначе `deny`. +### Хуки и `skillSuggester` (экспериментально) + +Помимо встроенной в навыки проверки (выше), есть **опциональные хуки Claude Code** (каталог `hooks/`), которые по умолчанию **выключены** и подключаются вручную (см. `hooks/README.md`): +- **support-guard** — перехватывает правки исходников на поддержке **в обход навыков** (прямые `Edit`/`Write`); реакцию берёт из того же `editingAllowedCheck`; +- **skill-suggester** — ненавязчиво подсказывает профильный навык, когда модель работает с исходниками напрямую. + +`skillSuggester` (`on`/`off`, по умолчанию `on`) включает/выключает подсказки skill-suggester. Действует только когда хук подключён; раскладка та же — `databases[].skillSuggester` для базы по `configSrc`, иначе корневое, иначе `on`. + ### Разрешение базы Все навыки `/db-*`, `/epf-build`, `/epf-dump`, `/erf-build`, `/erf-dump`, `/web-publish` используют единый алгоритм: diff --git a/hooks/README.md b/hooks/README.md index 5e81c862..dd5123a0 100644 --- a/hooks/README.md +++ b/hooks/README.md @@ -1,5 +1,10 @@ # Хуки: защита конфигураций на поддержке + подсказка навыков +> ⚠️ **Экспериментально, по умолчанию выключено.** Эти хуки **не подключаются автоматически** даже при +> установке плагина — их нужно включить вручную (см. «Установка» ниже). Базовая защита поддержки уже работает +> без хуков — встроена в сами навыки-мутаторы; хуки лишь добавляют перехват правок **в обход навыков** и +> подсказки. Фича новая, обкатывается; отзывы приветствуются. + Два хука Claude Code, которые помогают безопасно дорабатывать типовые конфигурации 1С: - **Защита от правки «на замке».** Если модель пытается напрямую (инструментами `Edit`/`Write`) @@ -20,17 +25,15 @@ **Node.js 18+** (тот же, что нужен для `/web-test`). Команда `node` должна быть доступна в PATH. -## Установка +## Установка (ручная — фича экспериментальная) -### Через плагин — автоматически -Если навыки установлены как плагин (`/plugin install 1c-skills@cc-1c-skills`), хуки подключаются сами — -настраивать ничего не нужно. +Хуки сейчас **не включаются автоматически** ни одним способом установки (плагин их не объявляет в манифесте). +Чтобы включить: -### Вручную (при установке копированием папки навыков) -Копирование `.claude/skills/` хуки не переносит. Чтобы включить их: - -1. Скопируйте каталог `hooks/` в проект, например в `<проект>/.claude/hooks/`. -2. Добавьте в `<проект>/.claude/settings.json`: +1. Убедитесь, что каталог `hooks/` доступен в проекте. При установке плагином он уже в составе плагина — + используйте путь `${CLAUDE_PLUGIN_ROOT}/hooks/...`. При установке копированием навыков скопируйте `hooks/` + в проект, например в `<проект>/.claude/hooks/`, и используйте `${CLAUDE_PROJECT_DIR}/.claude/hooks/...`. +2. Добавьте в `<проект>/.claude/settings.json` (пути ниже — для варианта с копированием): ```json {