# 2026-08-12 工作日志

## 找回并重建两个历史分析文档（整理到内容创作产品规划）
- 用户要求找回8月10-11日对话中生成的2个分析，整理到 `project/内容创作产品规划/` 下
- 原分析文件已不存在：标杆案例目录（含编导大纲全文+密度拆解）在8月10日18:18被删除；2个分析是对话中生成的未独立存档
- 确认用户给定的2个标题：
  1. **全链路复盘：AI为什么写不出细节**（8月10日全链路复盘）
  2. **分析：没有素材库，光靠模型能做到什么程度？**（素材库边际价值分析）
- 从记忆日志（2026-08-10.md「全链路复盘+素材库基建+流程优化」）+ 做梦人设卡片 + 做梦素材库 + S7大纲v3.4 + S7/S11流程文件重建：
  - 核心数据：AI大纲≈25可拍摄单元 vs 编导大纲（亚朵）≈82个，差距3-4倍；编导密度拆解19具名物品/14对话组/82拍摄单元/137信息单元
  - 三大根因：知识库全方法论零素材（规则推理非场景翻译）/ S7无深度标准 / 人设卡片缺失素材维
- 产出文件（新建）：
  - `project/内容创作产品规划/01_全链路复盘_AI为什么写不出细节.md` — 差距量化/3大根因/9项优化清单/执行修正时间线/复盘结论
  - `project/内容创作产品规划/02_分析_没有素材库光靠模型能做到什么程度.md` — 裸模型vs有素材库对照/骨架层vs血肉层分界/信息量天花板/完整性偏好/素材库边际价值/模型极限边界
- 关键洞察：模型=规则推理器（骨架），素材库使其升级为场景翻译器（血肉）；25→82单元密度提升3倍+；素材库本质=把编导脑中私有账号知识结构化转移给模型

## 金句库→对话库拆分（按对话关系×对话场景）
- 用户指出金句库太泛：按「极致维度」（反常识/价值观冲击）组织是表达手法维度，与S6场次表情绪功能位（关怀/冲突/表白）维度不匹配，AI检索不到；做梦（情侣）和俊希（亲子）金句混在一个库
- 决定：**删除通用金句库（无应用场景）**，台词全部按「对话关系×对话场景」组织为账号专属对话库
- 执行：
  - 删除 `references/素材库/04_金句库.md`（通用层）
  - 做梦：`04_素材库_金句口头禅.md` → `04_素材库_情侣对话.md`，重写为6个对话场景分区（深夜加班关怀/日常口是心非/价值观金句/生活智慧独白/柔软时刻/可复用模板），每条新增「对话场景+关系类型」字段，极致维度降为辅助标签
  - 俊希：新建 `04_素材库_亲子对话.md`（放学互动/做饭协作/童言童语/鼓励教育/家庭温馨/可复用模板），风格基线=小学生童真+妈妈广西口音+叫观众"小姨"
  - 设计规范：2.3金句库→2.3对话库（命名说明+字段结构+做梦/俊希双示例+设计要点）；极致类型对照表/极致维度标签库/目录结构表/迁移清单同步
  - 模板指南：04_素材库_金句口头禅.md → 04_素材库_{关系}对话.md
  - SKILL.md + 索引_知识素材库.md + 产品规划MD + 素材库规划图HTML 全部同步
- 字段升级：对话场景（必填，AI检索主维度）+ 关系类型（情侣/亲子/职场/闺蜜/自我独白）+ 极致触点 + 极致维度（辅助标签）
- 命名规范：账号层 `04_素材库_{关系}对话.md`（情侣对话/亲子对话/职场对话/自我独白）

## 生成做梦账号脚本02全新大纲（仅用账号素材隔离测试）⚠️选题错误已重建
- 用户要求：只用 `case/做梦` 下信息（避免上下文干扰），结合之前选题「加班补偿餐」生成全新大纲，不覆盖旧文件
- **❌ 第一版错误**：`case/做梦/脚本02/07_短视频大纲.md`（v1.0）选题角度写成「体检报告触发」（五类机制c健康关怀，200块小钱做大菜）——与用户确认的正确选题不符
- **根因**：脚本01从未落盘 `05_故事选题.md`（只有06框架+07大纲），选题「1000块加班补偿餐+两点开会+亚朵枕头植入」只存在于对话上下文和框架标题中；上次仅读06/07未严格对齐，凭印象编造了选题，且误判「本期无Brief」忽略了脚本01已有亚朵枕头植入
- **✅ 重建**：补齐脚本01 `05_故事选题.md`（从06/07反推），脚本02重建完整链路 05选题→06框架→07大纲，正确选题=1000块加班补偿餐（女老板和国外客户开会到两点→转账1000块备注「点外卖就行」→做梦嘴上答应转头做大餐），差异化角度=口是心非双向奔赴（vs脚本01守夜静默版），亚朵枕头植入保留（对话显性植入vs脚本01无声植入）
- 密度自检全过：具名物品17/对话4组/步骤链1/环境细节5/拍摄单元55（L2标准）
- 注意：case/做梦/ 素材库编号有跳跃（01美食→03生活仪式→04金句→05装修布局），02缺位（原道具库已删或未建）

