AIKraft/Skills/docs-governance

docs-governance

Направляет широкие запросы по управлению документацией в существующие навыки ECC и выполняет аудит ролей, ссылок, ADR и доказательств. Используйте, когда пользователь просит организовать проектную базу знаний или провести аудит целостности документации.

affaan-m official Документы ★ 280.5k

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

Направляет широкие запросы по управлению документацией в существующие навыки ECC и выполняет аудит ролей, ссылок, ADR и доказательств. Не создаёт параллельную систему управления проектами и не делает документацию авторитетнее кода или решений мейнтейнеров.

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

  • Пользователь просит организовать проектную базу знаний или упорядочить документацию.
  • Запрос охватывает несколько ролей документации, и владелец неясен.
  • Требуется детерминированный аудит целостности документации (read-only).
  • Проект должен обнаружить существующие источники документации перед добавлением файлов.

Как работает

  1. Определить существующие поверхности инструкций и документации в репозитории.
  2. Разрешить логические роли через контракт artifact-role, используя установленные источники истины.
  3. Выбрать наименьшую подходящую возможность из таблицы маршрутизации (например, living-docs-governance или architecture-decision-records).
  4. При запросе аудита разрешить директорию выбранного навыка и запустить скрипт audit-docs.py с нужным scope.
  5. Сообщить о сбоях, предупреждениях и пробелах в ответственности без изменения состояния проекта.

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

"Организуй нашу долгосрочную документацию проекта"
"Зафиксируй, почему мы выбрали PostgreSQL"
"Проверь, целы ли ссылки в документации и индекс ADR"

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

  • Python 3
  • Репозиторий с документацией и историей Git
  • Скрипт scripts/audit-docs.py внутри директории навыка

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

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

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

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