Навыки как база знаний команды

О чём урок

Навыки — это способ, которым организация преобразует свои институциональные знания в операционную деятельность. Инструкции являются явными, контролируются версиями, применяются широко и централизованно обновляются при изменении политики. Эмпирическое правило: создавайте навык для институциональных знаний, которые должны применяться последовательно; не создавайте навык для компонентов, которые относятся(открывается в новой вкладке) к CLAUDE.md или prompt. Предварительные условия: Не требуются. Наличие CLAUDE.md помогает, так как оно хранит рабочие знания агента в репозитории, но навык не зависит от него. Инфраструктура: Одна политика с указанным владельцем и письменным источником достоверной информации. Выберите одно знание, которое сегодня применяется непоследовательно. Это может быть стандарт безопасности, соглашение о проектировании API или правило бренда. Оформите его как навык — папку, содержащую файл SKILL.md, в метаданных которого указано, когда он срабатывает, а в теле — что делать. Инженер пишет его на основе достоверного источника информации владельца политики, используя Claude в качестве помощника. Поместите навык в репозиторий по пути .claude/skills//, чтобы он поставлялся вместе с кодом, или распространите его по всей организации через плагин. Проверьте, что навык срабатывает. Попросите Claude выполнить соответствующую задачу разными способами и убедитесь, что навык загружается каждый раз. При изменении политики измените навык и получите одобрение владельца политики на это изменение. Инженеры автоматически получают новую версию в своей следующей сессии. .claude/skills/secure-api-review/SKILL.md: markdown Навык — это элемент контроля, хотя и рекомендательный. Он делает вероятным применение Claude политики во время написания кода, но ничто не заставляет сессию соблюдать её. Политика, которая должна всегда соблюдаться, требует чего-то детерминированного за навыком, например, hook, который блокирует действие, или этап проверки, который повторно проверяет политику на PR. Навык делает нарушения редкими, а hook делает их почти невозможными. Вызовы навыков логируются в трассировках сессий, и владелец политики просматривает изменения навыков так же, как код.

План урока

1. Начало работы
2. Как это выполнить
3. Как это выглядит
4. Вопросы управления
5. Как это измерить
6. Hooks как защитные механизмы на этапе сборки