SuperAPI AI 工具集

ripple

编程与开发

查看项目

更新于 10-16 02:49

技能介绍

Ripple 是一个变更前影响分析工具(Agent Skill),定位为“在代码写出来之前,先弄清改动会波及到哪里”。它针对单个拟议变更,从纵向与横向两个维度评估后果,并产出可执行的影响分析报告。其原则包括:量两次、切一次;纵向深度揭示依赖;横向广度揭示模式;风险可量化;最好的代码是不需要重写的代码。

【用途】 Ripple 用于在实施变更前评估影响范围(blast radius)。典型触发场景包括:改动涉及有 5 个以上依赖方的共享/核心模块;重命名、移动或删除公共 API、导出或数据库列;引入可能与现有约定冲突的新架构模式;跨 3 个以上文件的 PR 前影响评估;判断重构是否会级联(Shotgun Surgery 检测);monorepo 或多仓库环境下的跨仓库依赖变更;AI 辅助的代码改动触及共享模块;审查高频变更文件(30 天内 ≥ 3 次修改);以及 CRAP 分数 ≥ 30 的方法改动。

【主要能力】

  1. 纵向影响分析:追踪依赖链,识别受影响区域,分为直接依赖方、传递依赖方、接口消费者、测试文件、配置五类;将破坏性变更按 7 种类型从 CRITICAL(移除导出)到 LOW(内部重构)分级;深度层级为 L0(被改文件)→ L1(直接,高置信度)→ L2(传递,中)→ L3+(较低置信度)。同时叠加文件变更历史(git log 频率)与缺陷历史,高频/易错文件会放大任意深度的风险。
  2. 横向一致性分析:确保变更遵循既有模式,覆盖命名约定、文件结构、代码模式、API 模式、类型模式五类。
  3. 级联分析:检测二阶效应,包括反馈回路、级联失败、涌现行为、资源争用、时间性级联。触发条件为:变更触及 ≥ 3 个服务边界、检测到双向依赖、共享资源被 ≥ 3 个受影响组件访问,或风险评分 ≥ 7。输出为级联风险图。
  4. 风险评分矩阵:按加权公式计算 1-10 分,并映射到 CRITICAL(9-10)、HIGH(7-8)、MEDIUM(4-6)、LOW(1-3)四档,给出对应行动建议。
  5. 影响范围阈值:受影响文件 ≥ 15 建议拆分 PR;PR 规模参考 elite < 105 LOC、目标 ≤ 200 LOC、硬上限 400 LOC;高频变更文件(30 天内 ≥ 3 次)提升风险;变更文件测试覆盖 < 80% 标记需补测试;L3+ 依赖降低置信度并建议人工核验;跨服务边界自动将范围因子 +2;AI 辅助改动需提升审查级别;CRAP ≥ 30 标记为高变更风险。

【使用方式】 Ripple 按 SCOPE → VERTICAL → HORIZONTAL → RISK_SCORE → RECOMMEND 五阶段工作流执行。支持子命令分发:解析用户输入的首个 token,若匹配 Recipe 子命令则激活对应 Recipe,否则走默认的 impact 流程。可用 Recipe 包括:impact(默认,完整纵向+横向分析)、vertical(仅纵向依赖与调用链)、horizontal(仅横向模式一致性)、naming(符号与 API 名称变更影响)、blast-radius(量化生产侧影响范围:客户数、SLO 消耗、收入、区域/AZ 范围、多租户扇出、数据分级)、rollback-plan(设计可逆性契约:前向兼容 schema、双写窗口、回填、特性开关 kill-switch、反向 DDL/事件重放/补偿动作,并记录中止条件与回滚后影响范围)、canary-scope(金丝雀队列选择、指标门禁、晋级/中止阈值与观察窗口设计)。输出格式有组合(默认)、仅影响(纵向)、仅一致性(横向)三种模板。

【适用场景】 适用于共享/核心模块改动、公共 API 或导出重命名与删除、新架构模式引入、多文件重构、跨仓库/monorepo 变更、级联失败风险评估、多智能体系统变更(按 OWASP 2026 Agentic Blast Radius 原则评估)等。

【限制与边界】 Ripple 只做分析,绝不直接修改代码(实现交由 Builder,重构交由 Zen),也不执行变更或部署。它要求所有分析至少追踪到 L2 深度,共享/核心模块扩展到 L3。遇到核心/共享模块有 ≥ 20 个直接依赖方、引入尚未建立的新架构模式、发现未记录的关键依赖、风险评分超过 7、可能触发级联失败的跨仓库变更、或触及合规敏感区域(认证、支付、PII 处理)时,需先询问确认。它不得在无代码、git 历史或文档证据的情况下假设意图,不得跳过横向一致性检查,不得在缺少量化风险评分与文件级影响清单的情况下给出建议,也不得低估影响范围(不确定时报告更大范围)。

【协作关系】 输入来自 Scout(缺陷调查)、Atlas(架构)、Spark(特性提案)、Sherpa(任务拆解)、Matrix(组合覆盖);输出交给 Builder(实现)、Guardian(PR 策略)、Zen(重构)、Radar(测试需求)、Sentinel(安全影响)。风险评分 ≥ 9 时应并行路由至 Sentinel(安全)与 Beacon(可观测性)。

【补充说明】 关于该工具的具体安装命令、收费方式、支持平台等信息,资料中暂未提供。