## 流程约定规则下沉技能本体 + 产物命名统一
- 背景：用户质疑「流程约定为什么写进长期记忆，有SKILL.md也有创作流程规范」——当时把「产物链必须完整」只写进了 WorkBuddy 项目记忆，技能本体（SKILL.md/创作流程规范）没有同步，部署到 CodeBuddy 等平台时规则会丢失
- 查明：技能本体其实已有产物落盘规范（SKILL.md 542行引用创作流程规范五），但存在两个缺陷：①只有「必须写入文件」没有「禁止跳步」硬约束；②产物命名双轨——规范写 `05_选题方案/06_脚本框架/07_脚本大纲`（旧命名），实际落盘（case/做梦/）是 `05_故事选题/06_短视频框架/07_短视频大纲`（2026-08-05重命名后未同步规范），S11里S1/S2还用了步骤名代替产物名（01_意图识别/02_需求完善 vs 规范01_需求拆分/02_需求拆解）
- 修复（4处）：
  1. 命名统一（3文件）：SKILL.md case目录树515-517、创作流程规范.md 407-409、11_脚本检查和诊断.md 7处引用（含S1/S2改为01_需求拆分/02_需求拆解）→ 全部对齐新命名
  2. 创作流程规范.md 五新增「🔴 过程产物链铁律（P0）」：全链落盘（只生成大纲也必须5→6→7全落盘）/信息只读已落盘文件禁止凭印象编造/文件即权威（历史旧命名按对应新命名处理）
  3. SKILL.md 关键规则新增「五、过程产物链必须完整（P0）」，指向创作流程规范五
  4. MEMORY.md 条目19改为指针（权威规则位置=SKILL.md关键规则五+创作流程规范五），保留教训案例
- 规则放置分层确认：SKILL.md（流程引擎+全局硬规则）→创作流程规范.md（协作机制+产出路径）→references/创作流程/N_xxx.md（步骤执行细节）→知识库/素材库（方法+素材）→case/（账号数据与产物）→MEMORY.md（仅本环境指针，不承担技能规则）

## 素材库新增镜头维度+画面维度 + 产品规划V1.3更新 + 知识库/素材库目录拆分
- 用户提出素材分块维度还差"镜头"和"画面"两个——不是素材类型差两个，是每条素材条目的字段维度差两个
- 现状：素材条目只有极致维度+适用场景双标签；装修布局库有机位信息但其他7个库零镜头/画面信息
- **新增两个通用分块维度**（词汇来自知识库10_分镜拍摄）：
  - 镜头维度：景别(5级)×运镜(9种)×机位角度(3种)×距离(5种)，标注格式`景别·运镜`
  - 画面维度：色调(5种)×光影(5种)×视觉焦点(4种)，标注格式`色调·光影·视觉焦点`
- 维度互补关系：极致触点回答"画面中发生什么"，镜头回答"怎么拍"，画面回答"什么风格"
- 双标签→四维标签过滤（极致维度×适用场景×镜头维度×画面维度）
- 美食库13字段→15字段（新增镜头维度+画面维度）
- F4分镜新增对接：镜头维度→分镜景别/运镜参数；画面维度→AI生图/生视频风格参数
- **产品规划更新**：`素材库/产品规划/短视频素材库产品规划.md` V1.2→V1.3（646行），金句库→对话库命名全同步、8库编号修正、架构图新增镜头/画面层、分块规范8类型全覆盖、附录D版本变更记录
- **分块定义新建**：`素材库/分块定义/素材库分块定义.md`（V1.0）——4通用维度标签库+8素材类型字段定义+每类型1个分块示例+四维标签过滤示例+分块质检清单
- **目录拆分**：`2_短视频创作知识库/` 拆为 `知识库/`（产品规划+入库规范+分块示例14文件+标签库14文件）和 `素材库/`（产品规划+分块定义）

## 素材库分块定义按类型拆分（对齐知识库分块示例模式）
- 用户指出分块定义"不太对"——知识库的分块示例是按创作维度每个一个独立文件（01_账号定位_分块示例.md…13文件），素材库应该按素材类型拆分，不是合并大文件
- 执行：删除合并的 `素材库分块定义.md`，拆为9个独立文件：
  - `00_通用维度_分块定义.md` — 4个通用分块维度完整标签库（极致11/镜头/画面/场景）+ 四维标签过滤 + 通用质检项
  - `01_美食库_分块定义.md` / `03_生活仪式库` / `04_对话库` / `05_装修布局库` / `06_生活服务库` / `07_穿搭库` / `08_妆容库` / `11_造型库` — 每文件含字段结构定义表 + 分块示例(1-2个) + 入库检查表
- 每个类型文件自包含：字段定义+示例+质检，引用00通用维度标签库
- 产品规划附录C新增「分块定义」索引行，指向00+8类型文件

