用途:在已有项目中贡献代码时,确保每一行新代码都复刻仓库既有约定,使评审者无法分辨原作者与新增内容的边界。核心原则是先观察再动手,任何新增函数、文件、目录都必须能在仓库中找到先例。
适用场景:修改既有仓库文件、向成熟架构引入新模块/路由/组件、为他人发起的项目贡献功能、重塑既有逻辑的重构。不适用于全新项目初始化或不会进入版本控制的一次性脚本。
使用方式:动手前先执行入口协议——调研2至3个解决同类问题的文件或函数;记录其共享约定,包括标识符格式、目录分类、导入约定、错误传播策略、状态访问模式、测试位置与框架;按相同约定产出代码;最后与原件并排审计,确认是否像原生代码。
一致性维度:文件层面关注同级文件位置、文件名构成、内部结构与导出方式;函数层面关注参数风格、返回封装、错误策略、可观测性与校验方式,并复用项目已有库与工具;架构层面关注分层方式、导入流向、业务逻辑集中位置与横切关注点。
影子法:找到最相似的文件,研究其结构、导入、错误处理、命名与导出风格,以其为骨架,只替换本功能独有的逻辑,再并排比对。
限制与护栏:禁止引入与现有依赖重叠的库、使用与代码库不符的命名约定、把文件放在违反目录结构的位置、未经人工明确批准更改既有约定、写出与邻近代码视觉上可区分的代码。偏离前须先征求许可。
提交前核对:文件位置、文件名、导入顺序与别名、标识符命名、错误处理、无重复依赖、测试框架与结构、日志通道均需与既有代码一致。
相关技能:godmode:ux-patterns、godmode:design-integration、godmode:quality-enforcement、godmode:codebase-research、godmode:system-design。