AIKraft/AI/Войти
AIKraft/Skills/adev-writing-guide

adev-writing-guide

Подробное руководство по написанию документации Angular (adev). Включает стандарты Google Technical Writing, расширения markdown и работу с кодом. Обязательно к использованию при создании, редактировании или рецензировании файлов в `adev/` и `adev/src/content`.

ANangular official Документы ★ 101k

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

Навык предоставляет комплексные руководства по созданию контента в директории adev/src/content, объединяя стандарты технического письма Google с Angular-специфичными соглашениями markdown. Он обеспечивает соблюдение единых стандартов качества, тональности и структуры при написании документации.

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

  • Создание новых файлов документации в директории adev/src/content.
  • Редактирование существующих материалов для соответствия стандартам Angular.
  • Рецензирование контента на предмет соблюдения правил тональности и грамматики.
  • Проверка использования Angular-специфичных компонентов и расширений markdown.

Как работает

  1. Применять дружественный, но профессиональный тон, избегая излишней неформальности.
  2. Обеспечивать доступность текста для глобальной аудитории, включая носителей неанглийских языков.
  3. Фокусироваться на потребностях пользователя (что нужно сделать), а не только на функциях системы.
  4. Использовать описательный текст для ссылок, избегая фраз вроде 'click here'.
  5. Не упоминать нерелизные функции и не делать необоснованных утверждений.
  6. Соблюдать Angular-специфичные соглашения markdown и использовать соответствующие компоненты.

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

Напиши раздел документации для новой директивы в adev/src/content, соблюдая стандарты Google Technical Writing.
Проверь этот текст на соответствие правилам тональности и доступности для документации Angular.
Отредактируй существующую статью в adev/, заменив неинформативные ссылки на описательные.

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

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

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

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