docs-governance — скилл

Плагин помогает агенту поддерживать документацию проекта, решения и результаты проверок между сессиями

  • 325 ★ репозитория
  • Последний коммит
  • MIT
Скилл

Расширенный доступ

Почему такой уровень

  • Режим настройки может менять документацию и файлы инструкций агента в подтвержденной области.
  • Отдельно включенные проверки могут добавлять хуки проекта.
Все причины и проверки

qshanx/docs-governance

Установка

Работает в

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/docs-governance

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Режим настройки может менять документацию и файлы инструкций агента в подтвержденной области.
  • Отдельно включенные проверки могут добавлять хуки проекта.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

docs-governance дает агенту сценарии для проверки и поддержки документации долгого проекта. Первичная проверка читает существующие материалы и предлагает небольшой следующий шаг. При настройке агент находит действующие правила, добавляет ссылки на нужные документы и записывает текущее состояние проекта. Отдельные скиллы разбирают архитектуру, договоренности между модулями и влияние правки на соседние части системы. После выполненной задачи агент может найти затронутые документы и обновить их по фактическому коду, сохранив различие между планом и реализованным поведением.

Для кого. Для команд, которые передают проект между сессиями и агентами и хотят сохранять причины решений вместе с кодом.

Подходит, если

  • Новый агент каждый раз заново ищет правила проекта
  • Документы расходятся с кодом после изменения интерфейса
  • Нужно проверить источники и повторы в документации
  • После задачи нужно обновить материалы для следующей сессии

Не подходит, если

  • Нужен трекер задач вместо GitHub Issues или Linear
  • Нужна автоматическая гарантия актуальности текста
  • Нужно установить обязательные хуки без настройки проекта

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

Проведи аудит документации только на чтение. Покажи устаревшие ссылки и предложи одно небольшое исправление.

Ограничения

Обычная работа опирается на Markdown, а дополнительный индекс SQLite можно перестроить; базу не нужно делать главным источником проекта. Настройка сначала подтверждает область файлов, поэтому существующие договоренности нужно показать агенту до правок. Хуки и проверки Git включаются отдельно через конфигурацию проекта и сами при установке не появляются. Скрипты проверяют структуру и ссылки, но смысловые расхождения с кодом должен разбирать агент по фактическим изменениям.

Как отключить. Отключите плагин и удалите только добавленные им ссылки из инструкций проекта. Отдельно настроенные хуки отключайте в конфигурации проекта.

Частые вопросы

Как запустить первую проверку?

В Claude Code вызовите `/governance-audit`. Первым результатом будет отчет.

Настройка создает коммит?

Нет. Настройка сама не инициализирует Git, не создает коммит и не отправляет изменения.

Можно использовать готовую спецификацию?

Да. Существующие PRD и спецификации сохраняют статус основных источников.

Как вызвать аудит в Codex?

Попросите `$docs-governance` проверить текущий проект в режиме чтения.

Нужно создавать все предлагаемые документы?

Нет. Настройка переиспользует существующие источники и ограничивается согласованной областью.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы

Многоагентный генератор документации: анализирует репозиторий и собирает README и конфиги для ИИ-ассистентов

ПлагинРасширенный доступ769Звезды репозитория

Repo Docs Skills

repo-docs-skills

Живая документация проекта для агентов: пошаговые руководства, понятия и справка по реальным запускам рядом с исходниками

СкиллРасширенный доступ422Звезды репозитория

Маркетплейс из пяти плагинов Claude Code для исследователя: литература, дизайн исследования, память проекта и рукопись

ПлагинШирокий доступ604Звезды репозитория

Скилл рисует проверенные схемы архитектуры, процессов, последовательностей и потоков данных в один интерактивный HTML-файл

СкиллРасширенный доступ93,9 тыс.Звезды репозитория
Официальный

CLI и скилл: агент публикует отчеты как HTML-документы, команда их комментирует, а каждая версия сохраняется

CLIРасширенный доступ410Звезды репозитория

