ns-canon

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

NS Canon

NS Canon

只维护事实源和进度,不新写正文,不创造未要求的新设定。
读取 memory-schema.md 获取完整结构。
Only maintains fact sources and progress; does not write new text or create unrequested new settings.
Read memory-schema.md for the complete structure.

职责

Responsibilities

  • project.yaml
    :项目身份。
  • plan.yaml
    :全书规模、卷、章节、番外、下一步。
  • memory.yaml
    :人物、世界、关系、伏笔、类型模块。
  • continuity.yaml
    :当前状态、事件、未收束线、修订影响。
  • index.yaml
    :正文条目路径、状态、字数、排序。
  • style.yaml
    :文风和章节契约。
  • research.yaml
    :来源和事实边界。
  • publish.yaml
    :正文根目录和发布规则。
  • finish.yaml
    :完稿状态和输出索引。
  • art.yaml
    :视觉一致性和文件索引。
  • project.yaml
    : Project identity.
  • plan.yaml
    : Overall book scale, volumes, chapters, side stories, next steps.
  • memory.yaml
    : Characters, world, relationships, foreshadowing, genre modules.
  • continuity.yaml
    : Current status, events, unresolved plot threads, revision impacts.
  • index.yaml
    : Text entry paths, status, word count, sorting.
  • style.yaml
    : Writing style and chapter contracts.
  • research.yaml
    : Sources and fact boundaries.
  • publish.yaml
    : Root directory of text and publishing rules.
  • finish.yaml
    : Completion status and output index.
  • art.yaml
    : Visual consistency and file indexes.

YAML/Markdown 协作

YAML/Markdown Collaboration

  • 章节和卷的 Markdown frontmatter 是 YAML 记忆与正文文件的连接层。
  • frontmatter 只放身份、排序、状态、时间、字数和标签;长说明写 Markdown 正文区或
    notes/*.md
  • index.yaml.entries
    必须能从章节 frontmatter 和审计字数重建。
  • _index.md
    维护卷简介、卷承诺和章节目录;
    plan.yaml
    维护计划,不互相复制长文本。
  • 章节
    ## 章末笔记
    是可选 Markdown;没有章末笔记时,直接从正文和上下文更新 canon。
  • 总卷数、总章数、番外数和总字数目标只写在
    plan.yaml.scale
  • The Markdown frontmatter of chapters and volumes serves as the connection layer between YAML memory and text files.
  • Frontmatter only includes identity, sorting, status, time, word count, and tags; long descriptions should be written in the Markdown text section or
    notes/*.md
    .
  • index.yaml.entries
    must be reconstructible from chapter frontmatter and audited word counts.
  • Volume
    _index.md
    maintains volume introductions, volume commitments, and chapter directories;
    plan.yaml
    maintains plans, and long texts should not be duplicated between them.
  • The optional
    ## End-of-Chapter Notes
    section in chapters is Markdown; if there are no end-of-chapter notes, update the canon directly from the text and context.
  • The total number of volumes, total chapters, number of side stories, and total word count target are only written in
    plan.yaml.scale
    .

规则

Rules

  • 新事实只写一个主 YAML 字段,避免重复记录。
  • 不确定内容写入
    continuity.yaml.loose_threads
    research.yaml.open_questions
  • 写完章节后,优先读可选的
    ## 章末笔记
    ,再更新
    index.yaml
    continuity.yaml
    memory.yaml
  • 只有分卷完成、全书完稿或交付物变化时更新
    finish.yaml
  • YAML 是事实源;Markdown 是长文说明或展示面板。
  • 调整规模时先改
    plan.yaml.scale
    plan.yaml.volumes/extras
    ,再同步卷
    _index.md
    的目录说明。
  • New facts should only be written in one primary YAML field to avoid duplicate records.
  • Uncertain content should be written to
    continuity.yaml.loose_threads
    or
    research.yaml.open_questions
    .
  • After finishing a chapter, prioritize reading the optional
    ## End-of-Chapter Notes
    before updating
    index.yaml
    ,
    continuity.yaml
    , and
    memory.yaml
    .
  • Update
    finish.yaml
    only when a volume is completed, the entire book is finished, or deliverables change.
  • YAML is the source of facts; Markdown is for long-form explanations or display panels.
  • When adjusting the scale, first modify
    plan.yaml.scale
    and
    plan.yaml.volumes/extras
    , then synchronize the directory description in the volume
    _index.md
    .

工具

Tools

  • 结构体检:
    python skills/ns-canon/scripts/schema_doctor.py <novel-root>
  • 连续性检查:
    python skills/ns-canon/scripts/continuity_check.py <novel-root>
  • 需要机器读结果时加
    --json
    ;需要把未收束线索作为失败条件时,连续性检查加
    --strict
  • Structure check:
    python skills/ns-canon/scripts/schema_doctor.py <novel-root>
    .
  • Continuity check:
    python skills/ns-canon/scripts/continuity_check.py <novel-root>
    .
  • Add
    --json
    when machine-readable results are needed; add
    --strict
    to continuity checks if unresolved plot threads should be treated as failure conditions.