Synthesis KB Edit 是一个用于编辑、验证和发布 Markdown 知识库变更的技能。它基于仓库中 .agents/knowledge-base.yaml 文件定义的策略执行完整的编辑工作流，允许用户以自然语言描述变更，同时强制执行仓库的绑定规则。
用途
该技能主要用于更新知识库内容，确保变更符合仓库声明的策略和流程。它适用于需要严格管控知识库编辑的场景，防止未经授权的修改、绕过保护措施或破坏共享历史。
主要能力
- 配置门禁：在编辑前检查 .agents/knowledge-base.yaml 是否存在且有效，缺失或无效则停止工作。
- 路径规则：根据 kb_config.py --resolve 的结果，仅允许在可编辑路径写入；生成和拒绝路径为硬性停止。
- 概念所有权：每个事实只对应一个拥有概念，写入前搜索所有现有提及，避免创建重复概念。
- 单一日期字段：仅使用配置声明的字段和控制值，移除冲突的正文副本。
- 验证检查：保存前运行配置检查、OKF 验证器、一致性检查和配置的保密扫描器，无法运行则阻止发布。
- 控制保护：禁止绕过钩子、扫描器、审查或分支保护，禁止使用 --no-verify。
- 提交隔离：仅暂存本次变更，不混入其他会话工作。
- 发布流程：不直接合并发布 PR，发布由 review.who_merges 指定的审查者负责。
- 协调板：并发根会话活跃时，写入前在协调板上认领仓库区域。
- 历史保护：禁止强制推送或重写共享历史，快进失败则停止并报告。
- 授权限制：技能不扩大权限，遵循当前会话的授权规则。
使用方式
技能提供以下参考文档：
- references/edit-and-ship.md：七步编辑发布工作流（预检、查找拥有概念、隔离、编辑、验证、审查暂存、发布）及 1.0.0 硬性不变量。任何编辑前需阅读。
- references/knowledge-base-config-v1.md：.agents/knowledge-base.yaml 的完整契约，配置检查失败或含义不清时阅读。
- references/coverage-map.md：1.0.0 文本各部分当前位置。
工作流包括配置门禁、按意图路由（编辑发布、发布现有编辑、发布后同步）、自然语言交互（翻译技术术语，叙述状态变更操作）和发布后同步（验证发布、快进默认分支、删除已合并分支、重新运行验证器）。
适用场景
适用于需要以受控方式更新 Markdown 知识库的团队，特别是那些有严格变更策略、需要防止意外修改、确保验证通过并遵循发布流程的场景。
限制
- 依赖有效的 .agents/knowledge-base.yaml 配置文件，缺失或无效则无法工作。
- 不扩大用户权限，必须遵循当前会话的授权规则。
- 禁止绕过任何保护措施。
- 无法处理并发会话冲突时的自动合并。
- 需要用户具备一定的自然语言描述能力，但无需了解 Git 细节。