# novelops-skill

**Repository Path**: adamin1988/novelops-skill

## Basic Information

- **Project Name**: novelops-skill
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-19
- **Last Updated**: 2026-09-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# NovelOps Skill

[![CI](https://img.shields.io/github/actions/workflow/status/qiyan233/novelops-skill/ci.yml?branch=main&label=CI)](https://github.com/qiyan233/novelops-skill/actions/workflows/ci.yml) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE) [![Version](https://img.shields.io/badge/version-v1.1.0-blue)](CHANGELOG.md)

当前版本：**1.1.0**

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

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

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

中文 | [English](#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 阶段。

---

## 核心使用方式

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

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

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

- [`SKILL.md`](SKILL.md)

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

- [`examples/demo-novel/README.md`](examples/demo-novel/README.md)
- [`docs/cli.md`](docs/cli.md)

---

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

### 先看定位

- [`SKILL.md`](SKILL.md)

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

### 再看一个完整例子

- [`examples/demo-novel/`](examples/demo-novel/)

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

### 最后按需看文档

- [`docs/cli.md`](docs/cli.md)
- [`docs/getting-started.md`](docs/getting-started.md)
- [`docs/project-template.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](CHANGELOG.md)
- [docs/cli.md](docs/cli.md)
- [docs/getting-started.md](docs/getting-started.md)
- [docs/project-template.md](docs/project-template.md)
- [references/json-schemas.md](references/json-schemas.md)
- [references/workflow-playbooks.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:

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

If you are new here, start with:

1. [SKILL.md](SKILL.md)
2. [examples/demo-novel/README.md](examples/demo-novel/README.md)
3. [docs/cli.md](docs/cli.md)

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