SuperAPI AI 工具集

cursor-principle-separate-before-serializing-shared-state

通用与其它

查看项目

更新于 10-16 09:56

技能介绍

用途:这是一条面向并发编程的编码原则,适用于多个执行者(如并行的智能体、任务或进程)可能写入同一文件、分支、键或状态对象的场景。核心主张是:先消除共享,只有在共享是真实不变量时才做结构化序列化。

主要能力:

  1. 识别共享可变状态,包括双方都读写的文件、都推送的分支、既定义又消费的 API。
  2. 默认消除共享写目标:让每个执行者拥有自己的文件、键、分支或状态目录,只在读取或报告边界合并。文中指出,两个 worker 把各自的 lastX 字段写进同一个 state.json 仍属于共享修改;而拆成 indexer-state.json 与 metrics-state.json 则不是。
  3. 仅当一个共享写目标确属真实不变量时,才结构化地序列化访问,例如锁文件、顺序阶段、单写入者执行者、或原子 compare-and-swap。

使用方式:按资料中的 Pattern 步骤执行:先识别共享可变状态;再默认消除共享写目标,追问执行者是否真的需要一个规范对象,还是各自在发布独立事实;最后在确有必要时才引入结构化序列化。

限制:资料强调“指令与约定不是并发控制”,把“我们需要一把锁”视为需要检查的设计信号,而非默认答案;通过约定让执行者“不要同时写”并不可靠。共享态并发写在资料中被描述为间歇性、难复现、调试成本高的竞态问题。安装命令、收费与具体平台支持暂未提供。