Скилл и программа docx: агент заполняет формы, правит таблицы и ведет рецензирование Word с отслеживаемыми правками

СкиллРасширенный доступ241Звезды репозитория

Коротко о README

Проект разделяет постоянные правила, навигацию и текущее состояние. Для истории используется существующий порядок проекта, а задачи остаются в его трекере.

Бейдж для README

Исходный SKILL.md

---
name: docs-governance
description: >-
  作为面向长期 AI 协作项目的知识、决策与验证治理总入口,把优秀 Agent 的一次性工作沉淀为可继承、可验证、可持续演进的项目集体能力;根据用户意图把任务路由到活文档、领域上下文与 ADR、变更影响、接口契约、测试资产、模块回归或闭环设计能力,并在大型变更中组织正确顺序。用于用户只说“文档治理”“项目治理”“帮我整理项目知识”“改完怎么收尾”而未指定具体 Skill,或需要跨多项治理能力时。English triggers: docs governance router, project knowledge governance, documentation workflow, governance workflow.
---

# 文档治理总路由

## 定位

> **把优秀 Agent 的一次性工作,沉淀为项目可继承、可验证、可持续演进的集体能力。**

本插件不是让 Agent 多写文档,而是治理长期 AI 协作中的项目知识、关键决策与验证证据:让后续 Agent 能恢复上下文、沿用已确认约束、复核结果,并把新的有效做法继续沉淀回项目。

先判断意图,再读取并执行对应 Skill。不要在本路由复制各 Skill 的方法论。

## 单项路由

| 用户意图 | 路由到 |
|---|---|
| 新建核心模块、补齐模块文档或维护模块约定,无须点名 Skill | `module-governance`;讨论只读,普通 Bug/样式不启动建档 |
| 审计核心模块知识入口覆盖 | `docs-audit`,仅报告;边界核对使用 `architecture-docs` |
| 检查治理规则应放在入口、Skill、附件、脚本还是 Hook,识别散落的可复用工作流 | `agent-workflow-governance`,默认只读交付证据与建议 |
| 采集项目健康证据、核对验证入口与 CI 衔接 | `living-docs-governance` 的“项目健康证据采集” |
| 编写或优化 Skill、Agent 入口及 AI 读取的文档 | `writing-for-agents`;事实核对仍走审计流程 |
| 规划、整理或只读审查文档目录、归属与读取入口 | `docs-structure` |
| 生成、精简或审查 AGENTS.md / CLAUDE.md,明确项目规范和产品读取入口 | `agent-entrypoints` |
| 产品文档管理员、来源登记、需求池/编号/版本、十阶段管理与产品审查 | `product-evolution`;Claude Code 可由 `product-docs-manager` 执行 |
| 新项目、讨论后项目或已有项目首次配置产品文档包与 Agent 入口 | `living-docs-governance` 的“统一 setup”模式;Claude Code 使用 `/governance-setup`,`/governance-init` 是兼容别名 |
| 本次改动后的文档同步、整理、收尾或交接 | `docs-maintenance` |
| 从对话、文档变更与审计记录复盘文档管理经验 | `docs-retro` |
| LOG 管理或复盘 | `living-docs-governance` |
| 是否需要架构文档,生成、完善或审查模块分工、状态归属、依赖与核心流程 | `architecture-docs` |
| 领域术语、`CONTEXT.md`、架构或数据库决策、ADR | `domain-modeling`(Matt 原文与本地适配);`context-and-decisions` 仅兼容旧调用 |
| 修改前判断牵连面、迁移、回滚、实施后对照 | `change-impact` |
| 前后端或服务间接口 | `contract-first` |
| 测试资产盘点、重要覆盖缺口或契约证据 | `test-collaboration` |
| 修改后验证本模块及下游 | `module-regression` |
| 文档散乱、导航、时效、重复主源与当前/历史区分的只读审计 | `docs-audit` |
| 指定 spine/context/adr/artifacts/full 的兼容审计 | `living-docs-governance` 的审计模式 |

Сообщить о проблеме

Foxx AIdocs-governance
Foxx AI

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.