Перейти к основному содержимому

Напишите свой первый навык от начала до конца

Средний

Давайте соберём рабочий навык с нуля и докажем, что он активируется. Мы сделаем небольшой навык «запись в чейнджлог» — универсальный и переиспользуемый.

Шаг 1 — Создайте папку​

mkdir -p .claude/skills/changelog-entry

(Используйте ~/.claude/skills/… для личного навыка во всех проектах.)

Шаг 2 — Напишите SKILL.md​

.claude/skills/changelog-entry/SKILL.md:

---
name: changelog-entry
description: Use when the user wants to turn recent git commits into a Keep a Changelog entry.
---

# Changelog Entry

When asked for a changelog entry:
1. Run `git log --oneline -20` to see recent commits.
2. Group them into Added / Changed / Fixed / Removed (Keep a Changelog style).
3. Write concise, user-facing bullets (not raw commit messages).
4. Output only the formatted entry.

description — это триггер: пишите его в формате «Use when…», чтобы Claude загружал навык в нужный момент.

Шаг 3 — (Необязательно) добавьте вспомогательный скрипт​

Навыки могут поставляться со скриптами. Добавьте scripts/recent.sh и сошлитесь на него из SKILL.md, если хотите детерминированный сбор данных:

#!/usr/bin/env bash
git log --oneline -20

Шаг 4 — Докажите, что он срабатывает​

Начните сессию и скажите: «Набросай запись в чейнджлог по недавней работе.» Claude должен распознать намерение, загрузить навык и выполнить его шаги. Если он не активируется, ваше description, вероятно, недостаточно конкретно описывает, когда его использовать, — уточните его.

Шаг 5 — Поделитесь им​

Соберите его (вместе с другими) в плагин, чтобы ваша команда установила его в один шаг, — или внесите его в наборы навыков AILmanac.

Подводные камни​

  • Расплывчатое описание → никогда не срабатывает (или срабатывает всегда). Будьте конкретны.
  • Слишком много в одном навыке → пусть он делает одну понятную работу.
  • Секреты в общем навыке → никогда; см. Проверка стороннего кода.

Дальше​