mirror of
https://github.com/Nikolay-Shirokov/cc-1c-skills.git
synced 2026-06-26 06:54:38 +03:00
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:
@@ -27,6 +27,5 @@
|
||||
"testing",
|
||||
"test-automation"
|
||||
],
|
||||
"skills": "./.claude/skills/",
|
||||
"hooks": "./hooks/hooks.json"
|
||||
"skills": "./.claude/skills/"
|
||||
}
|
||||
|
||||
@@ -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` используют единый алгоритм:
|
||||
|
||||
+12
-9
@@ -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
|
||||
{
|
||||
|
||||
Reference in New Issue
Block a user