К основному содержанию
скилл CX Codex официальный · Google

egm-drift-report — скилл для Claude Code: поиск расхождений

Скилл egm-drift-report для Claude Code сверяет дизайн-документы и README с кодом. Запускается по явному запросу на поиск расхождений или проверку согласованности файлов в каталоге.

Apache-2.0 583 установок ★ 21 935 обновлён 2026-11-15

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add google/elephant-goldfish-model --skill egm-drift-report -a claude-code
Открыть на GitHub

Что делает egm-drift-report

Скилл сравнивает дизайн-документы и README с текущим кодом и собирает найденные расхождения в один отчёт. Он проверяет пропущенные функции и поля моделей, жёстко заданные значения вместо запланированной логики, а также отличия в архитектуре и библиотеках. В отчёт попадают только различия; если документ совпадает с кодом, для него указывается No drift detected.

Скилл последовательно обрабатывает файлы и дописывает результат в {YYYY-MM-DD}_DRIFT_REPORT.md, по отдельной секции на каждый документ. Для поиска исходников он использует названные в документе файлы и символы, а если явных путей нет — поиск по коду. Автоматический вызов отключён: проверку запускают явной просьбой.

Какие задачи решает

  • найти функции из документа, которых нет в коде
  • сверить поля классов и структур с проектной спецификацией
  • обнаружить жёсткие значения вместо описанной динамической логики
  • выявить расхождения между README и реализацией

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

  • Найди расхождения между всеми дизайн-документами в этом каталоге и кодом.
  • Проверь README в каталоге на соответствие текущей реализации.
  • Сверь дизайн-документы с исходниками и запиши найденные различия в отчёт.

Как установить egm-drift-report

1Через Skills CLI (Vercel)

npx skills add google/elephant-goldfish-model --skill egm-drift-report -a claude-code

2Вручную: положить файлы

~/.claude/skills/egm-drift-report/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/egm-drift-report/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об egm-drift-report

Как установить egm-drift-report в Claude Code?

Выполни npx skills add google/elephant-goldfish-model --skill egm-drift-report -a claude-code. Скилл устанавливается в ~/.claude/skills/egm-drift-report/SKILL.md.

Что делает egm-drift-report?

Скилл сопоставляет дизайн-документы и README с текущим кодом, затем записывает только обнаруженные расхождения в {YYYY-MM-DD}_DRIFT_REPORT.md.

Вызывается ли egm-drift-report автоматически?

Нет. Автоматический вызов отключён, поэтому проверку запускают явной просьбой найти расхождения или проверить согласованность документов и кода.

Исходный текст

SKILL.md · Apache-2.0
---
name: egm-drift-report
license: Apache-2.0
disable-model-invocation: true
description: >-
  Runs drift detection on all design documents to check for document and
  code consistency. Produces an actionable report with differences. Use when the
  user asks to detect drift or check for consistency across all design documents
  or READMEs in a directory.
---

# Detect Drift In Designs and Code

When running in Codex or ChatGPT Work, first read [Codex integration](../../docs/codex.md).
In Claude Code or Cowork, read `${CLAUDE_PLUGIN_ROOT}/docs/claude.md` first.

When the user asks to detect drift across all designs or a set of READMEs, the
goal is to identify all instances where the codebase has diverged or failed to
implement the specifications described by those designs or READMEs.

1.  **Check Input**: Verify a directory containing design documents or READMEs
    is provided. If not provided, ask the user to specify the target directory.
2.  **List Documents**: List all files in the design directory.
3.  **Analyze**: For EACH design document:

    *   **Contextualize**: Read the design document. Identify the intent,
        proposed changes, and specific filenames/symbols mentioned.
    *   **Locate Source**: Find the corresponding source code files in the
        source tree. If paths aren't explicit, use code search or grep to
        locate the relevant classes, functions, or API endpoints mentioned in
        the doc. Prompt the user to add missing links to the document to make
        future detection cheaper.
    *   **Verify**: Read the current state of those source files.
    *   **Detect Drift**: Compare the design vs. reality. Look specifically for:
        *   Missing Features: Logic described in the doc but absent in the code.
        *   Incomplete Models: Dataclasses/Classes/Structs/Protos missing fields
            specified in the design.
        *   Logic Shortcuts: Hardcoded values where dynamic logic was planned.
        *   Architectural Divergence: Implementation using different
            patterns/libraries than proposed.
    *   **Filter**: Report ONLY the differences. Do not describe what is working
        or what matches. If the code matches the design perfectly, output "No
        drift detected."

