muse-agent-example/.agent/rules/元数据消费.md
zizi b86516505f W02 安装工程、启动骨架与验证环境:pyproject/uv 安装工程、启动装配骨架、conftest 用例身份与 OS 离线隔离。
按 R2 串行阶段整理提交;包内文件为该阶段交付(含后续小增量),状态以工作包清单为准。
2026-09-10 19:25:40 +08:00

10 lines
924 B
Markdown

# 元数据消费规则
> 权威合同:`docs/系统架构/新版设计/数据模型/元数据与结构演进.md`、`接口契约/元数据投影与版本.md`;机械门禁:`tests/架构/test_元数据不能跨模块写值.py`(随 S04 实现落地)。
1. **实例归属业务**:元数据模块拥有模具(类型、字段、结构版本),业务模块拥有实例值;禁止经元数据接口写业务实例。
2. **稳定 ID**:类型与字段用稳定 ID 登记;禁止传任意表名列名绕过登记。
3. **只增不改**:作品级结构扩展只追加;已发布字段定义不改语义,退出用弃用标记。
4. **投影按用途**:表单、提示词、导出各按字段用途投影;收紧投影不删除已存值,未知字段不静默丢弃。
5. **结构切换并发保护**:结构升级与内容写入并发时以版本约束拒绝冲突;历史值按其当时结构解释。