Skip to content

feat: 叙事模式与叙事流设计(Step 1.1) #78

@lailoo

Description

@lailoo

Step 1.1:Planner 叙事流设计

对应总纲 70.1 的 Step 1.1 | 状态:✅ 已实现


需求点

目标

planner.j2 中新增"第一步:选择叙事模式并设计叙事流"模块,让 Planner 在生成大纲前先确定叙事模式和逻辑链。

改动文件

文件 改动
prompts/blog/planner.j2 新增叙事模式选择表 + 叙事流设计指导

需求详情

  1. 叙事模式表:6 种模式供 LLM 选择
模式 适用场景 叙事流
what-why-how 介绍新技术/概念 是什么 → 为什么重要 → 怎么用
problem-solution 解决具体问题 痛点 → 失败方案 → 正确方案 → 验证
before-after 展示改进效果 旧方式 → 问题 → 新方式 → 对比
tutorial 手把手教程 目标 → 准备 → 步骤 1-N → 验证
deep-dive 深入原理分析 表面现象 → 第一层 → 核心层 → 启示
catalog 列举多个条目 框架 → 条目 1-N → 全局归纳
  1. 叙事流设计:选定模式后输出 narrative_mode + narrative_flow(reader_start, reader_end, logic_chain)

  2. 每章叙事角色:每个 section 输出 narrative_role(hook/what/why/how/compare/deep_dive/verify/summary/catalog_item)

  3. 设计原则:"先设计逻辑链条,再展开为章节"

向后兼容

  • 新字段为空时,下游 Writer 回退到现有行为

验证方案

检查清单

A. 字段完整性检查

检查项 通过标准
顶层有 narrative_mode 字段 值为 6 种模式之一
顶层有 narrative_flow.reader_start 非空字符串,描述读者起点
顶层有 narrative_flow.reader_end 非空字符串,描述读者终点
顶层有 narrative_flow.logic_chain 数组,≥3 个逻辑节点
每个 section 有 narrative_role 非空,值合理
narrative_mode 与主题匹配 "什么是 RAG" 应匹配 what-why-how 或 tutorial

B. 大纲质量检查

检查项 评分标准
第一章是否有"钩子"作用 是否从读者痛点/场景切入
章节顺序是否有逻辑递进 是否从浅到深、从概念到实践
最后一章是否有总结/展望 是否回顾要点或给出下一步
相邻章节之间是否有过渡逻辑 前一章的结论是否自然引出下一章
整体是否像"有设计的文章"而非"随机堆砌" 主观感受,1-5 分

测试主题矩阵

主题 期望 narrative_mode 验证重点
"什么是 RAG" what-why-how 是否先定义、再讲价值、再讲用法
"手把手搭建 RAG 系统" tutorial 是否有目标预览、前置条件、分步骤、验证
"10 个 RAG 性能优化技巧" catalog 是否有前置说明、条目结构一致、全局总结

通过标准

维度 通过条件
字段完整性 3 个主题全部输出 narrative_mode + narrative_flow + narrative_role,且值合理
模式匹配 3 个主题的 narrative_mode 至少 2 个匹配预期
大纲质量 改造后的大纲在 B 表的 5 项检查中,至少 3 项优于 baseline

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions