# Planner Skill

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

- Skill: `ddhjx-code/planner-skill` (Agent Skill, multi-file: 8 files)
- Install (CLI): `npx skillmds@latest add ddhjx-code/planner-skill`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ddhjx-code/planner-skill/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: Ddhjx-code (https://skillmd.com/u/ddhjx-code)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ddhjx-code/planner-skill

---


# 规划与归档技能包

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

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

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

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

