tanson515

Fanfic Writer

內容創作v2.1.0
作者:tanson515更新於 2026-05-17共 4 個版本 · 最新版本釋出於 2026-02-15fanfic-writer@clawhub_tanson515/fanfic-writer
文章寫作#小说写作

據 AlphaMoat 統計,截至 2026-10,Fanfic Writer 累計下載 8,729 次、獲 5 個星標,按累計下載量在本次參與排名的 10,914 個 AI 技能中排名第 3,184 位,在「內容創作」分類(927 個)中排名第 316 位。

列表預設按累計下載量排序,也可按星標排序;詳情頁排名按累計下載量計算。

累計下載
8729
星標
5
全站下載量排名
#3,184
全站前 30% · 「內容創作」前 35%
平台累計下載星標評論
ClawHub ↗25222-
SkillHub ↗87295—

各平台的計數口徑不同,統計時間不一致。

這個技能是做什麼的

它把寫作拆成多階段流水線,從初始化一路走到最終質檢,每個階段都要人工確認後才繼續。角色、劇情線、時間線、道具、地點、視角規則與會話記憶分成獨立狀態面板,每次狀態變更都帶章節、片段與置信度的證據記錄。

資料釋出於 2026-10-27

可以用來做什麼

  • 把一部長篇的設定與章節狀態集中管起來
  • 在續寫前核對時間線與角色狀態是否衝突

什麼時候用

  • 長篇寫到中途、設定開始互相打架時
  • 需要每步確認、不接受全自動跑完時

示例提示詞

以下是根據技能文件生成的示例,不代表實際執行結果。

初始化這部長篇的角色與時間線,然後停在第一階段等我確認
查一下上一章之後哪些伏筆還沒回收

月度資料趨勢

累計下載8729
1391533292732026-03 · 累計下載 26222026-05 · 累計下載 35082026-06 · 累計下載 19352026-07 · 累計下載 41282026-08 · 累計下載 43262026-09 · 累計下載 50102026-10 · 累計下載 872926-0326-0926-10
星標5
2462026-03 · 星標 22026-05 · 星標 62026-06 · 星標 22026-07 · 星標 62026-08 · 星標 62026-09 · 星標 52026-10 · 星標 526-0326-0926-10

2026-09 起統計方法調整:同名技能按作者分別統計,並覆蓋全部技能。圖中虛線為調整前的月份,與之後的資料不直接比較,也不計算跨越調整的增長。

月份累計下載環比星標
2026-108729—5
2026-095010—5
2026-084326+4.8%6
2026-074128+113.3%6
2026-061935-44.8%2
2026-053508—6
2026-032622—2

SKILL.md 原文

以下是作者釋出的原始檔案,按純文字顯示,本站未做修改或稽核;其中的連結不可點選,命令請核實後再執行。抓取於 2026-10-23。

6.8 KB · ClawHub v2.1.0
---
name: fanfic-writer
version: 2.1.0
description: 自动化小说写作助手 v2.1 - 基于证据的状态管理、多视角QC、原子I/O、每个阶段人工确认
homepage: https://github.com/openclaw/clawd
metadata:
  openclaw:
    emoji: "📖"
    category: "creative"
---
展開全部(共 241 行)
# Fanfic Writer v2.1 - 自动化小说写作系统 / Automated Novel Writing System

**版本 Version**: 2.1.0  
**架构 Architecture**: 基于证据的状态管理 with atomic I/O  
**安全机制 Safety**: Auto-Rescue, Auto-Abort Guardrail, FORCED 连击熔断  
**核心特性**: 每个阶段人工确认

---

## 系统概览 / System Overview

Fanfic Writer v2.1 是一套生产级的小说写作流水线,每个阶段都需要人工确认:

/ Fanfic Writer v2.1 is a production-grade novel writing pipeline with human confirmation at each phase:

- **9 阶段流水线 / 9 Phase Pipeline**: 从初始化到最终QC
- **7 状态面板 / 7 State Panels**: 角色、剧情线、时间线、道具、地点、POV规则、会话记忆
- **证据链 / Evidence Chain**: 所有状态变更带有 (章节, 片段, 置信度) 追踪
- **原子I/O / Atomic I/O**: temp → fsync → rename 模式 + 快照回滚
- **多视角QC / Multi-Perspective QC**: 3-评审协议 + 100分制评分
- **安全机制 / Safety Mechanisms**: Auto-Rescue, Auto-Abort
- **人工确认 / Human Confirmation**: 每个阶段必须确认才能继续

---

## 人工确认流程 / Human Confirmation Flow

根据设计文档,每个阶段都需要人工确认:

