sync: 本地文件为准同步至仓库(含知识库更新、分镜脚本新增、参考skills清理)

This commit is contained in:
maogeigei committed 2026-08-25 09:34:39 +08:00
1 parent fc0e9ddb6b
commit 6fb6dc19ff
332 files changed
+33905 -10830

No files matched your search

@@ -0,0 +1,196 @@
# 技能审计报告 — 短视频分镜创作·分镜制作技能
> 审计依据:`技能审计检查清单.md`(13条检查点,6大维度)
> 审计范围:SKILL.md + references/(制作流程4文件 + 知识库15维度) + references-add/
> 审计日期:2026-08-20
---
## 审计结果总览
| 级别 | 数量 | 说明 |
|:---:|:---:|:---|
| **P0(断链/红线)** | 2 | 必须修复,否则技能执行会出错 |
| **P1(不一致/冗余)** | 5 | 应修复,影响执行一致性 |
| **P2(轻微)** | 1 | 可选修复 |
| ✅ 通过 | 5 | 无问题 |
---
## 一、流程清晰(检查点 1-3)
### #1 步骤顺序正确 — ⚠️ P1
**问题:** SKILL.md「视频提示词工作流」节(L276)仍描述"5 步工作流",但 F4 已升级为 6 步(新增 Step 1 剧本分析)。该节声称是"F2/F4 共用的框架",但 F4 流程实际为 6 步。
**具体位置:**
- L276:`### 5 步工作流` — 标题未更新
- L288:`5 步工作流是 F2/F4 共用的框架` — 此声明已不成立(F4=6步,F2=5步)
**修复建议:** 标题改为"视频提示词工作流(F2 5步 / F4 6步)";L288 改为"F2 使用 5 步工作流,F4 在此基础上前置 Step 1 剧本分析变为 6 步"。
### #2 步骤编号连续 — ✅ 通过
制作流程文件 Step 1→6 连续无跳号;SKILL.md F2 表格 Step 1→5 连续。
### #3 无跳步 — ✅ 通过
F4 流程 Step 1→2→3→4→5→6 无跳步;F2 流程 Step 1→2→3→4→5 无跳步。
---
## 二、边界清晰(检查点 4-5)
### #4 步骤间职责不越界 — ✅ 通过
- Step 1 剧本分析只做 5 维度拆解,不做路径选择
- Step 2 需求分析只做参数确认,不做提示词组装
- Step 4 只组装提示词,校验归 Step 5
### #5 字段归属正确 — ✅ 通过
- 人物设定 → 11字段模板字段③,归属正确
- 表演指令 → 字段⑩,归属正确
- 负面词 → 字段⑪,归属正确
---
## 三、引用链路完整(检查点 6-7)
### #6 上游→下游不断裂 — ⚠️ P1
**问题:** SKILL.md「视频提示词工作流」节与制作流程文件断裂。
- 制作流程文件 Step 1→Step 3 有引用链("结合剧本分析结论")✅
- 制作流程文件 Step 1→Step 4 有引用链("剧本分析产出是六要素组装的内容来源")✅
- **但** SKILL.md L276-321「视频提示词工作流」节完全没有提及 Step 1 剧本分析 — 用户只读 SKILL.md 时看不到 F4 需要先做剧本分析
### #7 引用路径正确 — ⛔ P0
**问题:** PromptSkill4image 目录已被删除,但 SKILL.md 仍有 **20 处引用** 指向它。
**断链清单:**
| 行号 | 引用内容 | 断链类型 |
|:---:|:---|:---|
| L8 | `融合三大参考技能方法论:PromptSkill4image` | 描述失效 |
| L30 | F1 主要参考技能 `PromptSkill4image` | 表格断链 |
| L32 | F3 主要参考技能 `PromptSkill4image + ShotDesign` | 表格断链 |
| L36 | `PromptSkill4image/` — 图像提示词工程 | 目录声明断链 |
| L58 | `参考skills/PromptSkill4image/SKILL.md` 标准输出模板 A | 文件引用断链 |
| L129 | `参考skills/PromptSkill4image/SKILL.md` 通用图片提示词 | 文件引用断链 |
| L222-236 | 维度表 8 处 `PromptSkill4image subject/action/scene/lighting/mood/color_scheme/material/render_quality/composition/style` | 维度来源断链 |
| L238 | `F1/F3 图片提示词维度体系另见 参考skills/PromptSkill4image/SKILL.md` | 路径断链 |
| L258 | `参考skills/PromptSkill4image/SKILL.md` 变量规则章节 | 文件引用断链 |
| L327 | `综合三大参考技能的最佳实践提炼` | 描述失效 |
| L407 | 目录结构 `PromptSkill4image/` | 目录声明断链 |
**修复建议:**
- L8/327:"三大"→"两大"(PromptSkill4image 已删除,只剩 seedance2.0 + ShotDesign)
- L30/32:F1/F3 主要参考技能改为"ShotDesign + 知识库/01/03/12/15"或内部自建图片提示词方法论
- L58/129/258:指向 references/ 内部文件或自建图片提示词模板
- L222-236:维度表"主要来源"列删除 PromptSkill4image,改为"知识库/对应维度"
- L36/407:删除 PromptSkill4image 目录结构声明
---
## 四、一致性(检查点 8-10)
### #8 术语统一 — ⚠️ P1
**问题:** "六要素"一词在 SKILL.md 中承载了两个不同含义:
| 位置 | 用法 | 实际指代 |
|:---:|:---|:---|
| L79 | F2 Step 3 "六要素组装" | F2 反推场景(应为基础六要素) |
| L94 | "六要素公式" | 制作流程公式(现已拆为基础六要素+11字段) |
| L163 | "基础六要素" | 简单场景模板 |
| L180 | "基础六要素/完整11字段" | 两种模板 |
| L222-224 | "ShotDesign 六要素" | 参考技能原始六要素 |
| L284 | "六要素精准组装" | 5步工作流 Step 3 |
| L294 | "六要素组装公式" | 公式展开 |
**SKILL.md 未说明 F2(反推)应使用基础六要素而非 11 字段。**
### #9 字段不缺失 — ⛔ P0
**问题:** 校验项数 7→8 未同步到 SKILL.md。
| 位置 | 当前值 | 应为 |
|:---:|:---:|:---:|
| L80 | F2 Step 4 "7 项校验规则" | 8 项 |
| L285 | 5步工作流 Step 4 "7 项校验规则" | 8 项 |
| L361 | "综合…7项强制校验规则" | 8 项 |
| L364 | "7项强制校验规则(视频提示词)" | 8 项 |
制作流程文件 Step 5 已正确更新为"8项"(新增第 2 项字段完整性检查),但 SKILL.md 自身的质量自检清单和 F2 工作流表格均未同步。last_change 字段写了"7→8"但实际未执行。
### #10 格式不矛盾 — ⚠️ P1
**问题:** F2 同一步骤在 SKILL.md 两处用了不同名称:
| 位置 | Step 3 名称 |
|:---:|:---|
| L79(F2 表格) | "六要素组装" |
| L284(5步工作流表格) | "六要素精准组装" |
制作流程文件统一用"提示词构建"。三处同一步骤三个名称。
---
## 五、红线(检查点 11-12)
### #11 产物链完整 — ✅ 通过
F4 有完整产物链:`00_剧本分析 → 01_需求分析 → 02-04_提示词 → 05_校验交付`。
### #12 硬编码禁止 — ✅ 通过
知识库 15 维度文件 + 制作流程 4 文件中未发现账号名/角色名硬编码。
---
## 六、冗余(检查点 13)
### #13 重复定义 — ⚠️ P1
**问题:** SKILL.md 与制作流程文件重复定义了同一段内容,且版本不一致。
| 重复内容 | SKILL.md 位置 | 制作流程文件位置 | 冲突 |
|:---|:---:|:---:|:---|
| 工作流步骤 | L276-288(5步) | L6-12(6步) | 步数不同 |
| 六要素公式 | L294-299 | L91-149(3.1基础+3.2完整11字段) | 版本不同 |
| 校验清单 | L360-394(7项) | L65-73(8项) | 项数不同 |
**修复建议:** SKILL.md 中这些内容改为引用指针(指向制作流程文件),不重复定义。保留概要表格但不写死项数。
---
## 附:其他发现
### A1. 接口调用/ 空目录 — P1
SKILL.md L448 声明 `接口调用/ ← 标准接口定义与平台规范`,但实际目录为空。平台规范内容已并入制作流程文件第六节。
**建议:** 要么将平台规范独立成文件放入接口调用/,要么删除该目录声明。
### A2. seedance25-timed-prompter.md 未纳入架构 — P2
`参考skills/` 下有 `seedance25-timed-prompter.md`(单文件,非目录),是 Seedance 2.5 专用技能。其内容已提炼到制作流程文件中,但 SKILL.md description 和目录结构声明未提及它。
**建议:** description "两大参考技能"改为"两大参考技能+1个2.5时间测算参考";目录结构补充该文件声明。
---
## 修复优先级
| 优先级 | 问题 | 修复动作 |
|:---:|:---|:---|
| **P0-1** | #7 PromptSkill4image 20处断链 | 全部删除/替换为内部引用 |
| **P0-2** | #9 校验7项→8项未同步 | SKILL.md 4处 7→8 |
| **P1-1** | #1 L276 5步/共用声明过时 | 标题+L288 改为 F2 5步/F4 6步 |
| **P1-2** | #8 六要素术语不统一 | F2 明确标注"基础六要素" |
| **P1-3** | #10 Step 3 三处名称不同 | 统一为"提示词构建" |
| **P1-4** | #13 重复定义且版本冲突 | SKILL.md 改为引用指针 |
| **P1-5** | A1 接口调用空目录 | 删除目录声明或填充内容 |
| **P2-1** | A2 seedance25 未纳入架构 | 补充声明 |