该技能名为“Separate Before Serializing Shared State”(先分离,再串行化共享状态),用于指导并发场景下的状态设计。
用途:当并发执行者(如多个进程、任务、智能体或工作流)可能写入同一文件、分支、键或状态对象时,应用此原则来避免竞态条件。
主要能力:
- 识别共享可变状态,包括双方都读写的文件、都推送的分支、都定义并消费的 API。
- 默认策略是消除共享写入目标:判断这些执行者是否真的需要一个规范对象,还是各自发布独立事实。若为后者,则给每个执行者分配其独占的文件、键、分支或状态目录,只在读取或汇报边界进行合并。
- 指出常见误区:两个 worker 各自把 lastX 字段写入同一个 state.json 仍属于共享变更;而 indexer-state.json 与 metrics-state.json 分开则不属于。
- 仅当单一共享写入目标确实是真实不变量时,才采用结构化串行化:锁文件、顺序阶段、单写者执行者或原子比较交换。
- 强调“我们需要一把锁”应被视为需要检查的设计异味,而不是默认答案。
使用方式:在并发执行者可能共享可变状态时,先按上述模式识别共享点,优先尝试消除共享;若无法消除,再选择结构化串行化手段。资料未提供具体代码示例或安装命令。
适用场景:多进程或多任务写入同一文件、多分支推送、共享状态对象更新、并发 API 定义与消费等场景。
限制:资料未提供具体实现细节、平台限制或性能数据;该技能为设计原则,不替代具体并发控制机制的正确实现。