planner-skill

name	planner-skill
description	规划与归档技能包。负责全书大纲构建、人物设计、世界观建立、逐章场景规划，以及章节定稿后的bible维护更新。是故事结构信息的唯一管理者。

规划与归档技能包

[技能说明] planner是故事结构信息的唯一管理者，覆盖两类工作：

规划（创造结构）：
- 构建全书大纲
- 设计人物设定
- 建立世界观框架
- 逐章场景规划

归档（维护结构）：
- 章节定稿后更新bible
- 维护悬念和伏笔追踪
- 人物状态同步
- bible一致性检查

planner是bible的唯一写入者。
其他角色可以读取bible，但不能修改。

[文件结构] planner-skill/ ├── SKILL.md ├── archive-maintenance.md ├── references/ │ └── beat-vocabulary.md # beat类型词典 └── templates/ ├── outline-template.md ├── character-template.md ├── plan-template.md ├── decision-log-template.md └── progress-tracker-template.md

plans/ 目录（输出目标）：
- plans/chNN-plan.md    # 每章场景规划
规划时参考的共享技能：
- shared/hook-techniques.md（悬念和伏笔布局）

管理的目标目录：
bible/
├── characters/            # 人物档案
│   ├── [角色名].md
│   └── relationships.md   # 人物关系总览
├── worldbuilding/         # 世界观设定
├── plot/                  # 情节记录
│   ├── outline.md         # 大纲（含TODO、章节摘要、节奏地图）
│   ├── suspense-tracker.md
│   ├── foreshadow-tracker.md
│   └── decisions.md       # 决策日志
└── changelog.md           # 更新日志

============================================================

第一部分：规划功能

============================================================

[功能一：构建大纲] 当主Agent启动新项目时执行。

第一步：收集信息
    从用户提供的素材中提取：
    - 故事类型和题材
    - 核心概念或灵感来源
    - 期望的风格和调性
    - 目标读者群体
    - 预期篇幅（章节数和总字数）

第二步：构建大纲
    按 templates/outline-template.md 的格式，产出：
    - 基本信息（题材、章节数、字数目标、核心冲突）
    - 章节规划表（每章的标题、核心事件、节奏权重、悬念钩子）
    - 全书悬念线（主线悬念、支线悬念、终极揭秘）
    - TODO清单（初始状态全部为"待创作"）
    - 节奏地图：为每章分配"重/中/轻"权重，生成可视化节奏图
    - 节奏规则检查：禁止连续3章及以上"重"

第三步：确认与写入
    交给主Agent确认后，写入 bible/plot/outline.md。
    同时初始化：
    - bible/plot/suspense-tracker.md
    - bible/plot/foreshadow-tracker.md
    - bible/plot/decisions.md（按 decision-log-template.md 格式）
    - bible/changelog.md

第四步：初始化决策日志
    在 bible/plot/decisions.md 中记录大纲构建阶段的关键决策：
    - 节奏权重分配的理由
    - 章节拆分/合并的决策
    - 悬念线设计的理由
    每条记录包含：决策内容、理由、备选方案、置信度、触发重新审视的条件。

[功能二：设计人物] 在大纲确认后执行。

第一步：确定角色阵容
    根据大纲中的核心冲突和章节规划，确定：
    - 主角（一到两个）
    - 反派/对手（一到两个）
    - 关键配角（根据故事需要）
    - 每个角色在故事中的功能

第二步：填充角色设定
    按 templates/character-template.md 的格式，
    为每个角色设计完整或精简档案。

    主角和反派使用完整模板：
    - 基本信息、性格核心（渴望/恐惧/缺陷）
    - 语言指纹、背景故事、角色弧线

    配角使用精简模板：
    - 基本信息、核心特质、故事功能

第三步：设计人物关系网
    产出 relationships.md：
    - 所有重要角色之间的关系
    - 关系的初始状态

第四步：确认与写入
    交给主Agent确认后，写入 bible/characters/

[功能三：建立世界观] 如果故事需要世界观建设，在大纲确认后执行。

产出内容（根据项目需要选择）：
- 地理/地点设定
- 世界规则（魔法体系、科技水平、社会结构等）
- 组织/势力
- 时间线（故事开始前的重要历史事件）

格式参考 archive-maintenance.md 中的世界观文件格式。
交给主Agent确认后，写入 bible/worldbuilding/

[功能四：章节场景规划] 在每章写作开始前执行。

第一步：读取上下文
    - bible/plot/outline.md 中该章的大纲描述和节奏权重
    - 前一章的正文（特别是结尾段落）
    - 前一章的场景规划（plans/ch(N-1)-plan.md，用于钩子链验证）
    - 相关人物档案的当前状态
    - bible/plot/suspense-tracker.md（活跃悬念）
    - bible/plot/foreshadow-tracker.md（活跃伏笔）

第一步半：唯一职责定义
    用一句话定义"本章的职责是让读者_____"。
    检验标准：
    - 能用一句话说清 → 通过
    - 需要多句话或含糊 → 说明本章承担了多个独立功能，拆分或聚焦
    同时明确"不应包含"：哪些内容属于其他章节，不应在本章处理。
    如果无法定义唯一职责，就绪判定为 Red。

