1.1 KiB
1.1 KiB
文档与资源生成规则
权威合同:
docs/系统架构/新版设计/文件设计/工程配置与部署.md;机械门禁:工具/维护索引.py --检查、工具/构建资源包.py。
- 生成物只由登记输入产生:
src/muse/资源/运行资源.zip与清单.json只从工具/资源登记.json打包;docs/接口契约/生成/*只从工具/生成输入.json生成。改生成物先改登记。 - 生成物不手改:
src/muse/资源/、生成 Schema 与 OpenAPI 是产物;直接编辑会被下次生成覆盖并视为违规。 - 索引一致:所有
目录.md表内相对链接必须可达;技能分组索引与磁盘技能一一对应;make 检查全绿才算文档变更完成。 - 资源带发布身份:资源包必须有
发布身份与逐文件 sha256;生产加载只认安装包内清单,不读未审工作树。 - 声明即验证:写入 README/Makefile/工作流的命令必须先在本地真实执行通过;未验证的命令不得声明。
- 单一权威:正文性定义只在所属权威文档修改;索引、投影和引用不复制第二份定义。