check-cross-layer 是 Trellis 工作流中的实现后验证检查,定位为「安全网」:大多数缺陷来自「没想到」,而非技术不足。它建议在写代码前先看实现前检查清单,本检查在实现后执行。
用途:在改动完成后,按维度核对是否遗漏。
主要检查维度:A 跨层数据流(涉及 3 层以上时必查),含 API/路由、服务/业务逻辑、数据库/存储、UI/展示、工具等常见位置,核对读流(数据库→服务→API→UI)、写流(UI→API→服务→数据库)、层间类型/模式传递、错误向上传播、各层加载态。B 代码复用(改常量/配置时必查):先用 grep -r "value-to-change" src/ 等命令搜索同一值出现位置,2 处以上应抽成共享常量,改后更新所有使用点;B2 新建工具函数前先搜索是否已有类似实现,可扩展则扩展,并放对位置;B3 批量修改后核对其余相似模式。C 导入/依赖路径(新建文件时必查):相对/绝对路径正确、无循环依赖、符合项目模块组织。D 同层一致性:用 grep -r "ConceptName" src/ 查找同一领域概念的其他使用点,保持格式与展示一致,必要时共享配置/常量。
执行步骤:先用 git status 与 git diff --name-only 确定改动范围,再按改动类型选择适用维度执行。输出为报告:涉及哪些维度、各维度结果、发现问题与修复建议。
限制:资料未提供安装命令、收费、平台支持与具体失败案例;命令中的路径与扩展名需按项目调整,引用文档路径亦以实际仓库为准,文中未给出更多细节。