| 阶段 Phase | 需要确认的内容 | 状态 Status |
|-----------|---------------|-------------|
| Phase 1 | 书名、类型、字数、存放目录 | 必需 |
| Phase 2 | 风格指南 | 必需 |
| Phase 3 | 主线大纲 | 必需 |
| Phase 4 | 章节规划 | 必需 |
| Phase 5 | 世界观设定 | 必需 |
| Phase 6 | 每章正文后确认进入下一章 | 必需 |
| Phase 7 | Backpatch 确认 | 必需 |
| Phase 8-9 | 最终合并确认 | 必需 |

---

## 快速开始 / Quick Start

### 通过 OpenClaw 调用

```
帮我写一本都市灵异小说
```

AI 会引导你完成每个阶段的确认。

### 通过 CLI

```bash
# 初始化新书 (每个阶段会确认)
python -m scripts.v2.cli init

# 写作 (每章会确认)
python -m scripts.v2.cli write --run-dir <path>
```

---

## 架构 / Architecture

### 目录结构 / Directory Structure

```
novels/
└── {book_title_slug}__{book_uid}/
    └── runs/
        └── {run_id}/
            ├── 0-config/              # 配置层
            ├── 1-outline/             # 大纲层
            ├── 2-planning/           # 规划层
            ├── 3-world/              # 世界观层
            ├── 4-state/              # 运行时状态 (7面板)
            ├── drafts/                # 草稿层
            ├── chapters/              # 最终章节
            ├── anchors/               # 锚点
            ├── logs/                  # 日志
            ├── archive/              # 归档
            └── final/                 # 最终输出
```

---

## 阶段参考 / Phase Reference

| 阶段 Phase | 名称 Name | 描述 Description | 需要确认 |
|-----------|-----------|-----------------|---------|
| 1 | Initialization | 创建工作空间、配置 | ✅ 书名/类型/字数/目录 |
| 2 | Style Guide | 定义叙事风格 | ✅ 风格指南 |
| 3 | Main Outline | 生成书籍级情节结构 | ✅ 主线大纲 |
| 4 | Chapter Planning | 详细章节列表与钩子 | ✅ 章节规划 |
| 5 | World Building | 角色、阵营、规则、道具 | ✅ 世界观 |
| 5.5 | Alignment Check | 验证世界观匹配意图清单 | 自动 |
| 6 | Writing Loop | 清洗→草稿→QC→提交 | ✅ 每章确认 |
| 7 | Backpatch Pass | FORCED章节回补修复 | ✅ 确认 |
| 8 | Merge Book | 合并章节为最终版本 | ✅ 确认 |
| 9 | Whole-Book QC | 最终7点质量检查 | ✅ 确认 |

---

## 阶段6: 写作循环 (核心) / Phase 6: Writing Loop (Core)

### 确认流程 / Confirmation Flow

```
[生成大纲] → 用户确认 → [生成正文] → QC评分 → 用户确认 → [下一章]
```

### QC 评分标准

| 分数 Score | 状态 Status | 动作 Action |
|-----------|------------|------------|
| ≥85 | PASS | 保存,继续 |
| 75-84 | WARNING | 保存(带警告),继续 |
| <75 | REVISE | 重试 |
| 第三次<75 | FORCED | 保存,进Backpatch |

---

## 配置 / Configuration

### 0-book-config.json

```json
{
  "version": "2.1.0",
  "book": {
    "title": "书名",
    "title_slug": "book_slug",
    "book_uid": "8char_hash",
    "genre": "都市灵异",
    "target_word_count": 100000,
    "chapter_target_words": 2500
  },
  "generation": {
    "model": "moonshot/kimi-k2.5",
    "mode": "manual",
    "max_attempts": 3,
    "auto_threshold": 85,
    "auto_rescue_enabled": true
  }
}
```

---

## OpenClaw 集成 / OpenClaw Integration

### 模型说明

**重要**: 这个 skill 不硬编码任何模型。当 OpenClaw 调用此 skill 时,自动使用 OpenClaw 当前配置的模型。

### 函数入口

```python
from scripts.v2.openclaw_entry import run_skill, get_required_confirmations

# 获取某阶段需要确认的内容
confirmations = get_required_confirmations("6_write")
# Returns: ["每章正文生成后确认", "每章评分确认"]

# 运行 skill - 模型由 OpenClaw 自动提供
result = run_skill(
    book_title="我的小说",
    genre="都市",
    target_words=100000,
    mode="manual"
    # oc_context 由 OpenClaw 自动传入,包含当前模型
)
```

### oc_context 参数

OpenClaw 会自动传入 `oc_context` 参数,包含:
- `model_call` - 调用当前模型的方法
- `model_name` - 当前模型名称(可选)
- `generate` - 备选方法(可选)

