变更风险规划器
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_2a94830e/user-2a94830e-change-risk-planner。
技能介绍
你要解决什么问题
当你准备提交一次代码变更时,往往很难判断这次改动到底需要多少验证。改了一行配置,可能只是本地测试;但如果这一行落在认证逻辑、数据库迁移或部署脚本上,后果就完全不同。 manually 评估这类风险费时费力,而且容易因为「diff 很小」而放松警惕。
Change Risk Planner 要解决的问题正是:如何根据实际变更面,构建一个比例恰当的验证计划,而不是对所有改动一视同仁。
它如何工作
这个技能的核心逻辑是「先确认范围,再评估风险,最后映射验证与回滚」。具体步骤如下:
- 确认对比范围:对于工作区改动,使用
--base HEAD;对于分支或发布,则提供两个 ref。 - 运行检测脚本:在仓库内执行
scripts/plan_change.py,让它自动分析变更信号。 - 复核信号:当你对某个信号是否高风险有疑问时,可以先查阅文档。如果仍然确信它是高风险,就修正分类,而不是因为「分数看起来不舒服」就降级。
- 映射验证步骤与回滚机制:每个高风险信号至少对应一个验证步骤和一个回滚方案。
- 补充领域测试:从仓库脚本、CI 配置和责任人(ownership)文件中发现并加入针对性测试。
- 按序执行检查:先跑最快、最小的检查,再跑集成测试,最后执行发布检查。
- 记录残余风险:如果你跳过了某个建议检查,必须明确记录该步骤的残余风险。
输出与适用边界
在解释分数或扩展计划时,需要阅读 references/risk-model.md。技能的 Output Contract 要求返回以下内容:diff 范围、变更文件、检测到的风险信号、风险等级(risk band)、排序后的验证计划、发布控制措施、回滚准备事项,以及残余未知项。
需要注意的边界是:不要因为 diff 小就认为风险低。如果改动触及数据库迁移、认证逻辑、公开契约、部署流程或依赖根目录,哪怕只有一行,也必须按高风险对待。这个技能适合需要频繁合并代码、但又缺乏统一风险评估流程的工程团队,尤其是那些已经使用 scripts/plan_change.py 并希望将检测结果转化为可执行验证计划的场景。
使用场景
- 准备提交工作区改动前,需要根据 --base HEAD 的差异判断哪些改动触发高风险信号,并生成按优先级排序的验证步骤清单。
- 发布分支前,需要对照两个 ref 的差异评估变更面,为每个高风险信号至少准备一个验证步骤和一个回滚机制。
- CI 流水线集成变更分析后,需要将 plan_change.py 的检测结果转化为先跑快速检查、再跑集成与发布检查的执行顺序。
- 当团队决定跳过某项推荐检查时,需要在变更记录中明确标注该步骤的残余风险,而不是静默略过。
适合人员
- 需要频繁合并代码但又缺乏统一风险评估流程的后端工程师
- 负责发布流程、需要为每次变更提前准备验证和回滚方案的 SRE
- 维护包含迁移脚本和认证逻辑的代码库、担心小改动引发大故障的技术负责人
- 参与代码审查、需要快速判断 PR 改动范围和潜在风险的团队成员