AIKraft/Skills/verify-openspec-docs

verify-openspec-docs

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

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

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

Навык проверяет достоверность документации OpenSpec, сверяя утверждения с исходным кодом и README. Он используется для валидации точности страниц или разделов после их написания.

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

  • Проверка точности конкретной страницы документации перед публикацией.
  • Верификация одного раздела (## section) документации.
  • Проверка списка измененных утверждений (changed claims).
  • Запуск проверки по запросу пользователя вне сессии черновика.

Как работает

  1. Подтвердить цель проверки: страницу, раздел или список утверждений; если цель не указана, запросить её у пользователя.
  2. Прочитать README в корне дерева документации, содержащего целевой раздел, так как его инварианты и карта страниц подлежат проверке.
  3. Создать одного субагента на каждую единицу (один раздел или список утверждений).
  4. Запустить субагентов параллельно, передав им абсолютные пути к файлам, так как субагенты не наследуют навыки.
  5. Назначить субагентам роль скептического разработчика и фактчекера, проверяющего документацию по исходному коду.

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

Проверь достоверность раздела 'Installation' в документации OpenSpec.
Запусти верификацию страницы 'API Reference' против исходного кода.
Проверь утверждения в списке изменений для раздела 'Configuration'.

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

  • Доступ к репозиторию и файловой системе для чтения README и исходного кода.
  • Возможность запуска субагентов (general-purpose subagent).

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

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

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

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