From 5e07600e70b3e14902a4d5c1148c271fa4a6415e Mon Sep 17 00:00:00 2001 From: maogeigei Date: Tue, 8 Sep 2026 10:06:00 +0800 Subject: [PATCH] =?UTF-8?q?S1/S2=20=E4=BA=A7=E7=89=A9=E6=96=87=E4=BB=B6?= =?UTF-8?q?=E5=90=8D=E6=94=B9=E5=90=8D=EF=BC=9A01=5F=E9=9C=80=E6=B1=82?= =?UTF-8?q?=E6=8B=86=E5=88=86/02=5F=E9=9C=80=E6=B1=82=E6=8B=86=E8=A7=A3=20?= =?UTF-8?q?=E2=86=92=2001=5F=E9=9C=80=E6=B1=82=E7=90=86=E8=A7=A3/02=5F?= =?UTF-8?q?=E9=9C=80=E6=B1=82=E8=A1=A5=E5=85=A8=EF=BC=88=E5=AF=B9=E9=BD=90?= =?UTF-8?q?=E4=BA=A7=E7=89=A9=E8=AF=AD=E4=B9=89=E5=90=8D=E4=BD=93=E7=B3=BB?= =?UTF-8?q?=EF=BC=9BV1.0=20=E5=86=85=209=20=E5=A4=84=E5=BC=95=E7=94=A8?= =?UTF-8?q?=E9=9B=B6=E6=AE=8B=E7=95=99=EF=BC=9B1=5F=E6=84=8F=E5=9B=BE?= =?UTF-8?q?=E8=AF=86=E5=88=AB=E5=BC=95=E5=AF=BC=E8=AF=AD=E5=8E=BB=E6=97=A7?= =?UTF-8?q?=E6=AD=A5=E9=AA=A4=E5=90=8D=E6=AE=8B=E7=95=99=EF=BC=9B=E5=A4=B1?= =?UTF-8?q?=E8=AF=AF=20#016=20=E5=90=8C=E6=96=87=E4=BB=B6=E5=B9=B6?= =?UTF-8?q?=E8=A1=8C=20Edit=20=E7=AB=9E=E6=80=81=E6=95=99=E8=AE=AD?= =?UTF-8?q?=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- project/短视频脚本创作/V1.0/SKILL.md | 2 +- .../短视频脚本创作/V1.0/references-add/变更日志.md | 7 ++++++- .../V1.0/references/创作流程/11_脚本检查和诊断.md | 6 +++--- .../V1.0/references/创作流程/1_意图识别.md | 2 +- .../短视频脚本创作/V1.0/references/创作流程规范.md | 12 ++++++------ 失误与规避记录.md | 11 +++++++++++ 6 files changed, 28 insertions(+), 12 deletions(-) diff --git a/project/短视频脚本创作/V1.0/SKILL.md b/project/短视频脚本创作/V1.0/SKILL.md index c1ac7a6..af47653 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·视觉脚本→视觉短片、预设钩子→开场钩子、S1/S2 五板块归一、台词风格降层并入说话风格；账号定位 6→7 字段（补核心价值类型，S5 选题锚点落位）；规则「概念分层与源头表述规范」+失误 #015（明细见 references-add/变更日志.md）" +last_change: "09-07 产物文件名改名：01_需求拆分/02_需求拆解 → 01_需求理解/02_需求补全（对齐产物语义名体系，V1.0 内 9 处引用零残留；明细见 references-add/变更日志.md）" deployment: "source" agent_created: true --- diff --git a/project/短视频脚本创作/V1.0/references-add/变更日志.md b/project/短视频脚本创作/V1.0/references-add/变更日志.md index ce4b7e1..a93513e 100644 --- a/project/短视频脚本创作/V1.0/references-add/变更日志.md +++ b/project/短视频脚本创作/V1.0/references-add/变更日志.md @@ -7,7 +7,12 @@ --- -## 2026-09-07（术语统一：视觉短片 / 开场钩子 / 需求框-技能衔接） +## 2026-09-07（S1/S2 产物文件名改名：01_需求理解 / 02_需求补全） + +- **决策**：产物文件名 01_需求拆分.md / 02_需求拆解.md（旧步骤名「需求拆分任务规划 / 任务需求拆解完善」残留，两词同音近义、与现行步骤名对不上）→ 改名 **01_需求理解.md**（S1 产物=五板块状态表）/ **02_需求补全.md**（S2 产物=归类+AI 补全）。命名口径：编号承担"属于哪步"（01=S1、02=S2），文件名承担"装了什么"（与 03_对标拆解~11_诊断报告 产物语义名体系一致；不采用对齐步骤名方案，避免与 references/创作流程/1_意图识别.md、2_需求完善.md 撞名）。 +- **影响面（V1.0 内 9 处，运行时产物文件无需 mv）**：创作流程规范 L49/L68（行文 01需求理解~08广告植入）、L78、落盘表 L426-427、L452（需求拆分/拆解→需求理解/补全）；1_意图识别 L83 User Prompt 引导语「完成需求拆分和任务规划」→「完成需求理解与信息完整度判定」（旧步骤名残留联动清理）；11_脚本检查和诊断 L241-243。 +- **写入事故复盘（补入失误记录）**：同文件多处 Edit 并行提交发生写竞态——前一个 replace_all 的成果被并发写覆盖丢失（L49/L68/L427 残留），串行补做后零残留。教训：**同一文件多处修改必须串行，禁止并行 Edit；改后全量 grep 验证零残留**。 + - **D·视觉脚本 → D·视觉短片（全量）**：S9 格式列举（SKILL.md）、S6 内容形式映射表（F04 测评种草/F07 纯视觉短片）、S9 正文 6 处、创作流程规范 3 处、03_框架节奏/07_脚本格式选择指南 8 处——与工作台需求框/用户既定术语对齐，消除「纯视觉短片→D·视觉脚本」混用。 - **预设钩子 → 开场钩子（全量）**：S5 选题方案字段（含 10 种开场方式引用）+ S7 大纲回扣语义 + 04_爆款开场/00_口径说明——对外统称「开场钩子」（=S6 场1 段名、工作台需求框 hook 字段同名同义），S5 阶段语义由「预设」改为直接以开场钩子表达。 diff --git a/project/短视频脚本创作/V1.0/references/创作流程/11_脚本检查和诊断.md b/project/短视频脚本创作/V1.0/references/创作流程/11_脚本检查和诊断.md index 5496d26..5e82857 100644 --- a/project/短视频脚本创作/V1.0/references/创作流程/11_脚本检查和诊断.md +++ b/project/短视频脚本创作/V1.0/references/创作流程/11_脚本检查和诊断.md @@ -238,9 +238,9 @@ Gate-6 确认通过后，必须生成创作回顾.html。**页面板块顺序严 | 板块 | 来源文件 | 备注 | |------|---------|------| -| Hero 区（项目信息/选题来源/达人标签） | 01_需求拆分 + 05_故事选题 + {账号名}人设卡片 | 页面顶部固定 | -| S1 意图识别 | 01_需求拆分.md | | -| S2 需求完善 | 02_需求拆解.md | | +| Hero 区（项目信息/选题来源/达人标签） | 01_需求理解 + 05_故事选题 + {账号名}人设卡片 | 页面顶部固定 | +| S1 意图识别 | 01_需求理解.md | | +| S2 需求完善 | 02_需求补全.md | | | S3 对标拆解 | 03_对标拆解.md（如有） | 可选步��，无产出则跳过 | | S4 账号设定（完整版） | 04_人设卡片.md + {账号名}人设卡片.md | 账号设定（定位/内容打法/内容规则/结构偏好/视听风格/系列内容）+ 达人设定（身份/性格/说话风格/行为决策等） | | S5 选题方案 | 05_故事选题.md | | diff --git a/project/短视频脚本创作/V1.0/references/创作流程/1_意图识别.md b/project/短视频脚本创作/V1.0/references/创作流程/1_意图识别.md index 694b0b8..0d44a9b 100644 --- a/project/短视频脚本创作/V1.0/references/创作流程/1_意图识别.md +++ b/project/短视频脚本创作/V1.0/references/创作流程/1_意图识别.md @@ -80,7 +80,7 @@ ## User Prompt 模板 ``` -请分析以下用户创作需求，完成需求拆分和任务规划： +请分析以下用户创作需求，完成需求理解与信息完整度判定： 【用户输入】 {user_input} diff --git a/project/短视频脚本创作/V1.0/references/创作流程规范.md b/project/短视频脚本创作/V1.0/references/创作流程规范.md index b125fe4..b20475b 100644 --- a/project/短视频脚本创作/V1.0/references/创作流程规范.md +++ b/project/短视频脚本创作/V1.0/references/创作流程规范.md @@ -46,7 +46,7 @@ | Gate 行为 | 所有 Gate（Gate-0~6）自动通过，AI 自主决策推进 | | Gate-2 选题 | AI 自动选择推荐方案，不需用户逐个选择 | | 落盘范围 | 只落盘**最终交付物**，中间产物不落盘 | -| 中间产物 | 01需求拆分 ~ 08广告植入 仅在对话上下文中完整传递，不写入本地文件 | +| 中间产物 | 01需求理解 ~ 08广告植入 仅在对话上下文中完整传递，不写入本地文件 | | 最终交付物 | 账号级人设卡片 + 脚本正文 + 分镜脚本（可选）+ 诊断报告（可选）+ 创作回顾.html | | 数据流 | 输入输出关系不变，上游产物靠对话上下文传递（不写盘、不跳步、不编造） | | 适用场景 | 默认日常使用，用户只需最终脚本，桌面只留最终要用的文件 | @@ -65,7 +65,7 @@ | Gate 行为 | 所有 Gate（Gate-0~6）严格执行用户确认机制 | | Gate-2 选题 | 用户必须从方案中选择，AI 不代为决定 | | 落盘范围 | 同自动模式：只落盘**最终交付物**，中间产物不落盘 | -| 中间产物 | 01需求拆分 ~ 08广告植入 在对话上下文中完整传递，随 Gate 确认向用户展示，不写入本地文件 | +| 中间产物 | 01需求理解 ~ 08广告植入 在对话上下文中完整传递，随 Gate 确认向用户展示，不写入本地文件 | | 适用场景 | 用户希望深度参与创作过程、对内容有明确要求 | ### 🛠️ 开发模式 @@ -75,7 +75,7 @@ | 执行方式 | 全流程自动执行（执行行为同自动模式：后台静默、Gate 自动通过、只显式产出目标步骤） | | Gate 行为 | 所有 Gate 自动通过，AI 自主决策推进 | | 落盘范围 | 每步产物**全落盘**（与历史行为一致） | -| 中间产物 | 01_需求拆分.md ~ 11_诊断报告.md 全部写入 `脚本{编号}/` 目录 | +| 中间产物 | 01_需求理解.md ~ 11_诊断报告.md 全部写入 `脚本{编号}/` 目录 | | 数据流 | 上游信息只从已落盘文件读取 | | 适用场景 | 调试、审计、回溯、排查创作链路问题 | @@ -423,8 +423,8 @@ F05 教程教学类脚本必须包含**完整步骤链**，缺任一段 = 格式 | 步骤 | 文件名 | 写入路径 | 说明 | |:---:|------|------|------| -| 1 | 01_需求拆分.md | `脚本{编号}/01_需求拆分.md` | 五板块状态表 | -| 2 | 02_需求拆解.md | `脚本{编号}/02_需求拆解.md` | 内容归类 + AI补全（大纲容器不补全） | +| 1 | 01_需求理解.md | `脚本{编号}/01_需求理解.md` | 五板块状态表 | +| 2 | 02_需求补全.md | `脚本{编号}/02_需求补全.md` | 内容归类 + AI补全（大纲容器不补全） | | 3 | 03_对标拆解.md | `脚本{编号}/03_对标拆解.md` | 🔶 可选 | | 4 | 04_人设卡片.md | `脚本{编号}/04_人设卡片.md` | 账号设定 + 达人设定 | | — | {账号名}人设卡片.md | `{账号名}人设卡片.md` | 账号级共享（步骤4同步写入） | @@ -449,7 +449,7 @@ F05 教程教学类脚本必须包含**完整步骤链**，缺任一段 = 格式 | 模式 | 落盘内容 | 不落盘内容 | |------|---------|-----------| -| ⚡ 自动模式（默认） | `{账号名}人设卡片.md`（账号级）+ `09_脚本正文.md` + `10_分镜脚本.md`（可选）+ `11_诊断报告.md`（可选）+ `创作回顾.html` | 01~08 中间产物（需求拆分/拆解/对标/人设脚本内副本/选题/框架/大纲/广告植入） | +| ⚡ 自动模式（默认） | `{账号名}人设卡片.md`（账号级）+ `09_脚本正文.md` + `10_分镜脚本.md`（可选）+ `11_诊断报告.md`（可选）+ `创作回顾.html` | 01~08 中间产物（需求理解/补全/对标/人设脚本内副本/选题/框架/大纲/广告植入） | | 🤝 共创模式 | 同自动模式（只落盘最终交付物） | 01~08 中间产物（随 Gate 确认展示，不写盘） | | 🛠️ 开发模式 | 上表全部 11 步产物 + `创作回顾.html` | 无 | diff --git a/失误与规避记录.md b/失误与规避记录.md index cdb1c96..6ccd641 100644 --- a/失误与规避记录.md +++ b/失误与规避记录.md @@ -134,3 +134,14 @@ S1-S11 重跑生成脚本时，脚本正文出现 4 处输出模板未定义内 2. **每次 Edit 后抽查邻接行**：凡改句尾有换行敏感的段落（列表、表格、代码块），改完立即 `sed -n 'N-2,N+2p'` 看有无粘连；批量大改后通读成品一遍（本技能"逐条修复+复查式修复"纪律同样适用于文档编辑）。 3. **写入后检查 0 字节异常文件**：批量写完跑一次 `find <目录> -size 0`，发现即删并溯源。 4. **commit message 内禁用反引号**（会被 shell 二次解释），需引用路径时用中文引号「」或普通文本。 + +--- + +## #016 同一文件多处 Edit 并行提交产生写竞态丢改（2026-09-07） + +S1/S2 产物文件名改名（01_需求拆分/拆解 → 01_需求理解/02_需求补全）时，对 `references/创作流程规范.md` 的多个 replace_all 在**同一条消息里并行发出**（第一批 2 个、第二批 2 个）。工具均报「Successfully edited」，但事后 grep 发现 3 处残留（L49/L68「01需求拆分」、L427「02_需求拆解」）——并行编辑基于同一旧快照各自替换后写回，后写者覆盖先写者成果。串行逐个补做后零残留。 + +**规避与铁律：** +1. **同一文件的多次修改必须串行**（一条消息一个 Edit），不同文件之间才可以并行；同文件批量替换宁可用一次 replace_all 也不要拆多个并行 Edit。 +2. **「Successfully edited」≠ 已生效**：并行场景下报成功不代表最终文件含该改动，改完必须全量 grep 验证（本次靠 `需求拆分|需求拆解` 残留扫描抓出 3 处漏网）。 +3. 多词替换建议顺序：先做含下划线/更长的精确词（如 01_需求拆分），再做短词行文（如 01需求拆分），或统一用带上下文的整行替换，降低互相覆盖概率。