Tomsawyerhu/Chinese-WebNovel-Skill

Chinese‑WebNovel‑Skill

是什么 – 一组提示和数据模块的集合，旨在帮助大型语言模型（LLM）代理创作中文网络小说。与单一的庞大提示不同，该仓库将写作流程组织为一个 路由器（SKILL.md）和一系列专门的子技能（例如，情节规划、开头、对话、一致性审查）。每个子技能都自带教程、运行时规则、正反例，以及在需要时的模板资产。

为何重要 – 中文网络小说平台对结构有非常具体的要求（前几百字内必须有钩子、章节结尾紧凑、角色声音一致等）。通过将问题分解为可复用的模块，并结合本地真实小说摘录语料库，该系统让 LLM 能：

诊断当前所处的写作阶段，
从语料库中提取相关示例材料，
应用仅针对该阶段的聚焦式提示，
执行最终的一致性检查。

这种模块化方法使提示保持简短、可维护，且不易出现单个提示试图涵盖故事所有方面的“提示膨胀”问题。

核心设计

层级	内容	目的
1. `SKILL.md`	全局原则、流程约束、路由表	根据用户请求决定调用哪个模块
2. `references/modules/`	每个高频写作问题一个文件夹（如 `opening`, `dialogue`），包含 `README.md`, `tutorial.md`, `runtime.md`, `good_examples.md`, `bad_examples.md`, `source_index.md`	封装该问题的知识、规则和示例
3. `data/` & `analysis/`	原始小说文章、结构化摘录的 CSV、模仿指数、统计数据	提供可搜索的本地语料库，供模型参考
4. `scripts/` & `templates/`	语料库搜索的 Python 脚本、若干大纲模板文件	实现检索步骤并提供现成的大纲资产

模块（当前已实现）

concept_planning – 将一句话的设定转化为类型、钩子、核心设定、故事引擎、篇幅预估和第一卷方向。
opening – 生成前 300–3000 个字符，吸引读者注意。
volume_outline – 将故事引擎扩展为三章“黄金弧线”、全卷大纲和章节级大纲。
plot_logic – 修复因果链、动机、触发点、决策和回报逻辑。
character_consistency – 确保角色的目标、情绪、关系、外貌特征和声音保持一致。
transition – 处理时间跳跃、场景转换、视角切换和章节间的衔接。
dialogue – 构建关系张力、角色声音、信息嵌入和有力的对话。
chapter_ending – 添加钩子、余韵张力和为下一章做铺垫。
anti_ai_voice – 去除通用的 AI 风格表达、模板化说明和统一的语调。
consistency_review – 最终检查阶段，检查情节、角色、过渡、对话和结尾的一致性，确保章节完成。

每个模块遵循相同的结构，便于添加新的问题专用模块，而不会使主提示膨胀。

工作原理（高层流程）

用户输入 – 一个简短的故事构思或具体的写作问题。
路由器（SKILL.md） 判断请求是高层规划任务还是局部问题。
模块激活 – 调用相应的子技能；其 tutorial.md 和 runtime.md 指导 LLM。
语料库查找 – 脚本 search_corpus_examples.py 从 data/articles/ 和 analysis/excerpts.csv 中检索 2–4 个正面示例和 1–2 个负面示例。
提示构建 – LLM 接收一个简洁的提示，包含：
- 路由决策，
- 模块的规则和示例，
- 检索到的语料片段。
生成 – 模型为指定部分生成计划、草稿或修改稿。
一致性审查 – 章节写完后，consistency_review 自动运行，捕捉任何遗留矛盾。

该仓库还包含一个 Mermaid 图，可视化三阶段流程（规划 → 执行 → 最终审查）以及路由器、模块与本地语料库之间的数据流。

快速上手

# 克隆仓库
git clone https://github.com/Tomsawyerhu/Chinese-WebNovel-Skill.git
cd Chinese-WebNovel-Skill

# 运行语料库搜索（示例：查找关于“危机”情境的开头钩子）
python3 scripts/search_corpus_examples.py \
    --type '开头钩子' \
    --tag '危机压身' \
    --limit 5

# 要使用完整技能，将你的故事设定作为系统提示（system prompt）传给 LLM，内容为 SKILL.md 的全部内容。
# 具体 API 调用取决于你使用的 LLM（如 OpenAI、Anthropic、Claude 等）。

若只需修复单一问题，可直接调用对应模块（如 dialogue），并按以下顺序操作：

阅读模块的 README.md → tutorial.md → runtime.md。
让脚本检索相关示例。
使用整合后的信息向模型发起提示。

适合谁使用

中文网络小说作者：希望获得尊重 genre 规范、避免通用 AI 文风的 AI 辅助。
提示工程师：构建面向中文小说的 LLM 驱动写作助手。
研究人员：对模块化提示设计、检索增强生成、领域特定 AI 写作流水线感兴趣者。

维护理念

保持全局路由器尽可能简洁；新增问题以独立模块形式添加。
每个模块必须包含 教程 + 运行时规则 + 正反例。
在提示模型前，始终先检索具体的语料材料。
每章完成后必须运行 consistency_review。

核心要点 – Chinese‑WebNovel‑Skill 是一个结构化、检索增强的提示框架，使 LLM 能作为有纪律的合作者参与中文网络小说创作，将写作过程分解为清晰、可维护的模块，同时以真实小说示例为输出基础。