Навыки adr-log
📦

adr-log

v1.0 Ревизия содержимого r1 Безопасно ⚙️ Внешние команды🌐 Доступ к сети

Документируйте архитектурные решения с помощью ADR

Команды забывают, почему были приняты важные технические решения. Этот навык помогает составлять, проверять и организовывать ADR с четким контекстом, альтернативами и последствиями.

Поддерживает: Claude Codex Code(CC)
🥉 79 Бронза

Установить с помощью моего Агента

Скопируйте этот запрос в своего Агента. Он содержит каноническую страницу Skill и манифест.

Запрос агента
Review the Skillstore skill "adr-log" from https://skillstore.io/skills/doyajin174-adr-log.md and its manifest at https://skillstore.io/api/skills/doyajin174-adr-log/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.

Ваш Агент по-прежнему должен показать план и запросить все подтверждения, требуемые политикой безопасности.

Ресурсы для AI-агентов

Используйте эти ссылки, когда AI-агенту, crawler или script нужен чистый контекст вместо полной страницы.

Протестировать

Использование «adr-log». Мы выбрали Next.js App Router для нового маркетингового и продуктового сайта.

Ожидаемый результат:

Полный ADR со статусом accepted, контекстом решения, сравнением альтернатив, ожидаемыми преимуществами, компромиссами, рисками и ссылками.

Использование «adr-log». Нашей команде нужна история решений по выбору базы данных и аутентификации.

Ожидаемый результат:

План папки ADR, схема нумерации, структура индекса и чеклист для согласованных будущих записей.

Использование «adr-log». В старом ADR был выбран MongoDB, но теперь продукту требуется более строгая реляционная целостность.

Ожидаемый результат:

Заменяющий ADR, который объясняет изменившийся контекст, сравнивает варианты миграции и фиксирует последствия для команды.

Аудит безопасности

Безопасно

The static command findings are false positives from markdown code fences, inline filenames, and optional CLI examples. The hardcoded URLs are reference links, and the entropy heuristic reflects readable markdown with Korean text, not obfuscation. No prompt injection, data exfiltration intent, or hidden executable behavior was found.

2
Просканировано файлов
480
Проанализировано строк
0
Пункты проверки
0
Ложные срабатывания проигнорированы
Последний завершенный статический и семантический аудит не обнаружил подтвержденных проблем безопасности. Это не доказывает отсутствие побочных эффектов у навыка.
Поделиться и цитировать этот отчет

Делитесь версионным отчетом об оценке, нейтральным значком, встраиваемой карточкой и цитатами. Skillstore публикует доказательства, не решая, безопасен ли этот Skill.

Открыть версионный отчет
Оценка безопасности

Копировать ссылку на отчёт

https://skillstore.io/skills/doyajin174-adr-log/audits/8?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Значок Markdown

