Это базовый слой набора навыков технического письма, загружаемый при написании текстов в репозитории объемом более одного абзаца, таких как спецификации, проектные документы, README-файлы и отчеты. Перед началом работы необходимо прочитать аналогичные документы в той же директории и зафиксировать тип документа, целевую аудиторию, цель и границы охвата. Жесткие правила включают запрет на трактовку непроверяемых фактов как истинных, запрет на включение журналов изменений в документацию и принцип «только добавление» для уже принятых решений (без их переписывания). В том же репозитории доступны специализированные навыки для проектных документов, журналов изменений, руководств по эксплуатации, разборов инцидентов, справочников API и рецензирования.
Почему это важно Перед началом работы определите тип документа: для нормативных документов код не должен изменять документацию, а исторические записи не должны переписываться. Это предотвращает ситуацию, когда агент меняет установленные соглашения ради «синхронизации с кодом».
Аудит безопасности: не проводился
- Сканирование не выполнялось
Обоснование
- Установок через skills.sh за 24 часов: 417 (отражает только уровень интереса); лицензия MIT
- Файл SKILL.md прочитан из репозитория: содержит только правила написания текста, не выполняет команд и не подключается к сети
Использование
- После установки попросите агента написать или изменить документацию в репозитории; при работе с конкретным типом документа загрузите соответствующий специализированный навык, а перед сдачей результата проведите проверку с помощью reviewing-technical-prose
Риски
- Автоматический аудит на стороне клиента не проводился, на сайте не отображается команда установки
- Правила составлены на английском языке, и часть списков запрещенных терминов применима только к англоязычной документации