zizi e7b5100ba5 框架(规划管线): 建规划落库机制 persist_planning，planner 产结构化草稿主会话落库

- persist_planning.py：write(shadow)/confirm(confirmed) 落 example_planning_section；
  section_type=setting/outline/state/assembly/fine_outline；fine_outline 章级强制 target_chapter；全流程已验证
- planning SKILL.md：落库合同(section_type/payload/确认/已确认细纲取用SQL)，规划正式权威在库、works/文件退为留痕
- planner.md 禁区：不写库/git，落库由主会话经 persist_planning 做

2026-07-31 22:43:39 +08:00

3.5 KiB

Raw Blame History

name: planning description: 规划的功能合同(scenario: planning,规划槽位)。立项设定包/大纲/知识卡/状态的产出结构=schema 字段清单本身;续作修订同用此合同。 disable-model-invocation: true

规划(scenario: planning | purpose: planning | 槽位: 规划→planner)

何时用:立项产全套设定包与大纲;续作期按用户意图修订规划。产出全为草稿(未确认规划不进生成上下文)。

元数据驱动(本功能的核心机制)

产出结构=schema 字段清单本身,不是"参考 schema":

产出	结构来源
`设定.md` frontmatter	`novel_work.yaml` 逐字段
§作品核心	`work_core.yaml` 逐字段(谜底与真相/结局方向写进对应 aiContext 受限字段——底牌管理是规划的职责)
§世界观总纲	`world.yaml`;力量体系单列卡按 `power_system.yaml`
§文风画像	`style.yaml`(黑名单要具体词表、达标样张要真写一段)
`大纲.md`	`outline.yaml`;近三章细纲细到可直接开写(章目标/关键事件/出场/伏笔动作/钩子)
知识卡	各实体型 schema:基础字段(名称/别名/摘要/标签/来源=手工/状态=草稿)+特有字段
`状态.md`	`narrative_state.yaml` 开书初始态
`装配.yaml`	四槽位默认件+知识绑定[]+作品级扩展字段{}

字段全覆盖:每个字段都要有内容;写不出=设计问题,标「字段存疑:原因」——这是验证元数据设计的一等产出,不许静默跳过。schema 加字段,设定包立刻多一节。

功能约束(规划方法论)

设定互相咬合:势力实力用力量体系阶梯表述;人物境界在阶梯上有座标;地点归属对得上势力地盘;主角起点与第一卷冲突强度匹配。写完自查,咬不合当场改。
伏笔成网:核心悬念拆成伏笔分布进分卷粗纲;每条有埋设章与计划回收章,登记进状态台账。
变奏自查:与品类烂大街套路的差异点写进题材定位;没有差异点推倒重来。
「说话方式」必须是可执行语言指纹(口头禅/句长/称呼习惯),不许"豪爽""高冷"空词。

输出合同

产出按 section_type 分类：设定(setting)/大纲(outline)/状态(state)/装配(assembly)/细纲(fine_outline,章级)。planner 产出 schema 字段结构化内容(payload JSON),由主会话经 scripts/persist_planning.py 落 example_planning_section(先 shadow);works/<书名>/ 文件是人类可读留痕,规划正式权威在库。完成后报:字段存疑清单/咬合自查结论/伏笔台账条数。

规划落库(shadow→confirmed)

落库:.venv/bin/python .claude/skills/planning/scripts/persist_planning.py write <payload.json> --work-id N --section-type <type> [--target-chapter N] [--schema-type X] [--version N](planner 不碰库/git,主会话落库;先 --dry-run 试跑)。
确认:persist_planning.py confirm <section_id>(用户确认后 shadow→confirmed;确认后的规划才进生成上下文)。

已确认细纲取用(read-context 改道读库,不再当内存参数):

SELECT payload FROM example_planning_section
WHERE work_id=? AND section_type='fine_outline' AND target_chapter=? AND state='confirmed' AND deleted=false
ORDER BY version DESC LIMIT 1

fine_outline 是章级 section,必须带 target_chapter;书级(设定/大纲/状态/装配)target_chapter 为空。

红线

不写正文;修订场景只动用户点名的规划面,并列出波及(哪些细纲/卡受影响)。

3.5 KiB Raw Blame History