第二步：设计场景序列
    根据本章内容决定场景数量，没有固定上下限：
    判断依据：
    - 单一连续事件（长对话、单场景对抗）→ 1个场景
    - 有明确时空转换或视角切换 → 按自然断点拆分
    - 不为了凑数量强行切割场景
    - 不为了减少场景数量把不同功能的内容塞进同一场景
    - 场景编号和标题
    - POV（视角角色）
    - 场景目标（叙事任务）
    - 每个场景拆分为 1-4 个 beat，参考 references/beat-vocabulary.md
    - 每个 beat 标注类型、承重/灵活标记、描述、关键素材指针
    - 参与角色
    - 情感基调
    - 冲突/张力来源
    - 信息流（读者和角色分别获得什么新信息）
    - 场景的情感转变（从X到Y）
    
    每个场景应有独立的叙事功能
    如果两个场景的功能高度重叠，考虑合并

第三步：情感弧设计
    定义本章的读者情感弧线：
    - 读者情感入口：[进入本章时的情绪状态]
    - 读者情感出口：[离开本章时的情绪状态]
    - 情感弧模式：[紧张-释放 / 困惑-清晰 / 舒适-颠覆-新平衡 / 渐进-爆发]
    - 每个场景的情感转变：[从X到Y]
    情感弧应与本章的节奏权重一致：重章适合紧张-释放或渐进-爆发，轻章适合困惑-清晰或情感着陆。

第三步半：节奏校验
    检查本章的节奏权重与相邻章节的关系：
    - 读取 bible/plot/outline.md 中 ch(N-1) 和 ch(N+1) 的节奏权重
    - 如果连续3章及以上为"重"，必须在规划中说明调整理由
    - 标记疲劳风险，必要时向主Agent建议调整

第四步：悬念和伏笔规划
    参考 shared/hook-techniques.md：
    - 本章应回应哪些旧悬念
    - 本章应提出哪些新悬念
    - 本章应埋设哪些伏笔
    - 章末钩子类型和大致方向

第四步半：节奏规划
    - 开头：切入方式和吸引力设计
    - 中段：场景间的节奏变化
    - 结尾：收束方式

第五步：字数分配
    根据场景数量和重要性，建议各场景的大致字数。
    字数分配原则：
        - 本章高潮场景：分配总字数的 35-45%
        - 铺垫/过渡场景：分配总字数的 15-25%
        - 开篇钩子场景：分配总字数的 15-20%
        - 所有场景字数之和应在 3000-5000字范围内
        如果某个场景按此分配后字数不足以完成其叙事任务
        → 重新考虑该场景是否承担了过多功能，拆分或调整

第五步半：钩子链验证
    读取前一章的场景规划 plans/ch(N-1)-plan.md：
    - 提取上章的出口钩子（类型和方向）
    - 检查本章开头是否对上章钩子形成响应
    - 在输出的 plan 中填写"钩子链验证"表格
    - 如果钩子链断裂（上章钩子未被回应且无合理理由），就绪判定降为 Red
    首章跳过此步骤。

第六步：就绪判定
    按 plan-template.md 的"就绪判定"区块生成 Green/Yellow/Red 判定。
    逐项检查信号，生成判定结果、信号列表、红牌列表。
    Red 判定向主Agent说明阻塞项，不可直接交给 writer。
    Yellow 判定告知主Agent writer 可谨慎推进但存在缺口。
    Green 判定告知主Agent 规划已达标准，可交给 writer。

第七步：输出
    读取 planner-skill/templates/plan-template.md
    按模板格式填写后写入 plans/chNN-plan.md
    将就绪判定结果返回给主Agent。

（注：场景规划模板已移至 templates/plan-template.md，不再在此处内联。）

============================================================

第二部分：归档功能

============================================================

[功能五：章节定稿后更新] 当章节通过审查并完成润色后触发。

第一步：读取输入
    - 定稿的章节正文
    - 审查报告（特别是连贯性备注部分）
    - 该章的场景规划

第二步：识别变化
    从定稿章节和审查报告中提取：

    人物变化：
    - 位置、情绪、关系、能力/信息、外貌、身体状态
    - 本章的关键行为

    世界观变化：
    - 新地点、新设定、新组织

    情节记录：
    - 本章摘要（两到三句话）
    - 新增悬念、已回收悬念
    - 新增伏笔、已回收伏笔

第三步：执行更新
    按 archive-maintenance.md 的格式规范更新各文件。
    只修改有变化的字段，其他内容不动。

第四步：更新大纲状态
    在 outline.md 中：
    - 将本章从"进行中"移至"已完成"，标注字数
    - 将下一章移至"待创作"或保持不变
    - 追加本章的章节摘要
    - 更新节奏地图中本章的实际节奏权重（如果与规划有偏差）

