{
  "schemaVersion": "1.0",
  "item": {
    "slug": "fanfic-writer",
    "name": "Fanfic Writer",
    "source": "tencent",
    "type": "skill",
    "category": "内容创作",
    "sourceUrl": "https://clawhub.ai/tanson515/fanfic-writer",
    "canonicalUrl": "https://clawhub.ai/tanson515/fanfic-writer",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/fanfic-writer",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=fanfic-writer",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "INSTALL_GUIDE.md",
      "prompts/v1/chapter_draft_continue.md",
      "prompts/v1/chapter_draft_first.md",
      "prompts/v1/chapter_outline.md",
      "prompts/v1/chapter_plan.md",
      "prompts/v1/main_outline.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/fanfic-writer"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/fanfic-writer",
    "agentPageUrl": "https://openagent3.xyz/skills/fanfic-writer/agent",
    "manifestUrl": "https://openagent3.xyz/skills/fanfic-writer/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/fanfic-writer/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Fanfic Writer v2.1 - 自动化小说写作系统 / Automated Novel Writing System",
        "body": "版本 Version: 2.1.0\n架构 Architecture: 基于证据的状态管理 with atomic I/O\n安全机制 Safety: Auto-Rescue, Auto-Abort Guardrail, FORCED 连击熔断\n核心特性: 每个阶段人工确认"
      },
      {
        "title": "系统概览 / System Overview",
        "body": "Fanfic Writer v2.1 是一套生产级的小说写作流水线，每个阶段都需要人工确认：\n\n/ Fanfic Writer v2.1 is a production-grade novel writing pipeline with human confirmation at each phase:\n\n9 阶段流水线 / 9 Phase Pipeline: 从初始化到最终QC\n7 状态面板 / 7 State Panels: 角色、剧情线、时间线、道具、地点、POV规则、会话记忆\n证据链 / Evidence Chain: 所有状态变更带有 (章节, 片段, 置信度) 追踪\n原子I/O / Atomic I/O: temp → fsync → rename 模式 + 快照回滚\n多视角QC / Multi-Perspective QC: 3-评审协议 + 100分制评分\n安全机制 / Safety Mechanisms: Auto-Rescue, Auto-Abort\n人工确认 / Human Confirmation: 每个阶段必须确认才能继续"
      },
      {
        "title": "人工确认流程 / Human Confirmation Flow",
        "body": "根据设计文档，每个阶段都需要人工确认：\n\n阶段 Phase需要确认的内容状态 StatusPhase 1书名、类型、字数、存放目录必需Phase 2风格指南必需Phase 3主线大纲必需Phase 4章节规划必需Phase 5世界观设定必需Phase 6每章正文后确认进入下一章必需Phase 7Backpatch 确认必需Phase 8-9最终合并确认必需"
      },
      {
        "title": "通过 OpenClaw 调用",
        "body": "帮我写一本都市灵异小说\n\nAI 会引导你完成每个阶段的确认。"
      },
      {
        "title": "通过 CLI",
        "body": "# 初始化新书 (每个阶段会确认)\npython -m scripts.v2.cli init\n\n# 写作 (每章会确认)\npython -m scripts.v2.cli write --run-dir <path>"
      },
      {
        "title": "目录结构 / Directory Structure",
        "body": "novels/\n└── {book_title_slug}__{book_uid}/\n    └── runs/\n        └── {run_id}/\n            ├── 0-config/              # 配置层\n            ├── 1-outline/             # 大纲层\n            ├── 2-planning/           # 规划层\n            ├── 3-world/              # 世界观层\n            ├── 4-state/              # 运行时状态 (7面板)\n            ├── drafts/                # 草稿层\n            ├── chapters/              # 最终章节\n            ├── anchors/               # 锚点\n            ├── logs/                  # 日志\n            ├── archive/              # 归档\n            └── final/                 # 最终输出"
      },
      {
        "title": "阶段参考 / Phase Reference",
        "body": "阶段 Phase名称 Name描述 Description需要确认1Initialization创建工作空间、配置✅ 书名/类型/字数/目录2Style Guide定义叙事风格✅ 风格指南3Main Outline生成书籍级情节结构✅ 主线大纲4Chapter Planning详细章节列表与钩子✅ 章节规划5World Building角色、阵营、规则、道具✅ 世界观5.5Alignment Check验证世界观匹配意图清单自动6Writing Loop清洗→草稿→QC→提交✅ 每章确认7Backpatch PassFORCED章节回补修复✅ 确认8Merge Book合并章节为最终版本✅ 确认9Whole-Book QC最终7点质量检查✅ 确认"
      },
      {
        "title": "确认流程 / Confirmation Flow",
        "body": "[生成大纲] → 用户确认 → [生成正文] → QC评分 → 用户确认 → [下一章]"
      },
      {
        "title": "QC 评分标准",
        "body": "分数 Score状态 Status动作 Action≥85PASS保存，继续75-84WARNING保存（带警告），继续<75REVISE重试第三次<75FORCED保存，进Backpatch"
      },
      {
        "title": "0-book-config.json",
        "body": "{\n  \"version\": \"2.1.0\",\n  \"book\": {\n    \"title\": \"书名\",\n    \"title_slug\": \"book_slug\",\n    \"book_uid\": \"8char_hash\",\n    \"genre\": \"都市灵异\",\n    \"target_word_count\": 100000,\n    \"chapter_target_words\": 2500\n  },\n  \"generation\": {\n    \"model\": \"moonshot/kimi-k2.5\",\n    \"mode\": \"manual\",\n    \"max_attempts\": 3,\n    \"auto_threshold\": 85,\n    \"auto_rescue_enabled\": true\n  }\n}"
      },
      {
        "title": "模型说明",
        "body": "重要: 这个 skill 不硬编码任何模型。当 OpenClaw 调用此 skill 时，自动使用 OpenClaw 当前配置的模型。"
      },
      {
        "title": "函数入口",
        "body": "from scripts.v2.openclaw_entry import run_skill, get_required_confirmations\n\n# 获取某阶段需要确认的内容\nconfirmations = get_required_confirmations(\"6_write\")\n# Returns: [\"每章正文生成后确认\", \"每章评分确认\"]\n\n# 运行 skill - 模型由 OpenClaw 自动提供\nresult = run_skill(\n    book_title=\"我的小说\",\n    genre=\"都市\",\n    target_words=100000,\n    mode=\"manual\"\n    # oc_context 由 OpenClaw 自动传入，包含当前模型\n)"
      },
      {
        "title": "oc_context 参数",
        "body": "OpenClaw 会自动传入 oc_context 参数，包含：\n\nmodel_call - 调用当前模型的方法\nmodel_name - 当前模型名称（可选）\ngenerate - 备选方法（可选）"
      },
      {
        "title": "模块结构 / Module Structure",
        "body": "scripts/v2/\n├── __init__.py\n├── utils.py              # ID生成、slug、路径\n├── atomic_io.py          # 原子写入、快照\n├── workspace.py          # 目录管理\n├── config_manager.py     # 配置I/O\n├── state_manager.py      # 7面板\n├── prompt_registry.py    # 模板注册表\n├── prompt_assembly.py   # 提示词构建\n├── price_table.py       # 费率表管理\n├── resume_manager.py    # 断点续传、锁管理\n├── phase_runner.py      # 阶段1-5\n├── writing_loop.py       # 阶段6\n├── safety_mechanisms.py  # 阶段7-9\n├── cli.py               # CLI入口\n└── openclaw_entry.py    # OpenClaw入口 (v2.1新增)"
      },
      {
        "title": "v2.1.0 (2026-02-16)",
        "body": "✅ 每个阶段人工确认机制\n✅ OpenClaw 函数入口\n✅ 接入真实模型 API\n✅ 修复 Windows 兼容性\n✅ 完善中文文档"
      },
      {
        "title": "v2.0.0 (2026-02-11)",
        "body": "初始版本\n9阶段流水线\n7状态面板\n多视角QC"
      },
      {
        "title": "许可证 / License",
        "body": "MIT License"
      }
    ],
    "body": "Fanfic Writer v2.1 - 自动化小说写作系统 / Automated Novel Writing System\n\n版本 Version: 2.1.0\n架构 Architecture: 基于证据的状态管理 with atomic I/O\n安全机制 Safety: Auto-Rescue, Auto-Abort Guardrail, FORCED 连击熔断\n核心特性: 每个阶段人工确认\n\n系统概览 / System Overview\n\nFanfic Writer v2.1 是一套生产级的小说写作流水线，每个阶段都需要人工确认：\n\n/ Fanfic Writer v2.1 is a production-grade novel writing pipeline with human confirmation at each phase:\n\n9 阶段流水线 / 9 Phase Pipeline: 从初始化到最终QC\n7 状态面板 / 7 State Panels: 角色、剧情线、时间线、道具、地点、POV规则、会话记忆\n证据链 / Evidence Chain: 所有状态变更带有 (章节, 片段, 置信度) 追踪\n原子I/O / Atomic I/O: temp → fsync → rename 模式 + 快照回滚\n多视角QC / Multi-Perspective QC: 3-评审协议 + 100分制评分\n安全机制 / Safety Mechanisms: Auto-Rescue, Auto-Abort\n人工确认 / Human Confirmation: 每个阶段必须确认才能继续\n人工确认流程 / Human Confirmation Flow\n\n根据设计文档，每个阶段都需要人工确认：\n\n阶段 Phase\t需要确认的内容\t状态 Status\nPhase 1\t书名、类型、字数、存放目录\t必需\nPhase 2\t风格指南\t必需\nPhase 3\t主线大纲\t必需\nPhase 4\t章节规划\t必需\nPhase 5\t世界观设定\t必需\nPhase 6\t每章正文后确认进入下一章\t必需\nPhase 7\tBackpatch 确认\t必需\nPhase 8-9\t最终合并确认\t必需\n快速开始 / Quick Start\n通过 OpenClaw 调用\n帮我写一本都市灵异小说\n\n\nAI 会引导你完成每个阶段的确认。\n\n通过 CLI\n# 初始化新书 (每个阶段会确认)\npython -m scripts.v2.cli init\n\n# 写作 (每章会确认)\npython -m scripts.v2.cli write --run-dir <path>\n\n架构 / Architecture\n目录结构 / Directory Structure\nnovels/\n└── {book_title_slug}__{book_uid}/\n    └── runs/\n        └── {run_id}/\n            ├── 0-config/              # 配置层\n            ├── 1-outline/             # 大纲层\n            ├── 2-planning/           # 规划层\n            ├── 3-world/              # 世界观层\n            ├── 4-state/              # 运行时状态 (7面板)\n            ├── drafts/                # 草稿层\n            ├── chapters/              # 最终章节\n            ├── anchors/               # 锚点\n            ├── logs/                  # 日志\n            ├── archive/              # 归档\n            └── final/                 # 最终输出\n\n阶段参考 / Phase Reference\n阶段 Phase\t名称 Name\t描述 Description\t需要确认\n1\tInitialization\t创建工作空间、配置\t✅ 书名/类型/字数/目录\n2\tStyle Guide\t定义叙事风格\t✅ 风格指南\n3\tMain Outline\t生成书籍级情节结构\t✅ 主线大纲\n4\tChapter Planning\t详细章节列表与钩子\t✅ 章节规划\n5\tWorld Building\t角色、阵营、规则、道具\t✅ 世界观\n5.5\tAlignment Check\t验证世界观匹配意图清单\t自动\n6\tWriting Loop\t清洗→草稿→QC→提交\t✅ 每章确认\n7\tBackpatch Pass\tFORCED章节回补修复\t✅ 确认\n8\tMerge Book\t合并章节为最终版本\t✅ 确认\n9\tWhole-Book QC\t最终7点质量检查\t✅ 确认\n阶段6: 写作循环 (核心) / Phase 6: Writing Loop (Core)\n确认流程 / Confirmation Flow\n[生成大纲] → 用户确认 → [生成正文] → QC评分 → 用户确认 → [下一章]\n\nQC 评分标准\n分数 Score\t状态 Status\t动作 Action\n≥85\tPASS\t保存，继续\n75-84\tWARNING\t保存（带警告），继续\n<75\tREVISE\t重试\n第三次<75\tFORCED\t保存，进Backpatch\n配置 / Configuration\n0-book-config.json\n{\n  \"version\": \"2.1.0\",\n  \"book\": {\n    \"title\": \"书名\",\n    \"title_slug\": \"book_slug\",\n    \"book_uid\": \"8char_hash\",\n    \"genre\": \"都市灵异\",\n    \"target_word_count\": 100000,\n    \"chapter_target_words\": 2500\n  },\n  \"generation\": {\n    \"model\": \"moonshot/kimi-k2.5\",\n    \"mode\": \"manual\",\n    \"max_attempts\": 3,\n    \"auto_threshold\": 85,\n    \"auto_rescue_enabled\": true\n  }\n}\n\nOpenClaw 集成 / OpenClaw Integration\n模型说明\n\n重要: 这个 skill 不硬编码任何模型。当 OpenClaw 调用此 skill 时，自动使用 OpenClaw 当前配置的模型。\n\n函数入口\nfrom scripts.v2.openclaw_entry import run_skill, get_required_confirmations\n\n# 获取某阶段需要确认的内容\nconfirmations = get_required_confirmations(\"6_write\")\n# Returns: [\"每章正文生成后确认\", \"每章评分确认\"]\n\n# 运行 skill - 模型由 OpenClaw 自动提供\nresult = run_skill(\n    book_title=\"我的小说\",\n    genre=\"都市\",\n    target_words=100000,\n    mode=\"manual\"\n    # oc_context 由 OpenClaw 自动传入，包含当前模型\n)\n\noc_context 参数\n\nOpenClaw 会自动传入 oc_context 参数，包含：\n\nmodel_call - 调用当前模型的方法\nmodel_name - 当前模型名称（可选）\ngenerate - 备选方法（可选）\n开发 / Development\n模块结构 / Module Structure\nscripts/v2/\n├── __init__.py\n├── utils.py              # ID生成、slug、路径\n├── atomic_io.py          # 原子写入、快照\n├── workspace.py          # 目录管理\n├── config_manager.py     # 配置I/O\n├── state_manager.py      # 7面板\n├── prompt_registry.py    # 模板注册表\n├── prompt_assembly.py   # 提示词构建\n├── price_table.py       # 费率表管理\n├── resume_manager.py    # 断点续传、锁管理\n├── phase_runner.py      # 阶段1-5\n├── writing_loop.py       # 阶段6\n├── safety_mechanisms.py  # 阶段7-9\n├── cli.py               # CLI入口\n└── openclaw_entry.py    # OpenClaw入口 (v2.1新增)\n\n版本历史 / Version History\nv2.1.0 (2026-02-16)\n✅ 每个阶段人工确认机制\n✅ OpenClaw 函数入口\n✅ 接入真实模型 API\n✅ 修复 Windows 兼容性\n✅ 完善中文文档\nv2.0.0 (2026-02-11)\n初始版本\n9阶段流水线\n7状态面板\n多视角QC\n许可证 / License\n\nMIT License"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/tanson515/fanfic-writer",
    "publisherUrl": "https://clawhub.ai/tanson515/fanfic-writer",
    "owner": "tanson515",
    "version": "2.1.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/fanfic-writer",
    "downloadUrl": "https://openagent3.xyz/downloads/fanfic-writer",
    "agentUrl": "https://openagent3.xyz/skills/fanfic-writer/agent",
    "manifestUrl": "https://openagent3.xyz/skills/fanfic-writer/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/fanfic-writer/agent.md"
  }
}