AIKraft/Skills/Разработка

Разработка

Generate comprehensive technical documentation for developers taking over an AEM Edge Delivery Services project. Analyzes codebase structure, custom implementations, design tokens, and produces a complete developer guide.

adobe official Дизайн

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

Skill генерирует полное техническое руководство для разработчиков по проекту AEM Edge Delivery Services, анализируя структуру кодовой базы, кастомные реализации, дизайн-токены и конфигурацию. Результатом является файл DEVELOPER-GUIDE.pdf в директории project-guides, позволяющий новым или поддерживающим разработчикам понять, поддерживать и расширять проект.

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

  • Онбординг новых разработчиков в проект AEM Edge Delivery Services
  • Техническая передача проекта (handover) команде поддержки
  • Документирование архитектуры и кода для ревью
  • Создание документации, ориентированной на разработчиков

Как работает

  1. Получить и сохранить имя организации Config Service, затем перейти в корень Git-репозитория и убедиться, что это проект Edge Delivery Services (наличие scripts/aem.js)
  2. Собрать информацию о проекте: извлечь URL репозитория, ветку, метод конфигурации и получить список сайтов через API Config Service (admin.hlx.page/config/{ORG}/sites.json)
  3. Проанализировать архитектуру: изучить структуру папок (blocks, scripts, styles), определить кастомные файлы по истории коммитов (исключая boilerplate и автогенерацию aem-aemy[bot])
  4. Документировать систему блоков, моделей, шаблонов, дизайн-токены и кастомные функции в scripts/scripts.js (loadEager, loadLazy, decorateMain и др.)
  5. Сгенерировать markdown-файл DEVELOPER-GUIDE.md в директории project-guides с YAML-преамбулой и немедленно конвертировать его в PDF

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

Сгенерируй техническое руководство для разработчиков по текущему проекту AEM
Создай документацию по передаче проекта команде поддержки
Подготовь гайд для онбординга новых разработчиков в наш Edge Delivery Services проект

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

  • Доступ к Config Service API (требуется IMS-токен)
  • Наличие файла scripts/aem.js в корне проекта
  • Инструмент Bash для выполнения команд навигации и анализа git

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

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

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

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