AIKraft/Skills/Документ

Документ

Run /document `pr` | `changelog` | `release-note` | `postmortem` (or let it ask) to write the human facing prose about a change. Drafts from the real commits and diff, writing to the right place. Does not write code, tests, or specs.

javascript-mastery-pro official Документы

Что делает навык

Навык генерирует технические документы на основе реальных изменений в коде, таких как коммиты, diff или описание инцидентов. Он создает понятные тексты для разных аудиторий, строго опираясь на факты из истории изменений без выдумок.

Когда применять

  • Написание заголовка и тела Pull Request для ревьюеров
  • Добавление записи в CHANGELOG.md для разработчиков
  • Создание заметки о выпуске (release-note) для конечных пользователей
  • Подготовка документа postmortem для команды после инцидента

Как работает

  1. Агент определяет тип документа (pr, changelog, release-note, postmortem) и целевую аудиторию
  2. Собирает исходные данные: коммиты ветки, diff против базовой версии, merged изменения или описание инцидента
  3. При необходимости использует подагента scout на модели Claude Code: haiku для чтения больших diff
  4. Формулирует текст, опираясь только на зафиксированные факты, избегая выдуманных временных меток или причин
  5. Выводит результат в чат или записывает в соответствующий файл (например, CHANGELOG.md или docs/releases/<version>.md)
  6. Использует простой язык, обращаясь к читателю как к коллеге, и избегает дефисов в пунктуации

Примеры запросов агенту

/document pr
/document changelog
/document postmortem

Что понадобится

  • Доступ к истории коммитов и diff кода
  • Доступ к файловой системе для записи в CHANGELOG.md, docs/releases/ и docs/postmortems/
  • Возможность вызова подагента на модели Claude Code: haiku для больших diff

Описание составлено по SKILL.md навыка, сверено 05.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «document» из репозитория: # https://github.com/javascript-mastery-pro/skills
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r document/ ~/.claude/skills/document/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.