Novel Studio
Novel Studio 是一个面向 Claude Code Marketplace 和 Agent Skills 生态的小说创作仓库。插件名是 ns，技能统一以 NS 作为识别前缀，适合长篇、短篇、连载、系统文、无限流、悬疑、言情、奇幻、科幻、历史和现实题材。
仓库只保留 Claude Code marketplace 插件入口；其它支持 Agent Skills 的工具通过 npx skills 按需安装技能：
- Claude Code marketplace：
.claude-plugin/plugin.json 和 .claude-plugin/marketplace.json
- Codex / Cursor / Gemini CLI / OpenCode 等：
npx skills add honestman9527/novel-studio
核心模型
Novel Studio 只保留新版单本小说目录模型：
my-novel/
AGENTS.md / CLAUDE.md # agent 项目约束
.novelstudio/
project.yaml
plan.yaml
memory.yaml
continuity.yaml
index.yaml
style.yaml
research.yaml
art.yaml
finish.yaml
publish.yaml
notes/
records/
tools/
word_count.py
content/
volumes/
volume-001/
_index.md
ch001.md
ch002.md
extras/
extra-001.md
visuals/
cover-prompts.md
image-prompts.md
brief.md
media/
covers/
illustrations/
当前文件夹就是这部小说的根目录；.novelstudio/ 是唯一记忆目录；新项目正文默认放在 content/volumes/、content/extras/。旧项目已有 volumes/、extras/ 时可沿用。小说名只写在 .novelstudio/project.yaml 的 title 字段；卷名和章节名使用各自 frontmatter 的 title，brief.md 只展示对外文案，不作为小说名来源。
AGENTS.md 或 CLAUDE.md 只保存 agent 在本项目里的执行约束，例如工作流、写入边界、协作偏好和禁区；不保存小说记忆、剧情进度、设定库或资料摘录。.novelstudio/*.yaml 保存当前结构化记忆和索引；.novelstudio/notes/*.md 保存长说明；.novelstudio/records/*.md 保存进度、检查点、迁移、调研和修订过程记录；content/、brief.md、visuals/ 和 media/ 是主要创作产物。详细位置和同步关系见 ns-canon 的 memory-schema.md / file-roles.md。
边界速记：能用 .novelstudio/ 绝不用旧 novel-studio/ 写小说记忆；能用 project.yaml.title 绝不用章节/卷 frontmatter 或 brief.md 存小说名；能用 YAML 存短事实绝不用 notes 造第二套 canon；能用 notes 存长说明绝不用 AGENTS/CLAUDE 存设定；能用 records 存过程绝不用 YAML 记录流水账；能用 content/ 存正文绝不用 notes 存正文。
不知道该用哪个技能时，直接使用 ns。入口会根据请求判断应转入启动、创意、框架、agent 约束、canon 记忆、调研、写作、修订、文案或视觉提示词技能。
Claude Code 在线安装
推荐从插件市场安装：
claude plugin marketplace add honestman9527/dream-marketplace
claude plugin install ns@dream-marketplace
在 Claude Code 交互界面中也可以使用：
/plugin marketplace add honestman9527/dream-marketplace
/plugin install ns@dream-marketplace
/reload-plugins
本地开发加载
claude --plugin-dir D:\projects\novel-studio
其它 Agent 安装
npx skills 是开放技能生态的 CLI 工具。除 Claude Code marketplace 外，其它支持 Agent Skills 的编码助手统一使用它安装，并在交互提示中按需选择技能。
npx skills add honestman9527/novel-studio
交互式提示会让你：
- 选择要安装的技能（按需选择即可）
- 选择目标 Agent（Codex / Cursor / Gemini CLI / OpenCode …）
- 选择安装范围：项目级（仅当前仓库）或 全局级（所有项目）
安装完成后，技能文件会被放入对应 Agent 的技能目录（如 .claude/skills/、.codex/skills/ 等），Agent 下次启动即可识别。
常用管理命令：
npx skills list # 查看已安装技能
npx skills check # 检查可用更新
npx skills update # 更新所有技能到最新版本
npx skills remove <技能名> # 移除指定技能
提示： 更多技能可在 skills.sh 浏览和发现。
安装后可用的技能入口
/ns:ns
/ns:ns-start
/ns:ns-ideate
/ns:ns-build
/ns:ns-guidance
/ns:ns-canon
/ns:ns-research
/ns:ns-write
/ns:ns-revise
/ns:ns-pitch
/ns:ns-visual
技能分工
ns：总入口，按目标产物路由到最小可用子技能。ns-start：初始化空项目或接入已有正文项目，只创建结构、基础记忆和 .novelstudio/tools/word_count.py。ns-ideate：创意发散与收束，只产出题材方向、卖点、主角欲望和开篇钩子。ns-build：搭建故事圣经，只负责世界观、人物、类型规则、大纲、卷纲、章节计划和必要的长文 notes。ns-guidance：维护 AGENTS.md 或 CLAUDE.md，只记录 agent 项目约束和协作边界。ns-canon：维护 .novelstudio/ canon 记忆、notes、records、已定事实、连续性、索引和进度。ns-research：联网查找素材、考据、视觉参考并记录来源；创作素材优先从小说素材站、写作站、网文资料和类型小说相关网站提炼，事实考据再用官方/学术/专业来源核验。ns-write：写新的正文内容，统一负责下一章、续写、已完成卷级规划后的新卷首章、番外、序章、尾声和独立短篇。ns-revise：修订已有正文，统一负责润色、小改、扩写、压缩、重写和结构改。ns-pitch：生成简介、标签、pitch 和宣传文案到根目录 brief.md，内部梗概写入 .novelstudio/notes/synopsis.md。ns-visual：生成封面、角色、场景、道具和分镜插画提示词，输出到 visuals/。
主流程
Novel Studio 的核心流程是：先讨论和确认方向，再搭建框架，然后把可跨会话读取的记忆写进本地文件，最后分章节写作并持续回写 canon。不要依赖聊天上下文保存长期设定。
这套流程按“工程项目”方式写小说：每次开写前恢复本地状态，每次写完后同步索引、连续性和记忆；遇到设定冲突先修 canon 再改正文；交付前做字数、连续性、节奏和去 AI 味检查。换对话后应能只靠 .novelstudio/、当前卷 _index.md、相关 notes/records 和上一章继续。
新书启动
- 使用
ns-start 初始化项目结构，或接入已有 Markdown 正文。
- 使用
ns-ideate 进行头脑风暴，确认题材、卖点、主角欲望、核心阻力、世界/规则边界、类型承诺和第一章钩子。
- 脑暴收束后，把写前记忆落盘到
.novelstudio/notes/story-prep.md 或 .novelstudio/notes/ideation.md，并在 .novelstudio/records/brainstorm-*.md 留阶段检查点。
- 使用
ns-build 搭建世界观、人物关系、类型规则、大纲、卷计划和必要 notes。
- 使用
ns-write 写第一章或下一章。
- 每章完成后，同步
index.yaml、continuity.yaml、memory.yaml 和对应卷 _index.md。
新卷开写
用户要求“开新卷”“写下一卷”或“规划新卷”时，先进入 ns-build，不要直接写正文。
- 先确认本卷主题方向、类型承诺、情绪味道、主矛盾、阶段目标、胜负条件、代价和卷末变化。
- 整理本卷主角、关键配角、反派/阻力的功能和弧线。
- 整理地点、规则、势力、线索、伏笔和上一卷遗留问题。
- 拆出本卷大致章节段落：开卷钩子、推进段、反转段、高潮段和收束段。
- 将短摘要写入
.novelstudio/plan.yaml 的 volumes[]。
- 将人读卷承诺、主题和章节目录写入
content/volumes/<volume>/_index.md。
- 将长卷纲或分阶段写作地图写入
.novelstudio/notes/volume-<id>-outline.md。
- 将规划过程和检查点写入
.novelstudio/records/volume-<id>-planning.md。
- 上述卷级记忆都具备后，再使用
ns-write 写新卷正文。
新会话续写
新会话继续写章节时，先恢复本地记忆，再写正文：
