maogeigei
d07049ecf1
- 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
references-add/ — 用户部署后新增沉淀地（增量库）
本目录是用户部署到电脑后，新增的流程、方法、知识库的沉淀地，作为对 references/（默认标准库）的补充和扩展。
目录结构
references-add/
├── README.md ← 本文件
└── 路径配置.md ← 产出路径唯一权威（开发机/用户环境同构：桌面 MCNSkill项目/{账号名}/提示词{编号}/ 账号层直挂。运行时必读）
⚠️ 子目录按需创建，出厂不预置空目录（空目录不被版本库跟踪，部署时也不会存在）。 新增内容归入哪个目录见下方「文件命名规则」表：
制作流程/、接口调用/、功能/、知识库/{维度}/。
三层引用架构
| 层级 | 目录 | 定位 | 读写 |
|---|---|---|---|
| 1 | 参考skills/ |
外部参考技能（方法论来源，三大技能） | 只读 |
| 2 | references/ |
默认引用文件地址（出厂自带标准库） | 开发环境可编辑；部署环境只读 |
| 3 | references-add/（本目录） |
用户部署后新增沉淀地 | 可读写，持续增长 |
部署环境检测
根据**一步判定模型（仓库特征判定）**判断当前环境（看技能是否处于源技能 git 检出内）：
| 环境 | 判定条件 | 增量机制 | 新增内容写入位置 |
|---|---|---|---|
| ①开发机 | 技能处于源技能 git 检出内（git -C {技能目录} rev-parse --show-toplevel 返回仓库根） |
不启用 references-add/ | references/ 对应子目录 |
| ②用户环境 | 技能不在任何 git 检出内（技能无论装在哪、什么路径） | 启用 references-add/（本目录） | references-add/ 对应子目录 |
冲突检测与修复
用户在对话过程中新增方法、流程、知识库后：
- 比对检测：将新增内容与
references/中同类内容逐一比对（同名文件、同主题内容） - 无冲突：直接写入
references-add/对应子目录 - 有冲突：以新增内容为主（写入
references-add/），同时在references/对应文件中加 ⚠️ 注释标注冲突点及正确规则，不删除或覆盖原始内容
运行时引用优先级
技能执行时同时加载 references/ 和 references-add/，两者内容冲突以 references-add/ 为主：
参考skills/（方法论源） → references/（默认标准库） → references-add/（用户增量，冲突时以此为准）
完整规则详见
SKILL.md「动态增量管理」节。
文件命名规则
| 新增类型 | 归入目录 | 文件命名 | 示例 |
|---|---|---|---|
| 制作流程 | 制作流程/ |
{阶段号}_{制作环节}.md |
3_素材审验标准.md |
| 接口/平台规范 | 接口调用/ |
{接口名称}.md |
Seedance_平台限制.md |
| 功能细则 | 功能/ |
F{功能号}_{功能名}.md |
F1_图片反推细则.md |
| 提示词维度知识 | 知识库/{维度}/ |
{日期}_{知识主题}.md |
20260820_景别选择指南.md |
通用规则
- 防重复： 写入前先搜索
references/和references-add/中是否存在相似内容 - 格式要求： 每个文件包含知识来源（用户对话）和结构化提炼，非原始对话日志
- 维度归档： 知识库按 15 维度对号入座，非维度类内容归入
制作流程/或接口调用/ - 词汇分布： 各维度词汇表归入对应维度文件夹，不设独立词汇库
运行时加载规则
仅非开发机环境生效（②用户环境，即技能不在任何 git 检出内时）。同时加载 references/ 和 references-add/ 的内容，两者冲突时以 references-add/ 为主：
增量库子目录按需创建——下表中不存在的目录视为空，直接跳过即可，不必先建目录。
| 维度 | 加载规则 |
|---|---|
| 制作流程 | 先查 references/制作流程/，再查 references-add/制作流程/，同名文件以 references-add/ 为主 |
| 知识库 | 先搜 references/知识库/{维度}/，再搜 references-add/知识库/{维度}/，两目录共同参与检索，冲突时以 references-add/ 为主 |
| 接口调用 | 先查 references/接口调用/，再查 references-add/接口调用/，冲突时以 references-add/ 为主 |