## 技能素材库同步四维标签V1.3（references/素材库对齐产品规划）
- 用户指出 `references/素材库/`（技能实际素材库）与产品规划不一致——规划已升级四维标签+镜头/画面维度，实际素材库还是双标签+13字段
- 同步更新（10个文件）：
  1. `素材库设计规范.md` V1.3：头部双标签→四维标签过滤；新增1.4镜头维度标签库+1.5画面维度标签库+1.6四维标签过滤机制；美食库13→15字段+示例补镜头/画面；6个类型库字段结构全补镜头/画面；S7展开规则加镜头维度；S11加镜头/画面标注检查；新增3.4 F4分镜调用；目录结构表13→15字段；迁移清单新增第12条
  2. `模板_账号素材库创建指南.md`：定位金句→对话；双标签→四维标签；8个模板字段全补镜头/画面；最低要求同步
  3. 4个通用美食库文件（中式家常8道/煲汤5道/仪式感5道/宵夜3道=19道）：头部13→15字段说明+每道菜补镜头/画面维度
  4. 6个模板库（03生活仪式/05装修布局/06生活服务/07穿搭/08妆容/11造型）：头部四维标签+字段结构补镜头/画面
  5. SKILL.md素材库目录树：13字段→15字段、双标签→四维标签、金句库→对话库
  6. `索引_知识素材库.md`：美食库条目13→15字段、设计规范双标签→四维标签
  7. `case/做梦/01_素材库_美食.md`：11道菜全补镜头/画面维度（特写·微推/俯视·固定等+暖色·蒸汽漫射·食物光泽等）
- 知识库12_拆解评估的"反推13字段"是知识库自身术语（爆款文案反推13字段），与素材库无关，未改
- 验证：所有素材文件极致触点/镜头维度/画面维度覆盖一致，无"双标签/13字段"残留（仅设计规范迁移清单历史记录保留）

## 技能素材库清理多余文件 + references-add补充素材库维度
- **素材库清理**：用户要求 `references/素材库/` 去掉与产品规划不同步的多余文件
  - 删除6个不属于8素材类型+分块定义结构的文件：食材与烹饪知识.md/家居与卧室知识.md/产品植入话术模板.md/行为暗示_示例集.md/素材库设计规范.md/模板_账号素材库创建指南.md
  - 同步更新3个引用文件：SKILL.md目录树（去掉6条+加"分块定义/"条目）、索引_知识素材库.md（去掉6条+加分块定义表）、创作流程/7_生成短视频大纲.md（"参见素材库设计规范"→"参见素材库/分块定义/"）
  - 全项目grep确认零残留引用
  - 清理后技能库与产品规划完全对齐：8素材类型文件（执行内容，只在技能库）+ 分块定义/9文件（同步）+ 产品规划/2文件（设计文档，只在规划）
- **references-add补充素材库维度**：用户发现README.md和SKILL.md的references-add结构定义缺少素材库维度
  - 原有5维度：创作流程/接口调用/通用知识/分赛道知识/铁律避坑 → 新增第6维度：素材库
  - README.md更新：用途描述加"素材内容"、结构树加素材库/子目录、新增"素材库"章节（命名规范/字段结构/04对话库账号专属/分块定义不设增量）、运行时加载规则"四大维度"→"六大维度"（原文已有5行但标题写4，一并修正）+加素材库行
  - SKILL.md更新4处：整理规则表（五类→六类+加素材库行）、运行时加载规则表（五大维度→六大维度+加素材库行）、目录树（加素材库/子目录）、文件分类说明表（加素材库行）
  - 素材库增量规则：与references/素材库/同结构同字段（四维标签）、04对话库账号专属不设增量、分块定义不设增量统一用标准库

## 技能文件引用路径全面检查与修复
- 用户要求整体检查 skills 文件引用路径是否与产品规划同步
- **P0 失效引用修复（4处）**：SKILL.md中步骤1/2的链接和目录树使用旧文件名（`1_需求拆分任务规划.md`→`1_意图识别.md`、`2_任务需求拆解完善.md`→`2_需求完善.md`），创作流程规范.md已用新名但SKILL.md未同步
- **P1 描述/文件名不一致修复（3处）**：SKILL.md L406/L500 + 创作流程规范.md L355 描述"共鸣本质论"→实际文件名"共鸣的理解"（文件内容内部自称"共鸣本质论"是概念名不需改）
- **P1 目录树缺失补充**：SKILL.md目录树补充`帮助文档.md`和`scripts/Douyin_Video_Analysis_API.py`
- **P1 计数/范围修正**：知识库文件数68→69（4+8+8+11+5+2+6+9+4+3+1+8=69）；知识库范围`01~10_*/`→`01~12_*/`（2处）
- **P1 Case目录命名规范对齐**：SKILL.md从`账号{账号名}`→`{账号名}`（如`做梦`），`达人设定.md`→`00_{账号名}人设卡片.md`；创作流程规范.md同步；11_脚本检查和诊断.md 3处引用同步
- **与产品规划同步状态**：素材库（8类型+分块定义9文件）✅完全对齐；知识库维度（技能V1.0 12维度 vs 规划V2.0 13维度）为已知差距，V2重构未落地

