Egm Drift Report

google/elephant-goldfish-model/skills/egm-drift-report

作者 google72d06f52a2482885d9a64bd24b291c6e8628942cApache-2.021K 个星标收录于 2026年11月17日更新于 2026年11月17日仓库今天更新

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.

精选仅含说明软件开发文档与办公
AI 生成的概览

将设计文档和 README 与代码库比对,输出列出所有差异的 Markdown 报告。

功能
该技能针对目标目录中的每份设计文档或 README,读取其意图、拟议改动以及提到的文件名或符号,定位对应源码并进行比对。它会标出缺失功能、数据模型字段不全、硬编码的逻辑捷径以及架构偏离,且只报告不一致之处。结果按文档逐条追加到以日期命名的 DRIFT_REPORT.md 中,采用固定的标题加项目符号格式,若无差异则写“No drift detected.”。
适用场景
当用户要求检测漂移,或检查某目录下设计文档、README 与实现之间的一致性时使用。也适用于核查规划中的规格是否真正落地。
运行要求
仅为指令,不含脚本。需要提供设计文档或 README 所在的目标目录、对源码树的读取权限、代码搜索或 grep 能力,以及用于生成报告的写文件工具。

Detect Drift In Designs and Code

When running in Codex or ChatGPT Work, first read Codex integration. 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/elephant-goldfish-model位于skills/egm-drift-report提交72d06f5

许可证: Apache-2.0

内容归原作者所有。SourceWeft 从公开仓库中收录这些内容。

在 README 中添加徽章

向读者展示该技能已收录于 SourceWeft,徽章链接到本页。

“Listed on SourceWeft”徽章预览
[![Listed on SourceWeft](https://sourceweft.com/badge/skills/gh-google-elephant-goldfish-model-egm-drift-report-skills-egm-drift-report-a81159be2d1f0fad.svg)](https://sourceweft.com/skills/gh-google-elephant-goldfish-model-egm-drift-report-skills-egm-drift-report-a81159be2d1f0fad?utm_source=readme&utm_medium=badge)

举报或申请下架

更多来自 google/elephant-goldfish-model 的技能

Egm Resolve

google

精选

处理评审者提出的文档缺陷:分类为质疑、上报、建议修复或忽略,并经用户确认后应用修改。

写作与内容21K今天更新

Egm Review Loop

google

精选

Executes the Antagonistic-Review process from the Elephant-Goldfish Model (EGM) via an automated multi-agent review loop to audit documents against qualitative standards and structural templates, and automatically apply approved fixes. Use when reviewing design docs, READMEs, feature specifications, implementation plans, or verifying document completeness and tone.

待分类21K今天更新

Egm Draft

google

精选

Drafts a design document section-by-section using the concepts brief from egm-brainstorm (or user notes). This is the second step in the Elephant-Goldfish (EGM) feature flow. Use when you are ready to write a design doc after aligning on requirements + solution.

待分类21K今天更新

Egm Bootstrap

google

精选

为仓库目录树生成并修正符合 EGM 规范的 README.md 契约文件,可并行使用子代理。

文档与办公21K今天更新

Egm Brainstorm

google

精选

Interactive ideation and brainstorming skill for the Elephant & Goldfish Model (EGM). Helps turn half-baked concepts into structured hypotheses via clarifying questions, review, and iterative refinement. Produces an RFC summary for human review or more detailed design with egm-draft.

待分类21K今天更新

Egm Review

google

精选

Orchestrates the EGM Goldfish Review Protocol. Used as part of the EGM process to perform design document reviews. Executes five review phases: Initial Zoom Out Review, Comprehension Review, Design Critique, Intermediate Zoom Out Review, and Implementation Readiness.

待分类21K今天更新