S1/S2 产物文件名改名：01_需求拆分/02_需求拆解 → 01_需求理解/02_需求补全（对齐产物语义名体系；V1.0 内 9 处引用零残留；1_意图识别引导语去旧步骤名残留；失误 #016 同文件并行 Edit 竞态教训）
This commit is contained in:
maogeigei committed
1 parent
868482cab9
commit
3a0699fe15
6 files changed
+28
-12
No files matched your search
@@ -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
|
||||
---
|
||||
|
||||
@@ -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 阶段语义由「预设」改为直接以开场钩子表达。
|
||||
|
||||
@@ -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 | |
|
||||
|
||||
@@ -80,7 +80,7 @@
|
||||
## User Prompt 模板
|
||||
|
||||
```
|
||||
请分析以下用户创作需求，完成需求拆分和任务规划：
|
||||
请分析以下用户创作需求，完成需求理解与信息完整度判定：
|
||||
|
||||
【用户输入】
|
||||
{user_input}
|
||||
|
||||
@@ -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` | 无 |
|
||||
|
||||
|
||||
+11
@@ -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需求拆分），或统一用带上下文的整行替换，降低互相覆盖概率。
|
||||
Reference in new issue
Block a user