[![Skillstore security assessment](https://skillstore.io/badges/skills/doyajin174-adr-log/security.svg)](https://skillstore.io/skills/doyajin174-adr-log?utm_source=security_passport_badge)

Значок HTML

<a href="https://skillstore.io/skills/doyajin174-adr-log?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/doyajin174-adr-log/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

Встраиваемая карточка

<iframe src="https://skillstore.io/embed/skills/doyajin174-adr-log.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>
Академические ссылки (APA · BibTeX · CFF)

Цитата APA

Doyajin174. (2026). adr-log security audit report (audit version 8) [Author version 1.0]. Skillstore. https://skillstore.io/skills/doyajin174-adr-log/audits/8

Цитата BibTeX

@techreport{doyajin174-doyajin174-adr-log-2026, author = {Doyajin174}, title = {adr-log security audit report (audit version 8)}, institution = {Skillstore}, year = {2026}, number = {8}, url = {https://skillstore.io/skills/doyajin174-adr-log/audits/8}, note = {Author version 1.0} }

CITATION.cff

cff-version: 1.2.0 message: "If you use this Skill, cite its author and this versioned security audit report." title: "adr-log security audit report (audit version 8)" version: "1.0" type: report authors: - name: "Doyajin174" date-released: "2026-07-06" url: "https://skillstore.io/skills/doyajin174-adr-log/audits/8" identifiers: - type: other value: "skillstore:doyajin174-adr-log:audit:8" description: "Skillstore immutable audit report identifier"

Оценка Skillstore

Почему такая оценка Достоверность доказательств: Высокий
55
Архитектура
85
Сопровождаемость
87
Контент
70
Сообщество
91
Соответствие спецификации

Что вы можете построить

Фиксировать решения по фреймворкам

Зафиксировать, почему команда выбрала определенный вариант frontend, backend, базы данных или библиотеки вместо альтернатив.

Адаптировать новых инженеров

Создать понятную историю решений, объясняющую прошлые компромиссы новым участникам команды.

Проверять изменения с высоким влиянием

Использовать ADR во время pull request, чтобы документировать решения по инфраструктуре, безопасности или платформе.

Попробуйте эти промпты

Создать базовый ADR
Используй adr-log, чтобы подготовить черновик ADR для выбора PostgreSQL. Включи контекст, альтернативы, решение, последствия, риски и ссылки.
Проверить черновик ADR
Проверь мой черновик ADR на ясность, отсутствующие альтернативы, слабое обоснование и неясные последствия. Предложи конкретные правки.
Создать индекс ADR
Создай индекс ADR для этих решений с номерами, заголовками, статусами, датами и короткими сводками.
Спланировать заменяющий ADR
Проанализируй эти связанные ADR и подготовь черновик нового ADR, который заменяет устаревшее решение. Объясни влияние миграции и оставшиеся риски.

Лучшие практики

  • Пишите ADR вскоре после согласования в команде, пока обоснование еще ясно.
  • Документируйте серьезные альтернативы и компромиссы, а не только итоговый выбор.
  • Используйте новый ADR для замены старых решений вместо того, чтобы незаметно переписывать историю.

Избегать

  • Не используйте ADR для мелких деталей реализации, не имеющих долгосрочного влияния.
  • Не описывайте только выбранный вариант без контекста или отклоненных альтернатив.
  • Не храните решения только в чатах, встречах или комментариях к pull request.

Часто задаваемые вопросы

Что такое ADR?
ADR — это короткий документ, который фиксирует важное архитектурное решение и причину его принятия.
Когда следует использовать этот навык?
Используйте его, когда техническое решение влияет на архитектуру, зависимости, безопасность, эксплуатацию, производительность или долгосрочное сопровождение.
Может ли он создавать для меня файлы ADR?
Он может помочь подготовить содержимое и структуру файлов, если AI-инструменту разрешено редактировать ваше рабочее пространство.
Требует ли он adr-tools?
Нет. Навык включает необязательные примеры adr-tools, но обычных markdown-файлов достаточно для документации ADR.
Могу ли я использовать его с Claude Code или Codex?
Да. В отчете указана поддержка рабочих процессов Claude, Codex и Claude Code.
Как следует изменять старые решения?
Пометьте старый ADR как superseded и создайте новый ADR, который объясняет обновленное решение.

Сведения для разработчиков

Автор

Doyajin174

Лицензия

MIT

Версия автора

v1.0

Ревизия Skillstore

r1

Примечание о версии

Заявленная автором версия не соответствует SemVer.

Ссылка

72d5025b022c77f7a51bdf5c1637c689c80e89d1

Актуальность поддержки

18.07.2026

Использование

4 загрузок · 233 просмотров

Структура файлов

Больше от Doyajin174

Показать все
📦

ml-antipattern-validator

81

Проверка ML-процессов на скрытые антипаттерны

ML-проекты могут выглядеть точными, пока утечка данных или слабая оценка скрывают серьезные недостатки. Этот навык помогает проводить структурированные проверки разбиений, метрик, обучения и готовности к развертыванию.

Данные и аналитика Просмотр
📦

systematic-debugging

79

Систематически отлаживайте проблемы в программном обеспечении

Отладка часто не удается, когда исправления начинаются до того, как понятны факты. Этот навык направляет Claude, Codex и Claude Code через анализ первопричин, сравнение паттернов, проверку гипотез и подтвержденное исправление.

Кодинг и разработка Просмотр
📦

readme-for-developers

79

Создавайте README-файлы для онбординга разработчиков

Новые участники часто теряют время на поиск шагов настройки, архитектурного контекста и правил владения. Этот навык превращает факты о проекте в структурированный README, который помогает с онбордингом, отладкой и поставкой.

Документация Просмотр
📦

structured-logging

78

Реализовать структурированное логирование

Обычные текстовые логи сложно искать и сопоставлять. Этот навык помогает реализовать JSON-логирование, контекст запроса, редактирование чувствительных данных и поля, готовые для агрегации.

DevOps и инфраструктура Просмотр
Показать все
📦

project-planner

86

Планируйте программные проекты с помощью структурированных документов

от Dwsy

Программные проекты часто терпят неудачу, когда требования, проектные решения и задачи неясны. Этот навык превращает идеи проектов в структурированные плановые документы для рабочих процессов Claude, Codex и Claude Code.

Документация Просмотр
📦

github-release-assistant

83

Генерация двуязычной документации для релизов GitHub

от ZhanlinCui

Создание качественной документации для релизов требует времени и согласованности между языками. Этот навык автоматизирует генерацию двуязычных README-файлов на основе существующих метаданных репозитория.

Документация Просмотр
📦

skill-creation-guide

81

Создание эффективных ИИ-навыков

от notedit

Командам нужны воспроизводимые рекомендации для создания полезных ИИ-навыков без добавления ненужного контекста. Этот навык предоставляет структурированный процесс для планирования, написания, проверки и упаковки навыков.

Документация Просмотр