fanfic-writer自动化小说写作助手 v2.1 - 基于证据的状态管理、多视角QC、原子I/O、每个阶段人工确认
Install via ClawdBot CLI:
clawdbot install tanson515/fanfic-writer版本 Version: 2.1.0
架构 Architecture: 基于证据的状态管理 with atomic I/O
安全机制 Safety: Auto-Rescue, Auto-Abort Guardrail, FORCED 连击熔断
核心特性: 每个阶段人工确认
Fanfic Writer v2.1 是一套生产级的小说写作流水线，每个阶段都需要人工确认：
/ Fanfic Writer v2.1 is a production-grade novel writing pipeline with human confirmation at each phase:
根据设计文档，每个阶段都需要人工确认：
| 阶段 Phase | 需要确认的内容 | 状态 Status |
|-----------|---------------|-------------|
| Phase 1 | 书名、类型、字数、存放目录 | 必需 |
| Phase 2 | 风格指南 | 必需 |
| Phase 3 | 主线大纲 | 必需 |
| Phase 4 | 章节规划 | 必需 |
| Phase 5 | 世界观设定 | 必需 |
| Phase 6 | 每章正文后确认进入下一章 | 必需 |
| Phase 7 | Backpatch 确认 | 必需 |
| Phase 8-9 | 最终合并确认 | 必需 |
帮我写一本都市灵异小说AI 会引导你完成每个阶段的确认。
# 初始化新书 (每个阶段会确认)
python -m scripts.v2.cli init
# 写作 (每章会确认)
python -m scripts.v2.cli write --run-dir <path>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 | 名称 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点质量检查 | ✅ 确认 |
[生成大纲] → 用户确认 → [生成正文] → QC评分 → 用户确认 → [下一章]| 分数 Score | 状态 Status | 动作 Action |
|-----------|------------|------------|
| ≥85 | PASS | 保存，继续 |
| 75-84 | WARNING | 保存（带警告），继续 |
| <75 | REVISE | 重试 |
| 第三次<75 | FORCED | 保存，进Backpatch |
{
"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
}
}重要: 这个 skill 不硬编码任何模型。当 OpenClaw 调用此 skill 时，自动使用 OpenClaw 当前配置的模型。
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 自动传入，包含当前模型
)OpenClaw 会自动传入 oc_context 参数，包含：
model_call - 调用当前模型的方法model_name - 当前模型名称（可选）generate - 备选方法（可选）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新增)MIT License
Generated Mar 1, 2026
Authors can use this skill to streamline the drafting and revision process for novels, ensuring consistency in plot, characters, and world-building through structured phases. It helps manage complex narratives by requiring human confirmation at each step, reducing errors and maintaining creative control.
Agencies producing web novels or serialized content can deploy this skill to maintain quality and coherence across multiple writers or chapters. The multi-perspective QC and evidence chain tracking ensure standardized output, while human confirmations allow for client approvals at key milestones.
Instructors can integrate this skill into creative writing courses to teach students structured storytelling techniques. The phased approach with mandatory confirmations encourages iterative learning and feedback, helping students understand narrative development from outline to final draft.
Teams developing storylines for video games can utilize this skill to organize world-building, character arcs, and plot threads systematically. The state panels for characters, timelines, and locations align with game design needs, with confirmations ensuring alignment across team members.
Platforms offering tools for indie authors can embed this skill to provide guided novel creation, enhancing user engagement and output quality. The atomic I/O and safety mechanisms reduce data loss risks, while confirmations give users a sense of progress and control.
Offer the skill as a cloud service with tiered subscriptions based on usage limits, such as number of novels or words generated. Revenue comes from monthly fees, with premium tiers including advanced features like custom templates or priority support.
License the skill to large publishers, media companies, or educational institutions for internal use, with custom integrations and dedicated support. Revenue is generated through one-time or annual licensing fees, scaled by user count or project volume.
Provide a free basic version with limited phases or confirmations, and monetize through in-app purchases for additional features like extended QC, faster processing, or export options. Revenue streams include microtransactions and ad placements in the free tier.
💬 Integration Tip
Ensure the integration handles the mandatory human confirmations at each phase to maintain workflow integrity, and leverage the atomic I/O for reliable data persistence in production environments.
Write persuasive copy for landing pages, emails, ads, sales pages, and marketing materials. Use when you need to write headlines, CTAs, product descriptions, ad copy, email sequences, or any text meant to drive action. Covers copywriting formulas (AIDA, PAS, FAB), headline writing, emotional triggers, objection handling in copy, and A/B testing. Trigger on "write copy", "copywriting", "landing page copy", "headline", "write a sales page", "ad copy", "email copy", "persuasive writing", "how to write [marketing text]".
Write compelling UX copy, marketing content, and product messaging. Use when writing button labels, error messages, landing pages, emails, CTAs, empty states, tooltips, or any user-facing text.
Use when you have a spec or requirements for a multi-step task, before touching code
You are a Writing Team Lead managing specialized writers via MCP tools. Please ANALYZE the writing task and then:1. if exist references, create a detailed co...
Creates high-quality, SEO-optimized content that ranks in search engines. Applies on-page SEO best practices, keyword optimization, and content structure for...
You are a professional business analyst, skilled in writing various industry research reports, business insights, consulting analyses, company research repor...