## 技能目录重命名 + 分镜术语清理
- **目录重命名**：`1_脚本创作方法/` → `脚本创作技能/`；同步更新6处引用（SKILL.md×2 + 创作流程规范.md×3 + 短视频素材库产品规划.md×1）+ MEMORY.md路径；历史日志不改
- **分镜术语清理**：去掉"导演"和"执行"修饰词
  - "导演分镜" → "分镜"（全局替换）
  - "详细执行分镜" → "详细分镜"（全局替换）
  - "简版导演分镜" → "简版分镜"
  - "执行分镜"（独立使用）→ 删除，只保留"详细分镜/拍摄分镜"
  - "导演审阅反馈" → "审阅反馈"
  - "分镜导演"（角色名）→ "分镜师"
  - 涉及5文件：SKILL.md + 帮助文档.md + 创作流程规范.md + 10_生成短视频分镜脚本.md + 11_脚本检查和诊断.md
  - 验证：全项目grep零残留（"详细执行任务"是步骤1需求拆解术语，与分镜无关，不改）
  - **二次清理（统一术语）**：去掉"简版分镜/详细分镜"区分，统一为"分镜脚本"
    - 步骤10文件重写：移除模式A/B结构+11列拍摄表+附录+详细User Prompt模板，只保留段落级标注格式
    - SKILL.md 8处修改：description流程/核心能力/触发条件/步骤列表/步骤描述/格式规范/目录树/case目录
    - 帮助文档.md/创作流程规范.md/11_脚本检查和诊断.md 各1处
    - 创作流程规范.md 分镜格式章节：移除模式A/B+11列+列定义+额外输出，统一为单一分镜脚本格式
    - 验证：全项目grep"简版分镜|详细分镜|模式A|模式B|11列|段落级拍摄"零残留

## S4人设卡片模板 V2.0 融合升级（七维度+八维度 → 约束引擎）
- 背景：用户问 S4 模板（七维度账号设定+八维度达人人设）是否需要优化/融合新版本。实际三张人设卡片（做梦/俊希/旧梦留声机）从未按模板结构写过，模板与实际产物两套结构完全脱节
- 冗余检查：S4模板内部有2处重叠（核心人设逻辑四标签≈八维度身份/性格/表达；传播元素记忆符号≈八维度第8条符号标签）；三张实际卡片章节一致无冗余；融合方案是替换关系不并存
- **V2.0 三段结构**：
  1. 账号定位（元数据摘要6字段）：名称/赛道/内容形式/目标受众/变现模式/差异化定位
  2. 达人设定（约束引擎8章节）：核心定位/超级符号/表达DNA/内容运营法则(心智模型)/内容决策规则(决策启发式)/结构偏好/内在张力/诚实边界
  3. 账号类型适配：个人账号填二；群像账号用内容DNA+角色原型库替代个人设定，保留运营法则/决策规则/诚实边界，可选叙事引擎/制作风格体系/IP系列化/风险护栏
- 8章节来自三张实际卡片共识（不是凭空设计）：做梦/俊希=核心定位→超级符号→结构→运营法则→决策规则→表达DNA→内在张力→诚实边界；旧梦留声机=内容DNA→角色原型库→叙事引擎→制作风格→IP系列化→差异化壁垒→决策规则→风险护栏
- 修改文件（8个）：4_账号设定解析和确认.md（全文重写：业务逻辑/处理规则/提示词/输出模板/确认清单/Gate-1）+ SKILL.md 3处（核心能力/步骤4目的输出/目录树）+ 帮助文档.md 1处 + 2_需求完善.md 1处 + 5_生成短视频选题.md 1处 + 6_生成短视频框架.md 1处 + 11_脚本检查和诊断.md 1处
- 验证：正式链路零"七维度/八维度/8维度"残留（仅 _meta/ 历史归档有意保留）
- 设计原则：模板从"描述型信息清单"→"约束型创作引擎"——每个章节下游都有消费点（S5查决策规则/S9查表达DNA/S11查张力边界），七维度元数据压缩为摘要不单独成表

## 人设卡片模板 V2.1 术语通俗化 + 补回缺失维度（用户强烈要求）
- 用户反馈：①旧八维度（达人名称/身份人设/性格人设/说话行为风格/语言风格例句/价值观定位/外在特质/专属符号标签）内容好，新版不该丢；②"表达DNA"等术语生硬，编导看不懂，"用词要贴近编导贴近用户"
- **术语来源自省**：心智模型/决策启发式=认知心理学直译（AI重构模板时引入）；表达DNA=互联网流行语（AI造词）；内在张力/诚实边界/超级符号=文艺理论/营销学术语。全部是模型"学术腔"，无任何编导参与，旧版模板反而是通俗词（说话/行为风格、价值观&定位）
- **V2.1 达人设定8章节（融合旧八维度+新约束，全编导语言）**：
  1. 身份人设（角色定位一句话+社会身份/职业/家庭角色）
  2. 性格人设（核心性格2-3词+人物反差1-2组）
  3. 外在特质（外貌/穿搭/气质+记忆符号2-4个）
  4. 价值观与底线（相信什么/不能做什么/必须诚实什么）
  5. 说话风格（语言风格+口头禅/开场语+句式习惯+典型例句）
  6. 内容打法（持续出爆款的规律3-4条）
  7. 创作决策（遇到具体场景怎么拍5-6条）
  8. 结构偏好（三段式/五段式+时长）
