
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 У ИИ-ассистентов нет «плохой памяти». У них  . плохое управление Вы это видели: 
 
 
 
 Вы написали подробное руководство по архитектуре. Модель его игнорирует. Вы сказали «4-уровневая архитектура». Она выводит 3 уровня. Вы сказали «нет  ». Она удаляет  , как будто делает вам одолжение. el-input <el-input v-model="value" /> Дело не в интеллекте. Дело в стимулах. В Claude Code  , а не жестким ограничением. Если Claude «чувствует», что может ответить, не используя навык, он это сделает. И  . навыки являются доступным контекстом справочник вашего проекта становится украшением В нашей команде, создавая кодовую базу RuoYi-Plus с помощью Claude Code, мы отслеживали это: 
 
 Без вмешательства Claude проактивно активировал навыки проекта только примерно в 25% случаев. Итак, в 3 случаях из 4 ваши «правила» — это не правила. Это предложение. Нам нужно было что-то более строгое: механизм, который заставляет Claude вести себя меньше как умный стажер и больше как штатный инженер, который читает руководство перед написанием кода. Решением было не больше промптов. Решением были  . хуки После примерно 1 месяца итераций мы выпустили стек конфигурации  : .claude 
 
 
 
 
  (управление) 4 хука жизненного цикла  (знания) 26 навыков предметной области  (оркестрация процессов) слэш-команды  (параллельные специалисты) агенты Результат: 
 
  Меньше кода, нарушающего правила, меньше циклов «пожалуйста, переделайте», и гораздо меньше рискованных действий с инструментами. Активация навыков для задач разработки: ~25% → 90%+ Эта статья разбирает архитектуру, чтобы вы могли воспроизвести ее в своем репозитории. 1) Почему Claude Code «забывает»: навыки опциональны по умолчанию Стандартный поток Claude Code выглядит так: Пользовательский запрос → Claude отвечает (возможно, вызывает навык, возможно, нет)
 Это «возможно» — проблема. Внутренняя эвристика принятия решений Claude обычно заключается в следующем: 
 
 
 «Могу ли я быстро ответить на это без дополнительного контекста?» а не «Должен ли я   соблюдать правила репозитория?» обязательно Таким образом, система склоняется к удобству. Что вам нужно, так это  : легкий «плоскость управления», которая работает   Claude начнет рассуждать, и формирует работу каждый раз. институциональное трение до того, как 2) Прорыв: хук принудительной оценки навыков Мы реализовали хук, который срабатывает в самый ранний момент:  . UserPromptSubmit Он выводит короткий блок политики, который Claude видит   что-либо делать: перед тем, как 
 
 
 
 Оценить каждый навык: да/нет + причина Если «да»: немедленно вызвать навык Только после этого: приступить к реализации Основная логика хука «принудительной оценки» Мы намеренно сохраняем его простым и детерминированным: 
 
 
 обнаружение слэш-команд (аварийный выход) иначе выводим протокол оценки // .claude/hooks/skill-forced-eval.js (основная идея, упрощенно)
const prompt = process.env.CLAUDE_USER_PROMPT ?? "";
​
// Аварийный выход: если пользователь вызвал слэш-команду, пропускаем принудительную оценку
const isSlash = /^\/[^\s/]+/.test(prompt.trim());
if (isSlash) process.exit(0);
​
const skills = [
  "crud-development",
  "api-development",
  "database-ops",
  "ui-pc",
  "ui-mobile",
  // ... продолжить (у нас 26)
];
​
const instructions = [
  "## Обязательный протокол активации навыков (ДОЛЖЕН СОБЛЮДАТЬСЯ)",
  "",
  "### Шаг 1 — Оценка",
  "Для КАЖДОГО навыка выведите: [навык] — Да/Нет — Причина",
  "",
  "### Шаг 2 — Активация",
  "Если ХОТЯ БЫ один навык — Да → немедленно вызвать Skill(<имя>).",
  "Если ВСЕ — Нет → сообщить «Навыки не требуются» и продолжить.",
  "",
  "### Шаг 3 — Реализация",
  "Только после выполнения Шага 2 начните фактическое решение.",
  "",
  "Доступные навыки:",
  ...skills.map(s => `- ${s}`)
].join("\n");
​
console.log(instructions);
 Что меняется на практике До (без хука): 
 
 «Создайте управление купонами». Claude начинает кодировать… и игнорирует вашу 4-уровневую архитектуру или запрещенные компоненты. После (хук принудительной оценки): Claude сначала должен создать явную таблицу решений, затем активировать навыки, затем реализовать. Поведенческое изменение драматично, потому что вы устраняете «необязательное соблюдение». 3) Почему 90%, а не 100%? Потому что мы намеренно добавили  . быстрый путь Когда пользователь знает, что хочет, ввод команды вроде: 
 
 
 
 /dev build coupon management /crud b_coupon /check должен быть мгновенным. Поэтому хук пропускает оценку для слэш-команд и позволяет рабочему процессу команды взять верх. Вот компромисс: 
 
 
 Управление для свободных запросов Скорость для структурированных команд 4) Хуки как плоскость управления жизненным циклом (4-хуковый стек) Думайте о хуках как о конвейере CI для сессии агента — только он работает вживую, в вашем терминале. Мы используем четыре ключевых точки: 4.1 SessionStart: «посмотри на репозиторий перед тем, как говорить» Когда начинается сессия, мы показываем: 
 
 
 
 
 текущую ветку git несохраненные изменения открытые TODO / статус частые команды Пример вывода: 🚀 Начата сессия: RuoYi-Plus-Uniapp
