用途
hub-safety 是 jordancoin/codemap 项目中的一项安全协议技能,面向需要修改“枢纽文件”的代码编辑场景。枢纽文件指被 3 个及以上其他文件导入的文件,其改动会在整个代码库中产生连锁影响。该技能在被编辑文件具有较高导入方数量时激活,目的是降低破坏性变更的风险。
主要能力与操作流程
技能围绕编辑前、编辑中、编辑后三个阶段给出检查与操作要求。
编辑前:运行 codemap --importers <file> 查看全部依赖方;理解公开 API 表面,即哪些函数或类型被外部使用;检查依赖方是否存在测试,而不仅是枢纽文件自身的测试。
编辑中:优先采用增量式改动而非破坏性改动;若重命名或删除公开符号,需在同一提交中更新所有导入方;若修改函数签名,需检查所有调用点。
编辑后:运行完整测试套件而非仅枢纽文件的测试;运行 codemap --deps . 验证依赖图保持完整;若枢纽文件有 8 个及以上导入方,考虑分阶段发布,即先改枢纽、测试,再单独更新调用方。
风险分级
技能按导入方数量划分风险等级并给出对应动作:
- 3-5 个导入方:中风险,运行包测试与直接导入方测试。
- 6-10 个导入方:高风险,运行完整测试套件并审查所有导入方。
- 10 个以上导入方:严重风险,考虑拆分枢纽文件或使用接口。
适用场景
适用于依赖关系较复杂的代码库中,对高被引用模块进行重构、重命名、签名调整等改动时的风险控制。
限制
该技能依赖 codemap 工具及其命令(--importers、--deps)可用;具体实现细节、安装方式及版本要求暂未提供。