inkos-like-novel-os

Category: Tools & Productivity | Uploader: qiyan233 | Downloads: 0 | Version: v1.0（Latest）

Novel-production operating system for long-form fiction, web novels, serials, fanfiction, and side stories. Use when designing or running a structured writing pipeline with persistent world state, chapter summaries, hooks, character matrices, continuity audits, rewrite/revise loops, style guides, or per-book rules. Best for requests like building an InkOS-like skill, creating a long-novel workflow, keeping multi-chapter story consistency, generating/auditing/revising chapters, or maintaining story files across many chapters.

Changelog: Source: GitHub https://github.com/qiyan233/inkos-like-novel-os

Directory Structure

Current level: tree/main/

📁 .github/
- 📁 ISSUE_TEMPLATE/
  - 📄 bug_report.md 570 B
  - 📄 feature_request.md 681 B
- 📁 workflows/
  - 📄 ci.yml 858 B
- 📄 PULL_REQUEST_TEMPLATE.md 555 B
📁 assets/
- 📁 project-template/
  - 📄 book_rules.md 279 B
  - 📄 chapter_summaries.md 187 B
  - 📄 character_knowledge.md 189 B
  - 📄 character_matrix.md 19 B
  - 📄 continuity_issues.md 20 B
  - 📄 current_state.md 234 B
  - 📄 emotional_arcs.md 17 B
  - 📄 outline.md 203 B
  - 📄 pending_hooks.md 281 B
  - 📄 README-project.md 499 B
  - 📄 story_bible.md 197 B
  - 📄 style_guide.md 121 B
  - 📄 style_profile.json 190 B
  - 📄 subplot_board.md 16 B
📁 docs/
- 📄 cli.md 3.3 KB
- 📄 faq.md 1.7 KB
- 📄 getting-started.md 2.3 KB
- 📄 installation.md 1.4 KB
- 📄 project-template.md 2.3 KB
- 📄 user-paths.md 2.0 KB
📁 examples/
- 📁 demo-novel/
  - 📁 chapters/
    
    📄 ch01.md 3.1 KB
    
    📄 ch02.md 3.8 KB
  - 📄 book_rules.md 756 B
  - 📄 chapter_summaries.md 1.5 KB
  - 📄 character_knowledge.md 534 B
  - 📄 character_matrix.md 184 B
  - 📄 continuity_issues.md 135 B
  - 📄 current_state.md 968 B
  - 📄 emotional_arcs.md 156 B
  - 📄 outline.md 581 B
  - 📄 pending_hooks.md 445 B
  - 📄 README-project.md 415 B
  - 📄 README.md 3.5 KB
  - 📄 story_bible.md 772 B
  - 📄 style_guide.md 195 B
  - 📄 style_profile.json 102 B
  - 📄 subplot_board.md 186 B
📁 references/
- 📄 audit-dimensions.md 4.9 KB
- 📄 audit-rules.md 1.4 KB
- 📄 canon-side-story.md 1.2 KB
- 📄 file-schemas.md 2.9 KB
- 📄 json-schemas.md 3.4 KB
- 📄 revision-workflow.md 1.2 KB
- 📄 style-learning.md 1.0 KB
- 📄 worked-examples.md 5.1 KB
- 📄 workflow-playbooks.md 2.3 KB
📁 scripts/
- 📄 audit_chapter.py 14.9 KB
- 📄 build_next_chapter_context.py 3.5 KB
- 📄 build_revision_plan.py 7.1 KB
- 📄 build_write_next_packet.py 9.6 KB
- 📄 diff_story_state.py 4.3 KB
- 📄 extract_state.py 5.2 KB
- 📄 hook_report.py 4.1 KB
- 📄 init_novel_project.sh 1001 B
- 📄 inkos_cli.py 11.3 KB
- 📄 inkos_common.py 4.7 KB
- 📄 knowledge_check.py 5.7 KB
- 📄 package_skill.py 3.1 KB
- 📄 package_skill.sh 1.2 KB
- 📄 run_revision_cycle.py 5.0 KB
- 📄 smoke_test.py 10.0 KB
- 📄 smoke_test.sh 13.5 KB
- 📄 snapshot_story_state.py 3.7 KB
- 📄 suggest_spot_fixes.py 4.9 KB
- 📄 update_story_state.py 6.1 KB
📄 .gitignore 82 B
📄 AGENTS.md 167 B
📄 CHANGELOG.md 7.1 KB
📄 CODE_OF_CONDUCT.md 1.3 KB
📄 CONTRIBUTING.md 1.9 KB
📄 LICENSE 1.0 KB
📄 README.md 18.8 KB
📄 SECURITY.md 1.2 KB
📄 SKILL.md 14.5 KB
📄 VERSION 6 B

SKILL.md

