Files
mcn-short-video/project/短视频分镜创作/项目版本01/1_分镜创作方法/references

references/ — 默认引用文件地址(标准库)

本目录是技能的默认引用文件地址,存放出厂自带的标准创作流程、接口文档和知识库内容。

目录结构

references/
├── README.md           ← 本文件
├── 创作流程/           ← 标准创作流程文件
├── 接口调用/           ← 标准接口定义与调用文档
├── _meta/              ← 辅助参考资料
└── 知识库/             ← 标准知识库(10 分类)
    ├── 01_美学风格约束/    ← 渲染品质/冷暖色调/构图法则
    ├── 02_镜头四维编码/    ← Z/Y/X/F 坐标系统
    ├── 03_剪辑节奏公式/    ← 六套剪辑公式 + AI素材对策
    ├── 04_图片生成规范/    ← 角色卡/首帧图/关键帧图
    ├── 05_创意策略库/      ← 爆款模式/Hook设计
    ├── 06_平台规范/        ← Seedance限制/文件上限/合规
    ├── 07_词汇库/          ← 运镜词/风格词/修饰词
    ├── 08_案例库/          ← 实验案例/项目案例
    ├── 09_分镜驱动方法/    ← N宫格拆解/D-1/D-2模式
    └── 10_长视频策略/      ← 分段拼接/25格流水线

三层引用架构

层级 目录 定位 读写
1 参考skills/ 外部参考技能(方法论来源,三大技能) 只读
2 references/(本目录) 默认引用文件地址(出厂自带标准库) 开发环境可编辑;部署环境只读
3 references-add/ 用户部署后新增的流程/方法/知识库沉淀地 可读写,持续增长

部署环境检测

根据技能根目录的绝对路径判断当前是否已部署到用户电脑:

环境 判定条件 references/ 权限 新增内容写入位置
开发环境 路径含 MCNVideo AI\project\短视频分镜创作 可直接编辑 references/ 对应子目录
部署环境 路径不含上述开发特征 只读 references-add/ 对应子目录

冲突检测与运行时优先级

  • 冲突检测:用户新增内容后,与 references/ 同类内容逐一比对;有冲突时以新增内容为主(写入 references-add/),同时在 references/ 对应文件加 ⚠️ 注释标注,不覆盖原始内容
  • 运行时优先级:技能执行时同时加载 references/ 和 references-add/,两者冲突以 references-add/ 为主
参考skills/(方法论源) → references/(默认标准库) → references-add/(用户增量,冲突时以此为准)

完整规则详见 SKILL.md「动态增量管理」节。

当前状态

当前 references/ 各分类目录为空,标准方法论暂由 参考skills/ 三大外部参考技能提供。本目录作为标准库位置预留,后续可将精炼后的标准引用文件填充至此。

与 references-add/ 的关系

  • references/:默认标准库,出厂自带;开发环境可编辑,部署环境只读
  • references-add/:用户增量库,仅在部署环境启用,在对话中积累,随使用持续增长
  • 两者分类结构一一对应(创作流程 / 接口调用 / 知识库 10 分类)
  • 运行时同时加载,冲突时以 references-add/ 为主
  • 发现冲突时在 references/ 对应文件加 ⚠️ 注释标注,不删除或覆盖原始内容