luoluomashang/narrativespace

최근 기록된 소스 활동: 2026년 4월 14일 13:02

SkillsMP 카탈로그 업데이트: 2026년 11월 12일 12:52

수집된 skills: 8

GitHub 스타: 3
GitHub 포크: 0

AI 어시스턴트로 설치

이 프롬프트를 복사해 사용 중인 AI 어시스턴트에 입력하세요.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/luoluomashang/narrativespace.

저장소 README

README 원본 파일: README.md

README 원본 보기

README 전체 펼치기

# 叙事空间创作系统 v10.0 — 快速参考指南 > **版本**：10.0.0 | **最后更新**：2026-04-10 | **适用平台**：番茄小说网（男频商业网文） > > 完整使用说明请参阅 [使用手册.md](使用手册.md)。本文档适用于 **narrativespace-xushikj** 一体化版本。该版本将原来的 8 个 Skill 统一打包成1个，安装和使用方式简化如下。 ## 快速安装 ### 系统要求 - Claude Code 或 VS Code Copilot Chat（支持 Skill 文件调用） - Python 3.8+ （用于初始化脚本） - MCP 插件（可选）：`server-brave-search`（websearch）、`server-sequential-thinking` ### 安装步骤 1. **复制 Skill 文件夹** ```bash # 一体化版（推荐）：只复制 1 个文件夹 cp -R narrativespace-xushikj /你的项目/.claude/skills/ ``` 2. **项目初始化** ```bash python narrativespace-xushikj/scripts/init.py --project-dir /your/project/path ``` 这会自动： - 创建 `.xushikj/` 工作目录 - 同步 `config/` 文件到项目本地 - 初始化 `state.json`, `knowledge_base.json` 等文件 3. **初始化模式选项** | 模式 | 命令 | 适用场景 | |------|------|----------| | 默认 | `python init.py --project-dir .` | 首次初始化，跳过已存在文件 | | 升级 | `python init.py --project-dir . --upgrade` | 升级版本，保留用户数据 | | 强制 | `python init.py --project-dir . --force` | 重置项目（**慎用，覆盖数据**）| | 自动 | `python init.py --project-dir . --yes` | 跳过所有交互确认 | | 绑定作者 | `python init.py --project-dir . --link-author 作者名` | 绑定全局风格切片库作者 | 4. **重启 Claude Code** 开一个新对话，输入 "叙事空间" 或 "写网文" 即可开始。 --- ## 二阶段执行模式（新增）从二阶段开始，推荐使用「脚本编排 + 小规则集注入」模式，而不是把全量规则一次性塞给模型。 ### 什么时候执行二阶段执行模式分为两层： 1. **日常创作层**：当二阶段改造完成后，用户在实际写书时，每次进入某个步骤前执行。例如进入步骤1规划、步骤10写作前，先由脚本组装当前步骤 Prompt，再把结果交给模型执行。 ### 由谁执行 1. **普通聊天模式**：若当前环境只有普通对话能力、没有工具权限，则需要用户自己执行脚本。 2. **代理模式（如 Claude Code / VS Code Agent）**：若当前环境提供终端和文件工具权限，代理可以代替用户执行 Python 脚本、读取结果并继续下一步。 3. **更准确的边界**：不是“模型永远不能执行脚本”，而是“是否能执行脚本取决于宿主环境是否授予工具权限”。 ### 与用户确认的关系 1. 日常创作层：每完成一个步骤或阶段性动作后，仍应等待用户确认，再推进到下一步骤；不得自动跨步。 2. 即使在代理模式下，代理也应承担“执行者”角色，用户主要承担“确认者”和“创作决策者”角色。 ### 核心变化 1. 保留现有 Skill 架构 2. 每一步由 `scripts/assemble_prompt.py` 组装 Prompt 3. 规则改为按步骤小集合注入（2K-3K tokens 级别） 4. 每阶段执行完必须先自查，再进行用户确认 ### 常用命令 ```bash # 查看项目状态 python narrativespace/scripts/assemble_prompt.py --project-dir .xushikj --status # 写作前预检（Step10 强校验 + 字数门禁） python narrativespace/scripts/validate_state.py --project-dir . --for-step10 --chapter 1 --min-chapter-chars 2500 --strict # 组装快速立项提示词（v10.0 新起点） python narrativespace/scripts/assemble_prompt.py --project-dir .xushikj --step project_card --output file --output-file .xushikj/drafts/project_card_prompt.md # 组装步骤10提示词（写作，显式声明模式） python narrativespace/scripts/assemble_prompt.py --project-dir .xushikj --step 10 --chapter 12 --writing-mode pipeline --output file --output-file .xushikj/drafts/ch12_prompt.md # 推进步骤（按 v10.0 序列：project_card→4→7→8→9→10→11） python narrativespace/scripts/assemble_prompt.py --project-dir .xushikj --advance # 流程门禁回归测试（推荐改造后执行一次） python narrativespace/scripts/regression_workflow_guards.py --project-dir .xushikj --good-chapter 1 --bad-chapter 999 --min-chapter-chars 2500 ``` ### 风格切片落盘（Step 0 后必做） `slice_library.py` 主流程只负责 Step 0（量化分析 + chapter map），不会自动写入切片内容。完成 Step 1/2 的 LLM 选片后，必须执行以下命令落盘： ```bash python narrativespace/scripts/slice_library.py write-snippet --project-dir . --scene-type daily --content-file snippet_daily.md python narrativespace/scripts/slice_library.py write-dna --project-dir . --project-name my_project --dna-json dna_profile.json ``` --- ## 系统架构全貌 ### 8 个创作模块整个系统由 8 个高度专业化的模块组成： ``` ┌─────────────────────────────────┐ │ narrativespace-xushikj (主root) │ └──────────────┬──────────────────┘ │ ┌──────────────────────────┼──────────────────────────┐ │ │ │ ▼ ▼ ▼ ┌─────────┐ ┌──────────────┐ ┌──────────────┐ │benchmark│ │ planning │ │ knowledge │ │(步骤0)│ │ (步骤1-6,11) │ │ -base │ │对标分析│ │ 规划 │ │ (步骤7) │ └─────────┘ └──────────────┘ │ 知识库 │ └──────────────┘ │ ▼ ┌─────────────┐ ┌──────────┐ ┌───────────┐ │ scenes │ │ writing │ │interactive│ │ (步骤8-9) │ │(步骤10A) │ │(步骤10B) │ │ 场景规划 │ │流水线写作 │ │互动写作 │ └─────────────┘ └──────────┘ └───────────┘ │ └──────────────────────────┬─────────────────────────┘ │ ▼ ┌──────────────┐ │ humanizer │ │ (后处理) │ │ 去AI痕迹 │ └──────────────┘ ``` ### v10.0 精简工作流（7步） > **v10.0 变更**：原12步精简为7步。步骤1/2/2.5/3/5/6 合并为「快速立项`project_card`」，一次访谈完成立项。 | 步 | 模块 | 描述 | 输入 | 输出 | |----|------|------|------|------| | **0** | benchmark | 对标作品学习（可选）| 1-3部对标作品 | style_report.md + style_library/ | | **project_card** | planning | 快速立项（1-2轮访谈）| 题材/创意 | outline/project_card.md | | **4** | planning | 当前卷一页大纲 | 立项卡 | outline/volume_{V}_one_page.md | | **7** | knowledge-base | KB初始化 | 立项卡 + 大纲 | knowledge_base.json | | **8** | scenes | 场景清单 | 一页大纲 | scenes/{cycle}/scene_list.md | | **9** | scenes | 章节场景规划 | 场景清单 | scenes/{cycle}/scene_plans/*.md | | **10A** | writing | 流水线写作 | 场景卡 | chapters/chapter_*.md | | **10B** | interactive | 互动跑团写作 | 用户指示 | drafts/session_*.md | | **11** | planning | 书名与简介 | 完成稿 | outline/title_and_synopsis.md | | **后** | humanizer | 去AI痕迹 | 原稿 | 去AI版本 | --- ## v8.x 核心新功能速览 ### v8.0 新增 | 功能 | 说明 | |------|------| | **行文DNA提取** | 提供 2+ 部参考作品文本（≥500字/部）时自动触发。联合提取 DO/DON'T 约束 + 标杆段落，写作时以最高优先级注入 | | **TRPG沉浸互动** | 互动模式新增五种决策类型（行动/对话/态度/战术/内心）+ 决策密度自适应 + INTERRUPT即时干预 | | **情绪温度系统** | cold/warm/hot 三档独立控制叙事体温，与剧情张力解耦 | | **人味注入规则** | ht_01~ht_06 六条强制执行的反AI痕迹生成规则 | | **记忆锚点防遗忘** | 每章 ≤150字锚点（关键转折/悬念/情绪快照/下章债务），对抗长上下文遗忘 | | **三级概括压缩** | summary_index 自动分级压缩（近3章完整/4-10章50%/10+章最小化） | ### v8.1 新增 | 功能 | 说明 | |------|------| | **五型钩子分类** | 章末钩子按类型（悬念/反转/信息差/情绪/行动中断）分类追踪，防止连续同类 | | **七型微兑现** | 每章内嵌1-2处小型承诺兑现，保持读者持续正反馈 | | **Strand Weave 三轨** | 主线/情感线/悬念线三轨节奏并行追踪 + per-genre 压扬比例 | | **OOC人设检查** | 写作后自动对比角色初始设定与实际行为，检测Out-of-Character违规 | | **chapter_meta 结构化** | 每章新增结构化元信息（hook_type/strand_state/payoff记录） | ### v8.2 新增 | 功能 | 说明 | |------|------| | **RAG 本地语义检索** | 30章后自动启用，Ollama + nomic-embed-text，三级降级链，四层实体隔离锁 | | **卷级时间线里程碑追踪** | volume_N_timeline.json 记录里程碑/弧线端点/伏笔热度图，逾期自动注入警告 | | **叙述者口吻人格化** | humanizer 新增 ht_07 规则，统一叙述者语气风格 | ### v10.0 新增 | 功能 | 说明 | |------|------| | **规划流程精简** | 原步骤1/2/2.5/3/5/6 合并为一步 `快速立项(project_card)`，1-2轮访谈完成立项 | | **风格切片复刻系统** | 全局切片库 `~/.narrativespace/style_library/{author}/`，按 scene_type + scene_intensity 自动选片注入 Step 10 | | **v10.0 步骤序列** | `project_card → 4 → 7 → 8 → 9 → 10 → 11`，`--advance` 严格按此序列推进 | | **--link-author 参数** | `init.py --link-author 作者名` 绑定风格切片库作者，`--upgrade` 不覆盖已有绑定 | --- ## 使用方式 ### 模式 1：完整创作流程（从零开始，v10.0） ``` 你: "我想写网文，都市系统类。" 系统: 那我们一步步来。先做对标分析吗？或直接规划？你: "有3部对标作品。" 系统: [进入步骤0，对标分析 + 风格切片库构建] [输出style_report.md] 现在开始规划阶段... 你: 一句话描述你的故事。系统: [进入步骤1-6，完整规划] [输出所有规划文件] 你: 规划看起来不错。系统: 现在初始化知识库... [进入步骤7] [输出knowledge_base.json] 系统: 现在规划各章场景... [进入步骤8-9] [输出scene_list.md + 场景规划] 你: 准备好写了。系统: 选择流水线还是互动模式？你: 流水线，自动写第1-3章。系统: [进入步骤10A] [输出3章完整文本 + 质量报告] ``` ### 模式 2：跳步执行如果你已经有完整大纲，可以直接跳到某一步： ``` 你: "我已经有四页大纲了，直接初始化知识库。" 系统: 确认你有这些文件... [进入步骤7] [输出knowledge_base.json] 你: "现在写第一章。" 系统: [进入步骤10A] [输出chapter_1.md] ``` ### 模式 3：切换写作方式两种写作模式可以随时切换： ``` 你: "用流水线模式写第1-3章。" 系统: [进入步骤10A，写作3章] 你: "现在我要互动写第4章。" 系统: [切换到步骤10B，互动模式] 现在由你引导... 你: "让主角在这里背叛。" 系统: [实时修改剧情] 你: "好，这章就这样了，进行下一章。" 系统: [落盤确认，继续下一章] 你: "第5章继续用流水线吧。" 系统: [切换回步骤10A] ``` --- ## 关键文件说明 ### 项目结构创建项目后，你的目录会是这样： ``` 你的网文项目/ ├── .claude/skills/ │ └── narrativespace-xushikj/ # ← Skill根目录（从此处复制） │ ├── config/ # 配置文件 │ ├── templates/ # 输出格式模板 │ ├── modules/ # 8个创作模块 │ ├── scripts/ # 工具脚本 │ └── ... │ └── .xushikj/ # ← 项目本地工作目录（init.py创建） ├── config/ # 项目专用配置（from template） ├── state.json # 当前进度 ├── knowledge_base.json # 实体库 ├── outline/ │ ├── characters/ │ ├── one_sentence.md │ ├── one_paragraph.md │ └── ... ├── benchmark/ │ └── style_report.md ├── scenes/ │ ├── cycle_1/ │ │ ├── scene_list.md │ │ └── scene_plans/ │ └── ... └── chapters/ # 写好的章节 ├── chapter_1.md ├── chapter_2.md └── ... ``` ### 配置文件（config/）新项目会自动同步这些配置到 `.xushikj/config/`： - `foundational_principles.yaml` — 底层创作原则（因果、人物、主题） - `writing_rules.yaml` — 写作强约束（平台打法） - `style_rules.yaml` — 语言风格和去模板化 - `benchmark_triggers.yaml` — 对标基准和降权策略 - `quality_dimensions.yaml` — 8维质量评分标准 - `emotional_temperature.yaml` — **情绪温度系统**（v8.0）：cold/warm/hot 三档叙事体温 - `human_touch_rules.yaml` — **人味注入规则**（v8.0）：ht_01~ht_06 反AI痕迹规则 - `trpg_immersion.yaml` — **TRPG沉浸配置**（v8.0）：决策类型/密度/INTERRUPT - `style_modules/` — 风格模块（悬疑/爱情/奇幻等） **重要**：修改时优先改 `.xushikj/config/` 下的项目本地副本，不要直接改 Skill 的`config/`。前者只影响当前项目，后者影响所有新项目。 ### 模板文件（templates/）定义各步骤的输出格式： - `state_template.json` — 项目状态模板 - `kb_template.json` — 知识库模板 - `memory_template.md` — 回忆录模板 - `summary_index_template.md` — 总结索引 - `user_settings_template.md` — 用户设置 --- ## 规划阶段的交互方式 **重要规则**：规划阶段必须是强交互式的。系统不会一次性生成完整设定，而是逐步了解你的需求。 ### 正确的执行顺序 1. **第一步**：系统先问关键信息（题材、主角、平台、禁区等） 2. **每个小步骤前**：系统再问该步骤本身的具体需求 3. **信息足够后**：系统才生成当前步骤的草案 4. **草案生成后**：等待你确认或修改，不自动往下跑 5. **你确认后**：才进入下一步 ### 示例 ``` 你: "写网文" 系统: 我需要了解几个关键信息： 1. 想写什么类型？(都市/奇幻/悬疑等) 2. 主角是什么身份？ 3. 目标读者平台？(番茄/起点等) 4. 有没有内容禁区？你: "都市，打工仔，番茄，无特殊禁区" 系统: 好的。现在开始规划--请用一句话概括这个故事的核心卖点。你: [给出一句话] 系统: [生成 one_sentence.md] 确认这个一句话概括吗？需要修改吗？你: "改一下，加上系统元素" 系统: [修改后重新生成] 这样可以吗？你: "可以" 系统: 现在词在写开头，需要进一步展开。故事的主线矛盾是什么？爽点偏什么方向？你: [详细描述] 系统: [生成 one_paragraph.md] ``` **关键**：如果你希望某部分由系统自由发挥，可以直接说 "这部分你先提案"。系统会先给方案，但仍需你确认。 --- ## 两种写作模式详解 ### 流水线模式（代理/脚本编排执行） **适合场景**：已有清晰大纲，想高效产出 **特点**： - 系统自动按场景规划逐章生成 - 你在章间审阅、批注修改意见 - 自动落盤进入下一章 - 支持子 agent 架构（章节写手 + 总结官） - 内置帮回辅助系统和双保险质量控制 - 在普通聊天模式下，脚本通常由用户手动运行 - 在代理模式下，代理可直接代为运行脚本并继续流程 **流程**： ``` 场景规划 → 自动写作 → 质量评分 → 你审阅 → 通过/修改 → 落盤 → 下一章 ``` ### 互动模式（用户驾驶） **适合场景**：想深度参与故事走向，实时调整 **特点**： - 章内可随时干预（"让这里改成背叛"） - 帮回系统辅助用户指示 - 需要你主动说 "OK落盤" 才推进 - 更适合关键剧情节点 **流程**： ``` 你的指示 → 帮回理解 → 系统执行 → 生成片段 → 你确认/修改 → 帮回反馈 → 循环 → 最终落盤 ``` --- ## 去 AI 痕迹处理 (humanizer) 完成写作后，可以一键清除 AI 生成痕迹。 **处理层次**： 1. **主规则层**（R1-R7+可选R8）：小说场景的快速清洗 - 去除宣传性语言 - 修复象征意义夸大 - 消除 AI 问候式讨好语 2. **二级扫描层**（吸收humanizer-zh）：24类AI痕迹模式补漏 - 内容模式（空泛展望、模糊归因） - 语言模式（AI词簇、否定排比滥用） - 风格模式（破折号/粗体过多） - 聊天痕迹（知识截止声明残留） **安全边界**：不修改情节事实、人物关系、世界规则。仅处理表达层和可读性层。 --- ## 常见问题 **Q: 系统说找不到 state.json？** A: 正常现象。state.json会在你第一次开始创作时自动生成。 **Q: 可以跳过某些步骤吗？** A: 可以。但系统会先确认你已有相應输入（比如跳过规划要有完整大纲）。不会擅自补写关键设定。 **Q: 写到一半想改大纲怎么办？** A: 直接改对应的文件，告诉系统 "大纲已更新"。知识库和场景规划可能需要同步更新。 **Q: humanizer 会改我的情节吗？** A: 不会。它只处理表达层面的 AI 痕迹（句式、用词、排版）。不触碰情节和人物行为。R8规则会删除无用细节，但默认关闭。 **Q: 两种写作模式可以混用吗？** A: 可以。任何时刻都能切换。前几章流水线快速推进，关键节点切换互动精雕细琢，再切回流水线。 **Q: 8个模块是怎么交互的？** A: 通过state.json追踪进度，各模块读取当前状态，执行对应步骤，输出结果保存到.xushikj/，自動更新state。完全解耦，无直接调用。 --- ## 目录结构速览 ``` narrativespace-xushikj/ ├── SKILL.md # 主 Skill 入口（8模块路由调度） ├── prompt.md # 主路由提示词（含路由逻辑） ├── README.md # 本文档（快速参考） ├── 使用手册.md # 完整中文使用手册 │ ├── config/ # 全局配置种子（被 init.py 同步） │ ├── foundational_principles.yaml │ ├── writing_rules.yaml │ ├── style_rules.yaml │ ├── benchmark_triggers.yaml │ ├── quality_dimensions.yaml │ ├── bangui_modes.yaml # 帮回系统 │ ├── emotional_temperature.yaml # 情绪温度系统（v8.0） │ ├── human_touch_rules.yaml # 人味注入规则（v8.0） │ ├── trpg_immersion.yaml # TRPG沉浸配置（v8.0） │ ├── safety_guard.yaml │ ├── self_check_rules.yaml │ ├── meta_rules.yaml │ └── style_modules/ # 细分风格模块 │ ├── fantasy.yaml │ ├── horror.yaml │ ├── humor.yaml │ ├── literary.yaml │ ├── mystery.yaml │ ├── romance.yaml │ ├── suspense.yaml │ └── index.yaml │ ├── templates/ # 项目初始化用的模板 │ ├── state_template.json │ ├── kb_template.json │ ├── memory_template.md │ ├── summary_index_template.md │ ├── timeline_vol_template.json # 卷级时间线模板（v8.2） │ └── user_settings_template.md │ ├── scripts/ # 工具脚本 │ ├── init.py # 项目初始化/升级 │ ├── rag_index.py # RAG向量索引管理（v8.2） │ ├── volume_snapshot.py # 卷末状态快照生成（v8.2） │ ├── archive_long_lines.py # memory.md 超长行自动归档 │ ├── generate_kb_diff_template.py # KB Diff 骨架预生成 │ ├── update_skill_metadata.py # 批量同步模块元数据 │ └── validate_references.py # 跨模块引用完整性校验 │ ├── modules/ # 8个创作模块 │ ├── benchmark/ # 步骤0：对标分析 + 行文DNA提取 │ ├── planning/ # 步骤1-6+11：规划（三层粒度） │ ├── knowledge-base/ # 步骤7：KB 初始化 + 增量 diff │ ├── scenes/ # 步骤8-9：场景清单 + 场景卡 │ ├── writing/ # 步骤10A：流水线写作（含Orchestrator） │ ├── interactive/ # 步骤10B：互动跑团（TRPG状态机） │ └── humanizer/ # 后处理：去AI痕迹 + DNA校验 │ └── references/ # 全局参考文档 └── original-prompt-sections/ # 系统设计原始文档 ``` --- ## 技术细节 ### 状态机（State Machine）系统用 `state.json` 追踪创作进度（完整字段参见使用手册第15节）： ```json { "version": "8.2.0", "writing_mode": "pipeline | interactive", "planning_state": { "current_step": 7, "completed_steps": [...] }, "writing_state": { "current_chapter": 12, "current_cycle": "cycle_003" }, "interactive_state": { "current_scene_state": "PING_PONG", "turn_number": 8 }, "dna_extraction": { "done": true, "output_files": ["dna_human_proj.yaml"] }, "rag_state": { "enabled": true, "total_indexed": 35 }, "files": { "anchors": ["anchors/chapter_01_anchor.md", "..."] } } ``` ### 知识库（Knowledge Base）基于 EX3 论文的动态实体追踪，支持 add/update/evolve/resolve 四种 diff 操作： ```json { "entities": { "characters": { "char_001": { "name": "林默", "arc_stage": "挣扎期", "arc_history": [] } }, "locations": {}, "items": {}, "factions": {}, "abilities": {}, "events": {} }, "foreshadowing": { "planted": [], "resolved": [] }, "relationships": [], "timeline": [] } ``` 每章写完后，chapter-writer 自动输出 `kb_diffs/ch{N}_diff.json`，由 Orchestrator 增量应用。 ### 质量保证栈 - **8维度评分**（qd_01~qd_08）— 爽感/金手指/节奏/对话/一致性/意境/语言/钩子，合格线 64/80 - **qd_07 硬门槛** — 章末钩子 < 7分自动触发修订循环 - **Critic sub-agent** — 自动修订，最多2轮（防无限循环） - **Cycle 收敛检查** — 每5章检查爽感分布/质量均值/伏笔净增/节奏比例 - **DNA 自检**（v8.0）— DO清单命中率 < 50% 触发 HALT - **OOC 人设检查**（v8.1）— 自动对比角色设定与实际行为 --- ## 联系与反馈完整使用说明请查阅 [使用手册.md](使用手册.md)，各模块详细文档见 `modules/*/SKILL.md`。 --- **版本**：8.2.0 | **最后更新**：2026-04-05 | **状态**：生产就绪 ✅

저장소 README를 불러오는 중…