---
name: inkos-like-novel-os
description: Novel-production operating system for long-form fiction, web novels, serials, fanfiction, and side stories. Use when designing or running a structured writing pipeline with persistent world state, chapter summaries, hooks, character matrices, continuity audits, rewrite/revise loops, style guides, or per-book rules. Best for requests like building an InkOS-like skill, creating a long-novel workflow, keeping multi-chapter story consistency, generating/auditing/revising chapters, or maintaining story files across many chapters.
---

# inkos-like-novel-os

Version: 0.5.0

Build and run long-form fiction as a stateful pipeline, not a one-shot prompt.

Treat this skill as a **novel OS skeleton**: it provides project structure, workflow, audit criteria, and helper scripts for an OpenClaw-based writing system that is conceptually close to InkOS.

## Core operating model / 核心运行模型

Use this loop:

1. **Load truth files**
2. **Plan the next chapter**
3. **Draft with constraints**
4. **Run knowledge-boundary checks when the chapter depends on hidden truths or limited POV**
5. **Audit for continuity / style / pacing / leaks**
6. **Revise with spot fixes first**
7. **Extract candidate state updates from the accepted draft**
8. **Update story state**
9. **Queue unresolved issues for human review**

Prefer stable files over fragile memory. If information matters in later chapters, write it into a truth file.

## Project layout / 项目结构

When starting a new project, copy the template from `assets/project-template/`.

Expected files:

- `story_bible.md` — world rules, premise, factions, locations, power system
- `book_rules.md` — per-book rules, prohibitions, protagonist locks, tone limits
- `outline.md` — macro arc, chapter targets, payoff plan
- `current_state.md` — authoritative latest world state
- `chapter_summaries.md` — per-chapter summaries and state deltas
- `pending_hooks.md` — open promises, foreshadowing, unresolved conflicts
- `character_matrix.md` — who met whom, trust/conflict, information boundaries
- `character_knowledge.md` — optional structured knowledge boundary tracker for major characters
- `emotional_arcs.md` — tracked emotional movement by key character
- `subplot_board.md` — A/B/C line progress and stagnation notes
- `continuity_issues.md` — known inconsistencies or manual review backlog
- `style_guide.md` — qualitative style guide
- `style_profile.json` — optional quantitative style stats
- `chapters/` — chapter markdown files
- `reviews/` — audit and revision reports

`current_state.md` is the most important operational file. Keep it compact, current, and explicit.

## Recommended CLI workflow / 推荐 CLI 工作流

默认优先使用统一入口：

```bash
python3 scripts/inkos_cli.py <command> ...
```

这样更适合日常使用、文档引用和后续自动化；底层脚本仍可直接调用，但建议视为 advanced / lower-level usage。

### Quick start / 快速开始

#### 1) Initialize a project / 初始化项目

推荐：

```bash
python3 scripts/inkos_cli.py init /path/to/project "Book Title"
```

Lower-level usage / 底层脚本方式：

```bash
bash scripts/init_novel_project.sh /path/to/project "Book Title"
```

This copies the template and creates the standard directory layout.
For cross-platform usage, prefer `python3 scripts/inkos_cli.py init ...`.

#### 2) Build next-chapter context / 构建下一章上下文

推荐：

```bash
python3 scripts/inkos_cli.py context \
  --project /path/to/project \
  --recent-chapters 3 \
  --json
```

Lower-level usage / 底层脚本方式：

```bash
python3 scripts/build_next_chapter_context.py \
  --project /path/to/project \
  --recent-chapters 3 \
  --json
```

#### 3) Build write-next packet / 构建下一章工作包

推荐：

```bash
python3 scripts/inkos_cli.py write-next \
  --project /path/to/project \
  --json
```

Lower-level usage / 底层脚本方式：

```bash
python3 scripts/build_write_next_packet.py \
  --project /path/to/project \
  --json
```

Use this when you want a more structured handoff than raw context: chapter goal, active hooks, constraints, state targets, and suggested scene beats.

## Workflow / 工作流

### 1) Before writing a chapter / 写章前准备

Read at least:

- `story_bible.md`
- `book_rules.md`
- `outline.md`
- `current_state.md`
- latest section of `chapter_summaries.md`
- `pending_hooks.md`
- `character_matrix.md`

If maintained, also read:

- `character_knowledge.md`

If the request is for a side story, prequel, sequel, or alternate timeline, also establish:

- parent canon constraints
- divergence point
- what characters do **not** know yet
- which original hooks must remain untouched

### 2) Planning rules / 规划规则

Before drafting, explicitly decide:

- chapter purpose
- POV
- conflict driver
- payoff or partial payoff
- hooks to advance, delay, or close
- state changes that must occur
- constraints that must not be violated

Write a short chapter plan into the response or a scratch file if useful.

### 3) Drafting rules / 起草规则

