By name: f2s-kb-merge description: 解决 Git 合并后编辑器上下文冲突；可选传入冲突文件；实现侧冲突仅罗列待用户确认；触发：合并上下文冲突、f2s-kb-merge
编排（主 / 子 agent）
- 两字段（
subAgent/switchAgentVerification）语义以统一入口为唯一事实源：Cursor/Claude 读配置根rules/f2s-flow2spec-unified-entry.*；Codex 读.codex/topics/f2s-flow2spec-unified-entry.md（与上同源，flow2spec init镜像）。本技能不复述。 - 子 agent 职责（仅当
subAgent=true）：只做冲突扫描 + 按类别对照表，每条包含五字段 ——file/category（文档索引 / 总览规则 / 模块规则 / 技能 / 说明文档 / 实现类 / 依赖元数据）/ours_summary/theirs_summary/recommendation（并集 / 保留某侧 / 并入必须项 / 待用户选）。 - 子 agent 不出成品合并稿，避免主 agent 二次重写。
- 主 agent 职责：按策略落盘 + 实现类决策 + 验收。
- 默认落盘侧自验，本技能不绑定交叉校验。
/合并上下文冲突（f2s-kb-merge）
在 rebase / merge 后出现 <<<<<<< / ======= / >>>>>>> 时，优先自动合并「AI 与开发者上下文」相关文件，保证索引、规则、技能与说明文档互相对齐；涉及可执行实现、部署或依赖声明的冲突不擅自合并，需向用户展示双方差异并等待确认后再改。
传参（可选）
- 不传参：在工作区内自行检索仍存在冲突标记的文件，再按本技能分类与策略处理（含全量扫描后的摘要）。
- 传参：用户可指定一个或多个仍含冲突的文件（随消息 @ 文件或列出路径均可）。助手优先只处理这些文件中的冲突；若其中含「禁止自动合并」类别，仍只罗列差异与建议，不擅自写入。指定文件处理完毕后，可询问用户是否需要对工作区做补充扫描。
适用范围（可自动合并）
以下类别内的冲突，按本技能合并策略处理，无需逐行征求确认（除非两侧表述互斥且无法判断应以何为准）：
| 类别 | 说明 |
|---|---|
| 文档索引 | 承载「文档 ↔ 规则 / 技能」映射的索引表文件 |
| 项目总览规则 | 规则目录中的总入口文件 |
| 模块规则 | 同套规则目录下的其余规则片段 |
| 技能 | 技能目录下的 SKILL 说明文件 |
| 上下文说明文档 | 与规则、技能配套的说明类 Markdown |
| 索引联动的纯说明文档 | 由项目约定存放、仅被索引或规则引用、不含可执行实现语义的说明文档 |
禁止自动合并（须用户确认）
以下冲突不得在未获用户明确选择前合并：
- 应用或服务实现源码（业务逻辑、接口实现、数据访问等）
- 会改变对外暴露行为的配置（路由、函数注册、中间件链、运行入口等）
- 依赖与构建元数据（依赖声明、锁文件、构建与部署脚本等）
- 集中维护外部资源清单的实现模块：若两侧条目集合或注册内容不同，属运行行为差异，须用户确认保留范围（助手可建议「并集 + 去重」，待用户同意后再写入）
处理方式：列出冲突文件、简述两侧意图，给出推荐方案，请用户选定后再改上述范围中的文件。
合并策略（上下文类）
- 删除所有 Git 冲突标记（
<<<<<<</=======/>>>>>>>），不得残留。 - 索引表
- 同一索引行的 Rules / Skills / 链接列：做并集，路径去重、空格分隔。
- 仅在一侧出现的独立索引行：合并后保留，避免丢失条目。
- 总览规则
- 同一主题下多条 bullet：合并为信息完整的单条或并列多条，不丢弃任一侧独有的约束或引用。
- 长文档中的表格
- 描述不同维度能力的行：并集保留。
- 描述同一主题的重复行：合并为一条连贯表述，涵盖两侧要点。
- rules / skills
- 优先保留更具体、约束更清晰的表述；另一侧独有的必须 / 禁止条款并入，避免规则回退。
- 链接与路径
- 统一为仓库内可解析的相对路径，并与总览规则中的索引入口一致。
执行步骤
- 确定范围：若用户已指定冲突文件，仅以这些文件为范围；否则全工作区检索冲突标记（或结合 IDE 冲突列表）。再按适用范围分类。
- 若启用拆子，子 agent 按子交付对照表 schema（
file/category/ours_summary/theirs_summary/recommendation五字段）产出分类表；主 agent 接手后续落盘 / 决策 / 验收步骤。
- 若启用拆子，子 agent 按子交付对照表 schema（
- 上下文类：按合并策略直接修改并保存。
- 实现类：只输出对比摘要与建议，不修改文件直至用户确认。
- 输出摘要（Markdown）：已解决文件 + 要点；待确认文件 + 两侧差异 + 建议。
- 对已处理文件再次确认无冲突标记残留；若未做全量扫描，可提示用户是否补充扫描。
与相关命令的关系
/修正实现规则（f2s-kb-fix）：用户已指明问题点后的定向修正与文档/规则同步。- 本技能：合并产生的批量冲突，侧重编辑器上下文与说明文档同实现侧分离处理。
何时使用
- merge / rebase 后，规则 / 技能 / 索引 / 配套说明文档出现冲突（可全量处理，也可只处理用户指定的冲突文件）。
- 需要一次性对齐「索引 ↔ 规则 ↔ 技能 ↔ 说明文档」，且避免误合并实现或部署相关改动时。