egm-drift-report 是一个用于检测设计文档与代码之间漂移(drift)的技能,属于 google/elephant-goldfish-model 仓库,页面地址为 https://www.skills.sh/google/elephant-goldfish-model/egm-drift-report。
用途 当用户要求检测所有设计或一组 README 的漂移时,该技能的目标是找出代码库偏离或未能实现这些设计/README 所描述规格的所有情况。
主要能力
- 文档遍历:列出一个设计目录中的所有文件,并逐个分析每份设计文档。
- 上下文理解:阅读设计文档,识别其意图、提议的变更以及提到的具体文件名和符号。
- 源码定位:在源码树中查找对应源文件;若路径不明确,则通过代码搜索或 grep 定位文档中提到的相关类、函数或 API 端点,并提示用户补充文档中缺失的链接,以降低后续检测成本。
- 状态核验:阅读这些源文件的当前状态。
- 漂移检测:对比设计与现实,重点查找缺失功能(文档描述但代码中不存在)、不完整模型(数据类/类/结构体/Proto 缺少设计指定的字段)、逻辑取巧(本应动态逻辑处使用硬编码值)、架构分歧(实现采用与提议不同的模式或库)。
- 过滤输出:只报告差异,不描述正常或匹配的部分;若代码与设计完全一致,则输出“No drift detected”。
- 报告生成:将所有发现的不一致汇总为单一报告,使用文件写入工具追加到 {YYYY-MM-DD}_DRIFT_REPORT.md,格式为二级标题加设计文档名,后接具体偏差的项目符号列表或“No drift detected”。
使用方式 先确认用户提供了包含设计文档或 README 的目录,未提供则请用户指定目标目录。随后按文件顺序处理,以避免工具输出缓冲区溢出。在 Codex 或 ChatGPT Work 中运行需先阅读 Codex 集成说明;在 Claude Code 或 Cowork 中需先阅读 ${CLAUDE_PLUGIN_ROOT}/docs/claude.md。执行时需严格比对,凡设计文档提到而代码中缺失的具体对象、字段或文件名均视为可报告漂移;未被设计或 README 引用的逻辑部分同样视为漂移;应大量阅读文件以确认代码当前状态,而非依赖记忆。
适用场景 适合在持续开发中定期审查设计文档与代码实现是否同步,尤其适用于规格驱动开发、多份 README 对应多个模块、需要生成可执行差异清单的团队工作流。
限制 仅依据提供的资料,未说明支持的语言、框架、文档格式、性能表现或与其他工具的集成能力;报告只列出差异,不提供修复建议或自动改码;需要用户提供明确的设计目录,文档中缺失的源码链接需要人工补充。收费、价格、平台支持范围等信息暂未提供。