Files
mcn-short-video/project/短视频脚本创作/V1.0/subskills/mcn-video-prompt/references-add
maogeigei 7f80cc74da docs: 全量相对路径规范化(移除 maidou/废弃盘符/应用子技能锚点)
- 自动化任务调度机制.md: Debug SQL cd ~/.workbuddy + python 便携化
- mcn-data-insight(SKILL+抖音数据规则): 榜单落盘 C:/Users/maidou/Desktop 改桌面解析规则
- MCP_工具调用规范.md(主+ dou-analysis 副本): 废弃 MCNVideo AI 路径锚点改 D:/AgentSkill 两步判定
- 创作流程规范.md + 4_/11_ 流程: MCNSkillCase 残留改 产出根目录/{账号名} 规则
- mcn-video-prompt(SKILL+references-add): 废弃 DSHSkill项目 兜底并入用户环境
- 豁免保留: 禁止性规则示例行/变更记录历史行/references-add 路径配置
2026-09-04 09:54:30 +08:00
..

references-add/ — 用户部署后新增沉淀地(增量库)

本目录是用户部署到电脑后,新增的流程、方法、知识库的沉淀地,作为对 references/(默认标准库)的补充和扩展。

目录结构

references-add/
├── README.md           ← 本文件
├── 路径配置.md          ← 产出路径唯一权威(dsh 环境优先 `D:\dshworkspace\创作任务\`、无主工作区时并入用户环境;开发机/用户环境 桌面 MCNSkill项目/{账号名}/提示词{编号}/ 账号层直挂,运行时必读)
├── 制作流程/            ← 新增/变更的制作流程文件
├── 接口调用/            ← 新增的 API 接口文档与平台规范
└── 知识库/              ← 新增知识(15 维度,与 references/ 结构对应)
    ├── 01_主体描述/       ← 人/物/场景,含外貌细节与微表情系统
    ├── 02_动作行为/       ← 主体动作、姿势、互动、物理连贯性
    ├── 03_场景描述/       ← 背景、环境、时间、天气、空间锚定
    ├── 04_镜头类型/       ← 景别(特写→远景)+ 四维编码 Z 轴
    ├── 05_运镜方式/       ← 摄像机运动方式与节奏 + 四维编码运动维度
    ├── 06_焦距视角/       ← 镜头焦段、拍摄角度 + 四维编码 Y/X/F 轴 + 焦段心理学
    ├── 07_光线时间/       ← 光源类型、方向、强弱 + 光影三层
    ├── 08_氛围天气/       ← 情绪氛围、天气条件
    ├── 09_色彩后期/       ← 调色、滤镜、电影质感 + 冷暖色调对比系统
    ├── 10_后期细节/       ← 磨皮、锐化、运动模糊、胶片颗粒 + 有机瑕疵
    ├── 11_特效渲染/       ← 光效、散景、粒子、GI/SSS/体积光 + 深度美学约束
    ├── 12_画质分辨率/     ← 输出规格 + 反塑料感宣言
    ├── 13_音效音频/       ← 空间声学、材质拟声、音色控制
    ├── 14_构图布局/       ← 构图法则、版式、画面布局、极简先锋构图
    └── 15_视觉风格/       ← 导演风格参数化映射 + 艺术流派/渲染风格

三层引用架构

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

部署环境检测

根据两步判定模型判断当前环境(第一步查本机 D:\AgentSkill 是否存在;有 → 第二步看技能自身路径):

环境 判定条件 增量机制 新增内容写入位置
①开发机 本机有 D:\AgentSkill 且技能路径在 D:\AgentSkill\ 下 不启用 references-add/ references/ 对应子目录
②dsh 部署环境 本机有 D:\AgentSkill 且技能路径含 .dsh 启用 references-add/(本目录) references-add/ 对应子目录
③用户环境 本机无 D:\AgentSkill(技能无论装在哪、什么路径) 启用 references-add/(本目录) references-add/ 对应子目录

冲突检测与修复

用户在对话过程中新增方法、流程、知识库后:

  1. 比对检测:将新增内容与 references/ 中同类内容逐一比对(同名文件、同主题内容)
  2. 无冲突:直接写入 references-add/ 对应子目录
  3. 有冲突:以新增内容为主(写入 references-add/),同时在 references/ 对应文件中加 ⚠️ 注释标注冲突点及正确规则,不删除或覆盖原始内容

运行时引用优先级

技能执行时同时加载 references/ 和 references-add/,两者内容冲突以 references-add/ 为主:

参考skills/(方法论源) → references/(默认标准库) → references-add/(用户增量,冲突时以此为准)

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

文件命名规则

新增类型 归入目录 文件命名 示例
制作流程 制作流程/ {阶段号}_{制作环节}.md 3_素材审验标准.md
接口/平台规范 接口调用/ {接口名称}.md Seedance_平台限制.md
提示词维度知识 知识库/{维度}/ {日期}_{知识主题}.md 20260820_景别选择指南.md

通用规则

  • 防重复: 写入前先搜索 references/ 和 references-add/ 中是否存在相似内容
  • 格式要求: 每个文件包含知识来源(用户对话)和结构化提炼,非原始对话日志
  • 维度归档: 知识库按 15 维度对号入座,非维度类内容归入 制作流程/ 或 接口调用/
  • 词汇分布: 各维度词汇表归入对应维度文件夹,不设独立词汇库

运行时加载规则

仅非开发机环境生效(②dsh 部署环境/③用户环境,即本机无 D:\AgentSkill 或技能路径含 .dsh 时)。同时加载 references/ 和 references-add/ 的内容,两者冲突时以 references-add/ 为主:

维度 加载规则
制作流程 先查 references/制作流程/,再查 references-add/制作流程/,同名文件以 references-add/ 为主
知识库 先搜 references/知识库/{维度}/,再搜 references-add/知识库/{维度}/,两目录共同参与检索,冲突时以 references-add/ 为主
接口调用 先查 references/接口调用/,再查 references-add/接口调用/,冲突时以 references-add/ 为主