4.  **Report**: Produce a single report listing all discrepancies found.

    *   Append the analysis for each file to `{YYYY-MM-DD}_DRIFT_REPORT.md`
        using your file-writing tool.
    *   Strict Format:

        ```markdown
        ## <DESIGN_DOC_NAME>

        <Bulleted list of specific divergences found>
        <Or "No drift detected">
        ```

5.  **Guidance**

    -   Be rigorous. If a design doc mentions a specific object, field or file
        name and the code doesn't have it, that is a reportable drift. Double
        check for coverage. If there is some part of the logic that is not
        referenced in a design or README, this is a reportable drift.
    -   Read files liberally to ensure you are looking at the current state
        of the code, not relying on memory.
    -   Process the files sequentially to ensure the tool output buffer doesn't
        overflow.

© google · Apache-2.0 · google/elephant-goldfish-model

Похожие скиллы

Все скиллы по теме «Тексты и документация» →
rfc-generator patricio0312rev Скилл rfc-generator собирает RFC по техническому предложению: проблема, решение, альтернативы, риски и план внедрения по готовому шаблону, а не с чистого листа. CX Codex +1 294установок indexion-documentation trkbt10 Скилл indexion-documentation оценивает покрытие документации, ищет расхождения между кодом и доками и рисует граф зависимостей. CX Codex +1 5 000установок doc-gen ruvnet Скилл doc-gen генерирует документацию по кодовой базе, находит расхождения между кодом и текстами, а также запускает фоновые проверки по расписанию. Пригодится при частых изменениях в API. CX Codex +1 744установок design-docs ZaxbyHub Ведёт design-доки проекта: домен, техспеку, behavior-спеку, реестр section-ID и changelog. Запускается по заголовку [MODE: DESIGN_DOCS ...]. CX Codex +1 ★ 539звёзд репо merge-docs serpro69 Скилл merge-docs для Claude Code объединяет дизайн, план реализации и список задач из двух проработок одной фичи в один набор документов. Решает расхождения по коду проекта. CX Codex +1 ★ 155звёзд репо docs-drift-editor VoltAgent Community Субагент docs-drift-editor обновляет Markdown-страницы, которые разошлись с кодом, и не выдумывает команды и ссылки, которых нет в диффе. CX Codex ★ 26 718звёзд репо

Из того же набора7

egm-review Скилл egm-review для Claude Code проводит ревью дизайн-документа в пять фаз: от общего взгляда до готовности к реализации. Он подключает отдельных субагентов для отчётов. CX Codex +1 621установок egm-brainstorm Скилл egm-brainstorm для Claude Code и других платформ. Интерактивный инструмент для проработки гипотез и проектных концепций на этапе обсуждения до написания кода. CX Codex +1 601установок egm-bootstrap Скилл egm-bootstrap для Claude Code создаёт и проверяет README.md по модели Elephant-and-Goldfish. Запускается для подготовки документации по каталогам репозитория. CX Codex +1 594установок egm-draft Скилл egm-draft для Claude Code, автоматизирующий создание технических дизайн-документов по частям. Включается в работу после согласования требований для подготовки итеративного черновика. CX Codex +1 591установок egm-review-loop Скилл egm-review-loop для Claude Code запускает автоматический многоагентный цикл проверки документов по стандартам. Применяется при аудите спецификаций и планов реализации. CX Codex +1 590установок egm-resolve Скилл egm-resolve для Claude Code, который автоматизирует разбор отчётов о дефиците кода от ревьюеров Goldfish. Выполняет правки, предлагает решения и управляет интерактивными проверками. CX Codex +1 584установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой