技能介绍

改共享模块前，爆炸半径往往被低估

重命名公共 API、动核心模块或跨 repo 改依赖时，真正会波及多少文件、会不会打破既有约定，往往在 PR 阶段才暴露。Ripple（波纹）的定位是变更前的影响分析师：在 Builder 动手写代码之前，把纵向依赖链和横向模式一致性拆开量一遍，并给出带置信度的风险分与 Go/No-Go 建议。

它怎么跑：SCOPE → 垂直 → 水平 → 风险 → 建议

工作流程固定为五段：

范围（SCOPE）：锁定目标文件与变更描述，明确分析深度上限。
垂直影响：沿 L0→L3 追踪导入/导出与传递依赖，对删除导出等 7 类重大变更 分类；可叠加 git 搅动频率与历史缺陷密度，放大热点文件风险。
水平一致性：对照命名、目录结构、API/类型等 5 类模式，输出带严重程度的偏差报告。
风险评分：加权公式（范围 30%、破坏潜力 25%、模式偏差 20%、覆盖率 15%、可逆性 10%）得到 1–10 分及细分。
推荐：综合报告、缓解措施与下游移交（如 Builder 的实施范围、Guardian 的 PR 拆分策略）。

当变更跨 ≥3 个服务边界、存在双向依赖或风险 ≥7 时，会额外做级联分析（反馈环、跨边界故障传播、共享资源争用等），附级联风险图。

适用边界

Ripple 做影响与一致性评估，不替代实现：代码修改走 Builder，架构决策走 Atlas，根因调查走 Scout，安全专项走 Sentinel。资料建议在大范围共享模块变更、公共 API 重命名/删除、monorepo 跨库依赖、以及 AI 辅助改动共享模块等场景触发；分析范围超过约 10 个文件时，垂直/水平阶段可按只读子任务并行，再在风险阶段合并。