SuperAPI AI 工具集

semantic-merge

通用与其它

查看项目

更新于 10-15 21:49

技能介绍

用途:在 git merge、rebase、cherry-pick 或分支同步前,按“意图”而非“行”整合分支,理解双方各自想达成的目标,在双方改动都有效时进行综合,把会改变分支对用户含义的决策升级给用户,并留下可追踪的记录。核心原则是把冲突先视为意图冲突、其次才是行冲突;改变意图的冲突始终交给用户,智能体只执行用户的整合决策,不覆盖它。

主要能力:先检查仓库状态(当前分支、工作区状态、进行中的 merge/rebase/cherry-pick、合并基、传入提交范围、涉及文件),脏工作区用命名 stash 可逆保存并报告;先界定合并范围,满足无冲突、传入范围未触及当前分支自合并基以来改动的文件、且没有重命名/移动/重定义当前分支引用的标识符、路径、schema 或输出时视为简单合并,否则按完整深度处理。随后调查双方意图,按角色分类改动簇:行为/API、数据/schema、文档/叙述、生成产物、测试、配置/构建;数据契约、测试期望、输出等改变意图的调用交给用户。再制定解决计划(保留传入、保留当前分支、综合双方、从合并源重新生成派生产物、升级给用户),优先综合而非选边,优先重新生成而非手改生成文件。解决并落地后,检测并解决陈旧引用(重命名标识符、移动路径、旧文档注释、应重新生成的产物、跨文件导入/注册表/配置键)。

使用方式:按调用路径加载对应模式参考——workflow sync author 用 references/workflow-sync-author.md,workflow sync reviewer 用 references/workflow-sync-reviewer.md,独立合并用 references/standalone-merge.md;所有模式都走共享的 Semantic Coherence Checklist。

适用场景与限制:适用于需要按意图整合分支、处理重叠改动或同步分支的场合。编排器管理的并行工作树绕过本技能,匹配 <current-branch>-agent/parallel/<slug> 的分支用普通 git merge --no-ff 合并,merge-guard 钩子豁免 /parallel/ 源引用。更广泛的代码库一致性工作由 refactor-and-integrate 负责,不在本技能范围内。具体收费、价格、平台等信息暂未提供。