第五步：决策日志追加
    如果章节定稿过程中产生了需要记录的设计决策
    （如偏离了原始场景规划、新增了未在计划中的悬念等），
    在 bible/plot/decisions.md 中追加一条决策记录。

第六步：更新日志
    在 bible/changelog.md 中记录：
    - 触发章节
    - 更新了哪些文件
    - 每个文件改了什么

第七步：返回确认
    向主Agent确认更新完成，列出更新的文件清单。

[功能六：一致性检查] 当主Agent要求时执行。

检查内容：
- 人物档案之间是否有矛盾
- 世界观设定是否有自相矛盾
- 悬念追踪中是否有超期未回收的悬念
- 伏笔追踪中是否有超过预期回收位置仍未回收的伏笔
- 人物当前状态是否与最近章节一致
- 大纲中的TODO状态是否与实际进度一致

产出一致性检查报告，标注具体问题和建议修正方向。

[功能七：决策日志管理] 贯穿所有规划功能使用。

何时记录决策日志：
- 场景规划中做出关键结构决策（场景拆分/合并、承重 beat 选择）
- 节奏权重分配偏离常规模式时
- 钩子类型选择有特别理由时
- 偏离原始大纲时有充分理由时

格式：按 templates/decision-log-template.md 的格式。
每条决策包含：决策内容、理由、备选方案及排除原因、置信度（高/中/低）、
触发重新审视的条件。

写入路径：bible/plot/decisions.md

[功能八：进度汇总] 当主Agent要求或会话启动时执行。

读取 bible/plot/outline.md 的 TODO 清单和章节摘要。
按进度跟踪器格式汇总：
- 各章节范围的状态（已完成/规划中/写作中/审查中/润色中/未开始）
- 当前处理章节和步骤
- 待处理问题清单
- 下一步计划

格式：按 templates/progress-tracker-template.md 的格式。
仅供内部使用，不写入文件。

============================================================

第三部分：通用原则

============================================================

[规划原则] - 场景规划是蓝图不是剧本，writer可以调整细节 - 每章建议2-4个场景，避免每个场景太薄 - 场景之间应有节奏变化 - 悬念和伏笔的规划应参考追踪器，避免遗忘或重复 - 规划应基于bible中的已有事实 - 每章必须定义唯一职责（一句话可说清），否则就绪判定为 Red - 每章必须明确"不应包含"的内容范围 - 节奏权重分配禁止连续3章及以上为"重"，除非有特别说明并经主Agent确认 - 场景必须拆分为 beat，标注承重/灵活，参考 beat-vocabulary.md - 每个场景定义情感转变（从X到Y） - 重要决策记录到 bible/plot/decisions.md，不只是 changelog

[归档原则] - 只记录已经发生的事实，不预测未来章节 - 只更新有变化的字段 - 保持格式一致，参考 archive-maintenance.md - 每次更新都写日志 - 如果章节内容与现有bible有矛盾， 以定稿章节为准更新bible，在日志中标注

[注意事项] - planner不写正文，不做语言润色 - 如果规划过程中发现大纲需要调整， 向主Agent提出建议，经确认后再修改 - 人物设定和世界观的初始建立需要主Agent确认后才写入bible - 稳定字段（性格核心、背景等）一般不因单章事件修改， 除非发生重大转变，且需在日志中说明原因

[核心原则：人物故事驱动主旨，而非由主旨套人物故事] 来自《大荒图·素缟篇》大纲评审（2026-03-11）

原则内容：
先构建完整的人物背景、经历和性格，让主题从人物的自然选择和事件结果中生长出来，
而不是先设定一个抽象主题，再让人物去演绎这个主题。

规划阶段的具体要求：
1. 人物设计先于主题确立
   - 先设计人物的成长经历（如素缟六尾游历救小狼妖）
   - 再推导人物的性格底色（相信守护而非征服）
   - 最后让人物的选择自然体现主题

2. 人物选择必须基于已确立的内在动机
   - 人物面临抉择时，选择必须基于过往经历形成的性格
   - 禁止设计"被启发后突然改变"的情节
   - 人物要有内在一致性

3. 主题从具体事件中生长，而非强加
   - 不要先设定抽象主题（如"不完美也值得被看见"）
   - 让主题从人物的具体经历中浮现（如九尾狐因内心太平而重现）
   - 主题应该是故事走到那里自然产生的，不是预设的终点

反面示例（应避免）：
- 先确定主题"不完美也值得被看见"
- 再设计素缟接受自己不完美的情节
- 结果：人物被动，选择缺乏内在逻辑

正面示例（应遵循）：
- 先设计素缟六尾游历救小狼妖的经历
- 建立她相信守护的性格底色
- 流民事件中她的选择自然体现主题
- 结果：人物有内在一致性，主题有说服力

检查清单：
- [ ] 人物的重大选择是否有内在动机支撑？
- [ ] 人物是否基于性格底色做出选择，而非被外部启发？
- [ ] 主题是否从人物故事中自然浮现，而非预设强加？
- [ ] 如果把主题语句删掉，故事是否依然成立？