有状态的长篇网络小说AI写作系统，支持续写、审计、修订、结算章节等完整创作流程。通过真相文件管理世界观和角色交互矩阵，每章完成后验证字数和语义连续性，确保长篇连载一致性。支持玄幻、仙侠、都市、科幻等15种体裁。
【适用场景】
Ink 是一个有状态的长篇网络小说写作 AI Agent，适用于以下场景：
- 长篇连载写作：需要保持多章节剧情和角色状态一致性的网文创作 - 批量章节生产：需要连写、续写多章内容的网文作者 - 章节审计修订：需要对已有章节进行润色、扩写、压缩或改写 - 世界观管理：需要管理角色交互矩阵、资源账本、伏笔跟踪等真相文件 - 多体裁支持：玄幻、仙侠、都市、恐怖、悬疑、修真、科幻、浪漫、治愈、异世界等15种体裁
核心能力：状态化写作（真相文件）、章节验证（13维度语义连续性）、字数实测防作弊、多角色协同。
【操作步骤】
Step 1：定位书根
检查当前工作目录（cwd）是否为某本书的书根。判据：目录下同时存在 `chapters/` 和 `story/` 文件夹。
- 若是书根 → 进入步骤 c（识别书况） - 若不是书根 → 强制询问作者书根路径，得到路径后回到步骤 a
Step 2：识别书况
Read 书根下的 `PROGRESS.md`：
| 书况 | 分支 |
|---|---|
| PROGRESS.md 存在 | 继续健康体检 |
| 仅 `chapters/index.json` + `story/current_state.md` | 走「迁移老书」流程 |
| 两者均不存在 | 走「新建书」流程 |
Step 3：健康体检（每章必跑）
对最近一章跑 verify，检查13个环节是否全部通过：
```bash python3 <SKILL_DIR>/scripts/verify-chapter.py <书根> <书名> <章号> ```
- 全通过 → 进入下一步 - 有未通过项 → 立即向作者发出警告，在得到明确指令前禁止写下一章
Step 4：按意图加载 reference 模块
根据任务意图 Read 对应的 reference 模块：
| 用户意图 | 加载模块 |
|---|---|
| 写单章/续写 | `reference/write.md` |
| 连写批量章节 | `reference/batch-write.md` |
| 审计章节 | `reference/audit.md` |
| 修订章节 | `reference/revise.md` |
| 新建书/迁移 | `reference/init.md` |
| 结算章节 | `reference/settler.md` |
| 快照/回滚 | `reference/snapshot.md` |
| 伏笔治理 | `reference/hook-governance.md` |
Step 5：真相文件读写
每完成一个 skill 动作后必须更新书根的 `PROGRESS.md`。7个真相文件（角色交互矩阵、资源账本、人物矩阵、粒子账本、世界观、章节大纲、真相文件）按需读写，不得凭记忆写作。
Step 6：产出验证
写章/连写/重分析完成后，最后一条消息必须以 verify-chapter.py 的完整 stdout 开头，贴出13个环节的通过情况，否则视为章节未完成。
【代码模板】
核心触发词
``` ink / Ink / 写书 / 写小说 / 写第N章 / 续写 / 连写 / 连写N章 / 连续写作 / 审计章节 / 审计第N章 / 润色章节 / 修订 / 扩写 / 压缩 / 新建书 / 新建章节 / ink初始化 / ink init / ink迁移 / ink migrate / followup / 伏笔 / 资源账本 / 粒子账本 / 角色交互矩阵 / 人物矩阵 / 世界观 / 章节大纲 ```
激活自检流程
``` a. 定位书根 ──┬─ 不是书根 ─▶ b. 强制询问作者 ──▶ 回到 a └─ 是书根 ──▶ c. 识别书况 ──┬─ PROGRESS.md存在 ──▶ c.5健康体检─▶d ├─ 仅index.json+current_state ──▶ 迁移老书 └─ 俱无 ──▶ 新建书 ```
PROGRESS.md 更新时机
每个 skill 动作完成后（写章/审计/修订/结算）必须更新：
| 段标题 | 更新策略 |
|---|---|
| 🎯 当前状态 | 每次完全重写 |
| 📌 活跃followup | 每次从 story/audits/ 重算后重写 |
| 📚 真相文件索引 | 仅init或作者手动刷新时重写 |
| 📜 操作时间线 | 追加一行，超过20条时归档最老一行 |
验证清单（每次必查）
``` ✓ verify-chapter.py 全13环节通过 ✓ FIRST_DRAFT_WORD_COUNT 实测（非估算） ✓ 无元叙事泄漏正文（禁止输出plan/大纲/hook_id/账本数据到小说正文） ✓ 禁止破折号（正文严禁「——」，用逗号或句号断句） ✓ 禁止「不是……而是……」句式，改用直述句 ✓ 逐字稿字数在目标范围内 ```
【复盘要点】
1. 真相文件是核心：所有写作必须以真相文件为事实依据，不凭记忆；每动作后必更新 PROGRESS.md 2. 字数必须实测：verify-chapter.py 实测字数必须贴出，不得估算（已实测目测误差可达+55%） 3. 禁止双版本：reference 模块的 Step 2 清单是唯一读取清单，不在本 SKILL.md 里列精简版 4. 验证必贴律：写完章节后必须贴完整 verify stdout，否则章节不算完成 5. 禁止元叙事泄漏：大纲、待办清单、hook_id 等分析术语不得出现在小说正文中 6. 新建书必须列体裁：用户说「新建一本 XX」时，第一件事列出全部15种体裁确认，避免误匹配 7. 禁止破折号和「不是……而是……」：这是硬性禁令，违反即视为失败输出
来源：PapainTea/ink-skill (GitHub raw) https://github.com/PapainTea/ink-skill