mirror of
https://github.com/Nikolay-Shirokov/cc-1c-skills.git
synced 2026-06-26 15:04:34 +03:00
Nick Shirokov
378b19b59f
- 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>
82 lines
5.3 KiB
Markdown
82 lines
5.3 KiB
Markdown
# Хуки: защита конфигураций на поддержке + подсказка навыков
|
|
|
|
Два хука 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/` хуки не переносит. Чтобы включить их:
|
|
|
|
1. Скопируйте каталог `hooks/` в проект, например в `<проект>/.claude/hooks/`.
|
|
2. Добавьте в `<проект>/.claude/settings.json`:
|
|
|
|
```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` (включить редактирование объекта,
|
|
снять его с поддержки или включить возможность изменения всей конфигурации). Готовую команду под ваш
|
|
случай печатает сам отказ.
|
|
|
|
## Проверка
|
|
|
|
```bash
|
|
node hooks/test/run.mjs
|
|
```
|
|
|
|
Прогоняет защиту и подсказку на реальных выгрузках и на временных тестовых данных (в `test-tmp/`, не
|
|
попадает в git; рабочие выгрузки не затрагиваются).
|