InkOS Multi-Agent Novel Writing Skill by ara.so — Daily 2026 Skills collection InkOS is a multi-agent CLI system that autonomously writes, audits, and revises novels. Agents handle the full pipeline: Writer → Validator → Auditor → Reviser, with human review gates at configurable checkpoints. Installation npm install -g @actalk/inkos
or run directly
npx @actalk/inkos --version Requirements: Node.js ≥ 20.0.0 Quick Start
Create a new novel project
inkos book create --title "吞天魔帝" --genre xuanhuan
Write the next chapter
inkos write next 吞天魔帝
Audit a specific chapter
inkos audit 吞天魔帝 --chapter 3
Run the full daemon (continuous production)
inkos daemon start Project Structure After inkos book create , the project directory contains: story/ outline.md # Story outline (architect agent input) book_rules.md # Per-book custom rules and audit dimensions chapter_summaries.md # Auto-generated per-chapter summaries subplot_board.md # Subplot progress tracking (A/B/C lines) emotional_arcs.md # Per-character emotional arc tracking character_matrix.md # Character interaction matrix + info boundaries parent_canon.md # Spinoff only: imported canon constraints style_profile.json # Style fingerprint (if style import used) style_guide.md # LLM-generated qualitative style guide chapters/ ch001.md ch002.md ... Core Commands Book Management inkos book create --title "Title" --genre xuanhuan
genres: xuanhuan | xianxia | dushi | horror | general
inkos book list inkos book status 吞天魔帝 Writing Pipeline inkos write next 吞天魔帝
Write next chapter (auto-loads all context)
inkos write chapter 吞天魔帝 5
Write specific chapter
inkos audit 吞天魔帝 --chapter 3
Audit chapter (33 dimensions)
inkos revise 吞天魔帝 --chapter 3
Revise based on audit results
inkos revise 吞天魔帝 --chapter 3 --mode spot-fix
Point fix only (default)
inkos revise 吞天魔帝 --chapter 3 --mode rewrite
Full rewrite (use cautiously)
inkos revise 吞天魔帝 --chapter 3 --mode polish
Polish (no structural changes)
Genre System inkos genre list
List all built-in genres
inkos genre show xuanhuan
View full rules for a genre
inkos genre copy xuanhuan
Copy genre rules to project for customization
inkos genre create wuxia --name 武侠
Create new genre from scratch
Style Matching inkos style analyze reference.txt
Analyze style fingerprint
inkos style import reference.txt 吞天魔帝
Import style into book
inkos style import reference.txt 吞天魔帝 --name "某作者" Spinoff (Prequel/Sequel/IF-branch) inkos book create --title "烈焰前传" --genre xuanhuan inkos import canon 烈焰前传 --from 吞天魔帝
Import parent canon constraints
inkos write next 烈焰前传
Writer auto-reads canon constraints
AIGC Detection inkos detect 吞天魔帝 --chapter 3
Detect AIGC markers in chapter
inkos detect 吞天魔帝 --all
Detect all chapters
inkos detect --stats
View detection history statistics
Daemon (Continuous Production) inkos daemon start
Start scheduler (default: 15 min/cycle)
inkos daemon stop inkos daemon status Configuration Global Config ( ~/.inkos/config.json ) { "llm" : { "provider" : "openai" , "model" : "gpt-4o" , "apiKey" : "sk-..." , "temperature" : 0.8 } , "daemon" : { "intervalMinutes" : 15 , "dailyChapterLimit" : 10 , "parallelBooks" : 2 } , "webhook" : { "url" : "https://your-server.com/hooks/inkos" , "secret" : "your-hmac-secret" , "events" : [ "chapter-complete" , "audit-failed" , "pipeline-error" ] } , "aigcDetection" : { "provider" : "gptzero" , "apiKey" : "..." , "endpoint" : "https://api.gptzero.me/v2/predict/text" } } Per-Book Rules ( story/book_rules.md )
Book Rules: 吞天魔帝
禁忌 (Forbidden)
主角不得主动求饶
不得出现「命运」「天意」等宿命论表述
高疲劳词
震撼, 惊骇, 恐惧, 颤抖
additionalAuditDimensions
数值系统一致性: 战力数值不得前后矛盾
角色成长节奏: 主角突破间隔不少于3章
写手特别指令
战斗场面优先感官描写，禁止数值报告
Agent Architecture
InkOS runs five specialized agents in sequence:
ArchitectAgent → outline.md, book_rules.md
↓
WriterAgent → ch00N.md (reads: outline, summaries, arcs, matrix, style_guide, canon)
↓
ValidatorAgent → 11 deterministic rules, zero LLM cost
↓ (error found → trigger spot-fix immediately)
AuditorAgent → 33 LLM dimensions, temperature=0 for consistency
↓
ReviserAgent → spot-fix | rewrite | polish | anti-detect
Post-Write Validator Rules (Deterministic, No LLM)
Rule
Condition
Forbidden patterns
不是……而是……
constructs
Em-dash ban
——
character
Transition word density
仿佛/忽然/竟然≤1 per 3000 chars
High-fatigue words
Per-book list, ≤1 per chapter
Meta-narrative
Screenwriter-style narration
Report terminology
Analytical framework terms in prose
Author moralizing
显然/不言而喻 etc.
Collective reaction
「全场震惊」clichés
Consecutive 了
≥4 consecutive sentences with 了
Paragraph length
≥2 paragraphs over 300 chars
Book-specific bans
book_rules.md
forbidden list
Audit Dimensions (33 total, LLM-evaluated)
Key dimensions include:
Dims 1–23: Core narrative quality (plot, character, pacing, foreshadowing)
Dim 24–26: Subplot stagnation, arc flatness, rhythm monotony (all 5 genres)
Dim 27: Sensitive content
Dim 28–31: Spinoff-specific (canon conflicts, future info leakage, world rule consistency, foreshadowing isolation)
Dim 32: Reader expectation management
Dim 33: Outline deviation detection
Code Integration Examples
Programmatic Usage (TypeScript)
import
{
BookManager
}
from
'@actalk/inkos'
import
{
WriterAgent
}
from
'@actalk/inkos/agents'
import
{
ValidatorAgent
}
from
'@actalk/inkos/agents'
// Create and configure a book
const
manager
=
new
BookManager
(
)
const
book
=
await
manager
.
createBook
(
{
title
:
'吞天魔帝'
,
genre
:
'xuanhuan'
,
outlinePath
:
'./my-outline.md'
}
)
// Run the write pipeline for next chapter
const
writer
=
new
WriterAgent
(
{
temperature
:
0.8
}
)
const
chapter
=
await
writer
.
writeNext
(
book
)
// Run deterministic validation (no LLM cost)
const
validator
=
new
ValidatorAgent
(
)
const
validationResult
=
await
validator
.
validate
(
chapter
,
book
)
if
(
validationResult
.
hasErrors
)
{
// Auto spot-fix triggered
const
reviser
=
new
ReviserAgent
(
{
mode
:
'spot-fix'
}
)
const
fixed
=
await
reviser
.
revise
(
chapter
,
validationResult
.
errors
,
book
)
console
.
log
(
'Fixed violations:'
,
validationResult
.
errors
.
length
)
}
Webhook Handler (Express)
import
express
from
'express'
import
crypto
from
'crypto'
const
app
=
express
(
)
app
.
use
(
express
.
raw
(
{
type
:
'application/json'
}
)
)
app
.
post
(
'/hooks/inkos'
,
(
req
,
res
)
=>
{
const
sig
=
req
.
headers
[
'x-inkos-signature'
]
as
string
const
expected
=
crypto
.
createHmac
(
'sha256'
,
process
.
env
.
INKOS_WEBHOOK_SECRET
!
)
.
update
(
req
.
body
)
.
digest
(
'hex'
)
if
(
sig
!==
sha256=
${
expected
}
)
{
return
res
.
status
(
401
)
.
send
(
'Invalid signature'
)
}
const
event
=
JSON
.
parse
(
req
.
body
.
toString
(
)
)
switch
(
event
.
type
)
{
case
'chapter-complete'
:
console
.
log
(
Chapter
${
event
.
chapter
}
of "
${
event
.
book
}
" complete
)
// Trigger human review gate
notifyReviewer
(
event
)
break
case
'audit-failed'
:
console
.
log
(
Audit failed:
${
event
.
criticalCount
}
critical issues
)
break
case
'pipeline-error'
:
console
.
error
(
Pipeline error in "
${
event
.
book
}
":
,
event
.
error
)
break
}
res
.
status
(
200
)
.
json
(
{
received
:
true
}
)
}
)
Custom Genre Definition
// genres/wuxia.ts
import
type
{
GenreConfig
}
from
'@actalk/inkos/types'
export
const
wuxia
:
GenreConfig
=
{
id
:
'wuxia'
,
name
:
'武侠'
,
chapterTypes
:
[
'江湖相遇'
,
'武功切磋'
,
'恩怨纠葛'
,
'门派争斗'
,
'武林大会'
]
,
forbiddenPatterns
:
[
'内力值'
,
'战力'
,
'等级提升'
,
// No numerical power system
'系统'
,
'面板'
,
'属性点'
]
,
fatiguedWords
:
[
'震惊'
,
'无敌'
,
'碾压'
,
'秒杀'
]
,
languageRules
:
[
{
bad
:
'内力增加了100点'
,
good
:
'一股暖流沿经脉漫开，指尖的颤抖渐渐平息'
}
]
,
auditDimensions
:
[
'武功描写感官化'
,
'江湖规则内部一致性'
,
'恩怨情仇弧线完整性'
]
}
Style Import Pipeline
import
{
StyleAnalyzer
}
from
'@actalk/inkos/style'
const
analyzer
=
new
StyleAnalyzer
(
)
// Analyze reference text
const
profile
=
await
analyzer
.
analyze
(
'./reference-novel.txt'
)
console
.
log
(
profile
)
// {
// avgSentenceLength: 18.3,
// ttr: 0.42, // Type-Token Ratio
// rhetoricalDensity: 0.15,
// paragraphLengthDist: { p25: 45, p50: 89, p75: 156 },
// punctuationStyle: 'sparse'
// }
// Import into book (generates style_profile.json + style_guide.md)
await
analyzer
.
importToBook
(
'./reference-novel.txt'
,
'吞天魔帝'
,
{
authorName
:
'某作者'
}
)
Audit Revision Loop
The v0.4 hardened audit-revision loop prevents revision from introducing more AI markers:
AuditorAgent (temp=0)
↓ critical issues found
ReviserAgent spot-fix
↓
AI marker count comparison
↓ markers increased?
YES → discard revision, keep original
NO → accept revision
↓
Re-audit (temp=0)
Key settings for audit consistency:
Auditor always runs at
temperature: 0
— eliminates 0–6 critical variance on same chapter
Default revision mode is
spot-fix
(only modify problem sentences)
rewrite
mode is available but measured to introduce 6× more AI markers
polish
mode is boundary-locked: no paragraph add/delete, no name changes, no new plot
Spinoff Canon Constraints
When
parent_canon.md
is detected, 4 additional audit dimensions activate automatically:
parent_canon.md (auto-generated by inkos import canon)
正传世界规则
力量体系: 炼体→炼气→炼丹→炼神→炼虚
地理: 九州大陆，东海以东无人居住
阵营: 正道五宗 vs 魔道三门
关键事件时间线
第1章: 主角获得吞天诀
第45章: 正道五宗盟约成立 [分歧点]
角色快照 (分歧点时状态)
林天: 炼气期第三层，未知父母身世
剑宗宗主: 在世，尚未叛变
伏笔状态 (正传专属，番外禁止回收)
古剑残片: 未解
神秘老人身份: 未解 Troubleshooting Validator fires on every chapter Check book_rules.md fatigue word list — words listed there are enforced ≤1 per chapter. Remove infrequently used terms. Audit results wildly inconsistent between runs Confirm auditor temperature is locked to 0 in config. If using a proxy LLM API, ensure it respects temperature: 0 . Revision introduces more AI markers than original This is expected behavior — InkOS v0.4 automatically detects this and discards the revision. If it happens repeatedly, switch from rewrite to spot-fix mode explicitly. Spinoff audit incorrectly flags events Verify parent_canon.md has accurate divergence point timestamps. Events before the divergence point are canon-locked; events after are fair game for the spinoff. Daemon stops a book after repeated failures Check daemon status for the suspended book. After fixing the underlying issue (usually outline ambiguity or book_rules.md contradiction), run inkos daemon resume 书名 . Style guide not being applied by writer Run inkos style import again — if style_guide.md is missing or empty, the writer skips style injection silently. Check that the reference text is ≥5000 characters for reliable fingerprinting.