用途:把自然语言变更说明转成可执行的静态风险分析结果,回答“变更风险多大”“会影响什么”“上下游波及哪些服务或资源”。分析基础是已有的 topology.json,而非运行时监控或实时健康状态,结论属于静态拓扑影响推断,不代表运行时调用链。
主要能力:提炼变更卡片(change_type、target、action、scope、assumption);用脚本做结构化分析,命中目标节点、受影响下游 ECS、关联资源与入口链路;结合 references/risk_assessment_rules.md 由大模型推断 critical/high/medium/low 风险等级、风险结论与影响边界;区分直接影响、潜在影响与待确认项。第一版优先覆盖服务/组件与云资源两类对象。
使用方式:默认在当前工作区查找 business_topologies/<business>/topology.json 与 topology.md,也可复用 .trae/business_topologies/。优先执行自带脚本: python3 ./skills/byted-volcengine-topology-change-impact/scripts/change_risk_from_topology.py --node "<target>" --output markdown 已明确业务时可加 --business "<business>"。脚本只输出结构化拓扑数据,不输出风险等级,风险结论需由大模型阅读指南后推断。
适用场景:代码变更、配置变更、扩容缩容、网络策略调整、入口切换等;用户只给自然语言说明时也应主动结合拓扑分析。
限制:不构建拓扑,缺少 topology.json 时应先用 topology-graph-builder 生成;用户未说明目标对象时需先追问;低置信模糊命中应先给候选列表确认,不强行下结论;拓扑无法确认应用名时只能定位到 EIP/CLB/ECS/安全组/子网/VPC;不用于判断当前是否已故障。