AIKraft/AI/Войти
AIKraft/Skills/Записи решений

Записи решений

Draft, promote, archive, and supersede ADR-style decision records (types are open: architecture, product, security, policy, legal, …) and keep INDEX.md and cross-links generated, via the bundled scripts/decisions.py tool. Use when creating or promoting decision drafts, superseding or archiving a decision, fixing a promotion breach, or running build, check, promote, rename-draft-id, or install.

skymavis official Разработка

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

Навык управляет реестром записей решений (Decision Records) в стиле ADR, обеспечивая создание черновиков, их продвижение (promote), архивацию и замену (supersede). Он автоматизирует генерацию INDEX.md и поддержание перекрёстных ссылок через инструмент scripts/decisions.py.

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

  • Создание или продвижение черновиков решений в статус accepted.
  • Замена устаревшего решения или архивация записи.
  • Исправление нарушения процесса промоушена (promote).
  • Запуск сборки (build), проверки (check) или установки (install) инструмента.

Как работает

  1. Выполнить python scripts/decisions.py install для настройки симлинков и проверки CI.
  2. Использовать python scripts/decisions.py build для регенерации INDEX.md и обновления ссылок.
  3. Применить python scripts/decisions.py check для валидации записей (безопасно для CI).
  4. Запустить python scripts/decisions.py promote для перевода черновиков в статус accepted.
  5. Использовать python scripts/decisions.py rename-draft-id для переименования черновика.
  6. Применить python scripts/decisions.py migrate-layout для конвертации старой структуры в плоскую.

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

Запусти скрипт decisions.py для сборки INDEX.md и обновления ссылок.
Промоутиь черновик решения draft-001 в статус accepted.
Выполни проверку валидности записей решений через decisions.py check.

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

  • Python-скрипт scripts/decisions.py, симлинкованный в репозитории.
  • Директория docs/decisions/, где хранятся записи решений.

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

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

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

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