muse-agent-example/muse/lifecycle/flow/skills/book/design-story-foundation/SKILL.md

name, description, disable-model-invocation

name	description	disable-model-invocation
design-story-foundation	在正式规划前固化作品根设定，按固定三级章节树生成可比较的前期设计候选。用户仍在单文档前期设计阶段时使用；不写正文、不落库、不替用户定稿。不适用于合并多案（归 merge-story-candidates）或正式规划落库（归 plan-story）。	true

作品设定初始化

唯一目的

把零散对话收束成根设定与若干独立候选，让用户比较后再进 plan-story。不写正文、不落 PostgreSQL、不替用户定稿。

元数据驱动：输入与权威顺序

先冻结 design-story-foundation/v2 任务包（作品名、SoT 路径、候选数、根设定、对话记录、节奏要求、参考书证据、候选路径）。冲突顺序：用户最新明确要求 > 根设定已定事实 > 已接受方案 > 待定建议。

字段与完成判定见 候选生成合同；三级内容见 章节内容规范、一至五章、六至九章。冻结后派发；新要求先改任务包，旧候选作废。

根设定与候选章节树

根设定 = 上游硬约束（不占九章）；三级候选树 = 本 Skill 主输出。根设定只写稳定事实，不写过程/工具/方案来源；每点 30–60 字；歧义进「待决问题」。用户确认的稳定事实才回写根设定。

固定三级章节树与节奏

九章三级树与层级硬规则见章节内容规范。设定从追读节奏反推：前三章立处境与钩子、前十章局部闭环、前五十章阶段高潮、全书逐级扩舞台；区分世界事实 / 角色知情 / 读者披露。

参考书与冻结合同

参考书先读窗级大纲再校验前五十章正文；只借方法不照搬专名骨架。派发前冻结三级标题与号段（见候选生成合同）；同构只为比较。

独立生成

每候选一个独立 planner 子代理，只读共同输入与自己的文件；会话和工具授权隔离。调用走 execute-role-task，回执由 record-run-evidence 保存。超时从最后一个完整单元续写，禁止空话补篇幅。

复核与机械门

表达层复核（可用 humanizer-zh）后重跑机械门与语义复核清单。

.venv/bin/python muse/lifecycle/flow/skills/book/design-story-foundation/scripts/validate_candidates.py \
  --root-doc docs/design/<作品>-前期设计.md --min-candidates 5 docs/design/candidates/*.md

机械门查标题同构、号段、占位符、根设定句长；内容完整靠语义复核。失败码：SETTING_INIT_VALIDATION_FAILED。

用户选择与交接

比较报告不自动合并。统合交给 merge-story-candidates；用户确认方向后整理回 SoT。

进入 plan-story 前必须有用户选定记录，并用机械门校验：

.venv/bin/python muse/lifecycle/flow/skills/book/design-story-foundation/scripts/assert_selection_handoff.py \
  docs/design/<作品>-selection.json

选定 JSON 必含 selectedCandidate / confirmedByUser / confirmedAt。未通过交接闸不得把未选候选当正式设定写入规划。

数据与失败边界

只读写用户点名的前期设计 SoT 与临时候选目录；不碰正文/正式规划/知识卡/任何表；无授权不 Git 提交。输入不全、合同漂移、候选污染或机械门失败时稳定失败关闭。

输出

可比较的候选 Markdown + 比较报告；不写 Canonical。

复利合同

• 消费：用户对话与参考书方法证据，指导后续 plan-story 正式规划。
• 回写：本阶段不落 example_lesson；选定方案进入规划链后由 plan-story / decide-candidate 登记效果信号。