- **术语替换表**：表达DNA→说话风格、超级符号→记忆符号、内容运营法则(心智模型)→内容打法、内容决策规则(决策启发式)→创作决策、内在张力→人物反差、诚实边界→人设底线（卡片）/价值观与底线（模板）、内容DNA→内容基因、叙事引擎→情绪结构、制作风格体系→视听风格、IP系列化设计→系列内容规划、风险护栏→红线清单
- S4新增禁止规则：用词贴近编导，禁止学术化术语（心智模型/决策启发式/张力/DNA等）
- 修改文件：4_账号设定解析和确认.md（全文重写）+ 帮助文档.md 1处 + 11_脚本检查和诊断.md 1处 + 3张人设卡片全部章节标题 + case下"超级符号"批量替换（sed 5文件）+ 决策规则6→创作决策6等简称引用4处
- "法则X"小节保留（"爆款法则"是编导常用语不生硬）；原始设定信息.txt 是用户语料不动；S4禁止规则行有意保留
- 验证：全项目零残留（仅txt语料+禁止规则）
- **术语再修正（2026-08-12 14:46）**：「创作决策」→「行为决策」（用户指出该章节内容=遇到具体场景怎么做，条件→做法，本质是行为决策而非宽泛的创作决策）。sed 批量替换8文件18处：4_账号设定解析和确认.md（10处）+ 帮助文档.md 1处 + 11_脚本检查和诊断.md 1处 + 三张人设卡片章节标题（俊希"五条"、做梦/旧梦留声机"六条"）+ 简称引用（行为决策3/行为决策6 共3处）。保留：3_对标视频账号拆解.md 的"创作决策"普通叙述2处（泛指非章节引用）。上一条记录中"内容决策规则→创作决策"现为→行为决策
- **S4模板层级重构（2026-08-12 14:48）**：「内容怎么做」从达人设定移至账号设定（用户指出：账号设定=频道/内容层，达人设定=人物层，内容怎么做是频道内容策略非人物属性；佐证：群像适配早已把内容打法/行为决策列为"账号级约束"，个人账号却挂达人设定下，自相矛盾）。新结构：**账号设定 = 账号定位6字段 + 内容怎么做3章节（内容打法/行为决策/结构偏好）**；**达人设定 = 人物层5章节（身份人设/性格人设/外在特质/价值观与底线/说话风格）**；群像适配：账号设定直接适用，内容基因+角色类型库替代个人达人设定，保留价值观与底线（账号级红线）。修改文件：4_账号设定解析和确认.md（全文重写）+ SKILL.md 3处 + 帮助文档.md 1处 + 11_脚本检查和诊断.md 1处 + 2/5/6步骤引用3处；验证零残留。三张人设卡片保持原结构（完整账号文档，未按新分层重排）
- **行为决策归位达人设定（2026-08-12 15:00）**：用户指出"行为决策=人物遇到场景怎么做"，群像/情侣账号每个达人行为不同，应属达人设定而非账号设定。同时发现模板与产物错位：模板示例（经费不足→小钱做大菜）是人物行为，三张卡片实际填的"行为决策"内容（开头3秒经费/视觉奇观/洗碗定格）全是视频制作检查。拆分为两概念：**制作检查（账号级）= 视频怎么做才对（如果…则…），归账号设定"内容怎么做"第2章节；行为决策（达人级）= 人物遇到场景会怎么做（条件→做法），归达人设定第6章节，多达人账号每人一份**。账号设定=账号定位6字段+内容怎么做3章节（内容打法/制作检查/结构偏好）；达人设定=6章节（身份/性格/外在/价值观与底线/说话风格/行为决策）。修改：4_账号设定解析和确认.md 全文重写 + SKILL.md输出行 + 帮助文档 + 11诊断 + 三张卡片章节名（行为决策→制作检查）+ 脚本01/07大纲与脚本02/06框架引用（行为决策3/6→制作检查3/6）；验证零残留
- **制作检查移除 + 视听风格/系列内容入模板（2026-08-12 15:20）**：用户评估"制作检查"作用（三卡17条中15条被内容打法/结构偏好/红线清单100%覆盖，仅做梦2条独特），结论：验收清单功能与S11质检重复→独立章节移除，独特条目迁移（做梦外贸细节→内容打法法则二新增"身份落点"；摩擦来源→新增"法则五：摩擦必须来自人设"，做梦=金牌型严禁翻车挽尊）。同时"内容怎么做"3章节→4章节：内容打法/结构偏好/视听风格（新增，画面/声音/节奏/文案调性+操作指引，参考旧梦卡片"视听语言六维度"实践）/系列内容（新增，系列定位+单集故事模板，参考旧梦"系列内容规划"）。群像适配中视听风格/系列内容从可选提升为账号设定必填。改动：4_账号设定解析和确认.md 全文重写 + SKILL.md输出行 + 帮助文档 + 11诊断 + 三张卡片（做梦：删制作检查→新增视听风格、系列定位升级系列内容、四大内容打法→五大；俊希：删制作检查→新增视听风格+系列内容；旧梦：删制作检查，章节号前移）；脚本引用（制作检查3→法则二+四、制作检查6对齐→法则五对齐）；验证零残留
- **人设卡片去00_前缀（2026-08-12 15:05）**：用户质疑 `00_旧梦留声机人设卡片.md` 前缀无用。评估：`00_` 仅起排序置顶作用（排到素材库01-05和脚本目录前），无业务语义，且与素材库编号体系（01-05）混淆，去掉后仍排在脚本目录前→判定作用不大，去除。三张卡片统一改名（做梦/俊希/旧梦留声机）：`00_{账号名}人设卡片.md` → `{账号名}人设卡片.md`。同步4文件8处引用（SKILL.md 3处+创作流程规范2处+11诊断2处+4_账号设定1处）+ MEMORY.md 3.5条；验证零残留
- **内容规则恢复（认知纠偏，2026-08-12 18:30）**：用户纠正此前删除「如果…则…」格式内容的决策错误——**这不是制作检查/验收清单（事后），是账号的内容规则（事前约束：内容必须这么做）**。"之前的验收清单误导了，不是事后验收，是账号内容规则"。定位错误导致删除错误，现恢复：
  - **模板**：`4_账号设定解析和确认.md`「内容怎么做」4章节→5章节（内容打法/新增**内容规则**/结构偏好/视听风格/系列内容），同步11处（B章节表/两处确认清单②⑤/输出板块表/System Prompt核心任务2+重要规则2行/User Prompt/输出模板表/行为决策注释）；SKILL.md输出行 + 11诊断S4行同步；顺带修复11诊断L190残留的`00_{账号名}人设卡片`引用
  - **内容规则定义**：账号级内容铁律，5-8条"如果…则…"（条件→做法），从选题到成片全程生效，非事后验收；与达人设定行为决策区分（内容规则=账号级，行为决策=人物级）
  - **三张卡片恢复**（内容打法章节后插入「内容规则」章节，后续章节号顺延）：做梦 6条（开头3秒经费/视觉奇观/吃饭口是心非/洗碗定格/外贸细节/摩擦对齐人设）12章→13章；俊希 5条（小学生身份/菜钱极端/钱来源故事/童真/邪修小妙招）10章→11章；旧梦留声机 6条（3秒揪心/**角色加缺点**/高潮不解释/核爆不拖/收口不喊口号/选题真实）11章→12章——「角色加缺点」为此前评估遗漏、新版缺失细节，本次随内容规则恢复
  - **恢复来源**：旧梦旧版=Downloads快照（原「六条内容决策规则」）；做梦/俊希旧版=git历史 `00_` 前缀版本（git show HEAD:…）
  - 验证：三卡章节号连续无断号、无旧术语残留（制作检查/内容决策规则/决策启发式/制作风格体系）、无旧章节号引用、无脚本层级副本需同步

