diff --git a/project/短视频脚本创作/V1.0/SKILL.md b/project/短视频脚本创作/V1.0/SKILL.md index 9fbfe1e..d8ac9fb 100644 --- a/project/短视频脚本创作/V1.0/SKILL.md +++ b/project/短视频脚本创作/V1.0/SKILL.md @@ -9,7 +9,7 @@ description: > 诊断脚本质量、设计账号人设、选题策划、生成分镜、广告植入设计、生成创作回顾。 version: "1.0" updated_at: "2026-09-07" -last_change: "09-07 术语统一:D·视觉脚本→D·视觉短片、预设钩子→开场钩子(S5/S7 字段全量对齐,明细见 references-add/变更日志.md)" +last_change: "09-07 术语统一+分层源头化:D·视觉脚本→D·视觉短片、预设钩子→开场钩子(S5/S7 字段全量对齐);开场钩子分层源头化(S5 选方式/S6 做实现);新增规则「概念分层与源头表述规范」(明细见 references-add/变更日志.md)" deployment: "source" agent_created: true --- @@ -369,6 +369,7 @@ Skill部署到非原始开发路径时,所有用户新增的创作流程/接 > 判定标准+替换对照表+验证命令见:[创作流程规范.md](references/创作流程规范.md) 六 > **🔴 技能内一切文件引用必须用相对路径**(绝对路径随部署机器变化失效;md 链接相对自身文件解析、禁止越级出技能根)→ [路径引用规范.md](references/规则/路径引用规范.md) +> **🔴 跨步骤概念必须先分层再落笔**:策略层/实现层/容器层各写在各自主责环节的源头正文,下游只引用不重定义;禁止「X=Y」与括号标注在文档间打补丁(多了无法维护),发现不一致改源头正文 → [概念分层与源头表述规范.md](references/规则/概念分层与源头表述规范.md) ### 七、审计与修复工作方式 diff --git a/project/短视频脚本创作/V1.0/references-add/变更日志.md b/project/短视频脚本创作/V1.0/references-add/变更日志.md index 3e9ea0f..b671711 100644 --- a/project/短视频脚本创作/V1.0/references-add/变更日志.md +++ b/project/短视频脚本创作/V1.0/references-add/变更日志.md @@ -12,6 +12,7 @@ - **D·视觉脚本 → D·视觉短片(全量)**:S9 格式列举(SKILL.md)、S6 内容形式映射表(F04 测评种草/F07 纯视觉短片)、S9 正文 6 处、创作流程规范 3 处、03_框架节奏/07_脚本格式选择指南 8 处——与工作台需求框/用户既定术语对齐,消除「纯视觉短片→D·视觉脚本」混用。 - **预设钩子 → 开场钩子(全量)**:S5 选题方案字段(含 10 种开场方式引用)+ S7 大纲回扣语义 + 04_爆款开场/00_口径说明——对外统称「开场钩子」(=S6 场1 段名、工作台需求框 hook 字段同名同义),S5 阶段语义由「预设」改为直接以开场钩子表达。 - **需求框-技能衔接注明(mcn-work-shop/prompts/clarify.md)**:内容形式 4 项为粗选方向,落创作时细化为 S6 口径(口播→教程/知识分享/盘点,视觉短片→测评/沉浸式);故事框架四词(钩子前置/悬念反转/递进铺垫/先抑后扬)=达人倾向词,由 S6 用叙事形态 F01-F08 + 结构模板(三段式/五段式)定型。 +- **规则沉淀(09-07)**:新增 (先分层再落笔:策略/实现/容器各写源头正文;禁止 X=Y/括注跨文档打补丁,改源头正文;同族术语对外一个总称、改名一次全链路;含开场钩子家族案例);SKILL.md 红线摘要区新增 🔴 索引行;项目级 一致性维新增第 11/12 条(概念分层、源头表述自洽),编号重排 1→15,使用方法补层级先于枚举。 - **开场钩子分层表述源头化(5_选题 / 6_框架 / 04_爆款开场·00_)**:三个源头正文自洽——开场方式(04_ 库 10 种标准分类)由 S5 依据用户要求/账号结构性符号/对标拆解(S3)选定并写入选题方案;S6 场次表「本场钩子」=五类留人机制(悬念提问/反差画面/直击痛点/身份共鸣/利益承诺),场1 的本场钩子用于把 S5 已选开场方式实现为镜头与台词。消除 S5「钩子类型」一词双指(表头改「开场方式」、方案字段行改为单一开场方式成分);不再以对照式/括注维护,概念各归其位。 ## 2026-09-04(R73/R74 技能树体量优化) diff --git a/project/短视频脚本创作/V1.0/references/规则/概念分层与源头表述规范.md b/project/短视频脚本创作/V1.0/references/规则/概念分层与源头表述规范.md new file mode 100644 index 0000000..840de99 --- /dev/null +++ b/project/短视频脚本创作/V1.0/references/规则/概念分层与源头表述规范.md @@ -0,0 +1,44 @@ +# 概念分层与源头表述规范(防跨板块误读,P1) + +> 适用:技能树全部描述文件(创作流程 S 文件 / 知识库 / 规则 / 工作台 prompts·docs)。当同一个主题词跨多个步骤或板块出现、且相互之间容易被误读为"重复/冲突"时,按下述规范分层与表述。 +> 背景(2026-09-07 案例):「开场方式(10 种)」与「本场钩子(五选一)」曾被误判为两套冲突枚举,实为"策略层 → 实现层"两个层级——根因是源头正文未写清各自职责,且曾用"X=Y/括号标注"式补丁说明,越补越难维护。 + +## 一、先分层,再落笔 + +同一主题词在流程中跨步骤出现时,先判定其层级身份,再决定写在哪里: + +| 层级 | 含义 | 写法 | +|------|------|------| +| 策略层 | 决定"做什么"(选型/方向/内容策略) | 写在**做出该决定的步骤**正文 | +| 实现层 | 决定"怎么做出来"(手法/机制/落地) | 写在**执行该落地的步骤**正文,只引用策略层结果,不重选 | +| 容器层 | 流程上下文分类(如 S1 五维状态表) | 写在分类定义处,与内容字段分离 | + +规则: +1. 每一层只写在"负责它"的环节(源头正文),**下游只引用、不重定义、不旁挂解释**。 +2. 步骤正文里出现与本步骤职责无关的枚举/概念时,不要就地展开,改为流程语言指向源头("由 S5 选定,见…")。 + +## 二、源头正文自洽,禁止补丁式说明 + +1. 概念的身份(是什么)、来源(从哪来)、去向(交给谁落地)写进它的**产生环节正文**,用流程语言叙述(如:本步骤依据…选定…,写入方案…;落地由 S6 实现)。 +2. **禁止**用「X = Y」「X(即 Y)」或大段括注在多个文档间打补丁——补丁是分散的、需要跨文件同步维护,条目一多必然失同步。 +3. 若发现两处表述不一致,**改源头正文**统一,而不是在弱侧叠说明。 + +## 三、同族术语维护 + +1. 对外使用的统一总称只保留一处(如钩子家族对外总称「开场钩子」);细分概念各用职责名(「开场方式」= 开场内容策略、「本场钩子」= 留人机制),名称冲突时以职责命名,不以枚举集合命名。 +2. 术语改名 / 层级修正必须**一次覆盖全链路**:技能流程层(S 文件)+ 知识库 + 工作台(prompts / docs / 前端文案)同步,旧词只允许保留在变更记录中。 + +## 四、对照检查(新增概念或发现疑似冲突时) + +1. 该概念在哪些步骤/板块出现?逐处记录其**功能身份**(是字段名、列名、库引用,还是正文概念)? +2. 这些出现是否分属不同层级(策略 / 实现 / 容器)? +3. 每一层是否都写在自己的源头环节?下游是否只引用? +4. 有没有用括注或等式在非源头处打补丁?有 → 删除补丁,改写对应源头正文。 +5. 若两处同词异义:就近在**源头**用职责语言区分(如"本场钩子=留人机制,非开场方式分类;开场方式由 S5 选定"),而不是另立对照表。 + +## 五、案例:开场钩子家族(2026-09-07 定稿分层) + +- **开场方式**(策略层,`04_爆款开场` 库 10 种标准分类):回答"开场拍什么内容/用什么手法",由 S5 依据用户要求、账号结构性符号、对标拆解(S3)选定 1-2 种,写入选题方案的开场钩子字段。 +- **本场钩子**(实现层,S6 场次结构表列):回答"每场靠什么把观众留住",从 悬念提问 / 反差画面 / 直击痛点 / 身份共鸣 / 利益承诺 五类中选择;场1 的本场钩子把 S5 已选定的开场方式实现为镜头、台词与视觉爆点。 +- **开场钩子**(对外总称):指本条视频抓人开场的整体设计(含开场方式 + 本场钩子的落地),用于需求框字段名与对话口径。 +- 表述位置:S5(5_选题 4.3)写选定与来源;S6(6_框架 场次表 8 列定义)写实现;04_/00_ 写库定位与流程位置。三者正文自洽,无跨文件对照表。 diff --git a/技能审计检查清单.md b/技能审计检查清单.md index 2324f9a..b02e059 100644 --- a/技能审计检查清单.md +++ b/技能审计检查清单.md @@ -2,7 +2,7 @@ > 用途:审计技能文件(SKILL.md + references/ 全部分块)时,逐项对照的检查框架。 > 来源:2026-08-10 创作流程全量审计 P0/P1(7 条)的检查维度归纳。 -> 更新:2026-08-14 +> 更新:2026-09-07(一致性维新增「概念分层」「源头表述自洽」——开场钩子家族误判案例沉淀,规则详见 `references/规则/概念分层与源头表述规范.md`) --- @@ -34,33 +34,36 @@ | 6 | 上游→下游不断裂 | 上游输出字段,下游输入列表要引用 | S5「目标体感」S6/S7 没引用 | | 7 | 引用路径正确 | 引用走对层级(创作流程→知识库→素材库) | 素材库误走直接路径,应走知识库 05 间接引用 | -## 四、一致性(术语/字段/格式层面) +## 四、一致性(术语/字段/格式/表述层面) | # | 检查点 | 说明 | 之前案例 | |---|--------|------|---------| | 8 | 术语统一 | 同一概念一个叫法 | 「场次叙事格式」误作所有格式统称 | | 9 | 字段不缺失 | 输入列表字段完整 | S9 输入缺「框架方案」 | | 10 | 格式不矛盾 | 步骤间格式假设一致 | S10 假设 S9 用列表符号 | +| 11 | 概念分层 | 同族概念按职责分层(策略/实现/容器),每层写在责任环节源头,下游只引用 | 开场方式(策略,S5选) vs 本场钩子(实现,S6落地) 曾被误判两套枚举 | +| 12 | 源头表述自洽 | 概念关系用源头正文流程语言表达;禁止「X=Y」与括号标注在文档间打补丁;改名须一次覆盖技能层+知识库+工作台 | 开场钩子分层靠源头改写三文件解决,不留对照表 | ## 五、红线(P0 层面) | # | 检查点 | 说明 | |---|--------|------| -| 11 | 产物链完整 | 中间产物必须落盘,禁止只出最终产物 | -| 12 | 硬编码禁止 | 标准库(流程/知识库/素材库)禁账号名/角色名 | +| 13 | 产物链完整 | 中间产物必须落盘,禁止只出最终产物 | +| 14 | 硬编码禁止 | 标准库(流程/知识库/素材库)禁账号名/角色名 | ## 六、冗余(重复定义层面) | # | 检查点 | 说明 | |---|--------|------| -| 13 | 重复定义 | 同一概念不在多处重复定义(如 S9 格式定义与知识库重复) | +| 15 | 重复定义 | 同一概念不在多处重复定义(如 S9 格式定义与知识库重复) | --- ## 使用方法 -1. **逐条对照**:审计时按 1→13 顺序逐条检查,不要跳检。 +1. **逐条对照**:审计时按 1→15 顺序逐条检查,不要跳检。 2. **数据流优先**:第 6/7 条(引用链路)先画数据流(信息从哪来→落到哪→下游谁读),断点即缺口。 -3. **分级标注**:发现的问题按 P0(红线/断链)/ P1(不一致/冗余)分级,输出表格。 -4. **逐条修复**:修复时读一条→改一条→验证一条,禁止批量读取准备批量修改。 -5. **沉淀教训**:发现的失误及规避规则,追加到 `失误与规避记录.md`。 +3. **层级先于枚举**:第 11/12 条(概念分层/源头表述)先把同一概念各处的"功能身份"(字段名/列名/库引用/正文)标齐、判定层级,再判异同——禁止只看枚举集合就下"冲突"结论。 +4. **分级标注**:发现的问题按 P0(红线/断链)/ P1(不一致/冗余)分级,输出表格。 +5. **逐条修复**:修复时读一条→改一条→验证一条,禁止批量读取准备批量修改。 +6. **沉淀教训**:发现的失误及规避规则,追加到 `失误与规避记录.md`;可固化的表述/维护规则写入 `references/规则/` 下对应规范文件。