AgentSkillsCN

update-ai-setup

扫描项目中的AI文件，并将最新数据更新至registry/docs/ai-setup.md。在新增或删除技能、模式或配置后，用于同步注册表。请勿从零开始创建注册表——应手动创建docs/ai-setup.md。

SKILL.md
--- frontmatter
name: update-ai-setup
description: Сканирует AI-файлы проекта и обновляет реестр docs/ai-setup.md с актуальными данными. Используй для синхронизации реестра после добавления/удаления скиллов, паттернов или конфигов. Не используй для создания реестра с нуля — для этого создай docs/ai-setup.md вручную.
allowed-tools: "Read Write Edit Glob Grep Bash(wc*) Bash(ls*)"
agent: agents/auditor.md
context: fork

/update-ai-setup — Обновление реестра AI-конфигурации

<purpose> Автоматическое обновление docs/ai-setup.md — реестра всех AI-паттернов, скиллов и конфигурационных файлов проекта. Сканирует реальное состояние файлов и синхронизирует реестр. </purpose>

Перед началом

Прочитай .claude/qa_agent.md и .claude/agents/auditor.md.

Когда использовать

  • •После добавления/удаления скилла
  • •После изменения qa_agent.md, agents/*.md или CLAUDE.md
  • •После добавления/удаления анти-паттернов
  • •После изменения плагинов в .claude/settings.json
  • •После изменения MCP серверов в .mcp.json
  • •Периодическая проверка актуальности реестра

Входные данные

Не требуются. Скилл работает автоматически на основе текущего состояния файлов.

Алгоритм

Verbosity Protocol

Structured Output Priority: Весь analysis идёт в артефакт (MD/HTML), не в чат.

Chat output (ограничения):

  • •Brief Summary: max 5 строк (что нашли, сколько, итог)
  • •Findings table: max 15 строк (топ по severity)
  • •Полный отчёт: 📊 Полный отчёт: {path} + открыть файл

Iterative steps: Не выводить прогресс по каждому файлу. Checkpoint только при:

  • •Phase transition (Фаза N → Фаза N+1)
  • •Предупреждение обнаружено
  • •Завершение (SKILL COMPLETE)

Tools first:

  • •Grep → table → report, без "Now I will grep..."
  • •Read → analyze → report, без "The file shows..."

Post-Check: Inline перед SKILL COMPLETE (5-7 строк checklist), не отдельный файл.

Шаг 1: Чтение текущего реестра

Прочитай docs/ai-setup.md. Если файл не существует:

code
⚠️ WARNING: docs/ai-setup.md не найден — создаю новый файл.

Скилл создаёт пустой реестр на основе шаблона .claude/skills/init-skill/references/skill-template.md и продолжает сканирование.

Запомни текущие данные: список файлов, строки, количество паттернов, скиллов, анти-паттернов.

Шаг 2: Сканирование файлов

Выполни Glob по всем AI-файлам:

code
Обязательные:
  - CLAUDE.md
  - .claude/qa_agent.md
  - .claude/settings.json
  - .mcp.json
  - .claude/skills/*/SKILL.md
  - .claude/qa-antipatterns/_index.md
  - .claude/qa-antipatterns/*/*.md
  - .claude/skills/*/references/*
  - docs/ai-files-handbook.md
  - docs/ai-setup.md

Для каждого найденного файла подсчитай строки через wc -l.

Шаг 2b: Сканирование плагинов и MCP серверов

  1. •Прочитай .claude/settings.json → извлеки ключи из enabledPlugins
  2. •Прочитай .mcp.json → извлеки ключи из mcpServers
  3. •Сравни с таблицами "Плагины" и "MCP серверы" в docs/ai-setup.md
  4. •Дельта: добавить новые / удалить отсутствующие / обновить изменённые строки

Шаг 3: Обнаружение дельты

Сравни результаты сканирования с текущим реестром:

ПроверкаДействие
Новый файл (есть на диске, нет в реестре)Добавить в соответствующую таблицу
Удалённый файл (есть в реестре, нет на диске)Удалить из таблицы
Изменение размера > 20%Обновить счётчик строк
Новый скиллДобавить в таблицу скиллов + проверить CLAUDE.md
Новый анти-паттернДобавить в таблицу анти-паттернов

Если дельты нет — сообщи пользователю и заверши:

code
✅ Реестр актуален. Изменений не обнаружено.

Шаг 4: Обновление документа

Обнови docs/ai-setup.md:

  1. •Диаграмма архитектуры — обновить счётчики строк в слоях
  2. •Таблицы инвентаризации — добавить/удалить строки, обновить счётчики
  3. •Каталог паттернов — добавить новые паттерны (если обнаружены), обновить ссылки

Формат записи Changelog:

markdown
| YYYY-MM-DD | [Описание: что добавлено/удалено/обновлено] |

Шаг 5: Валидация и показ diff

Перед сохранением:

  1. •Проверь Quality Gates (см. ниже)
  2. •Покажи пользователю список изменений:
code
📊 DELTA REPORT
├─ Добавлено: [N файлов/паттернов]
├─ Удалено: [N файлов/паттернов]
├─ Обновлено: [N счётчиков строк]
├─ Health Metrics: [обновлено / нет данных]
└─ Changelog: [краткое описание записи]
  1. •Сохрани обновлённый docs/ai-setup.md

Формат вывода

code
✅ SKILL COMPLETE: /update-ai-setup
├─ Артефакты: docs/ai-setup.md
├─ Дельта: [+N добавлено, -N удалено, ~N обновлено | "нет изменений"]
├─ Quality Gates: PASS
└─ Changelog: [краткое описание]

Quality Gates

  • • Все пути в документе существуют на диске (проверить Glob)
  • • Счётчики строк совпадают с wc -l
  • • Нет placeholder'ов [xxx] в финальном документе
  • • Changelog содержит новую запись с текущей датой
  • • Количество скиллов в реестре = количеству .claude/skills/*/SKILL.md
  • • Количество анти-паттернов в реестре = количеству .claude/qa-antipatterns/*/*.md (файлы в подпапках, без _index.md)
  • • Количество плагинов в таблице = количеству ключей в settings.json → enabledPlugins
  • • Количество MCP серверов в таблице = количеству ключей в .mcp.json → mcpServers

Связанные файлы

  • •Реестр: docs/ai-setup.md
  • •Гайд: docs/ai-files-handbook.md
  • •Шаблон skill: .claude/skills/init-skill/references/skill-template.md