Cindy 工程迁移规则模板

用途：把有项目依据的工程原则改写成适合个人工具或 Aipcg 的可执行规则。填写的是迁移建议，除明确引用外，不代表 Cindy 对其他项目的既定要求。配套章节：CY-03。

一条规则的完整记录

规则名称：
目标项目与版本：
问题：具体触发条件和影响，避免只写“保持可靠”。
Cindy 机制：采用什么边界、接口或状态设计？
来源：文档／源码／历史验证链接，核验日期。
证据类型：规范要求／当前源码／历史运行／本次实测。
适用条件：项目为什么需要这条规则？
最小采用方式：具体修改哪一层，而非复制整套框架。
执行位置：入口／函数／schema／配置消费者。
检查样本：正常、边界、错误输入及预期观察。
实际检查：命令、环境、结果、结果文件；没运行写“未运行”。
失效条件：版本、依赖、业务或拓扑改变时回查什么？
不适用情形：哪些条件下应减轻或不采用？

三条示范规则

规则 A：可复用计算与宿主副作用分开

问题：布局算法直接调用 UE，普通 Python 无法检查单位、几何和资产匹配。来源是 Cindy 架构不变量 和 Electron 进程边界，证据类型为项目规范与已阅读的注入接口。

适用条件：计算逻辑需要 CLI、API 或引擎多个入口。最小采用方式是把坐标转换与几何审计写成纯函数，让引擎适配器传入资产尺寸并负责保存。执行位置是计算模块入口；检查同一保存样本在不启动 UE 时得到稳定输出。若脚本只有一次性引擎操作，不必强行拆出许多包。

规则 B：记录自定义状态，恢复默认删除 override

问题：把系统默认快照写进用户配置后，默认升级无法生效。来源为 配置契约，证据类型为权威规则；本模板未验证 TA 工具实现。

适用条件：配置会升级且允许用户自定义。最小采用方式是保存稀疏覆盖，并以“是否存在”合并。执行位置为配置加载器。检查缺省跟随新默认、显式 false／零保留、恢复默认删除覆盖。未使用持久设置的小脚本可只使用清楚的命令行参数，不必新增配置数据库。

规则 C：未知结果先核实，不能自动补成功或重跑

问题：外部执行器消失时，后代可能仍运行，重发会重复导入或构建。来源为 Pi 生命周期研究 和 当前 transport。证据类型为历史受控记录与当前源码；原 Windows 打包根因仍未证明。

适用条件：任务较长或有文件／引擎副作用。最小采用方式是记录任务 ID、父子进程、受理与终态，未知时查询现有结果。执行位置在任务控制器。检查正常静默、已退出且管道未关、用户取消及结果缺失。这里不照抄 250ms 为普通任务超时；短小无副作用的纯计算可以采用更简单的失败返回。

采用与验收表

完成条件：三条规则均有来源、适用条件、明确执行位置和能发现违例的检查；将建议与已有实现分开，不填写未做的运行结果。