## 脚本创作技能全面去硬编码
- 起因：用户发现 `脚本创作技能/case/做梦/01_素材库_美食.md` 重复目录（15字段升级版误写技能根目录而非V1.0/case/）
- 处理：删除技能根目录下重复case/，15字段版同步到 `V1.0/case/做梦/01_素材库_美食.md`
- SKILL.md L549 `如 做梦、大炮说电影` → `运行时由用户提供`
- 全面排查8文件30处硬编码，分P0/P1两级处理：
  - **P0（创作流程引擎，11处）**：`5_生成短视频选题.md` 9处（俊希露营案例/金钱机制/小姨/广西口音/亲子养成类→通用占位符）、`MCN_CYLG_python.md` 2处（俊希API示例→亲子美食账号）
  - **P1（素材库分块定义，19处）**：6个分块定义文件（00通用维度/01美食库/03生活仪式库/04对话库/05装修布局库/07穿搭库）做梦/俊希→账号A/账号B、女老板→角色A、做梦→角色B、俊希→账号B
  - 知识库1处：`选题三环模型_共鸣切入点设计.md` "金钱机制"→"孩子掌管家庭开支的固定环节"
- 最终验证：全项目grep零残留（做梦/俊希/大炮/女老板/小姨/广西口音/手绘手表/金钱机制）
- **硬编码禁止规则写入技能本体**：SKILL.md 新增「关键规则六·硬编码禁止规则（P0）」（三条红线表+判定标准+指向创作流程规范），创作流程规范.md 新增「六、硬编码禁止规则」（分区规则表+关键区分：素材库存具体物品≠硬编码+替换测试判定法+命名替换对照表+grep验证命令）。规则核心区分：创作流程/知识库禁止账号名角色名；素材库标准库禁止账号绑定但允许具体物品；case/账号专属目录全允许

## MCN MCP 配置 + 技能内嵌 MCP 自动安装机制
- 用户配置两个 MCN MCP 服务到 `~/.workbuddy/mcp.json`：
  - `myai-mcp-s`（test 环境）：`MYAI_ENV=test`，API=`http://maiya-trans.test.youmanvideo.com/api`
  - `myai-mcp-prod`（prod 环境）：`MYAI_ENV=prod`，API=`https://maiya-trans.youmanvideo.com/api`
