chore(hooks): сделать хуки опт-ин (экспериментально) + доки

- plugin.json: убран ключ hooks → плагин больше НЕ подключает хуки
  автоматически. Базовая защита поддержки (§1B в навыках) остаётся
  on-by-default; хуки — опциональный слой поверх (перехват правок мимо
  навыков + суфлёр), включается вручную.
- hooks/README.md: помечено «экспериментально, по умолчанию выключено»;
  раздел установки переписан под ручное включение.
- docs/v8-project-guide.md: добавлен флаг skillSuggester (глоб. + по базе)
  и секция про опциональные хуки.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Nick Shirokov
2026-06-20 20:40:46 +03:00
co-authored by Claude Opus 4.8
parent 4ec2420af6
commit 6e458bf0b8
3 changed files with 23 additions and 11 deletions
+12 -9
View File
@@ -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
{