Draft from observed reality, not abstract explanation.

Prefer:

- concrete action
- sensory evidence
- state changes that can be tracked later
- character knowledge limited to what they have seen, inferred, or been told

Avoid:

- breaking protagonist personality lock
- introducing untracked items/powers/injuries
- resolving major hooks accidentally
- report-speak in narrative prose
- broad whole-crowd reactions unless earned
- full-chapter rewrites when only a few lines are broken

### 4) Knowledge-boundary pass / 信息边界检查

When the chapter depends on mystery, hidden truths, or strict POV, run:

推荐：

```bash
python3 scripts/inkos_cli.py knowledge-check \
  --project /path/to/project \
  --chapter-file /path/to/project/chapters/ch12.md \
  --json
```

Lower-level usage / 底层脚本方式：

```bash
python3 scripts/knowledge_check.py \
  --project /path/to/project \
  --chapter-file /path/to/project/chapters/ch12.md \
  --json
```

Use this to catch:

- characters knowing facts too early
- narration slipping into omniscient scope
- side-story / prequel spoiler contamination
- certainty that should still be suspicion

### 5) Audit pass / 审计检查

After drafting, audit against `references/audit-dimensions.md`.

Minimum audit set:

- continuity / timeline
- character consistency
- information boundary leaks
- world-rule violations
- unresolved logic gaps
- pacing / subplot movement
- repetitive diction / fatigue terms
- outline drift

Recommended command:

```bash
python3 scripts/inkos_cli.py audit \
  --project /path/to/project \
  --chapter-file /path/to/project/chapters/ch12.md \
  --json
```

Lower-level usage / 底层脚本方式：

```bash
python3 scripts/audit_chapter.py \
  --project /path/to/project \
  --chapter-file /path/to/project/chapters/ch12.md \
  --json
```

Write reports into `reviews/` when operating on files.

### 6) Revision policy / 修订策略

Prefer this order:

1. **spot-fix** — patch only bad sentences/paragraphs
2. **polish** — improve local expression without changing story events
3. **rewrite scene** — only if scene logic is broken
4. **rewrite chapter** — last resort

Do not silently change:

- names
- outcomes of key events
- resource counts / power levels
- relationship states
- what characters know

If any of the above changes, also update truth files.

### 7) State extraction and update / 状态提取与更新

After a chapter is accepted, first extract candidate updates:

推荐：

```bash
python3 scripts/inkos_cli.py extract-state \
  --project /path/to/project \
  --chapter-file /path/to/project/chapters/ch12.md \
  --json
```

Lower-level usage / 底层脚本方式：

```bash
python3 scripts/extract_state.py \
  --project /path/to/project \
  --chapter-file /path/to/project/chapters/ch12.md \
  --json
```

This produces candidate:

- summary
- state changes
- hook open / advance / close items
- relationship changes
- emotional changes

Then feed approved items into:

推荐：

```bash
python3 scripts/inkos_cli.py state-update \
  --project /path/to/project \
  --chapter 12 \
  --title "The Price of Silence" \
  --summary "..." \
  --state-change "Lin Jin now knows the token is fake" \
  --hook-open "Who replaced the token?" \
  --relationship "Lin Jin -> Xu An: trust decreased" \
  --emotion "Lin Jin: suspicion hardens into anger"
```

Lower-level usage / 底层脚本方式：

```bash
python3 scripts/update_story_state.py \
  --project /path/to/project \
  --chapter 12 \
  --title "The Price of Silence" \
  --summary "..." \
  --state-change "Lin Jin now knows the token is fake" \
  --hook-open "Who replaced the token?" \
  --relationship "Lin Jin -> Xu An: trust decreased" \
  --emotion "Lin Jin: suspicion hardens into anger"
```

This updates `chapter_summaries.md` and also syncs `current_state.md` with the latest accepted chapter position plus a compact accepted-update block.

### 8) Hook pressure review / 钩子压力复核

When many hooks are active, run:

推荐：

```bash
python3 scripts/inkos_cli.py hook-report \
  --project /path/to/project \
  --stale-after 5 \
  --json
```

Lower-level usage / 底层脚本方式：

```bash
python3 scripts/hook_report.py \
  --project /path/to/project \
  --stale-after 5 \
  --json
```

Use this to spot:

- stale hooks that have been open too long
- current hook counts by status
- backlog pressure before the next chapter

## Modes to support / 支持模式

### Full pipeline mode / 全流程模式

Use when the user says things like:

- write the next chapter
- continue the novel
- run the full story pipeline
- draft and audit this chapter

Sequence:

1. run `write-next`
2. plan from chapter function and scene beats
3. draft
4. run `revise` or, if needed, knowledge-check + audit separately
5. extract candidate state
6. update state

### Audit-only mode / 仅审计模式

Use when the user already has chapter text and wants:

