AIKraft/AI/Войти
AIKraft/Skills/write-openspec-docs

write-openspec-docs

Переключает ИИ-агента в режим написания документации OpenSpec, загружая гайд по стилю и редактируя страницы в требуемом формате. Используйте при создании или правке страниц в дереве документации OpenSpec.

FIFission official Документы ★ 71.1k

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

Навык переключает ИИ-агента в режим написания документации OpenSpec, применяя строгие правила стиля из файла writing.md. Он обеспечивает создание страниц, оптимизированных для быстрого поиска информации (retrieval surface), с четкой структурой и лаконичным текстом. Используется для создания или редактирования страниц в дереве документации OpenSpec.

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

  • Создание новой страницы документации в формате OpenSpec.
  • Редактирование существующей страницы для улучшения её структуры и читаемости.
  • Проверка документации на соответствие требованиям извлечения информации (retrievability).
  • Преобразование сложного текста в формат «один факт — одна строка/список».

Как работает

  1. Прочитать файл writing.md, чтобы принять его как единственный источник истины для стиля.
  2. Выбрать тип страницы: Guide (для задач пользователя) или Reference (для структуры продукта и точных имен полей/команд).
  3. Составить краткий черновик, используя простые предложения (подлежащее, сказуемое, дополнение) без хайпа и вводных слов.
  4. Применить правило «одна задача на слот»: один факт на предложение, отдельные блоки для каждого понятия.
  5. Обеспечить наличие якорей для сканирования (code fence, жирный заголовок, таблица, список) для каждого ключевого факта.
  6. Провести финальную проверку: убедиться, что вопросы и имена продуктов находятся при беглом сканировании, и оценить визуальную завершенность страницы.

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

Напиши страницу документации для OpenSpec по файлу writing.md, следуя правилам стиля.
Отредактируй раздел справки, чтобы каждый факт был отделен и имел явный якорь для поиска.
Создай руководство (Guide) по выполнению задачи, используя короткие предложения и нумерованные шаги.

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

  • Доступ к файлу writing.md (стилевой гайд)

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

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

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

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