- 用户问：技能添加到 WorkBuddy 项目后，路径是否会有问题、MCP 是否会自动安装
- **路径检查结论**：技能已全部使用相对路径（grep 绝对路径零残留），Python 脚本纯标准库无第三方依赖，API 密钥通过环境变量读取，SKILL.md 明确声明"可直接拷贝到任意电脑部署"——路径无问题
- **MCP 自动安装结论**：MCP 配置是用户级（`~/.workbuddy/mcp.json`），项目级 skill 无法自动安装 MCP；当前技能 API 调用走 Python 脚本（Dify 接口），不经过 MCP
- **MCP 内嵌自动安装机制（用户提出并实施）**：
  - 技能根目录新建 `mcp-config.json`（含 `myai-mcp-prod` 正式环境配置）
  - SKILL.md 新增「MCP 依赖与自动配置」章节（触发条件后、11步流程前）：
    - 4步自动检测引导：检测 MCP 可用→提示用户→同意则读 mcp-config.json 合并到 ~/.workbuddy/mcp.json→提示 Trust
    - 降级策略：MCP 不可用时步骤3(视频解析)/步骤5(创意灵感)降级为用户手动提供，步骤1-2/4/6-11 不受影响
  - 目录结构同步更新（新增 mcp-config.json 条目）
  - 核心设计：MCP 配置随技能走，组员使用时自动检测+引导安装，拒绝则降级
  - **mcp-config.json 移至 scripts/**：从技能根目录移到 `scripts/mcp-config.json`，根目录只留入口文件（SKILL.md+帮助文档.md），SKILL.md 4处引用同步更新
  - **双环境策略**：mcp-config.json 含 `myai-mcp-prod`（正式）+`myai-mcp-test`（测试）两个服务；SKILL.md MCP 段新增「环境判定与安装策略」——复用已有的部署检测机制（路径含 `MCNVideo AI` = 开发环境），开发环境同时装两个（推荐两都装/可选只装正式），非开发环境只装正式；安装引导流程步骤2增加环境判定分支
  - **Douyin_Video_Analysis_API.py 弃用**：原 Python 脚本已删除，全部功能由 MCP 工具替代（upload_douyin_video / upload_other_video / short_video_detail）。接口文档 `Douyin_Video_Analysis.md` 重写为 MCP 工具调用说明（弃用声明+三工具表+两种场景流程+返回字段+降级策略+环境对照）。SKILL.md 6处引用同步更新（description/目录树scripts/目录树接口调用/分类表脚本行/分类表接口行/降级策略表）。帮助文档.md 工具接口表新增本地视频解析示例。scripts/ 现仅剩 MCN_CYLG_API.py + mcp-config.json
  - **登录状态自动检查 + 等待超时上限**（2026-08-12 17:22）：
    - SKILL.md MCP 段新增「登录状态检查」子章节（降级策略前）：每天检查一次（运行时内存缓存），流程 auth_status→feishu_login→auth_status→submit_auth_code兜底→auth_status终确，3次失败进入降级
    - 接口文档 `Douyin_Video_Analysis.md` 前置条件新增「登录状态自动检查」段（5步流程+缓存规则）
    - 等待时间：3-5分钟 → 最多15分钟（两处场景流程+轮询间隔1-2分钟+超过15分钟判定超时）
    - 降级策略表新增4类降级原因表（MCP未安装/登录失败/服务异常/解析超时），SKILL.md 降级策略表同步补充登录检查前置+降级触发条件4类
  - **MCP 内容架构重构（单一权威源）**（2026-08-12 17:27）：
    - 问题：MCP 操作细节占 SKILL.md 77行，且与 Douyin_Video_Analysis.md 大量重复（登录检查/降级策略/环境对照各写两遍）
    - 新建 `references/接口调用/MCP_工具调用规范.md`（123行）作为 MCP 操作规范单一权威源：服务依赖表/环境判定/安装引导/登录检查5步/降级策略/工具清单10个
    - SKILL.md MCP 段从77行精简到12行（摘要+指针 → 指向 MCP_工具调用规范.md），总行数 688→622
    - Douyin_Video_Analysis.md 从153行精简到96行，删除重复的登录检查段和降级策略段，改为 §指针引用，只保留视频解析专属内容（3工具/2场景/返回字段/流程集成）
    - SKILL.md 目录树+分类表同步更新（新增 MCP_工具调用规范.md 条目）
    - 原则：SKILL.md 是入口不是手册，操作细节下沉到接口调用目录，单一权威源不重复
  - **SKILL.md 精简大重构（622行→300行，-52%）**（2026-08-12 17:37）：
    - 提取6个区块（均有独立权威源）替换为摘要+指针：
      1. 创作模式（27行→3行+指针→创作流程规范.md二）
      2. 触发条件（32行→2行+指针→帮助文档.md，详细列表移入帮助文档.md）
      3. 关键规则全文（103行→40行摘要+指针，6条规则各保留P0标注+核心一句话）
      4. 文件目录结构（198行→20行概览+4个指针→索引_知识素材库.md/创作流程规范.md五/README.md/帮助文档.md）
      5. 知识库分类维度表（18行删除，三重复制→索引+规范已有）
      6. 快速启动模板（25行移入帮助文档.md，SKILL.md保留1行指针）
    - 帮助文档.md同步更新（89行→150行）：新增触发条件详细列表（5类16条）+快速启动模板
    - 验证结果：20个指针目标文件全部存在✅；零硬编码残留✅；无其他文件引用SKILL.md旧章节✅
    - 影响分析结论：对流程/知识库/素材库/后续迭代均无负面影响；消除重复内容同步风险

## 广告植入方法论层级化重构（L1-L4，2026-08-12 14:40）
- 起因：用户提供商业版广告植入 Dify 应用 System Prompt（双模式：模式一 Brief 抽取 / 模式二 大纲植入），要求提炼进 `知识库/11_广告植入方法论/广告植入方法论.md`，**按重要层级有序组织，方便作为 AI 上下文参考**
- 结构：7章 → 四级体系（20小节），章节标题统一为 `L#-#` 格式便于引用字面匹配：
  - **L1 铁律（一票否决）**：L1-1 Brief至尊（8维字段，缺失不编造）/ L1-2 核心切入≠内容方向 / L1-3 大纲冻结原则 / L1-4 合规红线（5项+**禁词对照表**6类）
  - **L2 结构**：L2-1 四段式分框架（开场/展开/高潮/收口，各段植入任务）/ L2-2 植入黄金位（5位对齐四段式）/ L2-3 五种植入方式 / L2-4 品牌调性 / L2-5 卖点分层（主1+次2-3）
  - **L3 执行**：L3-1 口播写法（感受+分享定位/三段式/**时长匹配3-4字每秒±3秒**/记忆锚点）/ L3-2 花字分工（硬性信息）/ L3-3 镜头卖点绑定（口播+镜头+花字三层）/ L3-4 卖点分散 / L3-5 位置时长优先级（位置>时长）/ L3-6 连贯性四条 / L3-7 场景客观性 / L3-8 禁写清单 / L3-9 植入设计模板（动笔前三问）
  - **L4 评估**：L4-1 自然度评估量表 / L4-2 内容损伤度规则
