SuperAPI AI 工具集

pre-modification

编程与开发

查看项目

更新于 11-11 05:23

技能介绍

用途

Pre-Modification Check with Repowise 用于在修改 Repowise 已索引代码库中的文件之前进行影响评估。该技能在代码库存在 .repowise/ 目录时激活,适用于 Claude 等助手在编辑文件前执行检查。

主要能力

编辑单个文件前,调用 get_risk(targets=["path/to/file.py"])。该工具按文件返回以下信息:

  • hotspot_score:热点分数
  • trend:趋势
  • risk_type:风险类型
  • impact_surface:影响面(前 3 项)
  • dependents_count:依赖者数量
  • co_change_partners:共同变更伙伴
  • primary_owner:主要所有者
  • test_gap:测试缺口
  • security_signals:安全信号

其中 defect_profile 仅出现在统计到修复记录的文件上,包含:过去 6 个月的 fix_count、last_fix_days_ago、表示近期持续修复压力的 bug_magnet 标志,以及 top_symbols(按符号的计数为近似值,应理解为“主要集中在此”)。技能说明指出,频繁被修复的文件是下一次编辑最可能破坏东西的最强单一信号,应优先关注。

针对多个文件时,可将所有目标合并为一次调用:get_risk(targets=["file1.py", "file2.py", "module/"])。

重构或移动代码前,先调用 get_context(targets=["file.py"]) 了解完整上下文:谁在使用该文件、有哪些决策约束它、为何如此组织,以避免违反架构决策。大规模重构时还可调用 get_health(targets=["file.py"]),其标记性发现(复杂度、深层嵌套、低内聚、重复)可用于指导改进并给出前后评分对比。

使用方式与告警规则

当 get_risk 显示以下情况时,应向用户明确提示:

  • defect_profile 中 bug_magnet 被设置:说明该文件近期被反复修复
  • 热点分数高于 90 百分位:说明这是频繁变更的高风险文件
  • 依赖者超过 10 个:列出主要依赖者,说明此处的 API 变更会破坏调用方
  • 巴士因子为 1:说明该代码仅由一人维护
  • 风险类型为 "bug-prone" 或 "high-coupling":在修改前明确标记

适用场景

适用于在 Repowise 索引过的代码库中修改、重构或删除文件之前的风险评估,尤其是识别缺陷频发文件、高变更复杂度热点、广泛影响面、单点维护风险及测试或安全敏感文件。

限制

若 get_risk 返回工具错误,可能表示 MCP 服务器未运行;此时可继续修改,但需注明风险评估不可用。该技能的功能依赖 Repowise 索引与 MCP 工具,具体安装与收费信息暂未提供。