novelops-skill

NovelOps Skill

当前版本：1.1.0

一个面向 OpenClaw 的长篇小说工作流 skill。
它的重点不是“单次写一章”，而是把长篇 / 连载 / 网文 / 同人写作跑成一个长期可维护的流程。

灵感参考原项目 InkOS：https://github.com/Narcooo/inkos

本项目是受 InkOS 启发的 skill skeleton，不是原项目官方移植版。

中文 | English

---

这是什么

你可以把它理解成一个“小说 workflow skill”：

• 用 truth files 维护世界观和当前状态
• 用 write-next 准备下一章
• 用 draft 把工作包交给 Hermes 等 LLM 直接起草（默认本地 Ollama）
• 用 revise 做修订闭环，用 auto-revise 做 LLM 段落级自动修订
• 用 extract-state / state-update 维护长期状态

也就是说，它不是只负责“写”，而是负责把多章写作这件事组织起来。

---

适合谁

适合这些情况：

• 你想做一个类似 InkOS 的小说写作 skill
• 你想让 AI 连续写很多章时尽量别崩设定
• 你想长期维护章节摘要、角色状态、伏笔和当前局势
• 你希望写作之外还有审计、修订、状态更新、快照这些环节

如果你只是想临时生成一篇短文，这个仓库会偏重。
如果你想跑长期、多章、可回溯的小说流程，它就是为这个场景准备的。

---

现在这个版本多了什么

1.0.0 这个版本把项目正式整理为 NovelOps Skill。

这次比较关键的提升是：

• 项目名称、skill 标识和打包名统一为 novelops-skill
• 推荐 CLI 入口统一为 python scripts/novelops_cli.py ...
• init 默认保护非空目录，避免误覆盖已有小说项目
• JSON 输出契约切换到 novelops.* namespace

换句话说，它从 InkOS-inspired skeleton，进入更独立、可发布的 NovelOps Skill 阶段。

---

核心使用方式

如果只记一条主线，可以理解成：

init -> write-next -> draft -> revise -> extract-state -> state-update

这里不展开写很多指令细节，因为这个仓库本身是 skill。
真正给智能体看的使用方式，应该优先看：

• SKILL.md

如果你是人在看仓库、想快速理解这个 skill 怎么用，建议看：

• examples/demo-novel/README.md
• docs/cli.md

---

第一次看这个仓库，建议这样读

先看定位

• SKILL.md

这是这个仓库最核心的文件。
README 负责介绍项目，SKILL.md 才更接近“这个 skill 真正怎么工作”。

再看一个完整例子

• examples/demo-novel/

如果你想最快看懂 write-next / revise / state-update 是怎么串起来的，先看 demo，比先读很多实现细节更直观。

最后按需看文档

• docs/cli.md
• docs/getting-started.md
• docs/project-template.md

---

仓库里主要有什么

这里只说用途，不展开实现：

• SKILL.md：skill 主说明
• scripts/：入口和辅助脚本
• assets/project-template/：小说项目模板
• examples/：示例项目
• docs/：使用说明
• references/：规则、结构和契约参考

如果你是普通使用者，最常接触的通常是：

• SKILL.md
• examples/demo-novel/
• docs/cli.md

---

当前定位

这个仓库现在更像一个面向长篇小说的 workflow skill，而不是单纯的 prompt 集合。

它已经能覆盖的事情：

• 下一章准备
• LLM 写作执行器（draft，Hermes 优先，默认本地 Ollama，云端 Nous Portal 可切换）
• 修订闭环
• LLM 段落级自动修订（auto-revise，默认出 diff，--apply 前自动快照）
• 可配置规则引擎（novelops.config.json 定制审计词表/阈值/禁用规则）
• 状态提取
• truth files 更新
• 基础回归和打包

还没做到的事情也很明确：

• 更多完整示例项目
• 多模型对比与自动重试策略
• 更细粒度的风格学习自动化

---

更多内容

• CHANGELOG.md
• docs/cli.md
• docs/getting-started.md
• docs/project-template.md
• references/json-schemas.md
• references/workflow-playbooks.md

---

English

An OpenClaw-oriented long-form fiction workflow skill.

This project is not mainly about generating a single chapter.
It is about running multi-chapter fiction as a maintainable workflow.

Core idea:

init -> write-next -> draft -> revise -> extract-state -> state-update

If you are new here, start with:

1. SKILL.md
2. examples/demo-novel/README.md
3. docs/cli.md

For humans, this README is intentionally lightweight.
The real operating behavior of the skill lives in SKILL.md.