- 排除项（属流程/输出层不入库）：双模式判断、植入要素总览字段、自检清单
- **引用同步**：8_植入广告内容.md 6处（旧`（一、…+五、…）`格式→L#-#格式；悬空引用"按平台/赛道的口播长度规范"→L3-1 时长匹配补齐）；索引_知识素材库.md L114 描述更新；创作流程规范.md L331 描述更新；验证旧式中文数字引用+悬空引用零残留
- 经验：方法论重构前必须全量盘点引用（5文件17处），章节编号变更会破坏所有 `（一、…）` 式引用；`L#-#` 命名让文档标题与引用字面匹配，AI 检索零歧义

## MCP 服务重装+skill模板同步（2026-08-12 18:45）
- 重装 myai-mcp 两个服务到 `~/.workbuddy/mcp.json`：`myai-mcp-test`（MYAI_ENV=test）+ `myai-mcp-production`（MYAI_ENV=prod），npx -y myai-mcp 启动；生产环境飞书授权成功（人觉/6ga153ef）
- npm 最新版 myai-mcp v0.1.2（10 工具：auth_status/feishu_login/submit_auth_code/current_user/logout/upload_douyin_video/upload_other_video/short_video_detail/list_hot_accounts/hot_account_detail）
- **skill 模板命名同步**：`myai-mcp-prod` → `myai-mcp-production`（4 文件：scripts/mcp-config.json + SKILL.md L54 + MCP_工具调用规范.md 11处 + Douyin_Video_Analysis.md L3），grep 验证旧命名零残留
- 部署到用户机器：只装 production（MYAI_ENV 必须显式 prod，否则上传落到 commentary/test/ 路径）

## 帮助文档同步最新改动（2026-08-12 18:55）
- 目标：`V1.0/脚本创作技能/帮助文档.md`，同步两块最新改动（广告植入方法论 L1-L4 重构 + MCP 服务命名/新能力）
- 更新 7 处：①写脚本-带货行补"L1铁律→L2结构→L3执行→L4评估"；②账号定位-新增MCP拉取账号设定示例；③诊断评分-新增植入自然度检测示例；④工具接口-新增账号设定查询+**MCP服务依赖说明**（myai-mcp-production/test，信任+飞书授权一次）；⑤快速启动模板尾部-新增植入方法论四级体系说明（创作注入L1-L3，L4归S11质检）；⑥⑦触发条件列表-账号设定拉取+植入自然度检查
- 原则：帮助文档为面向用户的操作指南，只加"能力示例+依赖说明"，不展开方法论细节（细节在知识库文件）
- **帮助文档回滚广告植入说明**（2026-08-12 18:57）：按用户要求去掉帮助文档中广告植入方法论的 4 处说明（带货行标注/植入自然度检测示例×2/快速启动模板尾部四级体系段），保留 MCP 相关更新（账号设定查询/服务依赖说明）
- **帮助文档去测试环境**（2026-08-12 18:58）：MCP 服务依赖说明只保留 `myai-mcp-production`，去掉 `myai-mcp-test` 测试环境提及；帮助文档面向用户不涉及测试环境
- **帮助文档简化**（2026-08-12 18:59）：156行→~70行。删除「触发条件详细列表」+「快速启动模板」两大冗余节（触发逻辑在SKILL.md承载）；6大功能表精简为每类2-4个代表性示例，保留MCP服务依赖说明+两种创作模式
- **帮助文档加MCP授权步骤**（2026-08-12 19:00）：MCP 服务依赖说明改为 4 步授权指引（专家→技能→连接器→自定义连接器→信任 myai-mcp-production→飞书授权一次）
- **MCP安装提醒提前到首次提问**（2026-08-12 19:01）：用户要求"首次提问时也提醒安装"。MCP_工具调用规范.md §3 触发时机从"需要调用API功能时"改为"用户首次提问即检测提醒"：新增三触发点表（首次提问=轻量提醒可跳过 / 步骤3·5=不重复提醒 / 直接调用=按流程提醒）+ 首次提问轻量文案（可跳过不影响核心创作，用到时再提醒）+ 步骤4拒绝后注明"用到时再次提醒"；SKILL.md L57 安装引导摘要同步