- skill: 素材库分块定义(00~11)、05_极致事件知识库 4 篇、08_对话风格总纲、mcn-video-prompt 提示词质量门禁与外部语料检索流程 - workbench: mcn-work-shop 新增 cli-backend.js(本地 CLI 接入)、工作台视觉交互规范;移除旧 UI 规范 - docs: 根目录极致事件/素材卡/审计方案报告与热门短视频清单入库 - memory: 补 09-14~09-29 日志与自动化任务记忆 - chore: .gitignore 排除 tools/、.tmp-chrome-*/、_k_test.cjs
7.1 KiB
7.1 KiB
references-add
用途
当 Skill 被部署到非原始开发路径时(即 Skill 根目录路径与原始项目路径不同), 所有用户在对话过程中新增的流程定义、接口文档、创作知识、避坑规则、素材内容统一整理到此文件夹。
知识分类体系(V2.0)
基于短视频产品规划图的 27 赛道 × 8 叙事形态三级分类体系:
| 层级 | 维度 | 枚举值 |
|---|---|---|
| L1 赛道 | 讲什么 | 个人才艺 / 生活vlog / 财富理财 / 二次元 / 居家装修 / 学习教育 / 小剧场 / 数码科技 / 旅行 / 美食 / 美妆 / 动物 / 亲子 / 汽车 / 情感 / 三农 / 健康医学 / 潮流风尚 / 舞蹈才艺 / 颜值造型 / 人文 / 音乐 / 影视 / 身体锻炼 / 体育 / 明星娱乐 / 游戏 |
| L2 内容形式(叙事形态) | 怎么拍 | F01剧情演绎 / F02Vlog纪实 / F03干货口播 / F04测评种草 / F05教程教学 / F06盘点解说 / F07纯视觉短片 / F08人物采访 |
| L3 细分垂类 | 具体方向 | 各赛道 × 形态下的细化分类(如:小剧场×F01 → 都市情感/逆袭爽剧/温情正能量等) |
结构
references-add/
├── README.md ← 本说明
├── 路径配置.md ← 🔴 产出路径唯一权威配置(运行时优先,用户自定义路径在此记录)
│
├── 创作流程/ ← 新增的创作流程文件(步骤变更、新步骤等)
├── 接口调用/ ← 新增的 API 接口定义与调用文档
│
├── 通用知识/ ← 🔵 不限赛道和内容形式的通用创作方法论
│
├── 素材库/ ← 🟡 新增素材内容(与 references/素材库/ 同结构)
│ ├── 01_美食库_*.md ← 新增美食素材(按细分命名)
│ ├── 03_生活仪式库_*.md
│ ├── 05_装修布局库_*.md
│ ├── 06_生活服务库_*.md
│ ├── 07_穿搭库_*.md
│ ├── 08_妆容库_*.md
│ └── 11_造型库_*.md
│
├── 分赛道知识/ ← 🟢 限定赛道 + 内容形式的知识
│ ├── 小剧场/
│ │ ├── F01_剧情演绎/
│ │ ├── F02_Vlog纪实/
│ │ ├── F03_干货口播/
│ │ └── ... (8种叙事形态)
│ ├── 生活vlog/
│ ├── 美妆/
│ ├── 学习教育/
│ ├── 身体锻炼/
│ ├── 汽车/
│ ├── 游戏/
│ └── ... (共27赛道)
│
└── 铁律避坑规则/ ← 🔴 创作中必须遵守的铁律和避坑指南
├── 通用/ ← 不限赛道和内容形式的通用铁律
└── 分赛道/ ← 限定赛道 + 内容形式的铁律
├── 小剧场/
│ ├── F01_剧情演绎/
│ └── ...
└── ...
通用知识 vs 分赛道知识 — 判定标准
| 判定维度 | 通用知识 | 分赛道知识 |
|---|---|---|
| 适用赛道 | 不限,所有赛道通用 | 限定 1 个赛道 |
| 适用内容形式 | 不限,所有叙事形态通用 | 限定 1 种叙事形态 |
| 案例来源 | 跨赛道/跨形态的共性提炼 | 单一赛道 × 形态的专属案例 |
| 反例 | 四柱子框架、SCQA叙事结构、完播率优化 | 「小剧场×F01 情感短剧的情绪曲线设计」 |
| 归入目录 | 通用知识/ |
分赛道知识/{赛道}/{内容形式}/ |
铁律避坑规则
铁律 = 在创作流程中必须执行的强制规则(违反即召回),避坑 = 经验积累的常见错误和应对。
| 分类 | 归入 | 示例 |
|---|---|---|
| 通用铁律 | 铁律避坑规则/通用/ |
"第一句OS必须点题+带人" |
| 赛道级铁律 | 铁律避坑规则/分赛道/{赛道}/{内容形式}/ |
"两性情感短剧不得使用对话流水账式OS" |
素材库
用户在部署环境中新增的可复用素材内容(非账号专属),与 references/素材库/ 同结构同字段。
| 规则 | 说明 |
|---|---|
| 文件命名 | {编号}_{类型名}_{细分}.md(如 01_美食库_川菜.md) |
| 字段结构 | 与 references/素材库/ 同类型文件保持一致(四维标签:极致标签×适用场景×镜头语言×画面风格) |
| 04_对话库 | 账号专属,不设通用增量,仍在产出根目录 {账号名}/(开发机与用户环境同构:桌面 MCNSkill项目/,或用户自定义路径)下管理 |
| 分块定义 | 不设增量,统一使用 references/素材库/分块定义/ |
与 references/ 的关系
| 目录 | 定位 | 内容来源 | 修改策略 |
|---|---|---|---|
references/ |
原始标准库(内置) | Skill 开发时固化 | 不随部署变更 |
references-add/ |
动态增量库 | 用户对话中积累 | 随使用持续增长 |
引用优先级
创作流程执行时,按以下顺序同时检索:
references/(标准) + references-add/(增量) → 合并结果
两个目录的内容取并集:标准库内容优先,增量库作为补充。两处都存在时以 references/ 为准(增量不覆盖标准)。
⚠️ 唯一例外:路径配置。
路径配置.md中用户自定义的产出路径覆盖标准库默认路径(用户要求优先于内置默认)。
运行时加载规则(六大维度)
当 references-add/ 目录存在且有内容时,以下六个维度均须同时加载两个目录:
| 维度 | 加载规则 |
|---|---|
| 创作流程 | 执行每个步骤前,同时检查 references/创作流程/ 和 references-add/创作流程/。增量中的同名文件补充合并到标准流程(取并集) |
| 通用知识 | 检索时同时搜索 references/知识库/ 和 references-add/通用知识/。通用知识不限赛道,作为基础方法论补充 |
| 分赛道知识 | 创作前先确定赛道+叙事形态,然后检索 references-add/分赛道知识/{赛道}/{内容形式}/ 获取赛道专属方法论。与 references/知识库/ 的通用方法论合并使用 |
| 素材库 | 调取素材时同时检索 references/素材库/ 和 references-add/素材库/。取并集,标准库优先,增量作为补充 |
| 接口调用 | 需要调用外部接口时,同时查阅 references/接口调用/ 和 references-add/接口调用/。两个目录的接口定义均可用 |
| 铁律避坑 | 创作完成前,必须检索 铁律避坑规则/通用/ + 铁律避坑规则/分赛道/{当前赛道}/{当前内容形式}/,逐条检查是否违反铁律 |
| 路径配置 | 每次执行创作流程前,先查 路径配置.md。有「用户自定义路径」记录 → 以用户指定为准(覆盖标准库默认桌面路径);无记录 → 按两环境判定(技能处于源技能 git 检出内 → 开发机 → 桌面 MCNSkill项目/;不在任何 git 检出内 → 用户环境 → 桌面 MCNSkill项目/。两环境产出同构),再按系统解析桌面路径。此维度为增量优先特例 |