muse-agent-example/.agent/rules/文档与资源生成.md
zizi af08551d7b 智能体能力与规则:导航元信息、技能目录与执行纪律
- 能力文件补 导航元信息(内容描述/使用场景/使用要求),技能目录按目录派生;索引检查与磁盘逐条一致。
- 规则:计划与提交新增「验证期冻结源码」「全量只跑一次」两条纪律并写清与生成、验收数据库的关系;
  模块依赖、任务与证据、文档与资源生成、测试隔离等规则同步本轮口径。
- 角色合同与配置的模型白名单保持一致;技能正文不再夹带索引注记(与后端资源加载同口径)。
2026-09-18 01:15:12 +08:00

1.6 KiB
Raw Blame History

文档与资源生成规则

权威合同:docs/系统架构/新版设计/文件设计/工程配置与部署.md;机械门禁:工具/维护索引.py --检查、工具/构建资源包.py。

  1. 生成物只由登记输入产生:src/muse/资源/运行资源.zip 与 清单.json 只从 工具/资源登记.json 打包;docs/接口契约/生成/* 只从 工具/生成输入.json 生成。改生成物先改登记。
  2. 生成物不手改:src/muse/资源/、生成 Schema 与 OpenAPI 是产物;直接编辑会被下次生成覆盖并视为违规。
  3. 索引一致:所有 目录.md 表内相对链接必须可达;技能分组索引与磁盘技能一一对应。编辑期检查受影响链接与索引,文档交付批次稳定后集中运行 make 检查,全绿才算完成;不为每次文字修改重复全量检查,未影响目录信息时不改索引。
  4. 资源带发布身份:资源包必须有 发布身份 与逐文件 sha256;生产加载只认安装包内清单,不读未审工作树。
  5. 声明即验证:写入 README/Makefile/工作流的命令必须先在本地真实执行通过;未验证的命令不得声明。
  6. 单一权威:正文性定义只在所属权威文档修改;索引、投影和引用不复制第二份定义。