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今天更新