---

## 开发 / Development

### 模块结构 / Module Structure

```
scripts/v2/
├── __init__.py
├── utils.py              # ID生成、slug、路径
├── atomic_io.py          # 原子写入、快照
├── workspace.py          # 目录管理
├── config_manager.py     # 配置I/O
├── state_manager.py      # 7面板
├── prompt_registry.py    # 模板注册表
├── prompt_assembly.py   # 提示词构建
├── price_table.py       # 费率表管理
├── resume_manager.py    # 断点续传、锁管理
├── phase_runner.py      # 阶段1-5
├── writing_loop.py       # 阶段6
├── safety_mechanisms.py  # 阶段7-9
├── cli.py               # CLI入口
└── openclaw_entry.py    # OpenClaw入口 (v2.1新增)
```

---

## 版本历史 / Version History

### v2.1.0 (2026-02-16)
- ✅ 每个阶段人工确认机制
- ✅ OpenClaw 函数入口
- ✅ 接入真实模型 API
- ✅ 修复 Windows 兼容性
- ✅ 完善中文文档

### v2.0.0 (2026-02-11)
- 初始版本
- 9阶段流水线
- 7状态面板
- 多视角QC

---

## 许可证 / License

MIT License

「內容創作」分類下的熱門技能

李白.Skill內容創作

李白.Skill:潤色專家 檢測並消除中文文字中的AI生成痕跡,將生硬的機器輸出轉化為自然流暢的人類文筆。融合規則檢測、分層改寫(詞彙→句式→內容→邏輯→語氣)和六步質控流水線,確保最終文字透過人工審查。

↓ 125萬★ 121user_741dc82b
libai-skill內容創作

李白.Skill:潤色專家 檢測並消除中文文字中的AI生成痕跡,將生硬的機器輸出轉化為自然流暢的人類文筆。融合規則檢測、分層改寫和質控流水線,確保最終文字透過人工審查。

↓ 101.8萬★ 11user_814dbe54
文章去AI味工具內容創作

識別並去掉文字里的 AI 寫作痕跡,讓文字讀起來更像人寫。

↓ 95.1萬★ 767user_ab5ae6ee
影片號爆款短影片拆解(付費版:全能)【零一數科·出品】內容創作

【零一數科·出品】影片號爆款短影片拆解(全能版)(付費版)。影片號爆款短影片拆解(付費版:全能)。一鍵拆解爆款,把一條影片號影片拆成結構分段、爆款歸因、六維評分和可借鑑策略,照著學照著抄。支援影片號分享連結和本地影片,付費全能版遠端分析,1–5 分鐘出視覺化 HTML 報告。

↓ 91.9萬★ 116u_c19e970c
影片號掛車爆單短影片指令碼生成【零一數科·出品】內容創作

【零一數科·出品】影片號掛車爆單短影片指令碼生成(付費版)。一條連結二創指令碼,丟進爆款影片號連結即以此骨架改寫成你的掛車指令碼,或按方向/目的/商品原創多條口播指令碼(含分段表、口播全文、六維質檢評分)。

↓ 55.4萬★ 39u_c19e970c
Humanizer內容創作

把文字里 AI 寫作的典型痕跡挑出來並改寫得更自然,同時保留原意的寫作編輯技能。

↓ 50.9萬★ 1116B*T
中文公文寫作內容創作

用於中文公文、事務性材料和新聞稿件的起草、改寫、壓縮、潤色、審校、文種核對、去口語化、降 AI 味及 Word 格式處理,適用於機關、企事業單位、學校和新聞機構。涵蓋申請、請示、報告、通知、通告、意見、決定、決議、議案、公報、命令、函、覆函、批覆、說明、方案、紀要、公告、公示、通報、制度、規定、辦法、細則、操作規程、工作要點、總結、調研、講話、致辭、主持詞、述職、可研、審查材料、技術需求、新聞訊息、編者按、新聞評論,以及採購、整改、反饋和 AI 算力等場景。

↓ 41.3萬★ 84gongyu0918
影片號爆款文案生成(體驗版)【零一數科·出品】內容創作

【零一數科·出品】影片號爆款文案生成(體驗版)。免費免登入出指令碼,給創作目的、行業、受眾、選題就按爆款結構(Hook-中段-CTA、節奏標籤)產出口播指令碼,資訊不全也能按爆款潛質兜底。本地執行、無需 Key,零成本上手。

↓ 33.9萬★ 94u_c19e970c

資料月份:2026-10 · 下載/星標數聚合自公開技能註冊庫(ClawHub、SkillHub),按月更新。口徑說明見資料方法。