- continuity check
- OOC check
- pacing review
- world-rule validation
- AI-ish writing detection

Read `references/audit-dimensions.md`, produce findings grouped by severity, then propose minimal edits.

### State-maintenance mode / 状态维护模式

Use when the user says:

- remember this chapter
- update the story bible
- update hooks / character relations / arcs
- summarize what changed

Focus on truth-file accuracy, not prose generation.

### Side-story / fanfic / sequel mode / 外传同人续作模式

Use when the project depends on another canon. Read `references/canon-side-story.md` and establish:

- parent canon facts
- allowed divergence
- forbidden spoilers
- hook isolation

## File discipline / 文件纪律

When working over many chapters:

- prefer additive updates over destructive rewrites
- never delete hook history without a reason
- mark hooks as `OPEN`, `PAID OFF`, `BROKEN`, `DEFERRED`, or `ADVANCED`
- mark uncertain facts as `UNCONFIRMED`
- separate **world facts** from **character beliefs**

Good pattern:

```md
## Facts
- The seal broke in chapter 17.

## Character beliefs
- Lin Jin believes Xu An caused it.
- Xu An does not know the true source.
```

## Bundled tools / 内置工具入口

推荐优先记住这一个入口：`scripts/inkos_cli.py`。

Common commands:

- `python3 scripts/inkos_cli.py init ...` — scaffold a new novel project
- `python3 scripts/inkos_cli.py context ...` — assemble next-chapter context
- `python3 scripts/inkos_cli.py write-next ...` — build a structured write-next packet
- `python3 scripts/inkos_cli.py audit ...` — run a chapter audit
- `python3 scripts/inkos_cli.py knowledge-check ...` — detect knowledge-boundary / POV leaks
- `python3 scripts/inkos_cli.py extract-state ...` — extract candidate state updates
- `python3 scripts/inkos_cli.py hook-report ...` — summarize hook lifecycle state
- `python3 scripts/inkos_cli.py state-update ...` — append structured story-state deltas and sync the latest accepted update into `current_state.md`
- `python3 scripts/inkos_cli.py revision-plan ...` — build revision plan from chapter or audit
- `python3 scripts/inkos_cli.py spot-fixes ...` — suggest low-risk local fixes
- `python3 scripts/inkos_cli.py revise ...` — run the revision workflow as one cycle
- `python3 scripts/inkos_cli.py snapshot ...` — create a state snapshot
- `python3 scripts/inkos_cli.py diff ...` — diff snapshots or current state
- `python3 scripts/inkos_cli.py smoke-test` — run smoke tests
- `python3 scripts/inkos_cli.py package` — create a clean `.skill` package

Advanced / lower-level usage:

- `scripts/init_novel_project.sh`
- `scripts/build_next_chapter_context.py`
- `scripts/build_write_next_packet.py`
- `scripts/audit_chapter.py`
- `scripts/knowledge_check.py`
- `scripts/extract_state.py`
- `scripts/hook_report.py`
- `scripts/update_story_state.py`
- `scripts/build_revision_plan.py`
- `scripts/suggest_spot_fixes.py`
- `scripts/run_revision_cycle.py`
- `scripts/snapshot_story_state.py`
- `scripts/diff_story_state.py`
- `scripts/smoke_test.py`
- `scripts/package_skill.py`
- `scripts/smoke_test.sh` (legacy shell entry)
- `scripts/package_skill.sh` (legacy shell entry)

## Use bundled references / 参考文档

Read these only when needed:

- `references/audit-dimensions.md` — audit taxonomy and severity model
- `references/file-schemas.md` — what each truth file should contain
- `references/workflow-playbooks.md` — step-by-step operating playbooks
- `references/worked-examples.md` — concrete end-to-end examples from project setup to chapter progression
- `references/json-schemas.md` — stable JSON output contracts for tooling and automation
- `references/audit-rules.md` — structured rule inventory for the chapter auditor
- `references/revision-workflow.md` — how audit, revision plans, spot fixes, and snapshots fit together
- `references/canon-side-story.md` — how to handle prequels / sequels / alternate lines
- `references/style-learning.md` — how to learn and apply style without overfitting

## Output expectations / 输出期望

When responding in chat, prefer concise operational structure:

- **Plan**
- **Draft / Findings / Proposed fixes**
- **State updates needed**
- **Open questions**

When producing audits, use severity:

- `critical` — breaks logic / continuity / core characterization
- `major` — noticeably weakens chapter or damages setup/payoff
- `minor` — style, clarity, repetition, local pacing
- `note` — optional enhancement

## Design goal / 设计目标

This skill is not a magic novel writer. It is a discipline layer that makes long-form AI writing more stable, inspectable, and maintainable.

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

inkos-like-novel-os

Directory Structure

SKILL.md

Report

Notice