Время: 2026-02-16 21:14
Ветка: master
​
⚠️ Несохраненные изменения: 5 файлов
📋 TODO: 3 открыто / 12 выполнено
​
Быстрые ссылки:
  /dev    создать функцию
  /crud   сгенерировать модуль
  /check  проверить соглашения
  Claude перестает вести себя так, будто он входит в пустую комнату. Почему это важно: 4.2 UserPromptSubmit: принудительная оценка навыков (дисциплина) Это ворота «должен прочитать руководство». 4.3 PreToolUse: слой безопасности (управление инструментами) Claude Code мощный, потому что он может использовать инструменты: Bash, писать файлы, редактировать код. Именно так и происходят несчастные случаи. PreToolUse — ваша последняя линия обороны, прежде чем произойдет что-то необратимое. Мы блокируем небольшой черный список (и предупреждаем о более широком сером списке): // .claude/hooks/pre-tool-use.js (концептуально)
const cmd = process.env.CLAUDE_TOOL_INPUT ?? "";
​
const hardBlock = [
  /rm\s+(-rf|--recursive).*\s+\//i,
  /drop\s+(database|table)\b/i,
  />\s*\/dev\/sd[a-z]\b/i,
];
​
if (hardBlock.some(p => p.test(cmd))) {
  console.log(JSON.stringify({
    decision: "block",
    reason: "Обнаружен опасный шаблон команды"
  }));
  process.exit(0);
}
​
// Опционально: предупреждать/подтверждать при чувствительных действиях (массовые удаления, chmod -R и т. д.)
 Это не паранойя. Мы видели, как модели «очищали временные файлы» с помощью   в неверном каталоге. Вам нужна защита, которая не зависит от осторожности модели. rm -rf 4.4 Stop: «замкнуть петлю» с руководством по следующим шагам Когда Claude заканчивает, мы: 
 
 
 
 суммируем изменения в файлах (новые и измененные) предлагаем следующие действия (запустить тесты, обновить документацию, закоммитить) опционально запускаем агентов (ревью кода) Пример: ✅ Готово — изменено 8 файлов
​
Следующие шаги:
- @code-reviewer для проверки соглашений бэкенда
- Изменен SQL: синхронизировать скрипты миграции
- Рассмотреть: git commit -m "feat: модуль купонов"
 Цель: устранить разрыв «работало в чате». 5) Навыки: слой знаний, который вы можете реально обеспечить После того как активация станет детерминированной, навыки станут тем, чем они должны были быть:  . базой знаний предметной области Мы создали 26 навыков по следующим направлениям: 
 
 
 
 
 
 
 бэкенд (CRUD, API, DB, аннотации, обработка ошибок) фронтенд (политика ПК-компонентов, управление состоянием) мобильная разработка (UI-наборы, ограничения платформы uniapp) интеграции (платежи, WeChat, OSS) качество (производительность, безопасность, поиск ошибок) управление инженерными процессами (архитектура, рабочий процесс git, технические решения) Структура файла навыка, которая масштабируется Каждый   следует одному и тому же шаблону: SKILL.md # Название навыка
