多agent协同修改同一文件需避免冲突，workbuddy通过主控agent（specupdater）统一写入、其余agent仅输出片段并串行执行，结合上下文变量拼接与版本快照校验实现安全合并。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当多个Agent需要协同修改同一份文件，比如一份产品需求文档要同时更新技术方案、UI描述和测试用例章节，必须避免写冲突、覆盖或顺序错乱——WorkBuddy默认不提供文件级锁机制，所有Agent对同一路径的写操作都会直接落盘，后执行者必然覆盖先执行者的结果。
明确主控Agent与只读/只写边界
第一步：在Agent管理页新建三个角色，名称分别为SpecUpdater、UIDescriber、TestCaseWriter；【SpecUpdater必须是唯一拥有该文件完整写权限的Agent】，其余两个仅启用文本提取与片段生成工具，禁用任何文件保存类插件。
第二步：为UIDescriber和TestCaseWriter的描述字段中明确写入“仅输出待插入的Markdown段落，不执行文件写入”，并在其Skill配置中移除所有fs.write、save_as等调用指令。
第三步：在流程编排中心新建串联流程，确保UIDescriber→TestCaseWriter→SpecUpdater三节点严格串行，且前两者输出均通过载荷映射传入SpecUpdater的input.sections字段。
用临时分片+主控拼接替代并发直写
方法一：基于上下文变量拼接
1、在流程的【上下文配置】页新增三个string类型变量：ui_section、test_section、timestamp。
2、为UIDescriber节点添加后置脚本：context.ui_section = output.markdown_block；为TestCaseWriter同理设置context.test_section = output.markdown_block。
3、SpecUpdater启动时自动读取context.ui_section与context.test_section，将其按预设锚点（如）注入原始文档对应位置，最后统一保存。
注意：若SpecUpdater在拼接前被手动中断，【ui_section与test_section变量不会自动清空，下次触发会复用旧值，必须人工重置或加时间戳校验】。
强制串行+版本快照保护
第一步：进入SpecUpdater节点属性 → 【前置条件】中勾选“检查目标文件MD5是否匹配上一版快照”，快照ID从流程全局context中读取。
第二步：在UIDescriber完成动作后，立即调用系统API生成当前文档快照并存入context.snapshot_v1；TestCaseWriter完成后存为context.snapshot_v2。
第三步：SpecUpdater执行前比对context.snapshot_v1与context.snapshot_v2是否一致，不一致则中止流程并抛出告警：“检测到UI与测试描述基于不同版本源文件生成，请确认是否需重新触发”。
这一步做完，同一份文件的多角色修改就从“抢写”变成“带版本验证的受控合并”。
