ns-canon

NS Canon

只维护项目记忆、事实和进度；不写新正文，不主动造设定。

读取 memory-schema.md 判断 NOVEL.md 执行约束、记忆和主要产物的关系；需要决定具体写入文件时读 file-roles.md；新建卷、章节、notes 或 records 时读 content-templates.md。

文件职责

• .novelstudio/NOVEL.md：每次先读，写入转 $ns-guidance。
• .novelstudio/：结构化记忆、notes、records 和工具。
• 创作产物：正文、brief、visuals、media；位置见 file-roles.md。
• 小说名唯一来源：.novelstudio/project.yaml:title；卷名/章节名的 title 不能反推书名。

写入边界

• 新写入小说记忆只用 .novelstudio/；旧 novel-studio/ 只作为迁移输入。
• 不直接写 .novelstudio/NOVEL.md；工作流、协作边界和写入禁区转 $ns-guidance。
• YAML/frontmatter 保持短小；长说明进 notes，进度/过程/检查点进 records。
• 不复制同一信息；只在其它文件保留摘要、状态或路径。

YAML/Markdown 协作

• 先定唯一来源：结构化事实归 YAML，正文和长说明归 Markdown，frontmatter 只做连接层。
• index.yaml.entries 应能从章节 frontmatter 和审计字数重建。
• 卷 _index.md 维护人读简介和目录；plan.yaml 维护计划。
• 章节笔记可辅助回写 canon，但不是必填。

同步顺序

• 新建/移动章节：章节 Markdown + frontmatter -> index.yaml -> 卷 _index.md。
• 改正文/章末笔记：审计字数 -> 更新 frontmatter -> index.yaml、continuity.yaml、memory.yaml。
• 改规模/卷计划：plan.yaml -> 必要的卷 _index.md 说明。
• 改 notes/records：YAML 只留摘要和路径。

阶段记忆

• 新书头脑风暴收束后，写一个可接续的写前记忆：notes/story-prep.md 或 notes/ideation.md 保存长说明，records/brainstorm-*.md 保存过程检查点，YAML 只留摘要、状态和路径。
• 每次新卷开写前，确保卷级记忆已落盘：plan.yaml.volumes[]、卷 _index.md、必要的 notes/volume-<id>-outline.md 和 records/volume-<id>-planning.md。
• 分阶段写作后更新当前阶段状态、已发生变化、未收束线索和下一章入口；长过程放 records，稳定事实回写 memory.yaml / continuity.yaml。
• 新会话接续时，应能只读 YAML、卷 _index.md、相关 notes/records 和上一章就恢复上下文。
• 发现设定崩塌或事实冲突时，先在 continuity.yaml 标出冲突、影响章节和修复策略，再按影响同步 memory.yaml、notes/records 和正文修订入口；不要在正文里硬圆而不回写 canon。

规则

• 新事实只写一个主 YAML 字段；不确定内容写到 loose/open questions。
• “以后 agent 都要/不要/这个文件别碰/写进 NOVEL.md”转 $ns-guidance。
• finish.yaml 只在分卷完成、全书完稿或交付物变化时更新。
• 修改 notes 后同步必要 YAML 摘要，避免分叉。

工具

• 结构体检：python skills/ns-canon/scripts/schema_doctor.py <novel-root>。
• 连续性检查：python skills/ns-canon/scripts/continuity_check.py <novel-root>。
• 恢复状态：python skills/ns-canon/scripts/resume_status.py <novel-root>。
• 需要机器读结果时加 --json；需要把未收束线索作为失败条件时，连续性检查加 --strict。