​
## Когда запускать
- Ключевые слова:
- Сценарии:
​
## Основные правила
### Правило 1
Объяснение + пример
​
### Правило 2
Объяснение + пример
​
## Запрещено
- ❌ ...
​
## Референсный код
- path/to/file
​
## Контрольный список
- [ ] ...
 Это единообразие важно, потому что модель учится   навыки. потреблять 6) Команды: рабочие процессы, а не предложения Навыки решают вопрос «что правильно». Команды решают вопрос «что за процесс». 6.1  : 7-шаговый конвейер разработки /dev Мы разработали   как концептуальный рабочий процесс: /dev 
 
 
 
 
 
 
 
 уточнение требований проектирование (API + модули + разрешения) проектирование БД (SQL + словари + меню) бэкенд (вывод 4-уровневой архитектуры) фронтенд (политика компонентов + маршрутизация) тестирование/проверка документация/отчет о ходе работ По сути, это: «как старшие хотят, чтобы работали младшие», закодированное как исполняемый скрипт. 6.2  : сгенерировать полный модуль из таблицы /crud Ввод: /crud b_coupon
 Вывод (примерный набор): 
 
 
 
 
 
 Сущность / BO / VO DAO + правила обертки запросов Сервис + Контроллер (без запрещенных шаблонов) Маппер Фронтенд API + шаблон страницы Ручная работа:  . Управление командами:   (плюс проверка) 2–4 часа 5–10 минут 6.3  : полностековая проверка соглашений (читаемая человеком) /check Здесь мы превращаем навыки в верификатор: 
 
 
 
 бэкенд: правила слоев, запрещенное наследование, политика использования оберток запросов фронтенд: запрещенные компоненты, использование оберток мобильная разработка: набор компонентов, единицы измерения, импорты 7) Агенты: параллельные специалисты (не перегружайте основной поток) Некоторые задачи должны выполняться выделенным субагентом: 
 
 
 : проверка соглашений по строгому контрольному списку @code-reviewer : обновление документов о статусе, TODO, показателей прогресса @project-manager Преимущество не в «большем интеллекте». Это   и уменьшение загрязнения контекста в основной сессии. разделение ответственности Практический шаблон: 
 
 
 
 
 основной агент генерирует код хук Stop предлагает ревью вы вызываете  @code-reviewer ревьюер возвращает структурированное изменение + список исправлений 8) Полная система: управление + знания + процессы + разделение труда Это архитектура в одном предложении: 
 
 Хуки обеспечивают поведение, Навыки предоставляют стандарты, Команды кодируют рабочие процессы, Агенты обрабатывают параллельную экспертизу. И да — вот как вы превращаете «общего ИИ-ассистента» в «родного для репозитория члена команды». 9) Минимальная воспроизводимая настройка (удобно для копирования и вставки) Если вам нужна наименьшая работающая версия, создайте следующее: .claude/
  settings.json
  hooks/
    skill-forced-eval.js
    pre-tool-use.js
  skills/
    crud-development/
      SKILL.md
 Минимальный   (хук UserPromptSubmit) settings.json {
  "hooks": {
    "UserPromptSubmit": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "node .claude/hooks/skill-forced-eval.js"
          }
        ]
      }
    ],
    "PreToolUse": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "node .claude/hooks/pre-tool-use.js"
          }
        ]
      }
    ]
  }
}
 Затем итерируйте: 
 
 
 
 
 
 добавьте SessionStart добавьте Stop расширяйте навыки только тогда, когда вы обнаруживаете повторяющееся «неправильное поведение» кодируйте повторяющиеся рабочие процессы как команды перепоручайте задачи ревью/PM агентам Заключение: «способность» — не узкое место —   — узкое место активация Ваша модель уже способна. Чего не хватает, так это  . системы, которая делает правильное поведение автоматическим Умный новый сотрудник без справочника будет импровизировать. Умный новый сотрудник с: 
 
 
 
 
 обеспеченными контрольными списками четкими запрещенными шаблонами повторяемыми рабочими процессами специалистами по ревью и PM …быстро становится последовательным. Claude — то же самое.

This story contains AI-generated text. The author has used AI either for research, to generate outlines, or write the text itself. 

Walkthroughs, tutorials, guides, and tips. This story will teach you how to do something new or how to do something better.

Branch

Read My Stories

Этот звук создан на языке оригинала истории!

Как создать уровень управления для кода Claude с помощью хуков, навыков и агентов

About Author

КОММЕНТАРИИ

БИРКИ

ЭТА СТАТЬЯ БЫЛА ПРЕДСТАВЛЕНА В

Related Stories

Хотите выиграть конкурс HackerNoon? Вот что рекомендуют победители конкурса #crypto-api

Утечка информации о системе Claude Sonnet 3.5: судебно-медицинский анализ

Повысьте свою производительность с помощью этих 18 инструментов разработчика 🚀🔥

Модель Bitcoin UTXO, обеспечивающая работу уникальной экосистемы

Хотите выиграть конкурс HackerNoon? Вот что рекомендуют победители конкурса #crypto-api

Утечка информации о системе Claude Sonnet 3.5: судебно-медицинский анализ

Повысьте свою производительность с помощью этих 18 инструментов разработчика 🚀🔥

Модель Bitcoin UTXO, обеспечивающая работу уникальной экосистемы

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps