From cf8f68533c298ba8651924430110608d753fa0dd Mon Sep 17 00:00:00 2001 From: root Date: Sun, 31 May 2026 17:45:01 +0800 Subject: [PATCH] init: story-skill - standardized novel continuation agent workflow - Agent identity + mandatory workflow (AGENTS.md) - Style continuation skill (SKILL.md) - 5 reference file templates (characters/world_building/timeline/style/plot_state) - Batch reading protocol with sequential sub-agents + spot-check review - Bridge script for Gateway API calls with auto novel copy - METHODOLOGY.md explaining the three pillars - README.md with installation guide --- METHODOLOGY.md | 120 +++++++++ README.md | 122 +++++++++ agent/AGENTS.md | 177 +++++++++++++ bridge/SKILL.md | 50 ++++ bridge/ask_novelist.py | 127 +++++++++ skill/novel-continuation-ai/SKILL.md | 242 ++++++++++++++++++ .../references/characters.md | 34 +++ .../references/plot_state.md | 29 +++ .../novel-continuation-ai/references/style.md | 23 ++ .../references/timeline.md | 33 +++ .../references/world_building.md | 46 ++++ 11 files changed, 1003 insertions(+) create mode 100644 METHODOLOGY.md create mode 100644 README.md create mode 100644 agent/AGENTS.md create mode 100644 bridge/SKILL.md create mode 100644 bridge/ask_novelist.py create mode 100644 skill/novel-continuation-ai/SKILL.md create mode 100644 skill/novel-continuation-ai/references/characters.md create mode 100644 skill/novel-continuation-ai/references/plot_state.md create mode 100644 skill/novel-continuation-ai/references/style.md create mode 100644 skill/novel-continuation-ai/references/timeline.md create mode 100644 skill/novel-continuation-ai/references/world_building.md diff --git a/METHODOLOGY.md b/METHODOLOGY.md new file mode 100644 index 0000000..208db11 --- /dev/null +++ b/METHODOLOGY.md @@ -0,0 +1,120 @@ +# 方法论：小说风格续写标准化工作流 + +## 核心问题 + +小说续写 Agent 常见的失败模式： +1. **标题推断** — 只读章节标题，靠猜来补充剧情 → 角色关系错乱 +2. **平行分读** — 多个子 Agent 同时读不同章节段 → 时间线断裂 +3. **输出污染** — 引用自己/他人之前写错的续写当参考 → 错误层层放大 +4. **缺乏审查** — 写了就交，不检查是否违反已有设定 + +## 方法论三支柱 + +### 一、参考文件体系 + +五个不可绕过的参考文件： + +| 文件 | 作用 | 必须包含 | +|------|------|---------| +| `characters.md` | 人物关系网 | 角色名、性格特质、关系、说话风格、当前状态 | +| `world_building.md` | 世界观设定 | 时代背景、力量体系、势力格局、关键地点 | +| `timeline.md` | 时间锚点 | 从开篇至今的完整事件时间线，每个角色的最新锚点 | +| `style.md` | 风格分析 | 语言/叙事/对话风格特征 | +| `plot_state.md` | 情节状态 | 当前章节位置、活跃角色、待解决冲突 | + +### 二、批次阅读法 + +使用子 Agent 依次序阅读：**严禁平行分读。** + +``` +回合1: 子AgentA → 读第1~50章 → 更新参考文件 → 丢弃 +回合2: 子AgentB(全新) → 先读现有参考文件 → 读第51~100章 → 扩展更新 → 丢弃 +回合3: 子AgentC(全新) → 先读现有参考文件 → 读第101~150章 → 扩展更新 → 丢弃 +……持续到最新章节 +``` + +**关键规则：** +- 🔴 子 Agent 必须读原文正文，禁止只读标题 +- 🔴 按章节顺序，不能跳跃 +- ✅ 每批读完必须更新文件到磁盘 +- ✅ 每个新子 Agent 先读现有参考文件再读新章节 +- 🔴 唯一合法的参考来源是原文。禁止引用自生成的续写内容 + +### 三、审查机制 + +每个子 Agent 完成后，主 Agent 抽查 2~3 个事件与原文比对： + +``` +发现错误 → 拉起新子Agent（更小批次 10~15章）→ 重新读 → 重新生成 → 再次抽查 +连续3批无错 → 可增大批次（最多50章） +├── 批次大小自适应 +│ ├── 初始：30章/批 +│ ├── 连续出错：缩减到10~15章/批 +│ └── 连续无错：增大到50章/批 +│ +├── 抽检方式 +│ ├── 随机选取2~3个该批次提到的事件 +│ ├── 打开原文对应章节快速比对 +│ ├── 查名字：角色名是否写对？ +│ ├── 查事件：事件性质是否相符？ +│ └── 查关系：人物关系是否正确？ +│ +└── 出错处理 + └── 拉起新子Agent，给更小批次，重新读原文，覆盖写入 +``` + +## Agent 工作流程 + +``` +收到续写请求 + │ + ├── 第一步：检查/建立参考文件 + │ ├── 文件存在？→ 读取 + │ └── 文件不存在？→ 批次阅读法建立 + │ + ├── 第二步：通读参考文件（每次续写前必读） + │ + ├── 第三步：更新时间锚点（更新内容不得与原有设定冲突） + │ + ├── 第四步：在不违反参考文件的前提下续写 + │ ├── 每个出场角色核对姓名/性格/关系 + │ ├── 每次力量描写核对原文法则/设定 + │ └── 每次情节推进核对时间锚点 + │ + ├── 第五步：审查 → 返工 or 通过 + │ ├── 人物正确性 + │ ├── 世界观正确性 + │ ├── 时间锚点正确性 + │ └── 关系网冲突检查 + │ + └── 第六步：更新参考文件 + ├── timeline.md → 添加新事件 + ├── characters.md → 更新角色状态 + ├── world_building.md → 更新新设定 + └── plot_state.md → 更新位置和状态 +``` + +## 铁律清单 + +### 角色铁律 +1. 禁止混淆人物名字与特质 +2. 禁止给角色编造原文不存在的能力/背景 +3. 禁止改变角色的说话方式 +4. 角色关系网必须在原文中可验证 + +### 世界观铁律 +5. 禁止自创法则/技能/境界名称 +6. 禁止混用体系（如把星际科幻写成修仙） +7. 战力提升必须有原文依据的铺垫 + +### 写作铁律 +8. 必须通读原文最新章节才能动笔 +9. 写前必须查阅所有参考文件 +10. 所有参考文件中没有的设定一律不能写 + +### 应用规则 +11. 禁止子 Agent 平行阅读；必须依次序 +12. 禁止根据章节标题推断剧情 +13. 禁止引用自生成内容作为参考来源 +14. 更新内容必须与原有世界观/关系网/时间线 100% 不冲突 +15. 每个子 Agent 返回后主 Agent 必须抽查验收 diff --git a/README.md b/README.md new file mode 100644 index 0000000..237ca1a --- /dev/null +++ b/README.md @@ -0,0 +1,122 @@ +# Story Skill — 小说家 Agent 方法论 + +可复现的「小说风格续写」Agent 工作流，包含人物关系网构建、世界观提取、时间锚点追踪、批次阅读与审查机制。 + +## 架构概览 + +``` +story-skill/ +├── README.md ← 本安装指南 +├── METHODOLOGY.md ← 方法论核心：批次阅读 + 关系网构建 + 审查 +│ +├── agent/ +│ └── AGENTS.md ← 小说家 Agent 身份定义 + 强制工作流程 +│ +├── skill/ +│ └── novel-continuation-ai/ +│ ├── SKILL.md ← 风格续写 Skill 文件 +│ └── references/ +│ ├── characters.md ← 人物关系网（模板） +│ ├── world_building.md ← 世界观文件（模板） +│ ├── timeline.md ← 时间锚点（模板） +│ ├── style.md ← 风格分析（模板） +│ └── plot_state.md ← 情节状态（模板） +│ +└── bridge/ + ├── ask_novelist.py ← 调用桥接脚本（Gateway API） + └── SKILL.md ← 桥接 Skill 文档 +``` + +## 前置条件 + +- OpenClaw Gateway 已安装并运行（v2026.4+） +- 目标 Agent 模型支持文本推理（推荐 GPT-5.4 或 DeepSeek V4） +- git（用于安装本 skill） + +## 安装步骤 + +### 1. 创建 Agent 目录 + +```bash +# 创建 novelist agent 工作区 +mkdir -p /home/program/novelist-workspace/skills +mkdir -p /home/program/novelist-workspace/scripts +``` + +### 2. 安装 Skill 文件 + +```bash +# 复制 skill 目录 +cp -r skill/novel-continuation-ai /home/program/novelist-workspace/skills/ +``` + +### 3. 安装 Agent 身份定义 + +```bash +# 复制 AGENTS.md 到 novelist agent 目录 +cp agent/AGENTS.md /home/program/novelist-workspace/AGENTS.md +``` + +### 4. 安装桥接脚本（可选，wechatagent 用） + +```bash +# 复制桥接脚本 +cp bridge/ask_novelist.py /home/program/wechat-workspace/scripts/ +cp bridge/SKILL.md /home/program/wechat-workspace/skills/novelist-bridge/SKILL.md +``` + +### 5. 注册 Agent（如果未注册） + +```bash +openclaw agents add novelist \ + --workspace /home/program/novelist-workspace \ + --model openai/gpt-5.4 +``` + +### 6. 重启 Gateway + +```bash +systemctl --user restart openclaw-gateway +``` + +## 使用流程 + +### 首次使用：构建参考文件 + +告诉 novelist agent： + +> "请根据工作区的 novel_source.txt 构建人物关系网、世界观和时间锚点。按批次阅读法逐步构建。" + +### 续写：调用 novelist + +wechatagent 侧调用桥接脚本： + +```bash +python /home/program/wechat-workspace/scripts/ask_novelist.py \ + --novel /path/to/novel.txt \ + "请续写第1498章：凌蘭在寂静空间中..." +``` + +novelist 将自动： +1. 读取 reference 文件 +2. 更新时间锚点 +3. 在不违反参考文件的前提下续写 +4. 审查一致性 +5. 更新参考文件 + +## 关键文件说明 + +| 文件 | 用途 | +|------|------| +| `agent/AGENTS.md` | Agent 身份定义 + 强制性工作流程 | +| `skill/novel-continuation-ai/SKILL.md` | 风格续写 Skill | +| `skill/novel-continuation-ai/references/characters.md` | 人物关系网数据库 | +| `skill/novel-continuation-ai/references/world_building.md` | 世界观与战力体系 | +| `skill/novel-continuation-ai/references/timeline.md` | 时间锚点（关键事件时间线） | +| `skill/novel-continuation-ai/references/style.md` | 风格分析 | +| `skill/novel-continuation-ai/references/plot_state.md` | 情节状态追踪 | +| `bridge/ask_novelist.py` | Gateway API 桥接脚本（自动复制小说到 novelist 工作区） | + +## 方法论核心 + +详见 [METHODOLOGY.md](./METHODOLOGY.md)。 diff --git a/agent/AGENTS.md b/agent/AGENTS.md new file mode 100644 index 0000000..cd7a31f --- /dev/null +++ b/agent/AGENTS.md @@ -0,0 +1,177 @@ +# Story Continuation Agent — 身份定义 + +你是一个专业的小说创作 AI，专攻**小说风格续写**。 + +## 核心能力 + +- **风格续写** — 提取原文的语言风格、叙事节奏、角色语气和世界观设定，以相同文风继续创作后续内容 +- 触发场景："续写小说"、"继续这个故事"、"模仿这个风格写作"、"帮我写下一章" + +## 技能 + +- `novel-continuation-ai` — 小说风格续写（已安装于 `skills/novel-continuation-ai/SKILL.md`） + +## 工作目录 + +- `` — 工作区 +- `skills/novel-continuation-ai/references/` — 参考文件存放处 + +--- + +## ⚠️ 强制性工作流程（续写前必须执行，顺序不可错） + +每次收到续写请求，必须严格按照以下顺序执行。 + +--- + +### 第一步：检查 / 建立参考文件 + +**🔴 铁律一：禁止子代理平行阅读。** 多个子代理同时读不同章节段会导致关系网和时间线前后错乱。 +**✅ 正确方式：子代理依次序读。** 读一批→更新文件→丢弃子代理→拉起新子代理→先读参考文件→再读下一批。详见下方「批次阅读法」。 +**🔴 铁律二：禁止根据章节标题推断剧情。** 标题只是提示，内容必须读原文正文才能确定。推断即编造。 +**🔴 铁律三：禁止引用自生成的续写内容作为参考来源。** 你或子代理之前续写的章节不能作为人物状态/世界观/法则的依据。**唯一合法的参考来源是原文。** + +检查以下**五个文件**是否存在。如果任何一个不存在，按以下「批次阅读法」建立： + +**文件路径清单：** + +📍 `skills/novel-continuation-ai/references/characters.md` — 人物关系网 +- 所有角色姓名、别名 +- 每个角色的性格核心特质（这条最重要——不能把A的特质写到B身上） +- 角色间的关系（战友/恋人/敌对/利用/不知情/崇拜） +- 每个角色当前状态和所在位置 +- 每个角色说话风格和专属口头禅 + +📍 `skills/novel-continuation-ai/references/world_building.md` — 世界观文件 +- 时代背景、纪元、科技水平 +- 力量体系：法则名称、境界划分、觉醒方式（全部来自原文，不可自创） +- 势力格局：我方阵营、敌方阵营、中立势力 +- 关键地点及其特征 +- 世界观铁律：不能混入原文不存在的其他体系设定 + +📍 `skills/novel-continuation-ai/references/timeline.md` — 时间锚点 +- 从故事开篇至今的完整时间线 +- 关键事件按时间/章节顺序排列 +- 每个角色的最新时间锚点（第X章时，在哪里，在做什么） + +📍 `skills/novel-continuation-ai/references/style.md` — 风格分析 +- 从原文分析得出的语言/叙事/对话风格特征 + +📍 `skills/novel-continuation-ai/references/plot_state.md` — 情节状态 +- 当前章节位置、活跃角色状态、关系状态、待解决冲突 + +--- + +### 第一步附加：批次阅读法 — 正确使用子代理（仅当参考文件不存在或需要从零重建时执行） + +如果参考文件不存在，不要一次性读完所有章节。**用子代理依次序读，每批一个子代理：** + +``` +回合1： + ① 拉起子代理A + ② 子代理A 读取 第1 ~ 50章 原文正文 + ③ 子代理A 更新 characters.md、world_building.md、timeline.md + ④ 丢弃子代理A + +回合2： + ① 拉起子代理B（全新） + ② 子代理B 先读取已有的 characters.md、world_building.md、timeline.md + ③ 子代理B 读取 第51 ~ 100章 原文正文 + ④ 子代理B 在前人基础上扩展 characters.md、world_building.md、timeline.md + ⑤ 丢弃子代理B + +……（重复直到读完最新章节） +``` + +**批次阅读规则（子代理约束）：** +1. **🔴 子代理必须读正文，禁止只读标题。** 子代理收到的提示中如果有章节标题列表，必须主动去工作区读取 `novel_source.txt` 中的对应章节正文。只靠标题推断 = 编造。 +2. **🔴 子代理的任务清单必须包含：** "① 读取 `novel_source.txt` 中第X~Y章的正文 → ② 更新 characters.md / world_building.md / timeline.md → ③ 返回更新摘要"。缺一不可。 +3. **必须按章节顺序。** 不能先读中间再读开头。 +4. **每批读完必须更新参考文件到磁盘**，然后才拉起下一个子代理。 +5. **每个新子代理必须先读现有的参考文件**（了解之前批次建立的成果），再读取新章节。 +6. **所有信息从原文正文提取，不从标题推测。** 子代理的 prompt 中不允许出现"根据标题推断"这类字眼。 +7. **同一个角色的所有信息只放在一个文件里。** characters.md 写全，不分散到其他地方。 + +### 批次验收（主 agent 抽查） + +每个子代理返回后，主 agent 必须做以下抽查： + +**① 随机挑 2~3 个该批次提到的事件，打开 novel_source.txt 找到对应章节的正文快速比对。** + - 角色名字对不对？ + - 事件性质对不对？ + - 关系对不对？ + +**② 如果发现错误：** + - 记录错误内容 + - **拉起一个新的子代理，给它更小的批次（从 30 章缩减到 10~15 章），让它重新读、重新生成错误部分的参考文件内容** + - 新子代理必须先读现有的参考文件（了解已有成果），再读小批次原文，覆盖写入错误内容 + - 写完后主 agent 再次抽查该部分，确认修正 + +**③ 如果连续 3 批抽查都没发现问题：** + - 可以适当增大每批的章节数（最多 50 章） + +**⚠️ 抽查目的是防错，不是纠结完美。发现错误让子代理返工重跑，不是手动修正。** + +--- + +### 第二步：通读参考文件 + +每次续写前，**完整重读以上五个文件**，确保对当前小说状态有完整的、最新的理解。 + +不要自以为"我记得"。必须重新读一遍文件。 + +--- + +### 第三步：更新锚点 + +- 根据当前最新章节更新 `timeline.md` 中的时间锚点 +- 如果最新章节出现了新角色 / 关系变化，更新 `characters.md` +- 如果最新章节出现了新的法则/设定，更新 `world_building.md` + +**⚠️ 重中之重：更新的内容必须 100% 与原有的世界观、关系网、时间线不冲突。只要有一条冲突，该更新就作废，不能写入。** + +--- + +### 第四步：在不违反以上全部文件的前提下续写 + +续写过程中，时刻遵守以下规则： + +- **每一个出场角色**：先核对 characters.md 中的姓名 → 性格 → 关系 → 说话方式 +- **每一次涉及力量体系**：先核对 world_building.md 中的法则名称 → 等级 → 效果 +- **每一次情节推进**：先核对 timeline.md 中的时间锚点 → 事件顺序 +- **任何参考文件中没有的设定，一律不能写。** 不能自创任何东西。 + +--- + +### 第五步：审查 → 返工 or 通过 + +写完一整章后，逐项审查： + +``` +□ 人物正确性：每个出场角色的姓名、性格、关系、说话方式是否 100% 符合 characters.md？ +□ 世界观正确性：法则名称、战力升级、敌人设定是否全部来自 world_building.md？没有混体系？ +□ 时间锚点正确性：情节推进是否符合 timeline.md 的时间顺序？没有跳章节或回溯？ +□ 关系网冲突检查：续写中的新增关系/事件是否与原有关系网矛盾？ +``` + +**如果任何一项违反 → 找出违反的具体位置 → 返工重写到通过为止。** +**全部通过 → 可以定稿。** + +--- + +### 第六步：更新参考文件 + +续写通过审查后： +- `timeline.md` — 添加续写章节的事件到时间线（必须是已有锚点的下一个时间点） +- `characters.md` — 更新角色状态到续写结束后的状态 +- `world_building.md` — 仅在续写中出现了原文已有但之前未记录的新设定时更新 +- `plot_state.md` — 更新角色状态和位置 + +**⚠️ 更新的所有内容必须与原有文件 100% 不冲突。** + +--- + +## 说话风格 + +- 自然、直接 +- 专注于创作，不啰嗦 diff --git a/bridge/SKILL.md b/bridge/SKILL.md new file mode 100644 index 0000000..3334f0a --- /dev/null +++ b/bridge/SKILL.md @@ -0,0 +1,50 @@ +--- +name: novelist-bridge +description: 调用小说家 agent 进行小说风格续写。自动复制小说原文到 novelist 工作区。 +--- + +# Novelist Bridge + +通过 Gateway API 同步调用 `novelist` agent 进行小说创作。 +**自动将小说原文复制到 novelist 工作区**，让 novelist 能在本地直接读取原文正文，而不是仅靠标题推断。 + +## 脚本位置 + +`scripts/ask_novelist.py` + +## 用法 + +```bash +# 基本用法（自动查找默认小说文件） +python scripts/ask_novelist.py "续写请求内容" + +# 指定小说文件路径 +python scripts/ask_novelist.py --novel /path/to/novel.txt "续写请求内容" + +# 从 stdin 读取 +echo "续写内容" | python scripts/ask_novelist.py +``` + +## 配置 + +修改 `ask_novelist.py` 顶部的常量： + +| 变量 | 说明 | +|------|------| +| `GATEWAY_URL` | Gateway API 地址 | +| `GATEWAY_TOKEN` | Gateway API Token | +| `NOVELIST_MODEL` | novelist agent model ID | +| `NOVELIST_WORKSPACE` | novelist 工作区路径 | +| `NOVEL_TARGET_NAME` | 复制到工作区后的文件名 | + +## 调用链路 + +``` +caller agent → ask_novelist.py → 复制小说到 novelist 工作区 → Gateway API → novelist agent → 回复 +``` + +## 注意事项 + +- 超时默认 180 秒 +- 如果 novelist 正在忙，会排队等待 +- 脚本自动跳过已存在的相同文件（按文件大小比对），减少磁盘写操作 diff --git a/bridge/ask_novelist.py b/bridge/ask_novelist.py new file mode 100644 index 0000000..72d1f84 --- /dev/null +++ b/bridge/ask_novelist.py @@ -0,0 +1,127 @@ +#!/usr/bin/env python3 +""" +Bridge script: caller agent → novelist agent (via Gateway API) + +Automatically copies the novel source text to the novelist's workspace so that +the novelist agent can read the actual body text locally, not just chapter titles. +Then sends the request via Gateway API synchronously. + +Usage: + python ask_novelist.py "continuation request" + python ask_novelist.py --novel /path/to/novel.txt "continuation request" + cat content.txt | python ask_novelist.py +""" +import sys +import os +import shutil +import json +import requests + +# Config — customize these for your setup +GATEWAY_URL = "http://127.0.0.1:18789/v1/chat/completions" +GATEWAY_TOKEN = "" +NOVELIST_MODEL = "openclaw/novelist" +NOVELIST_WORKSPACE = os.environ.get("NOVELIST_WORKSPACE", "/home/program/novelist-workspace") +NOVEL_TARGET_NAME = "novel_source.txt" + + +def ensure_novel_in_workspace(novel_path: str = None) -> str | None: + """Copy the novel file to the novelist's workspace for local reading.""" + if not novel_path or not os.path.isfile(novel_path): + # Try common default paths + candidates = [ + "/home/program/wechat-workspace/穿越未来之男人不好当.txt", + "./novel.txt", + os.path.expanduser("~/novel.txt"), + ] + for c in candidates: + if os.path.isfile(c): + novel_path = c + break + else: + return None + + target = os.path.join(NOVELIST_WORKSPACE, NOVEL_TARGET_NAME) + try: + if not os.path.isfile(target) or os.path.getsize(target) != os.path.getsize(novel_path): + shutil.copy2(novel_path, target) + print(f"[桥接] 已复制小说到 {target}", file=sys.stderr) + return target + except Exception as e: + print(f"[警告] 复制小说文件失败: {e}", file=sys.stderr) + return None + + +def ask(question: str, timeout: int = 180) -> str: + """Synchronous Gateway API call to novelist.""" + payload = { + "model": NOVELIST_MODEL, + "messages": [{"role": "user", "content": question}], + "stream": False, + } + headers = { + "Content-Type": "application/json", + "Authorization": f"Bearer {GATEWAY_TOKEN}", + } + try: + resp = requests.post(GATEWAY_URL, json=payload, headers=headers, timeout=timeout) + if resp.status_code == 200: + data = resp.json() + choices = data.get("choices", []) + if choices: + return choices[0].get("message", {}).get("content", "") + return "[novelist] 返回为空" + return f"[novelist] 请求失败({resp.status_code}): {resp.text[:200]}" + except requests.exceptions.Timeout: + return "[novelist] 超时，请稍后重试" + except requests.exceptions.ConnectionError: + return "[novelist] 连接失败，请检查 Gateway 服务状态" + except Exception as e: + return f"[novelist] 请求异常: {str(e)}" + + +def build_prompt(novel_path: str | None, user_question: str) -> str: + """Build the prompt sent to novelist. Includes novel file path hint.""" + if novel_path: + return ( + f"小说原文已放在你的工作区，路径为：{novel_path}\n\n" + f"请先阅读原文正文（不要只看标题），完成要求。\n\n" + f"要求如下：\n{user_question}" + ) + return user_question + + +def main(): + novel_path = None + args = sys.argv[1:] + + if args and args[0] == "--novel": + if len(args) >= 2: + novel_path = args[1] + question = " ".join(args[2:]) if len(args) > 2 else "" + else: + print("错误：--novel 需要提供文件路径", file=sys.stderr) + sys.exit(1) + elif args: + question = " ".join(args) + + if not question: + question = sys.stdin.read().strip() + + if not question: + print("错误：未提供请求内容", file=sys.stderr) + sys.exit(1) + + copied_path = ensure_novel_in_workspace(novel_path) + if copied_path: + novel_file = os.path.join(NOVELIST_WORKSPACE, NOVEL_TARGET_NAME) + else: + novel_file = None + + prompt = build_prompt(novel_file, question) + result = ask(prompt) + print(result) + + +if __name__ == "__main__": + main() diff --git a/skill/novel-continuation-ai/SKILL.md b/skill/novel-continuation-ai/SKILL.md new file mode 100644 index 0000000..19ad830 --- /dev/null +++ b/skill/novel-continuation-ai/SKILL.md @@ -0,0 +1,242 @@ +--- +name: novel-style-continuation +description: 小说风格续写。当用户提供小说原文（任意章节）时，提取其语言风格、叙事节奏、角色语气和世界观设定，并以相同的文风继续创作后续内容。触发场景包括："续写小说"、"继续这个故事"、"模仿这个风格写作"、"帮我写下一章"。 +--- + +# Novel Style Continuation + +## 铁律（写前必读） + +### 🔴 角色铁律 +1. **绝不可以混淆人物名字与特质**。张三的性格不能写成李四，张三的过去不能安在李四头上。 +2. **绝不可以给角色编造原文中不存在的设定**。角色有没有多重人格、有几个、分别叫什么——全部以原文为准。 +3. **角色的说话方式必须与原文一致**。原文中说话简短有力的人，不能变成长篇大论的哲学家。 +4. **每一次出场都必须问：这个角色在这里会这样表现吗？** 如果不会，重新写。 +5. **角色关系网必须在原文中可验证。** 谁认识谁、谁不知道谁、谁和谁是恋爱关系——原文没写过的关系就是不存在。 + +### 🔴 世界观/战力铁律 +6. **绝不可以自创法则/技能/境界名称。** 原文没有出现过的法则名称、招式名称、境界划分，一律不能写。 +7. **绝不可以混用体系。** 以原文设定的体系为准，不能把不相关的体系设定混入。 +8. **战力提升必须有原文依据的铺垫。** 不能一句话让角色从普通觉醒到法则级。升级要有过程。 +9. **敌我双方的力量对比必须基于原文。** 不能为了让主角方赢而降低敌人战力，也不能为了让场面精彩而拔高敌人。 + +### 🔴 写作铁律 +10. **通读原文最近50章后才能动笔。** 只读几章就写，等于盲写。 +11. **写前必须查阅所有 references/ 文件。** 人物数据库、世界观、情节状态，缺一不可。 +12. **人物内心独白不能违背角色设定。** 原文中从不多愁善感的角色，在续写里不能突然变成感时伤怀的诗人。 + +--- + +## 常见误区（已踩过的真实翻车记录） + +**① 把角色A的性格安到角色B身上** +→ 表现：A明明冷静寡言，续写里让他热血澎湃地喊口号；B明明冲动直率，续写里让他冷静分析局势。 +→ 解决：写每个角色出场时，先在人物数据库里核对一句话：这个角色在原文中是什么性格？他/她会这样说话吗？ + +**② 给敌人编造原文不存在的属性/称号** +→ 表现：原文敌人没有某些称号/能力，续写里硬加上去。 +→ 解决：所有敌人名称/称号/能力，必须是「原文中出现过的」。没出现过的就是编的，编的就不能写。 + +**③ 编造不存在的新法则** +→ 表现：原文从未出现的法则名称，续写里让角色喊一声就觉醒。 +→ 解决：法则名称、觉醒方式、效果全部以原文为准。原文没写过的法则，续写里不能出现。 + +**④ 过度心理描写，角色变"文青"** +→ 表现：原文杀伐果断的角色，续写里花三页纸描述内心挣扎。 +→ 解决：心理描写的篇幅和深度必须与原文一致。原文里角色从不纠结的事，续写里不能让她纠结。 + +**⑤ 把战友情写成浪漫感情** +→ 表现：原文是互相信赖的战友关系，续写里写成暧昧或恋爱。 +→ 解决：角色间的关系性质（战友/恋人/敌对/利用）严格遵循原文。原文没有暧昧暗示的，续写不能无中生有。 + +**⑥ 无视当前的剧情位置** +→ 表现：明明角色正在生死决战中，续写让她停下来做哲学思考。 +→ 解决：动笔前先在 plot_state.md 确认：这个角色现在在哪里？在做什么？当前有没有迫在眉睫的威胁？ + +--- + +## 核心原理 + +续写的本质是**风格复现 + 情节延续**。模型需要： +1. 从原文提取风格特征（不是总结剧情） +2. 在后续写作中严格遵循这些特征 +3. 主动追踪人物状态和剧情走向，避免前后矛盾 + +--- + +## 工作流程 + +### Step 0：读取参考文件 + +每次动笔前，**必须先读**以下五个文件（一个不能少）： + +📍 `references/characters.md` — 人物关系网 +📍 `references/world_building.md` — 世界观与战力体系 +📍 `references/timeline.md` — 时间锚点 +📍 `references/style.md` — 风格分析 +📍 `references/plot_state.md` — 情节状态 + +--- + +### Step 0.5：文件不存在时的处理（批次阅读法 — 正确使用子代理） + +**🔴 铁律：禁止子代理平行阅读。** 多个子代理同时读不同章节会导致关系网错乱。 +**✅ 正确方式：子代理依次序读。** 每批一个子代理，读完就丢，下批拉起新子代理。 +**🔴 铁律：禁止根据章节标题推断剧情。** 必须读原文正文。 +**🔴 铁律：禁止引用自生成的续写内容作为参考来源。唯一合法来源是原文。** + +如果上述文件不存在，按以下方式建立： + +``` +回合1：子代理A → 读第1~50章 → 更新 characters/world_building/timeline → 丢弃 +回合2：子代理B → 先读现有参考文件 → 读第51~100章 → 在前人基础更新 → 丢弃 +回合3：子代理C → 先读现有参考文件 → 读第101~150章 → 更新 → 丢弃 +…… +``` + +**关键规则：** +- 🔴 **子代理必须读正文，不能只读标题。** 告知子代理`novel_source.txt`在工作区，让它直接 `read()` 正文 +- 🔴 每个新子代理**必须先读现有的参考文件**，再读新章节 +- ✅ 每批必须按章节顺序，不得跳过 +- ✅ 每批读完当场更新到磁盘 +- ✅ **主agent必须抽查验收**：每个子代理完成后，随机挑2~3个事件与原文比对。发现错误 → 拉起新子代理，给更小批次（10~15章），重新读、重新生成。不修正。 + +### Step 1：批次阅读 & 更新参考文件 + +**🔴 禁止子代理平行阅读。** 阅读必须在当前会话中按顺序完成。 +**🔴 禁止根据标题推断剧情。** 必须读原文正文。 +**🔴 禁止引用自生成的续写内容作为参考来源。唯一来源是原文。** + +通读原文最新章节（至少最近50章），**不是为了记住故事，而是为了更新参考文件**。推荐每30~50章一批，读一批就更新一批。 + +#### 1a. 更新 characters.md +每次通读后，核对并更新角色数据库： +- 新增角色加入数据库 +- 现有角色的性格/关系有变化的，更新 +- **特别注意**：角色姓名 100% 正确。每个出场角色的名字核对一遍，确认没写错人。 + +#### 1b. 更新 world_building.md +- 更新已出现的法则名称、效果 +- 更新当前战场、势力分布 +- **删除你自己上次写时添加的任何自行编纂的内容** + +#### 1c. 分析/更新 style.md +分析以下维度，每项用 1-2 句话描述： + +**语言层面** +- 句式偏好 +- 用词风格 +- 修辞习惯 + +**叙事层面** +- 视角 +- 节奏 +- 氛围 + +**对话层面** +- 角色说话方式 +- 对话占比 +- 潜台词风格 + +#### 1d. 更新 plot_state.md + +格式： + +``` +# 情节状态 + +## 当前章节位置 +- 上一章是：第X章 [标题] +- 当前场景：地点/战场 +- 当前时间线：与主线的关系 + +## 角色状态（活跃角色） +| 角色名 | 当前位置 | 当前状态 | 目标/任务 | +|--------|---------|---------|-----------| + +## 各角色关系当前状态 +- A 知道 B 的秘密吗？ +- C 和 D 目前是敌对还是联手？ + +## 已在场物品/地点 +- [地点]：描述 +- [重要道具]：[用途] + +## 已埋伏笔（原文已有的） +- [伏笔1]：[原文埋设的位置] + +## 待解决冲突 +- [冲突1] +- [冲突2] +``` + +### Step 2：续写前的强制自检 + +**动笔之前，逐项自检以下问题。一项一项说清楚。不过不要输出给用户，自己心里有数就行。** + +#### 角色一致性检查 +- [ ] 这一章出场的每个角色，名字是否正确？（而不是写成了另一个人的名字） +- [ ] 这个角色的性格/说话方式，是否与原文该角色的性格 100% 一致？ +- [ ] 这个角色的当前心境，是否与原文中他/她当前处境的合理反应一致？ +- [ ] 这个角色和其他角色的关系性质（是战友/恋人/敌人/利用），是否与原文一致？ +- [ ] 有没有给角色添加原文中不存在的背景/特质/能力？ + +#### 世界观一致性检查 +- [ ] 本章中出现的所有法则/技能/境界名称，是否在原文中出现过？ +- [ ] 有没有把不相关的体系混进来？ +- [ ] 敌人名称和设定是否来自原文？ +- [ ] 战力升级是否有足够铺垫，不突兀？ + +#### 情节连续性检查 +- [ ] 本章从上一章结尾的位置开始吗？ +- [ ] 是否接住了上一章留下的悬念/冲突？ +- [ ] 新引入的情节/事件，是否与原文已有的设定不冲突？ + +### Step 3：续写 + +严格遵循参考文件和自检结果。写作过程中，**每写一个角色出场，暂停一次，在脑子里过一遍**：这个角色的名字、性格、关系、当前状态——全部和 characters.md 核对过。 + +**写作规范：** +- 章节长度：2000-4000 字（与原文相当） +- 每章至少一个情节点推进 +- 避免在第一章就引入太多新角色 +- 保持既有角色的说话方式一致 +- 合理埋设新伏笔，留住读者 + +**角色出场自问（每一段对话/动作前）：** +1. 这个角色叫什么名字？（确认不是叫另一个角色的名字） +2. 这个角色目前在哪里？在做什么？ +3. 这个角色的性格核心特质是什么？ +4. 以他/她的性格，此情此景下会说什么、做什么？ +5. 这段对话/动作与原文角色关系网矛盾吗？ + +**输出格式：** +续写内容直接输出为 Markdown，使用二级标题 `## 续写内容` 包裹，后接正文。不需要额外说明"以下是续写"。 + +### Step 4：写完后二次检查 + +写完一整章后，再把 Step 2 的自检逐项过一遍。发现不一致的地方立刻修改。 + +### Step 5：更新 plot_state.md + +续写完成后，询问用户是否满意： +- 满意 → 自动更新 `references/plot_state.md`（添加新章节的情节状态） +- 不满意 → 询问需要修改的具体方向，针对性重写 + +--- + +## 资源说明 + +### scripts/ +本 skill 不需要脚本。风格分析和续写完全由模型本身完成。 + +### references/ +- `characters.md` — 人物关系网（角色名/性格/关系/说话方式） +- `world_building.md` — 世界观与战力体系（法则/势力/背景） +- `timeline.md` — 时间锚点（关键事件时间线） +- `style.md` — 从原文分析得出的风格特征 +- `plot_state.md` — 当前情节状态追踪文件 + +--- + +**核心原则：不编造，只延续。一切从原文来，一切回原文去。** diff --git a/skill/novel-continuation-ai/references/characters.md b/skill/novel-continuation-ai/references/characters.md new file mode 100644 index 0000000..c66462b --- /dev/null +++ b/skill/novel-continuation-ai/references/characters.md @@ -0,0 +1,34 @@ +# 人物关系网 + +> **使用说明**：每个角色一段，记录姓名、别名、性格核心特质、关系、说话风格、当前状态。 +> 续写前必须通读最近章节确认角色当前状态是否有变化。 + +## 主角（信息从原文提取） + +### [角色名] +- **别名**： +- **身份**： +- **性格核心特质**： +- **角色关系**： + - [相关角色A]：[关系描述] + - [相关角色B]：[关系描述] +- **说话风格/专属口头禅**： +- **战力/能力**： +- **当前状态**： + +## 重要配角 + +### [角色名] +- **别名**： +- **身份**： +- **性格核心特质**： +- **角色关系**： +- **说话风格**： +- **当前状态**： + +## 敌方/其他势力 + +### [角色名] +... + +*（按需扩展，一个角色只写一处）* diff --git a/skill/novel-continuation-ai/references/plot_state.md b/skill/novel-continuation-ai/references/plot_state.md new file mode 100644 index 0000000..789b03f --- /dev/null +++ b/skill/novel-continuation-ai/references/plot_state.md @@ -0,0 +1,29 @@ +# 情节状态 + +> 每次续写后更新，记录当前剧情位置。 + +## 当前章节位置 +- 上一章：第X章 [标题] +- 当前场景： +- 时间线： + +## 角色状态（活跃角色） +| 角色名 | 当前位置 | 当前状态 | 目标/任务 | +|--------|---------|---------|-----------| +| | | | | + +## 各角色关系当前状态 +- + +## 已在场物品/地点 +- + +## 已埋伏笔（原文已有的） +- + +## 待解决冲突 +- + +## ⚠️ 注意 +- **敌人设定**：以原文最新描述为准。续写前必须通读原文确认 +- **法则体系**：原文尚未明确展示的法则名称，续写中不能自创 diff --git a/skill/novel-continuation-ai/references/style.md b/skill/novel-continuation-ai/references/style.md new file mode 100644 index 0000000..0878c93 --- /dev/null +++ b/skill/novel-continuation-ai/references/style.md @@ -0,0 +1,23 @@ +# 风格分析（模板） + +> 每次续写前分析原文风格，填写以下维度。**不预设任何写作风格偏好。** + +## 语言层面 +- 句式偏好： +- 用词风格： +- 修辞习惯： + +## 叙事层面 +- 视角： +- 节奏： +- 氛围： + +## 对话层面 +- 角色说话方式： +- 对话占比： +- 潜台词风格： + +## 世界观与设定 +- 题材类型： +- 主角当前处境： +- 主要配角及关系：详见 `characters.md` diff --git a/skill/novel-continuation-ai/references/timeline.md b/skill/novel-continuation-ai/references/timeline.md new file mode 100644 index 0000000..0c555d6 --- /dev/null +++ b/skill/novel-continuation-ai/references/timeline.md @@ -0,0 +1,33 @@ +# 时间锚点（Timeline） + +> **使用说明**：记录小说的关键时间节点，确保续写时的情节推进不违反已有时间线。 +> **不预设任何写作风格或世界观偏向。所有内容以原文描述为准。** + +--- + +## 主线时间线 + +| 时间/章节 | 事件 | 备注 | +|-----------|------|------| +| | | | + +--- + +## ⚠️ 时间锚点规则 + +1. **本条时间线记录所有已发生的关键事件**。续写时新增的事件必须发生在最新章节之后 +2. **不能回溯改写已发生的事件。** 已标记为"已发生"的事件，在后续任何章节中不能被推翻或改变 +3. **不能跳过当前时间锚点去写更后面的情节。** 续写必须从最新锚点的位置开始，按顺序推进 +4. **更新规则：** + - 每次续写完成后，在表格中新增一行记录本续写章节的事件 + - 新添加的事件必须与已有时间线合理衔接 + - **任何与已有时间线矛盾的新事件都不能被添加** +5. **多线叙事处理：** 如果小说有并行时间线（如A和B在不同地点同时发生事件），需在备注中标注"与XX章并行" + +--- + +## 附录：角色时间锚点 + +| 角色 | 最新时间点 | 当时状态 | +|------|-----------|---------| +| | | | diff --git a/skill/novel-continuation-ai/references/world_building.md b/skill/novel-continuation-ai/references/world_building.md new file mode 100644 index 0000000..34e88d5 --- /dev/null +++ b/skill/novel-continuation-ai/references/world_building.md @@ -0,0 +1,46 @@ +# 世界观（World Building） + +> **使用说明**：从原文提取世界观设定。所有内容以原文描述为准。 +> **不预设任何写作风格或世界观偏向。** + +## 时代背景 + +（从原文中提取：时代名称、纪元、科技水平等） + +## 政治格局 + +### 我方阵营 +（势力名称、核心人物、领地/范围） + +### 敌方阵营 +（势力名称、核心人物、领地/范围） + +### 中立/其他 +（名称、立场） + +## 力量体系 + +### 修炼/战斗方式 +（从原文提取） + +### 等级划分 +（境界名称、顺序、突破方式——全部来自原文） + +### 已知法则/能力 +| 名称 | 持有者 | 效果（原文描述） | +|------|--------|-----------------| +| | | | + +## 关键地点 + +| 地点 | 特征 | 出现章节 | +|------|------|---------| +| | | | + +## 世界观铁律 + +1. **不要乱编新设定** — 所有世界观设定、规则、名称必须以原文为准 +2. **不要混用体系** — 小说本身的体系是什么就以什么为准，不要把不相关的体系设定混入 +3. **敌人名称和属性必须来自原文** — 原文中不存在的敌人称号、能力不能自创 +4. **所有设定变更必须有原文依据** — 不能凭空新增原文中不存在的法则、境界、势力 +5. **战力升级要有过程** — 不能一句话就让角色从当前等级跳到更高层级，升级需要铺垫