{"id":"9ee87949-a5cf-48fa-9309-69278c89b39e","entityType":"agent","slug":"clawhub-sunshinejnjn-epic-novel-writer","name":"epic-novel-writer","canonicalUrl":"https://www.xpersona.co/agent/clawhub-sunshinejnjn-epic-novel-writer","canonicalPath":"/agent/clawhub-sunshinejnjn-epic-novel-writer","generatedAt":"2026-10-11T08:44:08.577Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-11T06:29:28.766Z","emptyReason":null},"description":"史诗级长篇网络小说创作skill，包含13阶段写作流程、人物设定、分卷规划、子Agent并行撰写、全文校验、存档管理等完整工作流。覆盖中篇（10-25万字）到超长篇（60-150万字），实测 420,000 字 / 300 章 / 10 卷。支持全局连续编号、只读存档、人物画像 JSON、HTML 导引页生成。 Skill: epic-novel-writer Owner: sunshinejnjn Summary: 史诗级长篇网络小说创作skill，包含13阶段写作流程、人物设定、分卷规划、子Agent并行撰写、全文校验、存档管理等完整工作流。覆盖中篇（10-25万字）到超长篇（60-150万字），实测 420,000 字 / 300 章 / 10 卷。支持全局连续编号、只读存档、人物画像 JSON、HTML 导引页生成。 Tags: creative-writing:1.1.0, latest:1.2.1, longform:1.1.0, novel:1.1.0, storytelling:1.1.0, writer:1.1.0 Version history: v1.2.1 | 2026-09-20T11:30:36.329Z | user v1.2.1: ClawHub security audit remediation. (","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 10/11/2026.","installCommand":"clawhub skill install s17ehnmpwm46zw2010e8g6j2z583gzv3:epic-novel-writer","sourceUrl":"https://clawhub.ai/sunshinejnjn/epic-novel-writer","homepage":"https://clawhub.ai/sunshinejnjn/skills/epic-novel-writer","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/sunshinejnjn/epic-novel-writer","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/sunshinejnjn/skills/epic-novel-writer","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":61,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"史诗级长篇网络小说创作skill，包含13阶段写作流程、人物设定、分卷规划、子Agent并行撰写、全文校验、存档管理等完整工作流。覆盖中篇（10-25万字）到超长篇（60-150万字），实测 420,000 字 / 300 章 / 10 卷。支持全局连续编号、只读存档、人物画像 JSON、HTML 导引页生成。 Ski"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-11T06:29:28.766Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T06:29:28.766Z","emptyReason":null},"stars":null,"forks":null,"downloads":1133,"packageName":null,"latestVersion":"1.2.1","tractionLabel":"1.1K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T06:29:28.751Z","emptyReason":null},"lastUpdatedAt":"2026-10-11T06:29:28.766Z","lastCrawledAt":"2026-10-11T06:29:28.751Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-12T06:29:28.751Z","lastVerifiedAt":null,"highlights":[{"version":"1.2.1","createdAt":"2026-09-20T11:30:36.329Z","changelog":"v1.2.1: ClawHub security audit remediation. (1) Fixed command-injection in archive-template.md: user-provided novel title is now sanitized via allowlist (tr -cd '[:alnum:] _.-') and all path expansions are quoted (previously unquoted [小说标题] interpolation could be shell-injected). (2) Added Operation Risk & Safety Rules section: confirm scope before archive, verify destination stays inside archive root, prefer file tools over shell. (3) Tightened archive triggers to explicit user commands only; vague phrasing no longer counts. (4) Stage 13 'archive v0' now requires explicit user confirmation (resolves contradiction with read-only-archive policy). (5) Reverse-merge now requires confirmation + backup warning (resolves read-only vs overwrite contradiction). (6) Added language note: docs are Chinese (Chinese web-novel domain), output language follows the project; English README available.","fileCount":12,"zipByteSize":23721},{"version":"1.2.0","createdAt":"2026-09-12T17:52:18.252Z","changelog":"v1.2.0: SKILL.md frontmatter 补全（name/version/license/中英 description/compatibility/allowed-tools）；新增 references/lifecycle.md（13 阶段完整流程详情）与 references/name-rules.md（命名规则表）；修正子文件表死链（lifecycle/name-rules 此前引用但缺失）；新增 LICENSE（BSD 3-Clause）与 VERSION 文件；README/README.zh 文件表与版本记录同步。","fileCount":12,"zipByteSize":21745},{"version":"1.1.2","createdAt":"2026-04-27T19:52:31.468Z","changelog":"Removed unsupported license field from SKILL.md frontmatter (ClawHub CLI v0.8.0 defaults to MIT-0 regardless; BSD-3-Clause license text preserved in README).","fileCount":9,"zipByteSize":19787},{"version":"1.1.1","createdAt":"2026-04-27T19:51:11.230Z","changelog":"Fixed license field from BSD-3-Clause to MIT.","fileCount":8,"zipByteSize":18541},{"version":"1.1.0","createdAt":"2026-04-27T17:21:35.109Z","changelog":"Initial release: 13-phase novel workflow, global chapter numbering, read-only archives, HTML guides, character JSON export, bilingual README (100k-1.5M words proven at 420k words).","fileCount":8,"zipByteSize":18553}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s17ehnmpwm46zw2010e8g6j2z583gzv3:epic-novel-writer","setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-sunshinejnjn-epic-novel-writer/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-sunshinejnjn-epic-novel-writer/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-sunshinejnjn-epic-novel-writer/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-sunshinejnjn-epic-novel-writer/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-sunshinejnjn-epic-novel-writer/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-sunshinejnjn-epic-novel-writer/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-11T08:44:08.573Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-sunshinejnjn-epic-novel-writer/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-sunshinejnjn-epic-novel-writer/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-sunshinejnjn-epic-novel-writer/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-sunshinejnjn-epic-novel-writer/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-11T06:29:28.766Z","emptyReason":null},"readme":"Skill: epic-novel-writer\n\nOwner: sunshinejnjn\n\nSummary: 史诗级长篇网络小说创作skill，包含13阶段写作流程、人物设定、分卷规划、子Agent并行撰写、全文校验、存档管理等完整工作流。覆盖中篇（10-25万字）到超长篇（60-150万字），实测 420,000 字 / 300 章 / 10 卷。支持全局连续编号、只读存档、人物画像 JSON、HTML 导引页生成。\n\nTags: creative-writing:1.1.0, latest:1.2.1, longform:1.1.0, novel:1.1.0, storytelling:1.1.0, writer:1.1.0\n\nVersion history:\n\nv1.2.1 | 2026-09-20T11:30:36.329Z | user\n\nv1.2.1: ClawHub security audit remediation. (1) Fixed command-injection in archive-template.md: user-provided novel title is now sanitized via allowlist (tr -cd '[:alnum:] _.-') and all path expansions are quoted (previously unquoted [小说标题] interpolation could be shell-injected). (2) Added Operation Risk & Safety Rules section: confirm scope before archive, verify destination stays inside archive root, prefer file tools over shell. (3) Tightened archive triggers to explicit user commands only; vague phrasing no longer counts. (4) Stage 13 'archive v0' now requires explicit user confirmation (resolves contradiction with read-only-archive policy). (5) Reverse-merge now requires confirmation + backup warning (resolves read-only vs overwrite contradiction). (6) Added language note: docs are Chinese (Chinese web-novel domain), output language follows the project; English README available.\n\nv1.2.0 | 2026-09-12T17:52:18.252Z | user\n\nv1.2.0: SKILL.md frontmatter 补全（name/version/license/中英 description/compatibility/allowed-tools）；新增 references/lifecycle.md（13 阶段完整流程详情）与 references/name-rules.md（命名规则表）；修正子文件表死链（lifecycle/name-rules 此前引用但缺失）；新增 LICENSE（BSD 3-Clause）与 VERSION 文件；README/README.zh 文件表与版本记录同步。\n\nv1.1.2 | 2026-04-27T19:52:31.468Z | user\n\nRemoved unsupported license field from SKILL.md frontmatter (ClawHub CLI v0.8.0 defaults to MIT-0 regardless; BSD-3-Clause license text preserved in README).\n\nv1.1.1 | 2026-04-27T19:51:11.230Z | user\n\nFixed license field from BSD-3-Clause to MIT.\n\nv1.1.0 | 2026-04-27T17:21:35.109Z | user\n\nInitial release: 13-phase novel workflow, global chapter numbering, read-only archives, HTML guides, character JSON export, bilingual README (100k-1.5M words proven at 420k words).\n\nArchive index:\n\nArchive v1.2.1: 12 files, 23721 bytes\n\nFiles: README.md (8688b), README.zh.md (6925b), references/archive-template.md (9903b), references/chapter-blueprint-template.md (889b), references/character-card-template.md (930b), references/lifecycle.md (6778b), references/name-rules.md (1770b), references/project-structure.md (1388b), references/world-setting-template.md (678b), skill-card.md (2578b), SKILL.md (4984b), _meta.json (136b)\n\nFile v1.2.1:SKILL.md\n\n---\nname: epic-novel-writer\nversion: 1.2.1\nlicense: BSD-3-Clause\ndescription: 史诗级长篇网络小说创作skill，包含13阶段写作流程、人物设定、分卷规划、子Agent并行撰写、全文校验、存档管理等完整工作流。覆盖中篇（10-25万字）到超长篇（60-150万字），实测 420,000 字 / 300 章 / 10 卷。支持全局连续编号、只读存档、人物画像 JSON、HTML 导引页生成。\ndescription_zh: \"史诗级长篇写作：13 阶段工作流（构思→人物→分卷→章级蓝本→前三章定调→分卷并行撰写→整卷/全文校验→只读存档），全局连续章节编号，人物画像 JSON + HTML 导引页，实测 42 万字 / 300 章 / 10 卷。\"\ndescription_en: \"Novel writing full workflow — from world-building and character design to chapter planning, manuscript writing, version archiving, and HTML guide generation. Covers medium (100-250k words) to super-long (600k-1.5m words), proven with 420k words / 300 chapters / 10 volumes. Supports global continuous numbering, read-only archives, character JSON, and HTML guides.\"\nhomepage: https://clawhub.ai/sunshinejnjn/epic-novel-writer\nmetadata:\n openclaw:\n emoji: \"🖊️\"\ncompatibility: Pure Markdown workflow, no external dependencies. Requires OpenClaw file I/O and shell execution capabilities.\nallowed-tools: Read, Write, Edit, Exec\n---\n\n# epic-novel-writer — 史诗级长篇写作 Skill\n\n> **语言说明**：本 skill 的流程文档以中文编写（面向中文网文创作场景，目录与术语为中文）；产出内容（正文、大纲、报告）的语言跟随用户项目语言，不限于中文。英文文档见 `README.md`。\n\n## 适用篇幅\n\n| 篇幅 | 章节数 | 字数范围 |\n|------|--------|---------|\n| 中篇 | 30-80 章 | 10-25 万字 |\n| 长篇 | 80-200 章 | 25-60 万字 |\n| 超长篇 | 200-500 章 | 60-150 万字 |\n\n> 实测标杆：420,000 字 / 300 章 / 10 卷\n\n## 核心规则\n\n### 所有编辑必须在 `在编辑稿/` 目录上完成\n- 修改 → 操作 `在编辑稿/` 的文件\n- 不要修改该目录外的文件\n\n### 存档版本（v1/v2/v3...）是只读的\n- 用于对比/核对/历史回溯\n- 如需对比先读存档参考，然后修改 `在编辑稿/`\n\n### 存档条件\n仅在用户**明确发出存档指令**时执行（\"存成 v1\"、\"终稿了\"、\"存档\"等）；不得把一般性讨论当作存档意图，拿不准先向用户确认。按顺序递增。\n\n### 安全规则\n- 小说标题**不得直接拼入 shell 命令**（命令注入风险）：先按 `references/archive-template.md` 的白名单净化，路径展开一律加引号\n- 存档/反向合并前必须先向用户确认；反向合并会覆盖 `在编辑稿/`，建议先备份\n\n## 写作流程（13 阶段）\n\n1. **构思沟通** → 故事类型、主题、篇幅、视角 → `01-story-premise.md`\n2. **人物设定** → 主角团/配角/关系/时间线 → `references/characters/`\n3. **核对修订人物** → 2 遍（年龄/关系/出场顺序/时间线）\n4. **分卷规划** → 每卷标题/章节范围/核心冲突 → `03-outline/00-master-outline.md`\n5. **卷级大纲** → 章节列表/节奏/伏笔/人物变化 → `03-outline/vol-{N}-outline.md`\n6. **章级蓝本** → 场景/人物/情节/伏笔 → `03-outline/vol-{N}/chapter-{XX}-blueprint.md`\n7. **撰写前三章** → 2 遍校验 + 润色，用户确认定调\n8. **分卷并行撰写** → Sub-Agent 并行，卷内串行\n9. **整卷校验** → 通读全卷 + 蓝本核对 → `06-validation/vol-{N}-validation-report.md`\n10. **重复 4-9** 依次完成各卷\n11. **全卷并行修订** → Sub-Agent 并行，2 遍\n12. **全文校验** → 3 遍（全局一致性/连贯性/文笔终检）\n13. **存档 v0**（须先经用户明确确认，非自动步骤）→ 按 `references/archive-template.md` 执行（含标题净化、路径加引号、风险确认规则）\n\n**命名规则：** 文件名 = 章编号 = 全局连续三位数。`chapter-001.md`（第 1 章），`chapter-031.md`（卷 2 第 1 章）。\n\n## 存档流程\n\n存档时按 `references/archive-template.md` 执行 8 步：\n- 生成人物画像 `char_data.json`（主要角色 + 次要角色）\n- 生成 HTML 导引页（暗色主题，响应式，章节全局连续编号）\n- 每个存档版本独立只读目录\n\n## 子文件\n\n| 文件 | 内容 |\n|------|------|\n| `references/project-structure.md` | 项目目录结构定义 + 核心规则 |\n| `references/lifecycle.md` | 13 阶段完整流程详情（每阶段产出文件） |\n| `references/name-rules.md` | 命名规则（全局连续编号、各文件命名表） |\n| `references/archive-template.md` | 存档流程模板（8 步 + 命令示例 + 检查清单） |\n| `references/world-setting-template.md` | 世界观设定模板 |\n| `references/character-card-template.md` | 人物卡模板 |\n| `references/chapter-blueprint-template.md` | 章级蓝本模板 |\n\n**许可**：BSD 3-Clause（见 `LICENSE`）。\n\nFile v1.2.1:README.md\n\n# epic-novel-writer — Epic Novel Writing Full Workflow\n\n> An AI-driven creative writing SKILL for long-form serialized novels, covering the entire lifecycle from world-building and character design to chapter planning, writing, version archiving, and HTML guide generation.\n\n**Adapted Length: Medium (100-250k words) → Long (250-600k words) → Super Long (600k-1.5m words)**\n> 💡 **Proven Benchmark**: Used to generate **420,000 words** (300 chapters, 10 volumes), validating global chapter numbering, anti-collapse settings system, and HTML guide generation for super-long-form novels.\n\n---\n\n## 🚀 Why This SKILL?\n\nThe hardest part of writing a novel isn't \"starting\" — it's **surviving 300 chapters without things falling apart**. This SKILL solves the most painful problems of long-form writing:\n\n### 1. File Names = Chapter Numbers, Never Get Lost\n```\nchapter-001.md → Chapter 1\nchapter-150.md → Chapter 150 (regardless of which volume)\nchapter-300.md → Chapter 300\n```\n**Restarting from 1 in every volume** is every long-form writer's nightmare. We use **global continuous numbering** — file name IS chapter number, open the folder and you know where you are.\n\n> **文件编号 = 章编号**：`chapter-001.md` 就是第 1 章，`chapter-300.md` 就是第 300 章。不管在哪一卷，文件名直接告诉你章节号。打开文件夹就知道写到哪了。\n\n### 2. One-Click Professional Archive\nFrom `references/archive-template.md`, an 8-step flow auto-generates:\n- ✅ **Full-text merged version** (md + txt dual format)\n- ✅ **Character profile JSON** (char_data.json with name, role, growth arc, first appearance)\n- ✅ **HTML guide page** (dark theme, responsive layout, character card grid, continuous chapter links)\n- ✅ **Plain text table of contents** (chapter numbers + hyperlinks)\n\n> **一键专业存档**：8 步流程自动生成全文合并版（md+txt）、人物画像 JSON、HTML 导引页（暗色主题 + 人物卡网格 + 连续章节链接）、纯文本目录。\n\n### 3. Anti-Collapse Settings System\n- **World-building template** (`world-setting-template.md`) — geography, history, power system, core conflicts\n- **Character card template** (`character-card-template.md`) — personality, background, ability growth arcs, appearance tracking\n- **Chapter blueprint template** (`chapter-blueprint-template.md`) — scene settings, plot outlines, foreshadowing/clue tracking, skill usage records\n\n> **防崩设定体系**：三个模板分别覆盖世界观、角色卡、章纲。章纲模板追踪每章伏笔、线索、技能调用，确保剧情不偏离。\n\n### 4. Read-Only Archives, Free Editing\nAll editing happens in `在编辑稿/` (Work-in-Progress), archive versions (v1/v2/v3…) are **read-only** — compare and trace back anytime; **reverse-merge (overwrites working files) requires explicit user confirmation and a backup first**.\n\n> **只读存档**：所有编辑在 `在编辑稿/` 完成，存档版本（v1/v2/v3…）只读，可随时对比、回溯；反向合并会覆盖编辑稿，需用户明确确认并先备份。\n\n---\n\n## 📋 Contents\n\n| File | Purpose |\n|------|---------|\n| `SKILL.md` | Core rules, workflow, naming conventions, archive process guide |\n| `references/project-structure.md` | Project directory structure + core rules |\n| `references/lifecycle.md` | 13-phase full workflow details (per-phase output files) |\n| `references/name-rules.md` | Naming rules (global continuous numbering + file naming table) |\n| `references/archive-template.md` | 8-step archive flow (directory structure + command examples + checklists) |\n| `references/world-setting-template.md` | World-building template (geography/history/power system/rhythm planning) |\n| `references/character-card-template.md` | Character card template (personality/background/ability growth/appearance tracking) |\n| `references/chapter-blueprint-template.md` | Chapter blueprint template (scene/plot/foreshadowing/skill usage) |\n\n---\n\n## 🔧 Quick Start\n\n### 1. Initialize Project\n\n```bash\nmkdir -p \"我的小说/在编辑稿/{01-story-premise,02-world-setting,03-outline,04-chapters,05-references}\"\n```\n\n### 2. Fill Core Settings\n\nCopy templates from `references/`:\n```bash\ncp references/world-setting-template.md 在编辑稿/02-world-setting.md\ncp references/character-card-template.md 在编辑稿/references/characters/主角.md\n```\n\n### 3. Start Writing Chapter 1\n\n```bash\ncp references/chapter-blueprint-template.md 在编辑稿/03-outline/chapter-001-blueprint.md\n# Fill blueprint, then create chapter-001.md in 04-chapters/\n```\n\n### 4. Archive\n\nWhen the user says \"存档\" (archive):\n```bash\n# Read references/archive-template.md and execute the 8-step flow\n```\n\n---\n\n## 📐 Project Structure\n\n```\nMyNovel/\n├── 在编辑稿/ ← 所有编辑在此 (all editing happens here)\n│ ├── 01-story-premise.md # 故事设定 (story premise)\n│ ├── 02-world-setting.md # 世界观 (world-building)\n│ ├── 03-chapters-written.md # 章节状态 (chapter status)\n│ ├── 03-outline/ # 大纲 (outlines)\n│ ├── 04-chapters/ # 正文 (manuscript, chapter-001.md ~ chapter-XXX.md)\n│ ├── 05-reports/ # 过程报告 (process reports)\n│ └── references/ # 参考文档 (reference docs)\n├── MyNovel_v1/ ← 存档（只读） (archive, read-only)\n├── MyNovel_v2/ ← 存档（只读） (archive, read-only)\n└── ……\n```\n\n---\n\n## ⚠️ Core Rules\n\n1. **All editing in `在编辑稿/`**, don't touch archive directories\n2. **Archive versions are read-only**, for comparison, tracking\n3. **Global continuous numbering**: `chapter-001.md` = Chapter 1, doesn't reset per volume\n4. **Archive must generate**: Character profile JSON + HTML guide page\n\n> **核心规则**：所有编辑在 `在编辑稿/` 完成；存档只读；文件名=章编号=全局连续；存档必含人物画像 JSON 和 HTML 导引页。\n\n---\n\n## 📏 Suitable Length\n\n| Length | Chapters | Word Count | Fit |\n|--------|----------|------------|-----|\n| Medium (中篇) | 30-80 chapters | 100k-250k words | ✅ Perfect fit |\n| Long (长篇) | 80-200 chapters | 250k-600k words | ✅ Ideal match |\n| Super Long (超长篇) | 200-500 chapters | 600k-1.5m words | ✅ Fully capable |\n\n> 💡 **实测标杆 (Proven Benchmark)**: 已用于生成 **420,000 字**（300 章，10 卷）\n\n**Estimation Reference (篇幅估算参考)**: ~4,000 words/chapter, ~10 chapters/volume (~40,000 words/volume). Given total word count, reverse-calculate chapters and volumes.\n\n---\n\n## 🏷️ Use Cases\n\n- Long-form serialized novels (100+ chapters)\n- Web novels / light novels / fantasy / sci-fi\n- AI-assisted writing (LLM generation + human polishing)\n- Multi-person collaboration (each works in `在编辑稿/`, archives regularly)\n- Complex world-building, many characters\n\n---\n\n## 📦 Installation\n\n```bash\nclawhub install epic-novel-writer\n```\n\n## 🔄 Update\n\n```bash\nclawhub update epic-novel-writer\n```\n\n## 🗂️ Version History\n\n| Version | Date | Changes |\n|---------|------|---------|\n| 1.2.1 | 2026-09-20 | ClawHub security audit remediation: fixed command-injection in archive template (title allowlist sanitization + quoted path expansions); added \"Operation Risk & Safety Rules\" (confirm before archive, verify destination stays in archive root, prefer file tools over shell); tightened archive triggers to explicit commands only; Stage 13 \"archive v0\" now requires explicit user confirmation (resolves intent contradiction); added language note (docs in Chinese, output follows project language); reverse-merge now requires confirmation + backup |\n| 1.2.0 | 2026-09-13 | SKILL.md frontmatter 补全（name/version/license/中英 description/compatibility/allowed-tools）；新增 `references/lifecycle.md`（13 阶段详情）与 `references/name-rules.md`（命名规则表）；修正子文件表死链；新增 `LICENSE`（BSD 3-Clause）与 `VERSION` 文件 |\n| 1.1.2 | 2026-04-27 | Removed unsupported license field from SKILL.md frontmatter (ClawHub CLI v0.8.0 defaults to MIT-0) |\n| 1.1.1 | 2026-04-27 | Fixed license field from BSD-3-Clause to MIT |\n| 1.1.0 | 2026-04-27 | Initial release: 13-phase novel workflow, global chapter numbering, read-only archives, character JSON, HTML guides |\n\n## 📄 License\n\nBSD 3-Clause License\n\nCopyright (c) 2026, sunshinejnjn@github\n\n---\n\n> 用结构化流程对抗长篇写作的混沌。从第 1 章到第 300 章，每一步都有据可查。\n> **Structure the chaos of long-form writing. Every chapter, every step, traceable.**\n\nFile v1.2.1:_meta.json\n\n{\n \"ownerId\": \"kn7dn131pvgfaveyzzzcrc5xf182yb84\",\n \"slug\": \"epic-novel-writer\",\n \"version\": \"1.2.1\",\n \"publishedAt\": 1789903836329\n}\n\nFile v1.2.1:references/archive-template.md\n\n# 版本存档模板\n\n> 本模板定义了版本存档的标准流程与输出结构。存档时参照此模板执行，生成新的 `[小说标题]_vN/` 目录。\n\n---\n\n## 存档触发条件\n\n仅在用户**明确发出存档指令**时执行存档：\n- 用户消息中明确包含\"存档\"、\"归档\"、\"存成 vN\"等**指令性表述**时才执行\n- **不得**把一般性讨论（如\"这章写得不错\"\"差不多可以了吧\"）理解为存档意图；拿不准就先问用户\"要存档吗？\"\n- 按创建顺序递增命名：`[小说标题]_v1/`、`[小说标题]_v2/`…\n\n## ⚠️ 操作风险与安全规则\n\n存档流程涉及**目录创建、整树复制、文件格式转换**等批量文件操作。执行前必须：\n\n1. **先向用户确认**本次存档的范围（目标目录名、章节范围），确认后再执行\n2. **标题净化（防命令注入）**：用户提供的小说标题**不得直接拼入 shell 命令**——标题中的 shell 元字符（`;`、`|`、`$(`、`>` 等）会被解释为命令。必须先按白名单过滤再引用：\n ```bash\n # $title 为用户提供的小说标题\n # 白名单：字母、数字、汉字、空格、_、-、.（UTF-8 locale 下 tr 的 [:alnum:] 包含汉字）\n safe_title=$(printf '%s' \"$title\" | tr -cd '[:alnum:] _.-')\n if [ -z \"$safe_title\" ]; then\n echo \"Error: 标题净化后为空，请改用不含特殊字符的标题\" >&2\n exit 1\n fi\n ```\n3. **所有路径展开一律加双引号**（`\"$safe_title\"`、`\"$output_file\"`），禁止裸展开\n4. 写入前校验目标路径确实位于存档目录内（防止 `..`、符号链接逃逸）\n5. 能用文件读写工具直接完成的步骤（复制、合并），**优先用文件工具而非拼 shell 命令**\n\n---\n\n## 命名规则（文件编号 = 章编号）\n\n**所有章节文件名使用全局连续三位数编号，不随卷重置：**\n\n| 卷 | 章节范围 | 文件名 |\n|----|---------|--------|\n| 卷 1 | 第 1-30 章 | `chapter-001.md` ~ `chapter-030.md` |\n| 卷 2 | 第 31-60 章 | `chapter-031.md` ~ `chapter-060.md` |\n| 卷 3 | 第 61-100 章 | `chapter-061.md` ~ `chapter-100.md` |\n| … | … | … |\n| 卷 N | 最后一卷 | `chapter-XXX.md` |\n\n**关键规则：**\n- ❌ 禁止每卷内从第 1 章重新开始编号（不要出现卷 1 有 1-30 章、卷 2 也有 1-30 章的情况）\n- ✅ 文件名直接反映全局章号：`chapter-031.md` = 第 31 章，`chapter-271.md` = 第 271 章\n- ✅ 三位数补零：`chapter-001.md`、`chapter-300.md`\n\n---\n\n## 存档目录结构\n\n```\n[小说标题]_vN/\n├── 01-story-premise.md # 故事设定（复制）\n├── 02-world-setting.md # 世界观设定（复制）\n├── 03-chapters-written.md # 章节完成状态（复制，反映存档时进度）\n├── 03-outline/ # 大纲目录（复制）\n│ ├── 00-master-outline.md\n│ ├── vol-1-outline.md\n│ └── ……\n├── 04-chapters/ # 正文文件（txt，按卷分目录）\n│ ├── vol-1/\n│ │ ├── chapter-001.txt\n│ │ ├── chapter-002.txt\n│ │ └── ……\n│ ├── vol-2/\n│ │ ├── chapter-031.txt\n│ │ └── ……\n│ └── ……\n├── 05-reports/ # 过程报告（复制）\n├── references/ # 参考文件（复制）\n│ ├── ai-ledger/\n│ ├── character-relationships.md\n│ ├── characters/\n│ └── skill-database.md\n├── media/ # 图片（复制）\n│ └── comfyui/images/\n│ └── ……\n├── [小说标题]_全文.md # 全文合并版（md）\n├── [小说标题]_全文.txt # 全文合并版（纯文本）\n├── [小说标题]_目录.txt # 纯文本目录导航\n├── [小说标题]_导引.html # ★ HTML 导引文件（核心导航页）\n└── char_data.json # 人物数据（JSON，供导引页使用）\n```\n\n---\n\n## 执行步骤\n\n### 步骤 1：创建存档目录\n\n```bash\nN=下一个序号（从现有最大序号 +1）\n# $title 必须先按上方安全规则净化为 $safe_title\nmkdir -p \"${safe_title}_v${N}/\"\n```\n\n### 步骤 2：复制只读文件\n\n将 `在编辑稿/` 下的非正文文件原样复制到存档目录：\n\n```bash\ncd \"${safe_title}_v${N}/\"\n# 复制根文件\ncp ../在编辑稿/01-story-premise.md ./\ncp ../在编辑稿/02-world-setting.md ./\ncp ../在编辑稿/03-chapters-written.md ./\n\n# 复制大纲目录\ncp -r ../在编辑稿/03-outline/ ./\n\n# 复制参考文件\ncp -r ../在编辑稿/references/ ./\ncp -r ../在编辑稿/media/ ./\n\n# 复制报告\ncp -r ../在编辑稿/05-reports/ ./\n```\n\n### 步骤 3：复制正文为 txt\n\n`在编辑稿/04-chapters/` 下所有章节已使用全局连续三位数编号，直接转为 txt 复制：\n\n```bash\nmkdir -p chapters\nfor vol_dir in ../在编辑稿/04-chapters/vol-*; do\n vol_num=$(basename \"$vol_dir\")\n mkdir -p \"chapters/${vol_num}\"\n for chapter_file in \"$vol_dir\"/*.md; do\n # 文件名已是全局连续三位数（chapter-NNN.md），直接转换格式\n sed 's/^#\\+ //; s/`//g; s/\\*\\*/\\n/g' \"$chapter_file\" > \"chapters/${vol_num}/$(basename \"$chapter_file\" .md).txt\"\n done\ndone\n```\n\n### 步骤 4：生成全文合并版\n\n将 `chapters/vol-*/chapter-*.txt` 按**全局章节号**顺序合并：\n\n```bash\n# 按卷 + 章号排序后合并（文件名已是三位数全局连续编号）\noutput_file=\"${safe_title}_全文.txt\"\ncat chapters/vol-*/chapter-*.txt > \"$output_file\"\n```\n\n**文件名 = 章编号 = 全局连续三位数**：`chapter-001.txt`（第 1 章）、`chapter-300.txt`（第 300 章），不随卷重置。\n\n### 步骤 5：生成目录\n\n生成 `\"${safe_title}_目录.txt\"`，格式：\n\n```\n# [小说标题] 目录 — vN\n\n## 第 001 章 [章节标题] → chapters/vol-1/chapter-001.txt\n## 第 002 章 [章节标题] → chapters/vol-1/chapter-002.txt\n……\n## 第 300 章 [章节标题] → chapters/vol-10/chapter-300.txt\n```\n\n**关键：章节号全局连续编号，不随卷重置。**\n- 卷 1 第 1 章 = 第 001 章\n- 卷 2 第 1 章 = 第 031 章（如果卷 1 有 30 章）\n- 卷 10 第 1 章 = 第 271 章（以此类推）\n\n### 步骤 6：生成人物画像 JSON\n\n扫描所有章节，提取**主要角色画像**，生成 `char_data.json`：\n\n```json\n{\n \"project\": \"[小说标题]\",\n \"version\": \"vN\",\n \"total_chapters\": 300,\n \"characters\": [\n {\n \"name\": \"主角名\",\n \"role\": \"主角\",\n \"portrait\": \"media/comfyui/images/主角图片.png\",\n \"description\": \"主角的简要描述\",\n \"key_arc\": \"成长线 1 → 成长线 2\",\n \"first_appearance\": \"第 1 章\",\n \"affinity\": \"主角简称\"\n }\n ]\n}\n```\n\n**生成规则：**\n- **主要角色**：指在正文中出现频率高、推动主线/关键剧情的角色\n- 至少包含：主角、女主/重要配角、核心灵体、关键引导者\n- 次要角色（每卷单元灵）可在 `char_data.json` 中以 `minor_characters` 字段补充\n\n### 步骤 7：生成 HTML 导引文件\n\n生成 `[小说标题]_导引.html`，要求：\n\n#### 页面结构\n\n1. **页面头部**\n - 小说标题 + 版本信息 + 统计数据\n - 示例：`[小说标题] v3 · 12 角色 · 300 章`\n\n2. **全文简要介绍**\n - 一段对整个小说的简要概述（200-300 字）\n - 包含核心主题、故事走向、整体氛围\n - 从 `01-story-premise.md` 和 `02-world-setting.md` 提取\n\n3. **人物卡区域**\n - 响应式网格布局（CSS Grid）\n - 每人一张卡片，包含：\n - 角色图片（`portrait` 字段）\n - 角色名 + 角色定位（如\"主角\"、\"灵体\"）\n - 简要描述（1-2 句话）\n - 暗色主题，hover 高亮边框\n\n4. **章节目录区域**\n - 按卷分组，每卷一个区块\n - **章节号全局连续编号**（关键要求）\n - 每章一个超链接指向 `chapters/vol-X/chapter-NNN.txt`\n - 格式：`第 001 章 [标题]`\n\n5. **页脚**\n - 版本信息、生成时间、统计数据\n\n#### 章节编号规则（非常重要）\n\n- ❌ **禁止**：每卷内从第 1 章重新开始编号\n- ✅ **必须**：全局连续编号（卷 1 第 1 章 = 第 001 章，卷 10 第 1 章 = 第 271 章）\n- 编号格式：三位数（第 001 章、第 300 章）\n- HTML 目录中显示为 `第 001 章 · 章节标题`\n\n#### 样式要求\n\n- 暗色主题（背景 `#0a0a0f`，卡片 `#12121a`）\n- 响应式布局（CSS Grid，移动端适配）\n- 字体：`PingFang SC, Microsoft YaHei, sans-serif`\n- 章节链接 hover 效果\n\n### 步骤 8：完成检查\n\n存档完成后验证：\n- [ ] 所有章节已提取为 txt\n- [ ] 全文合并版完整（无缺失、无重复）\n- [ ] 目录章节号全局连续\n- [ ] HTML 导引页人物卡完整\n- [ ] HTML 导引页章节链接全部有效\n- [ ] 全文介绍已添加\n- [ ] 存档目录内无可编辑文件（只读确认）\n\n---\n\n## 反向合并\n\n当存档版本与 `在编辑稿` 不一致时：\n\n1. **先告知用户差异范围**（哪些章节将被覆盖），并取得明确确认\n2. **以 `在编辑稿` 为准**：不需要反向合并\n3. **以存档版为准**：将存档版全文按章节拆分，覆盖 `在编辑稿/04-chapters/` 中的对应文件\n - ⚠️ 覆盖前建议先对 `在编辑稿/` 做备份（或先存档当前编辑稿），避免丢失未存档的修改\n\n---\n\n## 注意事项\n\n- ❌ 不要在存档版本上做任何编辑\n- ❌ 不要在 `在编辑稿/` 之外创建或修改内容\n- ✅ 生成存档时确保所有章节已正确排序和合并\n- ✅ 如果用户没有明确要求存档，不要擅自创建 vN 目录\n- ✅ **文件编号 = 章编号 = 全局连续三位数**，不要每卷从 1 开始\n- ✅ HTML 导引文件必须包含：人物卡 + 全文介绍 + 连续编号章节目录\n\nFile v1.2.1:references/chapter-blueprint-template.md\n\n# 章纲模板\n\n> 复制到 [小说项目目录]/03-outline/vol-{N}/chapter-{XX}-blueprint.md\n\n```markdown\n# 第 [X] 章：[章名]\n\n## 基本信息\n- **位置**: 第 [X] 章（卷 [N] 第 [M] 章）\n- **字数目标**: ~1500 字\n- **视角**: [主角/其他角色]\n\n## 场景设定\n- **时间**: \n- **地点**: \n- **天气/环境**: \n\n## 出场人物\n- [角色名]：状态 + 在本章的作用\n\n## 情节大纲\n1. **开场**（~10%）：[快速交代时间/地点/人物状态]\n2. **发展**（~40%）：[核心冲突逐步展开]\n3. **高潮**（~30%）：[冲突爆发/关键转折]\n4. **收尾**（~20%）：[情绪沉淀 + 下章钩子]\n\n## 关键事件\n- [事件 1]\n- [事件 2]\n\n## 伏笔/线索\n- [埋下的伏笔 → 预计在第 X 章回收]\n\n## 技能/设定调用\n- [本章节需要展示/用到的设定]\n\n## 注意事项\n- [遵守的设定限制]\n- [不能做的事情]\n```\n\nFile v1.2.1:references/character-card-template.md\n\n# 角色卡片模板\n\n> 复制此模板创建新角色卡，保存到 [小说项目目录]/references/characters/\n\n```markdown\n# 角色名\n\n## 基本信息\n- **身份**: \n- **年龄**: \n- **性别**: \n- **外貌**: \n- **口头禅/说话风格**: \n\n## 性格\n- **核心性格**: \n- **优点**: \n- **缺点/弱点**: \n- **内在冲突**: \n\n## 背景故事\n- **成长经历**: \n- **动机**: \n- **秘密**: \n- **人际关系**: \n - 与 [角色名] 的关系：\n\n## 能力/技能\n- **初始能力**: \n- **技能变化节点**:\n - 第 X 章：获得 XX 技能\n - 第 Y 章：技能升级/蜕变\n\n## 成长弧线\n- **起点状态**: \n- **转折点**: \n- **终点状态**: \n- **可能的黑化/反转**: \n\n## 登场与退出\n- **首次登场**: 第 [X] 章\n- **最后登场**: 第 [X] 章\n- **缺席期间**: 第 [X] 至 [Y] 章\n\n## 状态追踪\n- **当前状态**: \n- **当前位置**: \n- **当前目标**: \n- **携带物品**: \n```\n\nFile v1.2.1:references/lifecycle.md\n\n# 写作流程（完整生命周期，13 阶段）\n\n> 按阶段顺序执行。每个阶段有明确产出文件，下游阶段依赖上游产出。\n> 本文是 13 阶段的**完整详情**；SKILL.md 只给概览，执行时以本文为准。\n\n## 篇幅估算参考\n\n每章约 4,000 字，每卷约 10 章（~40,000 字）。用户给定总字数后，按此标准反推总章数和卷数。例如：12 万字 → 约 30 章 → 3 卷。\n\n| 篇幅 | 章节数 | 字数范围 | 推荐程度 |\n|------|--------|---------|---------|\n| 中篇 | 30-80 章 | 10-25 万字 | ✅ 完全覆盖 |\n| 长篇 | 80-200 章 | 25-60 万字 | ✅ 完美匹配 |\n| 超长篇 | 200-500 章 | 60-150 万字 | ✅ 完全胜任 |\n\n> 实测标杆：已用于生成 420,000 字（300 章，10 卷），验证了全局连续编号、防崩设定体系、HTML 导引页生成在超长篇场景下的可靠性。\n\n---\n\n### 阶段 1：构思沟通\n\n与用户深入沟通，确定以下核心要素：\n- 故事类型（奇幻/科幻/悬疑/现实/……）\n- 核心主题与想要表达的情感\n- 目标读者群体与文风偏好\n- 预期篇幅（总章数、总字数）\n- 叙事视角（第一人称/第三人称/多视角轮换）\n- 基调（轻松/沉重/悬疑/热血/……）\n\n**产出**：`01-story-premise.md`\n\n### 阶段 2：人物设定（含时间线）\n\n根据构思创建角色设定，包含：\n- **主角团**：姓名、年龄、身份、外貌、性格核心、成长弧线、首次出场章\n- **配角群**：核心配角、反派、辅助角色\n- **人物关系**：谁和谁是朋友/敌人/恋人/师徒/对立\n- **时间线**：故事起止时间、关键事件时间锚点、角色年龄变化追踪\n\n**产出**：`references/characters/角色名.md`（每个角色一张卡片）+ `references/character-relationships.md`\n\n### 阶段 3：核对修订人物与时间线（2 遍）\n\n**第 1 遍核对**：\n- 年龄一致性：角色年龄是否随时间线合理变化\n- 关系一致性：A 是 B 的哥哥，B 是 A 的弟弟（双向验证）\n- 首次出场顺序：角色不可能在出场前出现在场景中\n- 时间线逻辑：事件先后顺序是否自洽\n\n**第 2 遍修订**：\n- 根据第 1 遍发现的问题修正\n- 用户确认修改（或自行修正）\n- 最终锁定人物设定与时间线\n\n**产出**：修订后的人物卡片 + 关系表（时间线锁定，后续不再变动基础设定）\n\n### 阶段 4：分卷规划\n\n- 将故事按剧情阶段划分为若干卷\n- 每卷确定：卷编号、卷标题、章节范围、核心冲突、卷内主角弧光\n- 全局章号规划：确定每卷首尾章号（例如卷 1: 001-030，卷 2: 031-060）\n\n**产出**：`03-outline/00-master-outline.md`（总纲）\n\n### 阶段 5：卷级大纲\n\n为每一卷撰写大纲，包含：\n- 卷内章节列表（章号 + 标题 + 简要剧情说明）\n- 卷内节奏规划（开篇/发展/高潮/收尾）\n- 卷内伏笔清单（埋设章节 + 回收章节）\n- 卷内人物变化节点\n\n**产出**：`03-outline/vol-{N}-outline.md`（每卷一个）\n\n### 阶段 6：章级蓝本\n\n为每卷的每一个章节撰写蓝本（blueprint），包含：\n- 场景设定（时间、地点、环境）\n- 出场人物（状态 + 在本章作用）\n- 情节大纲（开场→发展→高潮→收尾，按百分比分配）\n- 关键事件清单\n- 伏笔/线索记录（本章节埋设 + 回收）\n- 技能/设定调用\n\n**产出**：`03-outline/vol-{N}/chapter-{XX}-blueprint.md`（每章一个）\n\n### 阶段 7：撰写前三章（开篇定调）\n\n**先写而非先写全卷**，确保文风和叙事基调正确：\n1. 按章级蓝本撰写第 1-3 章正文\n2. 每章完成后进行 **2 遍校验与润色**：\n - 第 1 遍：逻辑校验（与蓝本是否一致、时间线是否正确）\n - 第 2 遍：文笔润色（节奏、对话、描写质量）\n3. 用户确认前三章定调无误\n\n**产出**：`04-chapters/vol-1/chapter-001.md` ~ `chapter-003.md`（校验润色后的定稿）\n\n### 阶段 8：分卷并行撰写（Sub-Agent 并行）\n\n- 使用 Sub-Agent **并行**撰写同一卷内的各章（而非全卷全章同时，避免上下文过长）\n- 每卷内部章节**按顺序串行**撰写（前一章完成后再写下一章，保证连贯性）\n- 每个 Sub-Agent 负责一个卷内章节，拿到蓝本 + 前文上下文\n- 写完即校验\n\n**产出**：`04-chapters/vol-{N}/chapter-{XX}.md`\n\n### 阶段 9：整卷校验与蓝本核对\n\n卷内所有章节完成后，执行：\n1. **整卷校验**：通读全卷，检查剧情连贯性、角色一致性、伏笔回收情况\n2. **蓝本核对**：对比蓝本与正文，检查是否偏离预设、是否有遗漏的伏笔/设定\n3. 修正发现的问题\n4. 用户确认本卷定稿\n\n**产出**：修订后的正文 + `06-validation/vol-{N}-validation-report.md`（校验报告）\n\n### 阶段 10：重复阶段 4-9，依次完成各卷\n\n- 按卷编号顺序，重复分卷规划 → 章级蓝本 → 前三章式开篇校验 → 分章撰写 → 整卷校验\n- 每卷完成后锁定，不再修改（除非重大设定变更）\n\n### 阶段 11：全卷并行修订（Sub-Agent 并行，2 遍）\n\n所有卷完成后，使用 Sub-Agent **并行**执行修订：\n- 每个卷由一个 Sub-Agent 独立修订\n- **第 1 遍修订**：逻辑/设定一致性校验 + 剧情润色\n- **第 2 遍修订**：文笔打磨 + 细节完善\n\n**产出**：修订后的各卷正文\n\n### 阶段 12：全文校验（3 遍）\n\n全书完成后，执行全文级别校验：\n- **第 1 遍**：全局一致性校验（人物年龄、关系、能力随章节变化是否合理）\n- **第 2 遍**：剧情连贯性校验（跨卷伏笔、悬念回收、节奏分布）\n- **第 3 遍**：文笔终检（风格统一性、对话差异化、描写质量）\n\n**产出**：全文定稿 + `06-validation/full-book-validation-report.md`\n\n### 阶段 13：存档 v0（仅在用户明确确认后执行）\n\n全书定稿后，**先告知用户\"全文校验已完成，是否存档 v0？\"，获得明确确认后再执行**第一次完整存档：\n- 按 `references/archive-template.md` 执行 8 步存档流程\n- 存档命名：`[小说标题]_v0/`（v0 表示全书完成的首个存档）\n- 生成人物画像 JSON + HTML 导引页 + 全文合并版\n\n**产出**：`[小说标题]_v0/` 完整存档目录\n\n---\n\n## 注意事项\n\n- 不要在存档版本上做任何编辑\n- 不要在 `在编辑稿/` 之外创建或修改内容\n- 生成存档时确保所有章节都已正确排序和合并\n- 如果用户没有明确要求存档，不要擅自创建 v1/v2/v3 目录\n- **文件编号 = 章编号 = 全局连续三位数，不要每卷从 1 开始**（详见 `references/name-rules.md`）\n- **存档时务必生成人物画像 JSON 和 HTML 导引文件**\n\nFile v1.2.1:references/name-rules.md\n\n# 命名规则（文件编号 = 章编号）\n\n**核心规则：所有章节文件名使用全局连续三位数编号，不随卷重置。**\n\n| 卷 | 章节范围 | 文件名 |\n|----|---------|--------|\n| 卷 1 | 第 1-30 章 | `chapter-001.md` ~ `chapter-030.md` |\n| 卷 2 | 第 31-60 章 | `chapter-031.md` ~ `chapter-060.md` |\n| 卷 3 | 第 61-100 章 | `chapter-061.md` ~ `chapter-100.md` |\n| … | … | … |\n| 卷 N | 最后一卷 | `chapter-XXX.md` |\n\n**关键规则：**\n- ❌ **禁止**每卷内从第 1 章重新开始编号（不要出现卷 1 有 1-30 章、卷 2 也有 1-30 章的情况）\n- ✅ **文件名 = 章编号 = 全局连续三位数**：`chapter-001.md`（第 1 章）、`chapter-300.md`（第 300 章）\n- ✅ 三位数补零：`chapter-001.md`、`chapter-030.md`、`chapter-300.md`\n- ✅ 卷 1 第 1 章 = `chapter-001.md`，卷 2 第 1 章 = `chapter-031.md`（假设卷 1 有 30 章）\n\n**目录内文件命名：**\n\n| 文件 | 命名 |\n|------|------|\n| 总纲 | `03-outline/00-master-outline.md` |\n| 卷级大纲 | `03-outline/vol-{N}-outline.md` |\n| 章级蓝本 | `03-outline/vol-{N}/chapter-{XX}-blueprint.md` |\n| 章节正文 | `04-chapters/vol-{N}/chapter-{XX}.md` |\n| 卷校验报告 | `06-validation/vol-{N}-validation-report.md` |\n| 全书校验报告 | `06-validation/full-book-validation-report.md` |\n| 人物卡 | `references/characters/角色名.md` |\n| 人物关系 | `references/character-relationships.md` |\n| 存档目录 | `[小说标题]_v0/`、`[小说标题]_v1/`、`[小说标题]_v2/`…（按创建顺序递增，只读） |\n\n> 为什么全局连续：打开 `04-chapters/` 文件夹，文件名直接告诉你写到第几章，跨卷也能一眼定位。\"每卷从 1 开始\"是长篇写作最常见的迷路源。\n\nFile v1.2.1:references/project-structure.md\n\n# 小说项目结构\n\n```\n[小说标题]/\n├── 在编辑稿/ ← 所有编辑工作在此目录\n│ ├── 01-story-premise.md # 故事设定\n│ ├── 02-world-setting.md # 世界观设定\n│ ├── 03-chapters-written.md # 章节完成状态\n│ ├── 03-outline/ # 大纲（卷级 + 章级蓝图）\n│ ├── 04-chapters/ # 章节正文（按卷分目录）\n│ ├── 05-reports/ # 过程报告\n│ ├── 06-validation/ # 验证报告\n│ ├── references/ # 参考（人物卡、关系、线索台账）\n│ └── media/ # 图片/media\n├── [小说标题]_v1/ ← 存档版本（只读）\n├── [小说标题]_v2/ ← 存档版本（只读）\n└── ……\n```\n\n## 核心规则\n\n### 所有编辑必须在 在编辑稿 目录上完成\n- 修改章节/大纲/参考文档 → 操作 `在编辑稿/` 下的文件\n- 不要修改 `在编辑稿/` 之外的任何文件\n\n### 存档版本是只读的\n- 禁止在 v1/v2/v3 等存档目录上编辑\n- 用于对比/核对/历史回溯\n- 如需对比先读存档参考，然后改 `在编辑稿/`\n\n### 存档条件\n仅在用户**明确要求**时存档：\n- \"存成 v1\"、\"这是终稿了\"、\"存档\"等\n- 存档命名：`[小说标题]_v1/` → 递增\n\nFile v1.2.1:references/world-setting-template.md\n\n# 世界设定模板\n\n> 复制到 [小说项目目录]/02-world-setting.md 并开始填充\n\n```markdown\n# [世界名称] 设定\n\n## 世界观\n\n### 地理/空间\n- 世界层级：\n- 主要地点：\n- 区域规则：\n\n### 历史/背景\n- 起源：\n- 重大事件：\n- 当前局势：\n\n### 社会/文化\n- 权力结构：\n- 经济体系：\n- 信仰/宗教：\n\n## 力量体系\n\n### 等级\n- 等级 1：[描述]\n- 等级 2：[描述]\n- ...\n\n### 技能\n| 技能名 | 等级 | 效果 | 代价 |\n|--------|------|------|------|\n\n### 规则与限制\n- [限制 1]\n- [限制 2]\n\n## 故事基调\n\n### 核心矛盾\n- \n\n### 主题表达\n- \n\n### 节奏规划\n- 开篇：\n- 总体曲线：\n```\n\nFile v1.2.1:README.zh.md\n\n# epic-novel-writer — 史诗级长篇写作工作流\n\n一个面向长篇连载小说的 AI 驱动创作 SKILL，从世界观设定、人物塑造、章纲规划，到正文写作、版本存档、HTML 导引页生成，覆盖一部小说从零到出版的全生命周期。\n\n**适配篇幅：中篇（10-25 万字）→ 长篇（25-60 万字）→ 超长篇（60-150 万字）**\n> 💡 **实测标杆**：已用于生成 **420,000 字**（300 章，10 卷），验证了全局连续编号、防崩设定体系、HTML 导引页生成在超长篇场景下的可靠性。\n\n## 🚀 为什么需要这个 SKILL？\n\n写小说最难的不是\"开始\"，而是**持续 300 章不崩**。这个 SKILL 解决的是长篇写作中最痛苦的几个问题：\n\n### 1. 文件编号 = 章编号，永远不迷路\n```\nchapter-001.md → 第 1 章\nchapter-150.md → 第 150 章（不管它在哪一卷）\nchapter-300.md → 第 300 章\n```\n**每卷内从 1 重新开始**是每个长篇写作者的噩梦。我们采用**全局连续编号**——文件名即章节号，打开文件夹就知道写到哪了。\n\n### 2. 一键生成专业级存档\n从 `references/archive-template.md` 出发，8 步流程自动生成：\n- ✅ **全文合并版**（md + txt 双格式）\n- ✅ **人物画像 JSON**（char_data.json，含角色名、定位、成长线、首次出场）\n- ✅ **HTML 导引页**（暗色主题、响应式布局、人物卡网格、连续编号章节目录）\n- ✅ **纯文本目录**（章节号 + 超链接）\n\n### 3. 防崩设定体系\n- **世界观模板**（`world-setting-template.md`）— 地理、历史、力量体系、核心矛盾\n- **角色卡片模板**（`character-card-template.md`）— 性格、背景、能力成长弧线、登场退出追踪\n- **章纲模板**（`chapter-blueprint-template.md`）— 每章场景设定、情节大纲、伏笔/线索追踪、技能调用记录\n\n### 4. 只读存档，编辑自由\n所有编辑在 `在编辑稿/` 下完成，存档版本（v1/v2/v3…）**只读**，随时可以对比、回溯；**反向合并（覆盖编辑稿）需用户明确确认，建议先备份**。\n\n## 📋 包含什么\n\n| 文件 | 用途 |\n|------|------|\n| `SKILL.md` | 核心规则、工作流、命名规范、存档流程指引 |\n| `references/project-structure.md` | 项目目录结构定义 + 核心规则 |\n| `references/lifecycle.md` | 13 阶段完整流程详情（每阶段产出文件） |\n| `references/name-rules.md` | 命名规则（全局连续编号 + 各文件命名表） |\n| `references/archive-template.md` | 版本存档 8 步完整流程（目录结构 + 命令示例 + 检查清单） |\n| `references/world-setting-template.md` | 世界观设定模板（地理/历史/力量体系/节奏规划） |\n| `references/character-card-template.md` | 角色卡片模板（性格/背景/能力成长/登场追踪） |\n| `references/chapter-blueprint-template.md` | 章纲模板（场景/情节/伏笔/技能调用） |\n\n## 🔧 快速开始\n\n### 1. 初始化项目\n\n```bash\nmkdir -p \"我的小说/在编辑稿/{01-story-premise,02-world-setting,03-outline,04-chapters,05-references}\"\n```\n\n### 2. 填写核心设定\n\n从 `references/` 复制模板：\n```bash\ncp references/world-setting-template.md 在编辑稿/02-world-setting.md\ncp references/character-card-template.md 在编辑稿/references/characters/主角.md\n```\n\n### 3. 开始写第一章\n\n```bash\ncp references/chapter-blueprint-template.md 在编辑稿/03-outline/chapter-001-blueprint.md\n# 填写章纲后，在 04-chapters/ 创建 chapter-001.md\n```\n\n### 4. 存档\n\n用户说\"存成 v1\"时：\n```bash\n# 阅读 references/archive-template.md，按 8 步流程执行\n```\n\n## 📐 项目结构\n\n```\n我的小说/\n├── 在编辑稿/ ← 所有编辑在此\n│ ├── 01-story-premise.md # 故事设定\n│ ├── 02-world-setting.md # 世界观\n│ ├── 03-chapters-written.md # 章节状态\n│ ├── 03-outline/ # 大纲\n│ ├── 04-chapters/ # 正文（chapter-001.md ~ chapter-XXX.md）\n│ ├── 05-reports/ # 过程报告\n│ └── references/ # 参考文档\n├── 我的小说_v1/ ← 存档（只读）\n├── 我的小说_v2/ ← 存档（只读）\n└── ……\n```\n\n## ⚠️ 核心规则\n\n1. **所有编辑在 `在编辑稿/` 下完成**，不碰存档目录\n2. **存档版本只读**，用于对比、回溯\n3. **全局连续编号**：`chapter-001.md` = 第 1 章，不随卷重置\n4. **存档时需生成人物画像 JSON + HTML 导引页**\n\n## 📏 适用篇幅\n\n| 篇幅 | 章节数 | 字数范围 | 推荐程度 |\n|------|--------|---------|---------|\n| 中篇 | 30-80 章 | 10-25 万字 | ✅ 完全覆盖 |\n| 长篇 | 80-200 章 | 25-60 万字 | ✅ 完美匹配 |\n| 超长篇 | 200-500 章 | 60-150 万字 | ✅ 完全胜任 |\n\n> 💡 **实测标杆**：本项目已用于生成 **420,000 字**（300 章，10 卷），验证了全局连续编号、防崩设定体系、HTML 导引页生成等核心功能在超长篇场景下的可靠性。\n\n## 🏷️ 适用场景\n\n- 长篇连载小说（100 章+）\n- 网络文学/轻小说/奇幻/科幻\n- AI 辅助写作（大模型生成 + 人工润色）\n- 多人协作（每人在 `在编辑稿/` 下工作，定期存档）\n- 世界观复杂、角色众多的作品\n\n## 📦 安装\n\n```bash\nclawhub install epic-novel-writer\n```\n\n## 🔄 更新\n\n```bash\nclawhub update epic-novel-writer\n```\n\n## 🗂️ 版本记录\n\n| 版本 | 日期 | 变更 |\n|------|------|------|\n| 1.2.1 | 2026-09-20 | ClawHub 安全审计整改：修复存档模板命令注入漏洞（标题白名单净化 + 路径展开加引号）；新增\"操作风险与安全规则\"（存档前确认、校验目标路径、优先文件工具）；存档触发收紧为仅明确指令；阶段 13 存档 v0 改为需用户明确确认（消除意图矛盾）；增加语言说明（文档中文、产出跟随项目语言）；反向合并需确认并建议先备份 |\n| 1.2.0 | 2026-09-13 | SKILL.md frontmatter 补全（name/version/license/中英 description/compatibility/allowed-tools）；新增 `references/lifecycle.md`（13 阶段详情）与 `references/name-rules.md`（命名规则表）；修正子文件表死链；新增 `LICENSE`（BSD 3-Clause）与 `VERSION` 文件；README 双语言文件表同步 |\n| 1.1.2 | 2026-04-27 | Removed unsupported license field from SKILL.md frontmatter (ClawHub CLI v0.8.0 defaults to MIT-0) |\n| 1.1.1 | 2026-04-27 | Fixed license field from BSD-3-Clause to MIT |\n| 1.1.0 | 2026-04-27 | 首次发布：13 阶段写作流程、全局连续编号、只读存档、人物 JSON、HTML 导引页 |\n\n## 📄 协议\n\nBSD 3-Clause License\n\nCopyright (c) 2026, sunshinejnjn@github\n\n---\n\n> 用结构化流程对抗长篇写作的混沌。从第 1 章到第 300 章，每一步都有据可查。\n\nFile v1.2.1:skill-card.md\n\n## Description:\n\nNovel writing full workflow from world-building and character design to chapter planning, manuscript writing, validation, version archiving, and HTML guide generation for medium to super-long serialized novels.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[sunshinejnjn](https://clawhub.ai/user/sunshinejnjn)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal writers, editors, and AI-assisted writing teams use this skill to structure long-form serialized novel projects, maintain global chapter numbering, draft and validate chapters, and create archive packages with character data and HTML navigation.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Archive and reverse-merge workflows can create many files or overwrite files under the active manuscript directory.\n\nMitigation: Confirm archive and reverse-merge prompts carefully, verify the target scope and destination, and back up the active manuscript before reverse-merge.\n\nRisk: Archive operations may use shell commands with user-provided titles or paths.\n\nMitigation: Sanitize titles with the documented allowlist, quote path expansions, verify destinations remain inside the archive root, and prefer file tools when practical.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/sunshinejnjn/skills/epic-novel-writer)\n- [Project structure](references/project-structure.md)\n- [Lifecycle workflow](references/lifecycle.md)\n- [Naming rules](references/name-rules.md)\n- [Archive template](references/archive-template.md)\n- [World setting template](references/world-setting-template.md)\n- [Character card template](references/character-card-template.md)\n- [Chapter blueprint template](references/chapter-blueprint-template.md)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, code, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown project files, manuscript text, JSON character data, HTML guide files, validation reports, and shell command proposals.]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Outputs follow the user's project language; the workflow documentation is primarily Chinese with an English README.]\n\n## Skill Version(s):\n\n1.2.1 (source: server release metadata and SKILL.md frontmatter)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v1.2.0: 12 files, 21745 bytes\n\nFiles: README.md (7969b), README.zh.md (6397b), references/archive-template.md (8261b), references/chapter-blueprint-template.md (889b), references/character-card-template.md (930b), references/lifecycle.md (6649b), references/name-rules.md (1770b), references/project-structure.md (1388b), references/world-setting-template.md (678b), skill-card.md (2724b), SKILL.md (4242b), _meta.json (136b)\n\nFile v1.2.0:SKILL.md\n\n---\nname: epic-novel-writer\nversion: 1.2.0\nlicense: BSD-3-Clause\ndescription: 史诗级长篇网络小说创作skill，包含13阶段写作流程、人物设定、分卷规划、子Agent并行撰写、全文校验、存档管理等完整工作流。覆盖中篇（10-25万字）到超长篇（60-150万字），实测 420,000 字 / 300 章 / 10 卷。支持全局连续编号、只读存档、人物画像 JSON、HTML 导引页生成。\ndescription_zh: \"史诗级长篇写作：13 阶段工作流（构思→人物→分卷→章级蓝本→前三章定调→分卷并行撰写→整卷/全文校验→只读存档），全局连续章节编号，人物画像 JSON + HTML 导引页，实测 42 万字 / 300 章 / 10 卷。\"\ndescription_en: \"Novel writing full workflow — from world-building and character design to chapter planning, manuscript writing, version archiving, and HTML guide generation. Covers medium (100-250k words) to super-long (600k-1.5m words), proven with 420k words / 300 chapters / 10 volumes. Supports global continuous numbering, read-only archives, character JSON, and HTML guides.\"\nhomepage: https://clawhub.ai/sunshinejnjn/epic-novel-writer\nmetadata:\n openclaw:\n emoji: \"🖊️\"\ncompatibility: Pure Markdown workflow, no external dependencies. Requires OpenClaw file I/O and shell execution capabilities.\nallowed-tools: Read, Write, Edit, Exec\n---\n\n# epic-novel-writer — 史诗级长篇写作 Skill\n\n## 适用篇幅\n\n| 篇幅 | 章节数 | 字数范围 |\n|------|--------|---------|\n| 中篇 | 30-80 章 | 10-25 万字 |\n| 长篇 | 80-200 章 | 25-60 万字 |\n| 超长篇 | 200-500 章 | 60-150 万字 |\n\n> 实测标杆：420,000 字 / 300 章 / 10 卷\n\n## 核心规则\n\n### 所有编辑必须在 `在编辑稿/` 目录上完成\n- 修改 → 操作 `在编辑稿/` 的文件\n- 不要修改该目录外的文件\n\n### 存档版本（v1/v2/v3...）是只读的\n- 用于对比/核对/历史回溯\n- 如需对比先读存档参考，然后修改 `在编辑稿/`\n\n### 存档条件\n仅在用户**明确要求**时存档（\"存成 v1\"、\"终稿了\"、\"存档\"等），按顺序递增。\n\n## 写作流程（13 阶段）\n\n1. **构思沟通** → 故事类型、主题、篇幅、视角 → `01-story-premise.md`\n2. **人物设定** → 主角团/配角/关系/时间线 → `references/characters/`\n3. **核对修订人物** → 2 遍（年龄/关系/出场顺序/时间线）\n4. **分卷规划** → 每卷标题/章节范围/核心冲突 → `03-outline/00-master-outline.md`\n5. **卷级大纲** → 章节列表/节奏/伏笔/人物变化 → `03-outline/vol-{N}-outline.md`\n6. **章级蓝本** → 场景/人物/情节/伏笔 → `03-outline/vol-{N}/chapter-{XX}-blueprint.md`\n7. **撰写前三章** → 2 遍校验 + 润色，用户确认定调\n8. **分卷并行撰写** → Sub-Agent 并行，卷内串行\n9. **整卷校验** → 通读全卷 + 蓝本核对 → `06-validation/vol-{N}-validation-report.md`\n10. **重复 4-9** 依次完成各卷\n11. **全卷并行修订** → Sub-Agent 并行，2 遍\n12. **全文校验** → 3 遍（全局一致性/连贯性/文笔终检）\n13. **存档 v0** → 按 `references/archive-template.md` 执行\n\n**命名规则：** 文件名 = 章编号 = 全局连续三位数。`chapter-001.md`（第 1 章），`chapter-031.md`（卷 2 第 1 章）。\n\n## 存档流程\n\n存档时按 `references/archive-template.md` 执行 8 步：\n- 生成人物画像 `char_data.json`（主要角色 + 次要角色）\n- 生成 HTML 导引页（暗色主题，响应式，章节全局连续编号）\n- 每个存档版本独立只读目录\n\n## 子文件\n\n| 文件 | 内容 |\n|------|------|\n| `references/project-structure.md` | 项目目录结构定义 + 核心规则 |\n| `references/lifecycle.md` | 13 阶段完整流程详情（每阶段产出文件） |\n| `references/name-rules.md` | 命名规则（全局连续编号、各文件命名表） |\n| `references/archive-template.md` | 存档流程模板（8 步 + 命令示例 + 检查清单） |\n| `references/world-setting-template.md` | 世界观设定模板 |\n| `references/character-card-template.md` | 人物卡模板 |\n| `references/chapter-blueprint-template.md` | 章级蓝本模板 |\n\n**许可**：BSD 3-Clause（见 `LICENSE`）。\n\nFile v1.2.0:README.md\n\n# epic-novel-writer — Epic Novel Writing Full Workflow\n\n> An AI-driven creative writing SKILL for long-form serialized novels, covering the entire lifecycle from world-building and character design to chapter planning, writing, version archiving, and HTML guide generation.\n\n**Adapted Length: Medium (100-250k words) → Long (250-600k words) → Super Long (600k-1.5m words)**\n> 💡 **Proven Benchmark**: Used to generate **420,000 words** (300 chapters, 10 volumes), validating global chapter numbering, anti-collapse settings system, and HTML guide generation for super-long-form novels.\n\n---\n\n## 🚀 Why This SKILL?\n\nThe hardest part of writing a novel isn't \"starting\" — it's **surviving 300 chapters without things falling apart**. This SKILL solves the most painful problems of long-form writing:\n\n### 1. File Names = Chapter Numbers, Never Get Lost\n```\nchapter-001.md → Chapter 1\nchapter-150.md → Chapter 150 (regardless of which volume)\nchapter-300.md → Chapter 300\n```\n**Restarting from 1 in every volume** is every long-form writer's nightmare. We use **global continuous numbering** — file name IS chapter number, open the folder and you know where you are.\n\n> **文件编号 = 章编号**：`chapter-001.md` 就是第 1 章，`chapter-300.md` 就是第 300 章。不管在哪一卷，文件名直接告诉你章节号。打开文件夹就知道写到哪了。\n\n### 2. One-Click Professional Archive\nFrom `references/archive-template.md`, an 8-step flow auto-generates:\n- ✅ **Full-text merged version** (md + txt dual format)\n- ✅ **Character profile JSON** (char_data.json with name, role, growth arc, first appearance)\n- ✅ **HTML guide page** (dark theme, responsive layout, character card grid, continuous chapter links)\n- ✅ **Plain text table of contents** (chapter numbers + hyperlinks)\n\n> **一键专业存档**：8 步流程自动生成全文合并版（md+txt）、人物画像 JSON、HTML 导引页（暗色主题 + 人物卡网格 + 连续章节链接）、纯文本目录。\n\n### 3. Anti-Collapse Settings System\n- **World-building template** (`world-setting-template.md`) — geography, history, power system, core conflicts\n- **Character card template** (`character-card-template.md`) — personality, background, ability growth arcs, appearance tracking\n- **Chapter blueprint template** (`chapter-blueprint-template.md`) — scene settings, plot outlines, foreshadowing/clue tracking, skill usage records\n\n> **防崩设定体系**：三个模板分别覆盖世界观、角色卡、章纲。章纲模板追踪每章伏笔、线索、技能调用，确保剧情不偏离。\n\n### 4. Read-Only Archives, Free Editing\nAll editing happens in `在编辑稿/` (Work-in-Progress), archive versions (v1/v2/v3…) are **read-only**,可随时对比、回溯、反向合并。\n\n> **只读存档**：所有编辑在 `在编辑稿/` 完成，存档版本（v1/v2/v3…）只读，随时对比、回溯、反向合并。\n\n---\n\n## 📋 Contents\n\n| File | Purpose |\n|------|---------|\n| `SKILL.md` | Core rules, workflow, naming conventions, archive process guide |\n| `references/project-structure.md` | Project directory structure + core rules |\n| `references/lifecycle.md` | 13-phase full workflow details (per-phase output files) |\n| `references/name-rules.md` | Naming rules (global continuous numbering + file naming table) |\n| `references/archive-template.md` | 8-step archive flow (directory structure + command examples + checklists) |\n| `references/world-setting-template.md` | World-building template (geography/history/power system/rhythm planning) |\n| `references/character-card-template.md` | Character card template (personality/background/ability growth/appearance tracking) |\n| `references/chapter-blueprint-template.md` | Chapter blueprint template (scene/plot/foreshadowing/skill usage) |\n\n---\n\n## 🔧 Quick Start\n\n### 1. Initialize Project\n\n```bash\nmkdir -p \"我的小说/在编辑稿/{01-story-premise,02-world-setting,03-outline,04-chapters,05-references}\"\n```\n\n### 2. Fill Core Settings\n\nCopy templates from `references/`:\n```bash\ncp references/world-setting-template.md 在编辑稿/02-world-setting.md\ncp references/character-card-template.md 在编辑稿/references/characters/主角.md\n```\n\n### 3. Start Writing Chapter 1\n\n```bash\ncp references/chapter-blueprint-template.md 在编辑稿/03-outline/chapter-001-blueprint.md\n# Fill blueprint, then create chapter-001.md in 04-chapters/\n```\n\n### 4. Archive\n\nWhen the user says \"存档\" (archive):\n```bash\n# Read references/archive-template.md and execute the 8-step flow\n```\n\n---\n\n## 📐 Project Structure\n\n```\nMyNovel/\n├── 在编辑稿/ ← 所有编辑在此 (all editing happens here)\n│ ├── 01-story-premise.md # 故事设定 (story premise)\n│ ├── 02-world-setting.md # 世界观 (world-building)\n│ ├── 03-chapters-written.md # 章节状态 (chapter status)\n│ ├── 03-outline/ # 大纲 (outlines)\n│ ├── 04-chapters/ # 正文 (manuscript, chapter-001.md ~ chapter-XXX.md)\n│ ├── 05-reports/ # 过程报告 (process reports)\n│ └── references/ # 参考文档 (reference docs)\n├── MyNovel_v1/ ← 存档（只读） (archive, read-only)\n├── MyNovel_v2/ ← 存档（只读） (archive, read-only)\n└── ……\n```\n\n---\n\n## ⚠️ Core Rules\n\n1. **All editing in `在编辑稿/`**, don't touch archive directories\n2. **Archive versions are read-only**, for comparison, tracking\n3. **Global continuous numbering**: `chapter-001.md` = Chapter 1, doesn't reset per volume\n4. **Archive must generate**: Character profile JSON + HTML guide page\n\n> **核心规则**：所有编辑在 `在编辑稿/` 完成；存档只读；文件名=章编号=全局连续；存档必含人物画像 JSON 和 HTML 导引页。\n\n---\n\n## 📏 Suitable Length\n\n| Length | Chapters | Word Count | Fit |\n|--------|----------|------------|-----|\n| Medium (中篇) | 30-80 chapters | 100k-250k words | ✅ Perfect fit |\n| Long (长篇) | 80-200 chapters | 250k-600k words | ✅ Ideal match |\n| Super Long (超长篇) | 200-500 chapters | 600k-1.5m words | ✅ Fully capable |\n\n> 💡 **实测标杆 (Proven Benchmark)**: 已用于生成 **420,000 字**（300 章，10 卷）\n\n**Estimation Reference (篇幅估算参考)**: ~4,000 words/chapter, ~10 chapters/volume (~40,000 words/volume). Given total word count, reverse-calculate chapters and volumes.\n\n---\n\n## 🏷️ Use Cases\n\n- Long-form serialized novels (100+ chapters)\n- Web novels / light novels / fantasy / sci-fi\n- AI-assisted writing (LLM generation + human polishing)\n- Multi-person collaboration (each works in `在编辑稿/`, archives regularly)\n- Complex world-building, many characters\n\n---\n\n## 📦 Installation\n\n```bash\nclawhub install epic-novel-writer\n```\n\n## 🔄 Update\n\n```bash\nclawhub update epic-novel-writer\n```\n\n## 🗂️ Version History\n\n| Version | Date | Changes |\n|---------|------|---------|\n| 1.2.0 | 2026-09-13 | SKILL.md frontmatter 补全（name/version/license/中英 description/compatibility/allowed-tools）；新增 `references/lifecycle.md`（13 阶段详情）与 `references/name-rules.md`（命名规则表）；修正子文件表死链；新增 `LICENSE`（BSD 3-Clause）与 `VERSION` 文件 |\n| 1.1.2 | 2026-04-27 | Removed unsupported license field from SKILL.md frontmatter (ClawHub CLI v0.8.0 defaults to MIT-0) |\n| 1.1.1 | 2026-04-27 | Fixed license field from BSD-3-Clause to MIT |\n| 1.1.0 | 2026-04-27 | Initial release: 13-phase novel workflow, global chapter numbering, read-only archives, character JSON, HTML guides |\n\n## 📄 License\n\nBSD 3-Clause License\n\nCopyright (c) 2026, sunshinejnjn@github\n\n---\n\n> 用结构化流程对抗长篇写作的混沌。从第 1 章到第 300 章，每一步都有据可查。\n> **Structure the chaos of long-form writing. Every chapter, every step, traceable.**\n\nFile v1.2.0:_meta.json\n\n{\n \"ownerId\": \"kn7dn131pvgfaveyzzzcrc5xf182yb84\",\n \"slug\": \"epic-novel-writer\",\n \"version\": \"1.2.0\",\n \"publishedAt\": 1789235538252\n}\n\nFile v1.2.0:references/archive-template.md\n\n# 版本存档模板\n\n> 本模板定义了版本存档的标准流程与输出结构。存档时参照此模板执行，生成新的 `[小说标题]_vN/` 目录。\n\n---\n\n## 存档触发条件\n\n仅在用户**明确要求**时执行存档：\n- 用户说\"存成 vN\"、\"这是终稿了\"、\"存档\"等类似表述\n- 按创建顺序递增命名：`[小说标题]_v1/`、`[小说标题]_v2/`…\n\n---\n\n## 命名规则（文件编号 = 章编号）\n\n**所有章节文件名使用全局连续三位数编号，不随卷重置：**\n\n| 卷 | 章节范围 | 文件名 |\n|----|---------|--------|\n| 卷 1 | 第 1-30 章 | `chapter-001.md` ~ `chapter-030.md` |\n| 卷 2 | 第 31-60 章 | `chapter-031.md` ~ `chapter-060.md` |\n| 卷 3 | 第 61-100 章 | `chapter-061.md` ~ `chapter-100.md` |\n| … | … | … |\n| 卷 N | 最后一卷 | `chapter-XXX.md` |\n\n**关键规则：**\n- ❌ 禁止每卷内从第 1 章重新开始编号（不要出现卷 1 有 1-30 章、卷 2 也有 1-30 章的情况）\n- ✅ 文件名直接反映全局章号：`chapter-031.md` = 第 31 章，`chapter-271.md` = 第 271 章\n- ✅ 三位数补零：`chapter-001.md`、`chapter-300.md`\n\n---\n\n## 存档目录结构\n\n```\n[小说标题]_vN/\n├── 01-story-premise.md # 故事设定（复制）\n├── 02-world-setting.md # 世界观设定（复制）\n├── 03-chapters-written.md # 章节完成状态（复制，反映存档时进度）\n├── 03-outline/ # 大纲目录（复制）\n│ ├── 00-master-outline.md\n│ ├── vol-1-outline.md\n│ └── ……\n├── 04-chapters/ # 正文文件（txt，按卷分目录）\n│ ├── vol-1/\n│ │ ├── chapter-001.txt\n│ │ ├── chapter-002.txt\n│ │ └── ……\n│ ├── vol-2/\n│ │ ├── chapter-031.txt\n│ │ └── ……\n│ └── ……\n├── 05-reports/ # 过程报告（复制）\n├── references/ # 参考文件（复制）\n│ ├── ai-ledger/\n│ ├── character-relationships.md\n│ ├── characters/\n│ └── skill-database.md\n├── media/ # 图片（复制）\n│ └── comfyui/images/\n│ └── ……\n├── [小说标题]_全文.md # 全文合并版（md）\n├── [小说标题]_全文.txt # 全文合并版（纯文本）\n├── [小说标题]_目录.txt # 纯文本目录导航\n├── [小说标题]_导引.html # ★ HTML 导引文件（核心导航页）\n└── char_data.json # 人物数据（JSON，供导引页使用）\n```\n\n---\n\n## 执行步骤\n\n### 步骤 1：创建存档目录\n\n```bash\nN=下一个序号（从现有最大序号 +1）\nmkdir -p \"[小说标题]_v${N}/\"\n```\n\n### 步骤 2：复制只读文件\n\n将 `在编辑稿/` 下的非正文文件原样复制到存档目录：\n\n```bash\ncd \"[小说标题]_v${N}/\"\n# 复制根文件\ncp ../在编辑稿/01-story-premise.md ./\ncp ../在编辑稿/02-world-setting.md ./\ncp ../在编辑稿/03-chapters-written.md ./\n\n# 复制大纲目录\ncp -r ../在编辑稿/03-outline/ ./\n\n# 复制参考文件\ncp -r ../在编辑稿/references/ ./\ncp -r ../在编辑稿/media/ ./\n\n# 复制报告\ncp -r ../在编辑稿/05-reports/ ./\n```\n\n### 步骤 3：复制正文为 txt\n\n`在编辑稿/04-chapters/` 下所有章节已使用全局连续三位数编号，直接转为 txt 复制：\n\n```bash\nmkdir -p chapters\nfor vol_dir in ../在编辑稿/04-chapters/vol-*; do\n vol_num=$(basename \"$vol_dir\")\n mkdir -p \"chapters/${vol_num}\"\n for chapter_file in \"$vol_dir\"/*.md; do\n # 文件名已是全局连续三位数（chapter-NNN.md），直接转换格式\n sed 's/^#\\+ //; s/`//g; s/\\*\\*/\\n/g' \"$chapter_file\" > \"chapters/${vol_num}/$(basename \"$chapter_file\" .md).txt\"\n done\ndone\n```\n\n### 步骤 4：生成全文合并版\n\n将 `chapters/vol-*/chapter-*.txt` 按**全局章节号**顺序合并：\n\n```bash\n# 按卷 + 章号排序后合并（文件名已是三位数全局连续编号）\ncat chapters/vol-*/chapter-*.txt > [小说标题]_全文.txt\n```\n\n**文件名 = 章编号 = 全局连续三位数**：`chapter-001.txt`（第 1 章）、`chapter-300.txt`（第 300 章），不随卷重置。\n\n### 步骤 5：生成目录\n\n生成 `[小说标题]_目录.txt`，格式：\n\n```\n# [小说标题] 目录 — vN\n\n## 第 001 章 [章节标题] → chapters/vol-1/chapter-001.txt\n## 第 002 章 [章节标题] → chapters/vol-1/chapter-002.txt\n……\n## 第 300 章 [章节标题] → chapters/vol-10/chapter-300.txt\n```\n\n**关键：章节号全局连续编号，不随卷重置。**\n- 卷 1 第 1 章 = 第 001 章\n- 卷 2 第 1 章 = 第 031 章（如果卷 1 有 30 章）\n- 卷 10 第 1 章 = 第 271 章（以此类推）\n\n### 步骤 6：生成人物画像 JSON\n\n扫描所有章节，提取**主要角色画像**，生成 `char_data.json`：\n\n```json\n{\n \"project\": \"[小说标题]\",\n \"version\": \"vN\",\n \"total_chapters\": 300,\n \"characters\": [\n {\n \"name\": \"主角名\",\n \"role\": \"主角\",\n \"portrait\": \"media/comfyui/images/主角图片.png\",\n \"description\": \"主角的简要描述\",\n \"key_arc\": \"成长线 1 → 成长线 2\",\n \"first_appearance\": \"第 1 章\",\n \"affinity\": \"主角简称\"\n }\n ]\n}\n```\n\n**生成规则：**\n- **主要角色**：指在正文中出现频率高、推动主线/关键剧情的角色\n- 至少包含：主角、女主/重要配角、核心灵体、关键引导者\n- 次要角色（每卷单元灵）可在 `char_data.json` 中以 `minor_characters` 字段补充\n\n### 步骤 7：生成 HTML 导引文件\n\n生成 `[小说标题]_导引.html`，要求：\n\n#### 页面结构\n\n1. **页面头部**\n - 小说标题 + 版本信息 + 统计数据\n - 示例：`[小说标题] v3 · 12 角色 · 300 章`\n\n2. **全文简要介绍**\n - 一段对整个小说的简要概述（200-300 字）\n - 包含核心主题、故事走向、整体氛围\n - 从 `01-story-premise.md` 和 `02-world-setting.md` 提取\n\n3. **人物卡区域**\n - 响应式网格布局（CSS Grid）\n - 每人一张卡片，包含：\n - 角色图片（`portrait` 字段）\n - 角色名 + 角色定位（如\"主角\"、\"灵体\"）\n - 简要描述（1-2 句话）\n - 暗色主题，hover 高亮边框\n\n4. **章节目录区域**\n - 按卷分组，每卷一个区块\n - **章节号全局连续编号**（关键要求）\n - 每章一个超链接指向 `chapters/vol-X/chapter-NNN.txt`\n - 格式：`第 001 章 [标题]`\n\n5. **页脚**\n - 版本信息、生成时间、统计数据\n\n#### 章节编号规则（非常重要）\n\n- ❌ **禁止**：每卷内从第 1 章重新开始编号\n- ✅ **必须**：全局连续编号（卷 1 第 1 章 = 第 001 章，卷 10 第 1 章 = 第 271 章）\n- 编号格式：三位数（第 001 章、第 300 章）\n- HTML 目录中显示为 `第 001 章 · 章节标题`\n\n#### 样式要求\n\n- 暗色主题（背景 `#0a0a0f`，卡片 `#12121a`）\n- 响应式布局（CSS Grid，移动端适配）\n- 字体：`PingFang SC, Microsoft YaHei, sans-serif`\n- 章节链接 hover 效果\n\n### 步骤 8：完成检查\n\n存档完成后验证：\n- [ ] 所有章节已提取为 txt\n- [ ] 全文合并版完整（无缺失、无重复）\n- [ ] 目录章节号全局连续\n- [ ] HTML 导引页人物卡完整\n- [ ] HTML 导引页章节链接全部有效\n- [ ] 全文介绍已添加\n- [ ] 存档目录内无可编辑文件（只读确认）\n\n---\n\n## 反向合并\n\n当存档版本与 `在编辑稿` 不一致时：\n\n1. 先确认以哪个版本为准\n2. **以 `在编辑稿` 为准**：不需要反向合并\n3. **以存档版为准**：将存档版全文按章节拆分，覆盖 `在编辑稿/04-chapters/` 中的对应文件\n\n---\n\n## 注意事项\n\n- ❌ 不要在存档版本上做任何编辑\n- ❌ 不要在 `在编辑稿/` 之外创建或修改内容\n- ✅ 生成存档时确保所有章节已正确排序和合并\n- ✅ 如果用户没有明确要求存档，不要擅自创建 vN 目录\n- ✅ **文件编号 = 章编号 = 全局连续三位数**，不要每卷从 1 开始\n- ✅ HTML 导引文件必须包含：人物卡 + 全文介绍 + 连续编号章节目录\n\nFile v1.2.0:references/chapter-blueprint-template.md\n\n# 章纲模板\n\n> 复制到 [小说项目目录]/03-outline/vol-{N}/chapter-{XX}-blueprint.md\n\n```markdown\n# 第 [X] 章：[章名]\n\n## 基本信息\n- **位置**: 第 [X] 章（卷 [N] 第 [M] 章）\n- **字数目标**: ~1500 字\n- **视角**: [主角/其他角色]\n\n## 场景设定\n- **时间**: \n- **地点**: \n- **天气/环境**: \n\n## 出场人物\n- [角色名]：状态 + 在本章的作用\n\n## 情节大纲\n1. **开场**（~10%）：[快速交代时间/地点/人物状态]\n2. **发展**（~40%）：[核心冲突逐步展开]\n3. **高潮**（~30%）：[冲突爆发/关键转折]\n4. **收尾**（~20%）：[情绪沉淀 + 下章钩子]\n\n## 关键事件\n- [事件 1]\n- [事件 2]\n\n## 伏笔/线索\n- [埋下的伏笔 → 预计在第 X 章回收]\n\n## 技能/设定调用\n- [本章节需要展示/用到的设定]\n\n## 注意事项\n- [遵守的设定限制]\n- [不能做的事情]\n```\n\nFile v1.2.0:references/character-card-template.md\n\n# 角色卡片模板\n\n> 复制此模板创建新角色卡，保存到 [小说项目目录]/references/characters/\n\n```markdown\n# 角色名\n\n## 基本信息\n- **身份**: \n- **年龄**: \n- **性别**: \n- **外貌**: \n- **口头禅/说话风格**: \n\n## 性格\n- **核心性格**: \n- **优点**: \n- **缺点/弱点**: \n- **内在冲突**: \n\n## 背景故事\n- **成长经历**: \n- **动机**: \n- **秘密**: \n- **人际关系**: \n - 与 [角色名] 的关系：\n\n## 能力/技能\n- **初始能力**: \n- **技能变化节点**:\n - 第 X 章：获得 XX 技能\n - 第 Y 章：技能升级/蜕变\n\n## 成长弧线\n- **起点状态**: \n- **转折点**: \n- **终点状态**: \n- **可能的黑化/反转**: \n\n## 登场与退出\n- **首次登场**: 第 [X] 章\n- **最后登场**: 第 [X] 章\n- **缺席期间**: 第 [X] 至 [Y] 章\n\n## 状态追踪\n- **当前状态**: \n- **当前位置**: \n- **当前目标**: \n- **携带物品**: \n```\n\nFile v1.2.0:references/lifecycle.md\n\n# 写作流程（完整生命周期，13 阶段）\n\n> 按阶段顺序执行。每个阶段有明确产出文件，下游阶段依赖上游产出。\n> 本文是 13 阶段的**完整详情**；SKILL.md 只给概览，执行时以本文为准。\n\n## 篇幅估算参考\n\n每章约 4,000 字，每卷约 10 章（~40,000 字）。用户给定总字数后，按此标准反推总章数和卷数。例如：12 万字 → 约 30 章 → 3 卷。\n\n| 篇幅 | 章节数 | 字数范围 | 推荐程度 |\n|------|--------|---------|---------|\n| 中篇 | 30-80 章 | 10-25 万字 | ✅ 完全覆盖 |\n| 长篇 | 80-200 章 | 25-60 万字 | ✅ 完美匹配 |\n| 超长篇 | 200-500 章 | 60-150 万字 | ✅ 完全胜任 |\n\n> 实测标杆：已用于生成 420,000 字（300 章，10 卷），验证了全局连续编号、防崩设定体系、HTML 导引页生成在超长篇场景下的可靠性。\n\n---\n\n### 阶段 1：构思沟通\n\n与用户深入沟通，确定以下核心要素：\n- 故事类型（奇幻/科幻/悬疑/现实/……）\n- 核心主题与想要表达的情感\n- 目标读者群体与文风偏好\n- 预期篇幅（总章数、总字数）\n- 叙事视角（第一人称/第三人称/多视角轮换）\n- 基调（轻松/沉重/悬疑/热血/……）\n\n**产出**：`01-story-premise.md`\n\n### 阶段 2：人物设定（含时间线）\n\n根据构思创建角色设定，包含：\n- **主角团**：姓名、年龄、身份、外貌、性格核心、成长弧线、首次出场章\n- **配角群**：核心配角、反派、辅助角色\n- **人物关系**：谁和谁是朋友/敌人/恋人/师徒/对立\n- **时间线**：故事起止时间、关键事件时间锚点、角色年龄变化追踪\n\n**产出**：`references/characters/角色名.md`（每个角色一张卡片）+ `references/character-relationships.md`\n\n### 阶段 3：核对修订人物与时间线（2 遍）\n\n**第 1 遍核对**：\n- 年龄一致性：角色年龄是否随时间线合理变化\n- 关系一致性：A 是 B 的哥哥，B 是 A 的弟弟（双向验证）\n- 首次出场顺序：角色不可能在出场前出现在场景中\n- 时间线逻辑：事件先后顺序是否自洽\n\n**第 2 遍修订**：\n- 根据第 1 遍发现的问题修正\n- 用户确认修改（或自行修正）\n- 最终锁定人物设定与时间线\n\n**产出**：修订后的人物卡片 + 关系表（时间线锁定，后续不再变动基础设定）\n\n### 阶段 4：分卷规划\n\n- 将故事按剧情阶段划分为若干卷\n- 每卷确定：卷编号、卷标题、章节范围、核心冲突、卷内主角弧光\n- 全局章号规划：确定每卷首尾章号（例如卷 1: 001-030，卷 2: 031-060）\n\n**产出**：`03-outline/00-master-outline.md`（总纲）\n\n### 阶段 5：卷级大纲\n\n为每一卷撰写大纲，包含：\n- 卷内章节列表（章号 + 标题 + 简要剧情说明）\n- 卷内节奏规划（开篇/发展/高潮/收尾）\n- 卷内伏笔清单（埋设章节 + 回收章节）\n- 卷内人物变化节点\n\n**产出**：`03-outline/vol-{N}-outline.md`（每卷一个）\n\n### 阶段 6：章级蓝本\n\n为每卷的每一个章节撰写蓝本（blueprint），包含：\n- 场景设定（时间、地点、环境）\n- 出场人物（状态 + 在本章作用）\n- 情节大纲（开场→发展→高潮→收尾，按百分比分配）\n- 关键事件清单\n- 伏笔/线索记录（本章节埋设 + 回收）\n- 技能/设定调用\n\n**产出**：`03-outline/vol-{N}/chapter-{XX}-blueprint.md`（每章一个）\n\n### 阶段 7：撰写前三章（开篇定调）\n\n**先写而非先写全卷**，确保文风和叙事基调正确：\n1. 按章级蓝本撰写第 1-3 章正文\n2. 每章完成后进行 **2 遍校验与润色**：\n - 第 1 遍：逻辑校验（与蓝本是否一致、时间线是否正确）\n - 第 2 遍：文笔润色（节奏、对话、描写质量）\n3. 用户确认前三章定调无误\n\n**产出**：`04-chapters/vol-1/chapter-001.md` ~ `chapter-003.md`（校验润色后的定稿）\n\n### 阶段 8：分卷并行撰写（Sub-Agent 并行）\n\n- 使用 Sub-Agent **并行**撰写同一卷内的各章（而非全卷全章同时，避免上下文过长）\n- 每卷内部章节**按顺序串行**撰写（前一章完成后再写下一章，保证连贯性）\n- 每个 Sub-Agent 负责一个卷内章节，拿到蓝本 + 前文上下文\n- 写完即校验\n\n**产出**：`04-chapters/vol-{N}/chapter-{XX}.md`\n\n### 阶段 9：整卷校验与蓝本核对\n\n卷内所有章节完成后，执行：\n1. **整卷校验**：通读全卷，检查剧情连贯性、角色一致性、伏笔回收情况\n2. **蓝本核对**：对比蓝本与正文，检查是否偏离预设、是否有遗漏的伏笔/设定\n3. 修正发现的问题\n4. 用户确认本卷定稿\n\n**产出**：修订后的正文 + `06-validation/vol-{N}-validation-report.md`（校验报告）\n\n### 阶段 10：重复阶段 4-9，依次完成各卷\n\n- 按卷编号顺序，重复分卷规划 → 章级蓝本 → 前三章式开篇校验 → 分章撰写 → 整卷校验\n- 每卷完成后锁定，不再修改（除非重大设定变更）\n\n### 阶段 11：全卷并行修订（Sub-Agent 并行，2 遍）\n\n所有卷完成后，使用 Sub-Agent **并行**执行修订：\n- 每个卷由一个 Sub-Agent 独立修订\n- **第 1 遍修订**：逻辑/设定一致性校验 + 剧情润色\n- **第 2 遍修订**：文笔打磨 + 细节完善\n\n**产出**：修订后的各卷正文\n\n### 阶段 12：全文校验（3 遍）\n\n全书完成后，执行全文级别校验：\n- **第 1 遍**：全局一致性校验（人物年龄、关系、能力随章节变化是否合理）\n- **第 2 遍**：剧情连贯性校验（跨卷伏笔、悬念回收、节奏分布）\n- **第 3 遍**：文笔终检（风格统一性、对话差异化、描写质量）\n\n**产出**：全文定稿 + `06-validation/full-book-validation-report.md`\n\n### 阶段 13：存档 v0\n\n全书定稿后，执行第一次完整存档：\n- 按 `references/archive-template.md` 执行 8 步存档流程\n- 存档命名：`[小说标题]_v0/`（v0 表示全书完成的首个存档）\n- 生成人物画像 JSON + HTML 导引页 + 全文合并版\n\n**产出**：`[小说标题]_v0/` 完整存档目录\n\n---\n\n## 注意事项\n\n- 不要在存档版本上做任何编辑\n- 不要在 `在编辑稿/` 之外创建或修改内容\n- 生成存档时确保所有章节都已正确排序和合并\n- 如果用户没有明确要求存档，不要擅自创建 v1/v2/v3 目录\n- **文件编号 = 章编号 = 全局连续三位数，不要每卷从 1 开始**（详见 `references/name-rules.md`）\n- **存档时务必生成人物画像 JSON 和 HTML 导引文件**\n\nFile v1.2.0:references/name-rules.md\n\n# 命名规则（文件编号 = 章编号）\n\n**核心规则：所有章节文件名使用全局连续三位数编号，不随卷重置。**\n\n| 卷 | 章节范围 | 文件名 |\n|----|---------|--------|\n| 卷 1 | 第 1-30 章 | `chapter-001.md` ~ `chapter-030.md` |\n| 卷 2 | 第 31-60 章 | `chapter-031.md` ~ `chapter-060.md` |\n| 卷 3 | 第 61-100 章 | `chapter-061.md` ~ `chapter-100.md` |\n| … | … | … |\n| 卷 N | 最后一卷 | `chapter-XXX.md` |\n\n**关键规则：**\n- ❌ **禁止**每卷内从第 1 章重新开始编号（不要出现卷 1 有 1-30 章、卷 2 也有 1-30 章的情况）\n- ✅ **文件名 = 章编号 = 全局连续三位数**：`chapter-001.md`（第 1 章）、`chapter-300.md`（第 300 章）\n- ✅ 三位数补零：`chapter-001.md`、`chapter-030.md`、`chapter-300.md`\n- ✅ 卷 1 第 1 章 = `chapter-001.md`，卷 2 第 1 章 = `chapter-031.md`（假设卷 1 有 30 章）\n\n**目录内文件命名：**\n\n| 文件 | 命名 |\n|------|------|\n| 总纲 | `03-outline/00-master-outline.md` |\n| 卷级大纲 | `03-outline/vol-{N}-outline.md` |\n| 章级蓝本 | `03-outline/vol-{N}/chapter-{XX}-blueprint.md` |\n| 章节正文 | `04-chapters/vol-{N}/chapter-{XX}.md` |\n| 卷校验报告 | `06-validation/vol-{N}-validation-report.md` |\n| 全书校验报告 | `06-validation/full-book-validation-report.md` |\n| 人物卡 | `references/characters/角色名.md` |\n| 人物关系 | `references/character-relationships.md` |\n| 存档目录 | `[小说标题]_v0/`、`[小说标题]_v1/`、`[小说标题]_v2/`…（按创建顺序递增，只读） |\n\n> 为什么全局连续：打开 `04-chapters/` 文件夹，文件名直接告诉你写到第几章，跨卷也能一眼定位。\"每卷从 1 开始\"是长篇写作最常见的迷路源。\n\nFile v1.2.0:references/project-structure.md\n\n# 小说项目结构\n\n```\n[小说标题]/\n├── 在编辑稿/ ← 所有编辑工作在此目录\n│ ├── 01-story-premise.md # 故事设定\n│ ├── 02-world-setting.md # 世界观设定\n│ ├── 03-chapters-written.md # 章节完成状态\n│ ├── 03-outline/ # 大纲（卷级 + 章级蓝图）\n│ ├── 04-chapters/ # 章节正文（按卷分目录）\n│ ├── 05-reports/ # 过程报告\n│ ├── 06-validation/ # 验证报告\n│ ├── references/ # 参考（人物卡、关系、线索台账）\n│ └── media/ # 图片/media\n├── [小说标题]_v1/ ← 存档版本（只读）\n├── [小说标题]_v2/ ← 存档版本（只读）\n└── ……\n```\n\n## 核心规则\n\n### 所有编辑必须在 在编辑稿 目录上完成\n- 修改章节/大纲/参考文档 → 操作 `在编辑稿/` 下的文件\n- 不要修改 `在编辑稿/` 之外的任何文件\n\n### 存档版本是只读的\n- 禁止在 v1/v2/v3 等存档目录上编辑\n- 用于对比/核对/历史回溯\n- 如需对比先读存档参考，然后改 `在编辑稿/`\n\n### 存档条件\n仅在用户**明确要求**时存档：\n- \"存成 v1\"、\"这是终稿了\"、\"存档\"等\n- 存档命名：`[小说标题]_v1/` → 递增\n\nFile v1.2.0:references/world-setting-template.md\n\n# 世界设定模板\n\n> 复制到 [小说项目目录]/02-world-setting.md 并开始填充\n\n```markdown\n# [世界名称] 设定\n\n## 世界观\n\n### 地理/空间\n- 世界层级：\n- 主要地点：\n- 区域规则：\n\n### 历史/背景\n- 起源：\n- 重大事件：\n- 当前局势：\n\n### 社会/文化\n- 权力结构：\n- 经济体系：\n- 信仰/宗教：\n\n## 力量体系\n\n### 等级\n- 等级 1：[描述]\n- 等级 2：[描述]\n- ...\n\n### 技能\n| 技能名 | 等级 | 效果 | 代价 |\n|--------|------|------|------|\n\n### 规则与限制\n- [限制 1]\n- [限制 2]\n\n## 故事基调\n\n### 核心矛盾\n- \n\n### 主题表达\n- \n\n### 节奏规划\n- 开篇：\n- 总体曲线：\n```\n\nFile v1.2.0:README.zh.md\n\n# epic-novel-writer — 史诗级长篇写作工作流\n\n一个面向长篇连载小说的 AI 驱动创作 SKILL，从世界观设定、人物塑造、章纲规划，到正文写作、版本存档、HTML 导引页生成，覆盖一部小说从零到出版的全生命周期。\n\n**适配篇幅：中篇（10-25 万字）→ 长篇（25-60 万字）→ 超长篇（60-150 万字）**\n> 💡 **实测标杆**：已用于生成 **420,000 字**（300 章，10 卷），验证了全局连续编号、防崩设定体系、HTML 导引页生成在超长篇场景下的可靠性。\n\n## 🚀 为什么需要这个 SKILL？\n\n写小说最难的不是\"开始\"，而是**持续 300 章不崩**。这个 SKILL 解决的是长篇写作中最痛苦的几个问题：\n\n### 1. 文件编号 = 章编号，永远不迷路\n```\nchapter-001.md → 第 1 章\nchapter-150.md → 第 150 章（不管它在哪一卷）\nchapter-300.md → 第 300 章\n```\n**每卷内从 1 重新开始**是每个长篇写作者的噩梦。我们采用**全局连续编号**——文件名即章节号，打开文件夹就知道写到哪了。\n\n### 2. 一键生成专业级存档\n从 `references/archive-template.md` 出发，8 步流程自动生成：\n- ✅ **全文合并版**（md + txt 双格式）\n- ✅ **人物画像 JSON**（char_data.json，含角色名、定位、成长线、首次出场）\n- ✅ **HTML 导引页**（暗色主题、响应式布局、人物卡网格、连续编号章节目录）\n- ✅ **纯文本目录**（章节号 + 超链接）\n\n### 3. 防崩设定体系\n- **世界观模板**（`world-setting-template.md`）— 地理、历史、力量体系、核心矛盾\n- **角色卡片模板**（`character-card-template.md`）— 性格、背景、能力成长弧线、登场退出追踪\n- **章纲模板**（`chapter-blueprint-template.md`）— 每章场景设定、情节大纲、伏笔/线索追踪、技能调用记录\n\n### 4. 只读存档，编辑自由\n所有编辑在 `在编辑稿/` 下完成，存档版本（v1/v2/v3…）**只读**，随时可以对比、回溯、反向合并。\n\n## 📋 包含什么\n\n| 文件 | 用途 |\n|------|------|\n| `SKILL.md` | 核心规则、工作流、命名规范、存档流程指引 |\n| `references/project-structure.md` | 项目目录结构定义 + 核心规则 |\n| `references/lifecycle.md` | 13 阶段完整流程详情（每阶段产出文件） |\n| `references/name-rules.md` | 命名规则（全局连续编号 + 各文件命名表） |\n| `references/archive-template.md` | 版本存档 8 步完整流程（目录结构 + 命令示例 + 检查清单） |\n| `references/world-setting-template.md` | 世界观设定模板（地理/历史/力量体系/节奏规划） |\n| `references/character-card-template.md` | 角色卡片模板（性格/背景/能力成长/登场追踪） |\n| `references/chapter-blueprint-template.md` | 章纲模板（场景/情节/伏笔/技能调用） |\n\n## 🔧 快速开始\n\n### 1. 初始化项目\n\n```bash\nmkdir -p \"我的小说/在编辑稿/{01-story-premise,02-world-setting,03-outline,04-chapters,05-references}\"\n```\n\n### 2. 填写核心设定\n\n从 `references/` 复制模板：\n```bash\ncp references/world-setting-template.md 在编辑稿/02-world-setting.md\ncp references/character-card-template.md 在编辑稿/references/characters/主角.md\n```\n\n### 3. 开始写第一章\n\n```bash\ncp references/chapter-blueprint-template.md 在编辑稿/03-outline/chapter-001-blueprint.md\n# 填写章纲后，在 04-chapters/ 创建 chapter-001.md\n```\n\n### 4. 存档\n\n用户说\"存成 v1\"时：\n```bash\n# 阅读 references/archive-template.md，按 8 步流程执行\n```\n\n## 📐 项目结构\n\n```\n我的小说/\n├── 在编辑稿/ ← 所有编辑在此\n│ ├── 01-story-premise.md # 故事设定\n│ ├── 02-world-setting.md # 世界观\n│ ├── 03-chapters-written.md # 章节状态\n│ ├── 03-outline/ # 大纲\n│ ├── 04-chapters/ # 正文（chapter-001.md ~ chapter-XXX.md）\n│ ├── 05-reports/ # 过程报告\n│ └── references/ # 参考文档\n├── 我的小说_v1/ ← 存档（只读）\n├── 我的小说_v2/ ← 存档（只读）\n└── ……\n```\n\n## ⚠️ 核心规则\n\n1. **所有编辑在 `在编辑稿/` 下完成**，不碰存档目录\n2. **存档版本只读**，用于对比、回溯\n3. **全局连续编号**：`chapter-001.md` = 第 1 章，不随卷重置\n4. **存档时需生成人物画像 JSON + HTML 导引页**\n\n## 📏 适用篇幅\n\n| 篇幅 | 章节数 | 字数范围 | 推荐程度 |\n|------|--------|---------|---------|\n| 中篇 | 30-80 章 | 10-25 万字 | ✅ 完全覆盖 |\n| 长篇 | 80-200 章 | 25-60 万字 | ✅ 完美匹配 |\n| 超长篇 | 200-500 章 | 60-150 万字 | ✅ 完全胜任 |\n\n> 💡 **实测标杆**：本项目已用于生成 **420,000 字**（300 章，10 卷），验证了全局连续编号、防崩设定体系、HTML 导引页生成等核心功能在超长篇场景下的可靠性。\n\n## 🏷️ 适用场景\n\n- 长篇连载小说（100 章+）\n- 网络文学/轻小说/奇幻/科幻\n- AI 辅助写作（大模型生成 + 人工润色）\n- 多人协作（每人在 `在编辑稿/` 下工作，定期存档）\n- 世界观复杂、角色众多的作品\n\n## 📦 安装\n\n```bash\nclawhub install epic-novel-writer\n```\n\n## 🔄 更新\n\n```bash\nclawhub update epic-novel-writer\n```\n\n## 🗂️ 版本记录\n\n| 版本 | 日期 | 变更 |\n|------|------|------|\n| 1.2.0 | 2026-09-13 | SKILL.md frontmatter 补全（name/version/license/中英 description/compatibility/allowed-tools）；新增 `references/lifecycle.md`（13 阶段详情）与 `references/name-rules.md`（命名规则表）；修正子文件表死链；新增 `LICENSE`（BSD 3-Clause）与 `VERSION` 文件；README 双语言文件表同步 |\n| 1.1.2 | 2026-04-27 | Removed unsupported license field from SKILL.md frontmatter (ClawHub CLI v0.8.0 defaults to MIT-0) |\n| 1.1.1 | 2026-04-27 | Fixed license field from BSD-3-Clause to MIT |\n| 1.1.0 | 2026-04-27 | 首次发布：13 阶段写作流程、全局连续编号、只读存档、人物 JSON、HTML 导引页 |\n\n## 📄 协议\n\nBSD 3-Clause License\n\nCopyright (c) 2026, sunshinejnjn@github\n\n---\n\n> 用结构化流程对抗长篇写作的混沌。从第 1 章到第 300 章，每一步都有据可查。\n\nFile v1.2.0:skill-card.md\n\n## Description:\n\nA full workflow for long-form serialized novel writing, covering world-building, character design, chapter planning, manuscript drafting, validation, version archiving, and HTML guide generation.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[sunshinejnjn](https://clawhub.ai/user/sunshinejnjn)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal writers and creative teams use this skill to plan, draft, validate, and archive medium to very long serialized novels. It helps maintain continuity across world settings, character records, outlines, chapters, validation reports, read-only archives, character JSON, and HTML guide pages.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Archive and reverse-merge workflows can copy, merge, or overwrite project files.\n\nMitigation: Use the skill only on a backed-up project directory and require explicit confirmation before archive or restore actions.\n\nRisk: Shell command templates may behave unexpectedly when novel titles or paths contain special characters.\n\nMitigation: Sanitize or quote user-provided titles and paths before running any generated shell command.\n\nRisk: The security review flags the release as suspicious because archive operations combine shell commands with project-wide file changes.\n\nMitigation: Review the archive and reverse-merge steps before installation or operational use.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/sunshinejnjn/skills/epic-novel-writer)\n- [Project structure reference](references/project-structure.md)\n- [Lifecycle reference](references/lifecycle.md)\n- [Naming rules reference](references/name-rules.md)\n- [Archive template](references/archive-template.md)\n- [World setting template](references/world-setting-template.md)\n- [Character card template](references/character-card-template.md)\n- [Chapter blueprint template](references/chapter-blueprint-template.md)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, code, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown manuscripts and planning files, JSON character profiles, HTML guide pages, and shell command snippets.]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Archive and restore actions can modify project-wide files and should be confirmed before execution.]\n\n## Skill Version(s):\n\n1.2.0 (source: server release metadata and SKILL.md frontmatter)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v1.1.2: 9 files, 19787 bytes\n\nFiles: README.md (6965b), README.zh.md (5387b), references/archive-template.md (8261b), references/chapter-blueprint-template.md (889b), references/character-card-template.md (930b), references/world-setting-template.md (678b), skill-card.md (2562b), SKILL.md (14118b), _meta.json (136b)\n\nFile v1.1.2:SKILL.md\n\n---\nname: epic-novel-writer\ndescription: Novel writing full workflow — from world-building and character design to chapter planning, manuscript writing, version archiving, and HTML guide generation. Covers medium (100-250k words) to super-long (600k-1.5m words), proven with 420k words / 300 chapters / 10 volumes. Supports global continuous numbering, read-only archives, character JSON, and HTML guides.\nmetadata:\n openclaw:\n emoji: \"🖊️\"\n version: \"1.1.1\"\ncompatibility: Pure Markdown workflow, no external dependencies. Requires OpenClaw file I/O and shell execution capabilities.\nallowed-tools: Read, Write, Edit, Exec\n---\n\n# epic-novel-writer — 史诗级长篇写作 Skill\n\n---\n\nBSD 3-Clause License\n\nCopyright (c) 2026, sunshinejnjn@github\n\nRedistribution and use in source and binary forms, with or without\nmodification, are permitted provided that the following conditions are met:\n\n1. Redistributions of source code must retain the above copyright notice, this\n list of conditions and the following disclaimer.\n\n2. Redistributions in binary form must reproduce the above copyright notice,\n this list of conditions and the following disclaimer in the documentation\n and/or other materials provided with the distribution.\n\n3. Neither the name of the copyright holder nor the names of its\n contributors may be used to endorse or promote products derived from\n this software without specific prior written permission.\n\nTHIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \"AS IS\"\nAND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE\nIMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE\nDISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE\nFOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL\nDAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR\nSERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER\nCAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,\nOR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE\nOF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n\n## 项目结构\n\n```\n[小说标题]/\n├── 在编辑稿/ ← 所有编辑工作在此目录\n│ ├── 01-story-premise.md # 故事设定\n│ ├── 02-world-setting.md # 世界观设定\n│ ├── 03-chapters-written.md # 章节完成状态\n│ ├── 03-outline/ # 大纲（卷级 + 章级蓝图）\n│ ├── 04-chapters/ # 章节正文（按卷分目录）\n│ ├── 05-reports/ # 过程报告\n│ ├── 06-validation/ # 验证报告\n│ ├── references/ # 参考（人物卡、关系、线索台账）\n│ └── media/ # 图片/media\n├── [小说标题]_v1/ ← 存档版本（只读）\n├── [小说标题]_v2/ ← 存档版本（只读）\n├── [小说标题]_v3/ ← 存档版本（只读）\n└── ……\n```\n\n## ⚠️ 核心规则\n\n### 所有编辑必须在 在编辑稿 目录上完成\n\n- **任何时候**修改章节、大纲、参考文档，操作对象都是 `在编辑稿/` 下的文件\n- 不要修改 `在编辑稿/` 之外的任何文件\n\n### 存档版本（v1/v2/v3...）是只读的\n\n- **禁止**在 v1/v2/v3 等存档目录上做任何编辑\n- 存档版本只用于**对比、核对、历史回溯**\n- 如果需要对比编辑稿和存档，先用存档作为参考，然后修改 在编辑稿 中的内容\n- 违反此规则会导致内容冲突，务必遵守\n\n### 阶段性存档规则\n\n仅在用户**明确要求**某个版本作为阶段性成果时，才创建存档版本：\n- 用户说\"存成 v1\"、\"这是终稿了\"、\"存档\"等类似表述\n- 存档命名：`[小说标题]_v1/`、`[小说标题]_v2/` 等，按创建顺序递增\n\n---\n\n## 📦 版本存档\n\n### 存档流程模板\n\n存档的完整流程定义在以下模板文件中，存档时严格参照执行：\n\n> **模板路径**：`references/archive-template.md`（本 SKILL 内）\n\n该模板包含：\n- 存档目录结构（每个文件的用途）\n- 8 个执行步骤（从创建目录到完成检查）\n- 命名规则（文件编号 = 章编号）\n- 人物画像 JSON 生成指南\n- HTML 导引文件生成要点\n- 反向合并规则\n\n### 存档时的工作方式\n\n1. 先读 `references/archive-template.md` 获取完整流程\n2. 按模板中的步骤逐项执行\n3. 模板中每个步骤都有对应的命令示例，可直接参考执行\n4. 完成后用模板中的「完成检查」清单逐项验证\n\n### 命名规则（文件编号 = 章编号）\n\n> **这是存档流程中的核心规则，已同步到模板中：**\n\n- ❌ **禁止每卷内从第 1 章重新开始编号**（不要出现卷 1 有 1-30 章、卷 2 也有 1-30 章的情况）\n- ✅ **文件名 = 章编号 = 全局连续三位数**：`chapter-001.md`（第 1 章）、`chapter-300.md`（第 300 章）\n- ✅ 卷 1 第 1 章 = `chapter-001.md`，卷 2 第 1 章 = `chapter-031.md`（假设卷 1 有 30 章）\n\n### 人物画像生成\n\n存档时应生成 `char_data.json`，包含主要角色画像：\n\n**主要角色定义**：在正文中出现频率高、推动主线或关键剧情的角色。至少包含：\n- 主角\n- 女主/重要配角\n- 核心死党/对照\n- 关键灵体\n- 关键引导者\n\n**每个角色的画像字段**：\n| 字段 | 说明 |\n|------|------|\n| `name` | 角色名 |\n| `role` | 角色定位（主角/灵体/引导者等） |\n| `portrait` | 角色图片路径（media 目录） |\n| `description` | 简要描述（1-3 句话） |\n| `key_arc` | 角色关键成长线（→ 分隔） |\n| `first_appearance` | 首次出场章节号（如\"第 1 章\"） |\n| `affinity` | 简称/昵称（用于图片文件匹配） |\n\n次要角色（每卷单元灵）可在 `minor_characters` 数组中补充。\n\n### HTML 导引文件\n\n存档时生成 `[小说标题]_导引.html`，这是存档的**核心导航页**：\n\n**页面必须包含四个区域：**\n\n1. **页面头部** — 标题 + 版本 + 统计数据（如\"[小说标题] v3 · N 角色 · M 章\"）\n\n2. **全文简要介绍** — 从 `01-story-premise.md` 和 `02-world-setting.md` 提取，写一段 200-300 字的小说概述，包含核心主题、故事走向、整体氛围\n\n3. **人物卡区域** — 响应式网格，每人一张卡片（图片 + 名字 + 角色定位 + 简述），暗色主题，hover 高亮\n\n4. **章节目录区域** — 按卷分组，**章节号全局连续编号**（不是每卷从 1 开始！），每章超链接指向对应 txt 文件\n\n**样式要求**：\n- 暗色主题（背景 `#0a0a0f`，卡片 `#12121a`）\n- 响应式布局（CSS Grid，移动端适配）\n- 字体：`PingFang SC, Microsoft YaHei, sans-serif`\n- 章节链接 hover 效果\n\n**关键检查**：章节号是否全局连续？每个链接是否能正确导航？\n\n---\n\n## 📐 写作流程（完整生命周期）\n\n> 以下为标准写作流程，按阶段顺序执行。每个阶段输出明确文件，下游阶段依赖上游产出。\n\n### 阶段 1：构思沟通\n\n与用户深入沟通，确定以下核心要素：\n- 故事类型（奇幻/科幻/悬疑/现实/……）\n- 核心主题与想要表达的情感\n- 目标读者群体与文风偏好\n- 预期篇幅（总章数、总字数）\n- 叙事视角（第一人称/第三人称/多视角轮换）\n- 基调（轻松/沉重/悬疑/热血/……）\n\n> **篇幅估算参考**：每章约 4,000 字，每卷约 10 章（~40,000 字）。用户给定总字数后，按此标准反推总章数和卷数。例如：12 万字 → 约 30 章 → 3 卷。\n\n**产出**：`01-story-premise.md`\n\n### 阶段 2：人物设定（含时间线）\n\n根据构思创建角色设定，包含：\n- **主角团**：姓名、年龄、身份、外貌、性格核心、成长弧线、首次出场章\n- **配角群**：核心配角、反派、辅助角色\n- **人物关系**：谁和谁是朋友/敌人/恋人/师徒/对立\n- **时间线**：故事起止时间、关键事件时间锚点、角色年龄变化追踪\n\n**产出**：`references/characters/角色名.md`（每个角色一张卡片）+ `references/character-relationships.md`\n\n### 阶段 3：核对修订人物与时间线（2 遍）\n\n**第 1 遍核对**：\n- 年龄一致性：角色年龄是否随时间线合理变化\n- 关系一致性：A 是 B 的哥哥，B 是 A 的弟弟（双向验证）\n- 首次出场顺序：角色不可能在出场前出现在场景中\n- 时间线逻辑：事件先后顺序是否自洽\n\n**第 2 遍修订**：\n- 根据第 1 遍发现的问题修正\n- 用户确认修改（或自行修正）\n- 最终锁定人物设定与时间线\n\n**产出**：修订后的人物卡片 + 关系表（时间线锁定，后续不再变动基础设定）\n\n### 阶段 4：分卷规划\n\n- 将故事按剧情阶段划分为若干卷\n- 每卷确定：卷编号、卷标题、章节范围、核心冲突、卷内主角弧光\n- 全局章号规划：确定每卷首尾章号（例如卷 1: 001-030，卷 2: 031-060）\n\n**产出**：`03-outline/00-master-outline.md`（总纲）\n\n### 阶段 5：卷级大纲\n\n为每一卷撰写大纲，包含：\n- 卷内章节列表（章号 + 标题 + 简要剧情说明）\n- 卷内节奏规划（开篇/发展/高潮/收尾）\n- 卷内伏笔清单（埋设章节 + 回收章节）\n- 卷内人物变化节点\n\n**产出**：`03-outline/vol-{N}-outline.md`（每卷一个）\n\n### 阶段 6：章级蓝本\n\n为每卷的每一个章节撰写蓝本（blueprint），包含：\n- 场景设定（时间、地点、环境）\n- 出场人物（状态 + 在本章作用）\n- 情节大纲（开场→发展→高潮→收尾，按百分比分配）\n- 关键事件清单\n- 伏笔/线索记录（本章节埋设 + 回收）\n- 技能/设定调用\n\n**产出**：`03-outline/vol-{N}/chapter-{XX}-blueprint.md`（每章一个）\n\n### 阶段 7：撰写前三章（开篇定调）\n\n**先写而非先写全卷**，确保文风和叙事基调正确：\n1. 按章级蓝本撰写第 1-3 章正文\n2. 每章完成后进行 **2 遍校验与润色**：\n - 第 1 遍：逻辑校验（与蓝本是否一致、时间线是否正确）\n - 第 2 遍：文笔润色（节奏、对话、描写质量）\n3. 用户确认前三章定调无误\n\n**产出**：`04-chapters/vol-1/chapter-001.md` ~ `chapter-003.md`（校验润色后的定稿）\n\n### 阶段 8：分卷并行撰写（Sub-Agent 并行）\n\n- 使用 Sub-Agent **并行**撰写同一卷内的各章（而非全卷全章同时，避免上下文过长）\n- 每卷内部章节**按顺序串行**撰写（前一章完成后再写下一章，保证连贯性）\n- 每个 Sub-Agent 负责一个卷内章节，拿到蓝本 + 前文上下文\n- 写完即校验\n\n**产出**：`04-chapters/vol-{N}/chapter-{XX}.md`\n\n### 阶段 9：整卷校验与蓝本核对\n\n卷内所有章节完成后，执行：\n1. **整卷校验**：通读全卷，检查剧情连贯性、角色一致性、伏笔回收情况\n2. **蓝本核对**：对比蓝本与正文，检查是否偏离预设、是否有遗漏的伏笔/设定\n3. 修正发现的问题\n4. 用户确认本卷定稿\n\n**产出**：修订后的正文 + `06-validation/vol-{N}-validation-report.md`（校验报告）\n\n### 阶段 10：重复阶段 4-9，依次完成各卷\n\n- 按卷编号顺序，重复分卷规划 → 章级蓝本 → 前三章式开篇校验 → 分章撰写 → 整卷校验\n- 每卷完成后锁定，不再修改（除非重大设定变更）\n\n### 阶段 11：全卷并行修订（Sub-Agent 并行，2 遍）\n\n所有卷完成后，使用 Sub-Agent **并行**执行修订：\n- 每个卷由一个 Sub-Agent 独立修订\n- **第 1 遍修订**：逻辑/设定一致性校验 + 剧情润色\n- **第 2 遍修订**：文笔打磨 + 细节完善\n\n**产出**：修订后的各卷正文\n\n### 阶段 12：全文校验（3 遍）\n\n全书完成后，执行全文级别校验：\n- **第 1 遍**：全局一致性校验（人物年龄、关系、能力随章节变化是否合理）\n- **第 2 遍**：剧情连贯性校验（跨卷伏笔、悬念回收、节奏分布）\n- **第 3 遍**：文笔终检（风格统一性、对话差异化、描写质量）\n\n**产出**：全文定稿 + `06-validation/full-book-validation-report.md`\n\n### 阶段 13：存档 v0\n\n全书定稿后，执行第一次完整存档：\n- 按 `references/archive-template.md` 执行 8 步存档流程\n- 存档命名：`[小说标题]_v0/`（v0 表示全书完成的首个存档）\n- 生成人物画像 JSON + HTML 导引页 + 全文合并版\n\n**产出**：`[小说标题]_v0/` 完整存档目录\n\n---\n\n## 📏 适用篇幅\n\n| 篇幅 | 章节数 | 字数范围 | 推荐程度 |\n|------|--------|---------|---------|\n| 中篇 | 30-80 章 | 10-25 万字 | ✅ 完全覆盖 |\n| 长篇 | 80-200 章 | 25-60 万字 | ✅ 完美匹配 |\n| 超长篇 | 200-500 章 | 60-150 万字 | ✅ 完全胜任 |\n\n> 💡 **实测标杆**：本项目已用于生成 **420,000 字**（300 章，10 卷），验证了全局连续编号、防崩设定体系、HTML 导引页生成等核心功能在超长篇场景下的可靠性。\n\n## 📏 适用篇幅\n\n| 篇幅 | 章节数 | 字数范围 | 推荐程度 |\n|------|--------|---------|---------|\n| 中篇 | 30-80 章 | 10-25 万字 | ✅ 完全覆盖 |\n| 长篇 | 80-200 章 | 25-60 万字 | ✅ 完美匹配 |\n| 超长篇 | 200-500 章 | 60-150 万字 | ✅ 完全胜任 |\n\n> 💡 **实测标杆**：本项目已用于生成 **420,000 字**（300 章，10 卷），验证了全局连续编号、防崩设定体系、HTML 导引页生成等核心功能在超长篇场景下的可靠性。\n\n## 注意事项\n\n- 不要在存档版本上做任何编辑\n- 不要在 在编辑稿/ 之外创建或修改内容\n- 生成存档时确保所有章节都已正确排序和合并\n- 如果用户没有明确要求存档，不要擅自创建 v1/v2/v3 目录\n- **文件编号 = 章编号 = 全局连续三位数，不要每卷从 1 开始**\n- **存档时务必生成人物画像 JSON 和 HTML 导引文件**\n\nFile v1.1.2:README.md\n\n# epic-novel-writer — Epic Novel Writing Full Workflow\n\n> An AI-driven creative writing SKILL for long-form serialized novels, covering the entire lifecycle from world-building and character design to chapter planning, writing, version archiving, and HTML guide generation.\n\n**Adapted Length: Medium (100-250k words) → Long (250-600k words) → Super Long (600k-1.5m words)**\n> 💡 **Proven Benchmark**: Used to generate **420,000 words** (300 chapters, 10 volumes), validating global chapter numbering, anti-collapse settings system, and HTML guide generation for super-long-form novels.\n\n---\n\n## 🚀 Why This SKILL?\n\nThe hardest part of writing a novel isn't \"starting\" — it's **surviving 300 chapters without things falling apart**. This SKILL solves the most painful problems of long-form writing:\n\n### 1. File Names = Chapter Numbers, Never Get Lost\n```\nchapter-001.md → Chapter 1\nchapter-150.md → Chapter 150 (regardless of which volume)\nchapter-300.md → Chapter 300\n```\n**Restarting from 1 in every volume** is every long-form writer's nightmare. We use **global continuous numbering** — file name IS chapter number, open the folder and you know where you are.\n\n> **文件编号 = 章编号**：`chapter-001.md` 就是第 1 章，`chapter-300.md` 就是第 300 章。不管在哪一卷，文件名直接告诉你章节号。打开文件夹就知道写到哪了。\n\n### 2. One-Click Professional Archive\nFrom `references/archive-template.md`, an 8-step flow auto-generates:\n- ✅ **Full-text merged version** (md + txt dual format)\n- ✅ **Character profile JSON** (char_data.json with name, role, growth arc, first appearance)\n- ✅ **HTML guide page** (dark theme, responsive layout, character card grid, continuous chapter links)\n- ✅ **Plain text table of contents** (chapter numbers + hyperlinks)\n\n> **一键专业存档**：8 步流程自动生成全文合并版（md+txt）、人物画像 JSON、HTML 导引页（暗色主题 + 人物卡网格 + 连续章节链接）、纯文本目录。\n\n### 3. Anti-Collapse Settings System\n- **World-building template** (`world-setting-template.md`) — geography, history, power system, core conflicts\n- **Character card template** (`character-card-template.md`) — personality, background, ability growth arcs, appearance tracking\n- **Chapter blueprint template** (`chapter-blueprint-template.md`) — scene settings, plot outlines, foreshadowing/clue tracking, skill usage records\n\n> **防崩设定体系**：三个模板分别覆盖世界观、角色卡、章纲。章纲模板追踪每章伏笔、线索、技能调用，确保剧情不偏离。\n\n### 4. Read-Only Archives, Free Editing\nAll editing happens in `在编辑稿/` (Work-in-Progress), archive versions (v1/v2/v3…) are **read-only**,可随时对比、回溯、反向合并。\n\n> **只读存档**：所有编辑在 `在编辑稿/` 完成，存档版本（v1/v2/v3…）只读，随时对比、回溯、反向合并。\n\n---\n\n## 📋 Contents\n\n| File | Purpose |\n|------|---------|\n| `SKILL.md` | Core rules, workflow, naming conventions, archive process guide |\n| `references/archive-template.md` | 8-step archive flow (directory structure + command examples + checklists) |\n| `references/world-setting-template.md` | World-building template (geography/history/power system/rhythm planning) |\n| `references/character-card-template.md` | Character card template (personality/background/ability growth/appearance tracking) |\n| `references/chapter-blueprint-template.md` | Chapter blueprint template (scene/plot/foreshadowing/skill usage) |\n\n---\n\n## 🔧 Quick Start\n\n### 1. Initialize Project\n\n```bash\nmkdir -p \"我的小说/在编辑稿/{01-story-premise,02-world-setting,03-outline,04-chapters,05-references}\"\n```\n\n### 2. Fill Core Settings\n\nCopy templates from `references/`:\n```bash\ncp references/world-setting-template.md 在编辑稿/02-world-setting.md\ncp references/character-card-template.md 在编辑稿/references/characters/主角.md\n```\n\n### 3. Start Writing Chapter 1\n\n```bash\ncp references/chapter-blueprint-template.md 在编辑稿/03-outline/chapter-001-blueprint.md\n# Fill blueprint, then create chapter-001.md in 04-chapters/\n```\n\n### 4. Archive\n\nWhen the user says \"存档\" (archive):\n```bash\n# Read references/archive-template.md and execute the 8-step flow\n```\n\n---\n\n## 📐 Project Structure\n\n```\nMyNovel/\n├── 在编辑稿/ ← 所有编辑在此 (all editing happens here)\n│ ├── 01-story-premise.md # 故事设定 (story premise)\n│ ├── 02-world-setting.md # 世界观 (world-building)\n│ ├── 03-chapters-written.md # 章节状态 (chapter status)\n│ ├── 03-outline/ # 大纲 (outlines)\n│ ├── 04-chapters/ # 正文 (manuscript, chapter-001.md ~ chapter-XXX.md)\n│ ├── 05-reports/ # 过程报告 (process reports)\n│ └── references/ # 参考文档 (reference docs)\n├── MyNovel_v1/ ← 存档（只读） (archive, read-only)\n├── MyNovel_v2/ ← 存档（只读） (archive, read-only)\n└── ……\n```\n\n---\n\n## ⚠️ Core Rules\n\n1. **All editing in `在编辑稿/`**, don't touch archive directories\n2. **Archive versions are read-only**, for comparison, tracking\n3. **Global continuous numbering**: `chapter-001.md` = Chapter 1, doesn't reset per volume\n4. **Archive must generate**: Character profile JSON + HTML guide page\n\n> **核心规则**：所有编辑在 `在编辑稿/` 完成；存档只读；文件名=章编号=全局连续；存档必含人物画像 JSON 和 HTML 导引页。\n\n---\n\n## 📏 Suitable Length\n\n| Length | Chapters | Word Count | Fit |\n|--------|----------|------------|-----|\n| Medium (中篇) | 30-80 chapters | 100k-250k words | ✅ Perfect fit |\n| Long (长篇) | 80-200 chapters | 250k-600k words | ✅ Ideal match |\n| Super Long (超长篇) | 200-500 chapters | 600k-1.5m words | ✅ Fully capable |\n\n> 💡 **实测标杆 (Proven Benchmark)**: 已用于生成 **420,000 字**（300 章，10 卷）\n\n**Estimation Reference (篇幅估算参考)**: ~4,000 words/chapter, ~10 chapters/volume (~40,000 words/volume). Given total word count, reverse-calculate chapters and volumes.\n\n---\n\n## 🏷️ Use Cases\n\n- Long-form serialized novels (100+ chapters)\n- Web novels / light novels / fantasy / sci-fi\n- AI-assisted writing (LLM generation + human polishing)\n- Multi-person collaboration (each works in `在编辑稿/`, archives regularly)\n- Complex world-building, many characters\n\n---\n\n## 📦 Installation\n\n```bash\nclawhub install epic-novel-writer\n```\n\n## 🔄 Update\n\n```bash\nclawhub update epic-novel-writer\n```\n\n## 📄 License\n\nBSD 3-Clause License\n\nCopyright (c) 2026, sunshinejnjn@github\n\n---\n\n> 用结构化流程对抗长篇写作的混沌。从第 1 章到第 300 章，每一步都有据可查。\n> **Structure the chaos of long-form writing. Every chapter, every step, traceable.**\n\nFile v1.1.2:_meta.json\n\n{\n \"ownerId\": \"kn7dn131pvgfaveyzzzcrc5xf182yb84\",\n \"slug\": \"epic-novel-writer\",\n \"version\": \"1.1.2\",\n \"publishedAt\": 1777319551468\n}\n\nFile v1.1.2:references/archive-template.md\n\n# 版本存档模板\n\n> 本模板定义了版本存档的标准流程与输出结构。存档时参照此模板执行，生成新的 `[小说标题]_vN/` 目录。\n\n---\n\n## 存档触发条件\n\n仅在用户**明确要求**时执行存档：\n- 用户说\"存成 vN\"、\"这是终稿了\"、\"存档\"等类似表述\n- 按创建顺序递增命名：`[小说标题]_v1/`、`[小说标题]_v2/`…\n\n---\n\n## 命名规则（文件编号 = 章编号）\n\n**所有章节文件名使用全局连续三位数编号，不随卷重置：**\n\n| 卷 | 章节范围 | 文件名 |\n|----|---------|--------|\n| 卷 1 | 第 1-30 章 | `chapter-001.md` ~ `chapter-030.md` |\n| 卷 2 | 第 31-60 章 | `chapter-031.md` ~ `chapter-060.md` |\n| 卷 3 | 第 61-100 章 | `chapter-061.md` ~ `chapter-100.md` |\n| … | … | … |\n| 卷 N | 最后一卷 | `chapter-XXX.md` |\n\n**关键规则：**\n- ❌ 禁止每卷内从第 1 章重新开始编号（不要出现卷 1 有 1-30 章、卷 2 也有 1-30 章的情况）\n- ✅ 文件名直接反映全局章号：`chapter-031.md` = 第 31 章，`chapter-271.md` = 第 271 章\n- ✅ 三位数补零：`chapter-001.md`、`chapter-300.md`\n\n---\n\n## 存档目录结构\n\n```\n[小说标题]_vN/\n├── 01-story-premise.md # 故事设定（复制）\n├── 02-world-setting.md # 世界观设定（复制）\n├── 03-chapters-written.md # 章节完成状态（复制，反映存档时进度）\n├── 03-outline/ # 大纲目录（复制）\n│ ├── 00-master-outline.md\n│ ├── vol-1-outline.md\n│ └── ……\n├── 04-chapters/ # 正文文件（txt，按卷分目录）\n│ ├── vol-1/\n│ │ ├── chapter-001.txt\n│ │ ├── chapter-002.txt\n│ │ └── ……\n│ ├── vol-2/\n│ │ ├── chapter-031.txt\n│ │ └── ……\n│ └── ……\n├── 05-reports/ # 过程报告（复制）\n├── references/ # 参考文件（复制）\n│ ├── ai-ledger/\n│ ├── character-relationships.md\n│ ├── characters/\n│ └── skill-database.md\n├── media/ # 图片（复制）\n│ └── comfyui/images/\n│ └── ……\n├── [小说标题]_全文.md # 全文合并版（md）\n├── [小说标题]_全文.txt # 全文合并版（纯文本）\n├── [小说标题]_目录.txt # 纯文本目录导航\n├── [小说标题]_导引.html # ★ HTML 导引文件（核心导航页）\n└── char_data.json # 人物数据（JSON，供导引页使用）\n```\n\n---\n\n## 执行步骤\n\n### 步骤 1：创建存档目录\n\n```bash\nN=下一个序号（从现有最大序号 +1）\nmkdir -p \"[小说标题]_v${N}/\"\n```\n\n### 步骤 2：复制只读文件\n\n将 `在编辑稿/` 下的非正文文件原样复制到存档目录：\n\n```bash\ncd \"[小说标题]_v${N}/\"\n# 复制根文件\ncp ../在编辑稿/01-story-premise.md ./\ncp ../在编辑稿/02-world-setting.md ./\ncp ../在编辑稿/03-chapters-written.md ./\n\n# 复制大纲目录\ncp -r ../在编辑稿/03-outline/ ./\n\n# 复制参考文件\ncp -r ../在编辑稿/references/ ./\ncp -r ../在编辑稿/media/ ./\n\n# 复制报告\ncp -r ../在编辑稿/05-reports/ ./\n```\n\n### 步骤 3：复制正文为 txt\n\n`在编辑稿/04-chapters/` 下所有章节已使用全局连续三位数编号，直接转为 txt 复制：\n\n```bash\nmkdir -p chapters\nfor vol_dir in ../在编辑稿/04-chapters/vol-*; do\n vol_num=$(basename \"$vol_dir\")\n mkdir -p \"chapters/${vol_num}\"\n for chapter_file in \"$vol_dir\"/*.md; do\n # 文件名已是全局连续三位数（chapter-NNN.md），直接转换格式\n sed 's/^#\\+ //; s/`//g; s/\\*\\*/\\n/g' \"$chapter_file\" > \"chapters/${vol_num}/$(basename \"$chapter_file\" .md).txt\"\n done\ndone\n```\n\n### 步骤 4：生成全文合并版\n\n将 `chapters/vol-*/chapter-*.txt` 按**全局章节号**顺序合并：\n\n```bash\n# 按卷 + 章号排序后合并（文件名已是三位数全局连续编号）\ncat chapters/vol-*/chapter-*.txt > [小说标题]_全文.txt\n```\n\n**文件名 = 章编号 = 全局连续三位数**：`chapter-001.txt`（第 1 章）、`chapter-300.txt`（第 300 章），不随卷重置。\n\n### 步骤 5：生成目录\n\n生成 `[小说标题]_目录.txt`，格式：\n\n```\n# [小说标题] 目录 — vN\n\n## 第 001 章 [章节标题] → chapters/vol-1/chapter-001.txt\n## 第 002 章 [章节标题] → chapters/vol-1/chapter-002.txt\n……\n## 第 300 章 [章节标题] → chapters/vol-10/chapter-300.txt\n```\n\n**关键：章节号全局连续编号，不随卷重置。**\n- 卷 1 第 1 章 = 第 001 章\n- 卷 2 第 1 章 = 第 031 章（如果卷 1 有 30 章）\n- 卷 10 第 1 章 = 第 271 章（以此类推）\n\n### 步骤 6：生成人物画像 JSON\n\n扫描所有章节，提取**主要角色画像**，生成 `char_data.json`：\n\n```json\n{\n \"project\": \"[小说标题]\",\n \"version\": \"vN\",\n \"total_chapters\": 300,\n \"characters\": [\n {\n \"name\": \"主角名\",\n \"role\": \"主角\",\n \"portrait\": \"media/comfyui/images/主角图片.png\",\n \"description\": \"主角的简要描述\",\n \"key_arc\": \"成长线 1 → 成长线 2\",\n \"first_appearance\": \"第 1 章\",\n \"affinity\": \"主角简称\"\n }\n ]\n}\n```\n\n**生成规则：**\n- **主要角色**：指在正文中出现频率高、推动主线/关键剧情的角色\n- 至少包含：主角、女主/重要配角、核心灵体、关键引导者\n- 次要角色（每卷单元灵）可在 `char_data.json` 中以 `minor_characters` 字段补充\n\n### 步骤 7：生成 HTML 导引文件\n\n生成 `[小说标题]_导引.html`，要求：\n\n#### 页面结构\n\n1. **页面头部**\n - 小说标题 + 版本信息 + 统计数据\n - 示例：`[小说标题] v3 · 12 角色 · 300 章`\n\n2. **全文简要介绍**\n - 一段对整个小说的简要概述（200-300 字）\n - 包含核心主题、故事走向、整体氛围\n - 从 `01-story-premise.md` 和 `02-world-setting.md` 提取\n\n3. **人物卡区域**\n - 响应式网格布局（CSS Grid）\n - 每人一张卡片，包含：\n - 角色图片（`portrait` 字段）\n - 角色名 + 角色定位（如\"主角\"、\"灵体\"）\n - 简要描述（1-2 句话）\n - 暗色主题，hover 高亮边框\n\n4. **章节目录区域**\n - 按卷分组，每卷一个区块\n - **章节号全局连续编号**（关键要求）\n - 每章一个超链接指向 `chapters/vol-X/chapter-NNN.txt`\n - 格式：`第 001 章 [标题]`\n\n5. **页脚**\n - 版本信息、生成时间、统计数据\n\n#### 章节编号规则（非常重要）\n\n- ❌ **禁止**：每卷内从第 1 章重新开始编号\n- ✅ **必须**：全局连续编号（卷 1 第 1 章 = 第 001 章，卷 10 第 1 章 = 第 271 章）\n- 编号格式：三位数（第 001 章、第 300 章）\n- HTML 目录中显示为 `第 001 章 · 章节标题`\n\n#### 样式要求\n\n- 暗色主题（背景 `#0a0a0f`，卡片 `#12121a`）\n- 响应式布局（CSS Grid，移动端适配）\n- 字体：`PingFang SC, Microsoft YaHei, sans-serif`\n- 章节链接 hover 效果\n\n### 步骤 8：完成检查\n\n存档完成后验证：\n- [ ] 所有章节已提取为 txt\n- [ ] 全文合并版完整（无缺失、无重复）\n- [ ] 目录章节号全局连续\n- [ ] HTML 导引页人物卡完整\n- [ ] HTML 导引页章节链接全部有效\n- [ ] 全文介绍已添加\n- [ ] 存档目录内无可编辑文件（只读确认）\n\n---\n\n## 反向合并\n\n当存档版本与 `在编辑稿` 不一致时：\n\n1. 先确认以哪个版本为准\n2. **以 `在编辑稿` 为准**：不需要反向合并\n3. **以存档版为准**：将存档版全文按章节拆分，覆盖 `在编辑稿/04-chapters/` 中的对应文件\n\n---\n\n## 注意事项\n\n- ❌ 不要在存档版本上做任何编辑\n- ❌ 不要在 `在编辑稿/` 之外创建或修改内容\n- ✅ 生成存档时确保所有章节已正确排序和合并\n- ✅ 如果用户没有明确要求存档，不要擅自创建 vN 目录\n- ✅ **文件编号 = 章编号 = 全局连续三位数**，不要每卷从 1 开始\n- ✅ HTML 导引文件必须包含：人物卡 + 全文介绍 + 连续编号章节目录\n\nFile v1.1.2:references/chapter-blueprint-template.md\n\n# 章纲模板\n\n> 复制到 [小说项目目录]/03-outline/vol-{N}/chapter-{XX}-blueprint.md\n\n```markdown\n# 第 [X] 章：[章名]\n\n## 基本信息\n- **位置**: 第 [X] 章（卷 [N] 第 [M] 章）\n- **字数目标**: ~1500 字\n- **视角**: [主角/其他角色]\n\n## 场景设定\n- **时间**: \n- **地点**: \n- **天气/环境**: \n\n## 出场人物\n- [角色名]：状态 + 在本章的作用\n\n## 情节大纲\n1. **开场**（~10%）：[快速交代时间/地点/人物状态]\n2. **发展**（~40%）：[核心冲突逐步展开]\n3. **高潮**（~30%）：[冲突爆发/关键转折]\n4. **收尾**（~20%）：[情绪沉淀 + 下章钩子]\n\n## 关键事件\n- [事件 1]\n- [事件 2]\n\n## 伏笔/线索\n- [埋下的伏笔 → 预计在第 X 章回收]\n\n## 技能/设定调用\n- [本章节需要展示/用到的设定]\n\n## 注意事项\n- [遵守的设定限制]\n- [不能做的事情]\n```\n\nFile v1.1.2:references/character-card-template.md\n\n# 角色卡片模板\n\n> 复制此模板创建新角色卡，保存到 [小说项目目录]/references/characters/\n\n```markdown\n# 角色名\n\n## 基本信息\n- **身份**: \n- **年龄**: \n- **性别**: \n- **外貌**: \n- **口头禅/说话风格**: \n\n## 性格\n- **核心性格**: \n- **优点**: \n- **缺点/弱点**: \n- **内在冲突**: \n\n## 背景故事\n- **成长经历**: \n- **动机**: \n- **秘密**: \n- **人际关系**: \n - 与 [角色名] 的关系：\n\n## 能力/技能\n- **初始能力**: \n- **技能变化节点**:\n - 第 X 章：获得 XX 技能\n - 第 Y 章：技能升级/蜕变\n\n## 成长弧线\n- **起点状态**: \n- **转折点**: \n- **终点状态**: \n- **可能的黑化/反转**: \n\n## 登场与退出\n- **首次登场**: 第 [X] 章\n- **最后登场**: 第 [X] 章\n- **缺席期间**: 第 [X] 至 [Y] 章\n\n## 状态追踪\n- **当前状态**: \n- **当前位置**: \n- **当前目标**: \n- **携带物品**: \n```\n\nFile v1.1.2:references/world-setting-template.md\n\n# 世界设定模板\n\n> 复制到 [小说项目目录]/02-world-setting.md 并开始填充\n\n```markdown\n# [世界名称] 设定\n\n## 世界观\n\n### 地理/空间\n- 世界层级：\n- 主要地点：\n- 区域规则：\n\n### 历史/背景\n- 起源：\n- 重大事件：\n- 当前局势：\n\n### 社会/文化\n- 权力结构：\n- 经济体系：\n- 信仰/宗教：\n\n## 力量体系\n\n### 等级\n- 等级 1：[描述]\n- 等级 2：[描述]\n- ...\n\n### 技能\n| 技能名 | 等级 | 效果 | 代价 |\n|--------|------|------|------|\n\n### 规则与限制\n- [限制 1]\n- [限制 2]\n\n## 故事基调\n\n### 核心矛盾\n- \n\n### 主题表达\n- \n\n### 节奏规划\n- 开篇：\n- 总体曲线：\n```\n\nFile v1.1.2:README.zh.md\n\n# epic-novel-writer — 史诗级长篇写作工作流\n\n一个面向长篇连载小说的 AI 驱动创作 SKILL，从世界观设定、人物塑造、章纲规划，到正文写作、版本存档、HTML 导引页生成，覆盖一部小说从零到出版的全生命周期。\n\n**适配篇幅：中篇（10-25 万字）→ 长篇（25-60 万字）→ 超长篇（60-150 万字）**\n> 💡 **实测标杆**：已用于生成 **420,000 字**（300 章，10 卷），验证了全局连续编号、防崩设定体系、HTML 导引页生成在超长篇场景下的可靠性。\n\n## 🚀 为什么需要这个 SKILL？\n\n写小说最难的不是\"开始\"，而是**持续 300 章不崩**。这个 SKILL 解决的是长篇写作中最痛苦的几个问题：\n\n### 1. 文件编号 = 章编号，永远不迷路\n```\nchapter-001.md → 第 1 章\nchapter-150.md → 第 150 章（不管它在哪一卷）\nchapter-300.md → 第 300 章\n```\n**每卷内从 1 重新开始**是每个长篇写作者的噩梦。我们采用**全局连续编号**——文件名即章节号，打开文件夹就知道写到哪了。\n\n### 2. 一键生成专业级存档\n从 `references/archive-template.md` 出发，8 步流程自动生成：\n- ✅ **全文合并版**（md + txt 双格式）\n- ✅ **人物画像 JSON**（char_data.json，含角色名、定位、成长线、首次出场）\n- ✅ **HTML 导引页**（暗色主题、响应式布局、人物卡网格、连续编号章节目录）\n- ✅ **纯文本目录**（章节号 + 超链接）\n\n### 3. 防崩设定体系\n- **世界观模板**（`world-setting-template.md`）— 地理、历史、力量体系、核心矛盾\n- **角色卡片模板**（`character-card-template.md`）— 性格、背景、能力成长弧线、登场退出追踪\n- **章纲模板**（`chapter-blueprint-template.md`）— 每章场景设定、情节大纲、伏笔/线索追踪、技能调用记录\n\n### 4. 只读存档，编辑自由\n所有编辑在 `在编辑稿/` 下完成，存档版本（v1/v2/v3…）**只读**，随时可以对比、回溯、反向合并。\n\n## 📋 包含什么\n\n| 文件 | 用途 |\n|------|------|\n| `SKILL.md` | 核心规则、工作流、命名规范、存档流程指引 |\n| `references/archive-template.md` | 版本存档 8 步完整流程（目录结构 + 命令示例 + 检查清单） |\n| `references/world-setting-template.md` | 世界观设定模板（地理/历史/力量体系/节奏规划） |\n| `references/character-card-template.md` | 角色卡片模板（性格/背景/能力成长/登场追踪） |\n| `references/chapter-blueprint-template.md` | 章纲模板（场景/情节/伏笔/技能调用） |\n\n## 🔧 快速开始\n\n### 1. 初始化项目\n\n```bash\nmkdir -p \"我的小说/在编辑稿/{01-story-premise,02-world-setting,03-outline,04-chapters,05-references}\"\n```\n\n### 2. 填写核心设定\n\n从 `references/` 复制模板：\n```bash\ncp references/world-setting-template.md 在编辑稿/02-world-setting.md\ncp references/character-card-template.md 在编辑稿/references/characters/主角.md\n```\n\n### 3. 开始写第一章\n\n```bash\ncp references/chapter-blueprint-template.md 在编辑稿/03-outline/chapter-001-blueprint.md\n# 填写章纲后，在 04-chapters/ 创建 chapter-001.md\n```\n\n### 4. 存档\n\n用户说\"存成 v1\"时：\n```bash\n# 阅读 references/archive-template.md，按 8 步流程执行\n```\n\n## 📐 项目结构\n\n```\n我的小说/\n├── 在编辑稿/ ← 所有编辑在此\n│ ├── 01-story-premise.md # 故事设定\n│ ├── 02-world-setting.md # 世界观\n│ ├── 03-chapters-written.md # 章节状态\n│ ├── 03-outline/ # 大纲\n│ ├── 04-chapters/ # 正文（chapter-001.md ~ chapter-XXX.md）\n│ ├── 05-reports/ # 过程报告\n│ └── references/ # 参考文档\n├── 我的小说_v1/ ← 存档（只读）\n├── 我的小说_v2/ ← 存档（只读）\n└── ……\n```\n\n## ⚠️ 核心规则\n\n1. **所有编辑在 `在编辑稿/` 下完成**，不碰存档目录\n2. **存档版本只读**，用于对比、回溯\n3. **全局连续编号**：`chapter-001.md` = 第 1 章，不随卷重置\n4. **存档时需生成人物画像 JSON + HTML 导引页**\n\n## 📏 适用篇幅\n\n| 篇幅 | 章节数 | 字数范围 | 推荐程度 |\n|------|--------|---------|---------|\n| 中篇 | 30-80 章 | 10-25 万字 | ✅ 完全覆盖 |\n| 长篇 | 80-200 章 | 25-60 万字 | ✅ 完美匹配 |\n| 超长篇 | 200-500 章 | 60-150 万字 | ✅ 完全胜任 |\n\n> 💡 **实测标杆**：本项目已用于生成 **420,000 字**（300 章，10 卷），验证了全局连续编号、防崩设定体系、HTML 导引页生成等核心功能在超长篇场景下的可靠性。\n\n## 🏷️ 适用场景\n\n- 长篇连载小说（100 章+）\n- 网络文学/轻小说/奇幻/科幻\n- AI 辅助写作（大模型生成 + 人工润色）\n- 多人协作（每人在 `在编辑稿/` 下工作，定期存档）\n- 世界观复杂、角色众多的作品\n\n## 📦 安装\n\n```bash\nclawhub install epic-novel-writer\n```\n\n## 🔄 更新\n\n```bash\nclawhub update epic-novel-writer\n```\n\n## 📄 协议\n\nBSD 3-Clause License\n\nCopyright (c) 2026, sunshinejnjn@github\n\n---\n\n> 用结构化流程对抗长篇写作的混沌。从第 1 章到第 300 章，每一步都有据可查。\n\nFile v1.1.2:skill-card.md\n\n## Description:
\nNovel writing full workflow from world-building and character design to chapter planning, manuscript writing, version archiving, and HTML guide generation for medium to super-long novels.
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[sunshinejnjn](https://clawhub.ai/user/sunshinejnjn)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nExternal writers and creative-writing agents use this skill to plan, draft, validate, and archive long-form serialized novels with consistent world-building, character records, chapter blueprints, and continuous chapter numbering.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: The skill edits project files and may create archive/version folders as part of the writing workflow.
\nMitigation: Run it inside a project-specific directory and confirm archive creation before allowing baseline or version folders to be generated.
\nRisk: Novel planning, drafting, and validation guidance can introduce continuity, style, or factual errors into long manuscripts.
\nMitigation: Review generated outlines, chapters, reports, character JSON, and HTML guides before treating them as final.
\n\n\n## Reference(s):
\n- [ClawHub skill page](https://clawhub.ai/sunshinejnjn/epic-novel-writer)
\n- [Publisher profile](https://clawhub.ai/user/sunshinejnjn)
\n- [Archive workflow template](artifact/references/archive-template.md)
\n- [Chapter blueprint template](artifact/references/chapter-blueprint-template.md)
\n- [Character card template](artifact/references/character-card-template.md)
\n- [World setting template](artifact/references/world-setting-template.md)
\n\n\n## Skill Output:
\n**Output Type(s):** [text, markdown, code, shell commands, configuration, guidance]
\n**Output Format:** [Markdown guidance with project files, shell command examples, character JSON, and HTML archive guide output]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Uses a project work-in-progress directory for edits and creates read-only archive/version folders only when explicitly requested.]
\n\n## Skill Version(s):
\n1.1.2 (source: server release metadata)
\n\n## Ethical Considerations:
\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
\n\nArchive v1.1.1: 8 files, 18541 bytes\n\nFiles: README.md (6956b), README.zh.md (5387b), references/archive-template.md (8261b), references/chapter-blueprint-template.md (889b), references/character-card-template.md (930b), references/world-setting-template.md (678b), SKILL.md (14131b), _meta.json (136b)\n\nFile v1.1.1:SKILL.md\n\n---\nname: epic-novel-writer\ndescription: Novel writing full workflow — from world-building and character design to chapter planning, manuscript writing, version archiving, and HTML guide generation. Covers medium (100-250k words) to super-long (600k-1.5m words), proven with 420k words / 300 chapters / 10 volumes. Supports global continuous numbering, read-only archives, character JSON, and HTML guides.\nmetadata:\n openclaw:\n emoji: \"🖊️\"\n version: \"1.1.1\"\nlicense: MIT\ncompatibility: Pure Markdown workflow, no external dependencies. Requires OpenClaw file I/O and shell execution capabilities.\nallowed-tools: Read, Write, Edit, Exec\n---\n\n# epic-novel-writer — 史诗级长篇写作 Skill\n\n---\n\nBSD 3-Clause License\n\nCopyright (c) 2026, sunshinejnjn@github\n\nRedistribution and use in source and binary forms, with or without\nmodification, are permitted provided that the following conditions are met:\n\n1. Redistributions of source code must retain the above copyright notice, this\n list of conditions and the following disclaimer.\n\n2. Redistributions in binary form must reproduce the above copyright notice,\n this list of conditions and the following disclaimer in the documentation\n and/or other materials provided with the distribution.\n\n3. Neither the name of the copyright holder nor the names of its\n contributors may be used to endorse or promote products derived from\n this software without specific prior written permission.\n\nTHIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \"AS IS\"\nAND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE\nIMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE\nDISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE\nFOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL\nDAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR\nSERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER\nCAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,\nOR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE\nOF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n\n## 项目结构\n\n```\n[小说标题]/\n├── 在编辑稿/ ← 所有编辑工作在此目录\n│ ├── 01-story-premise.md # 故事设定\n│ ├── 02-world-setting.md # 世界观设定\n│ ├── 03-chapters-written.md # 章节完成状态\n│ ├── 03-outline/ # 大纲（卷级 + 章级蓝图）\n│ ├── 04-chapters/ # 章节正文（按卷分目录）\n│ ├── 05-reports/ # 过程报告\n│ ├── 06-validation/ # 验证报告\n│ ├── references/ # 参考（人物卡、关系、线索台账）\n│ └── media/ # 图片/media\n├── [小说标题]_v1/ ← 存档版本（只读）\n├── [小说标题]_v2/ ← 存档版本（只读）\n├── [小说标题]_v3/ ← 存档版本（只读）\n└── ……\n```\n\n## ⚠️ 核心规则\n\n### 所有编辑必须在 在编辑稿 目录上完成\n\n- **任何时候**修改章节、大纲、参考文档，操作对象都是 `在编辑稿/` 下的文件\n- 不要修改 `在编辑稿/` 之外的任何文件\n\n### 存档版本（v1/v2/v3...）是只读的\n\n- **禁止**在 v1/v2/v3 等存档目录上做任何编辑\n- 存档版本只用于**对比、核对、历史回溯**\n- 如果需要对比编辑稿和存档，先用存档作为参考，然后修改 在编辑稿 中的内容\n- 违反此规则会导致内容冲突，务必遵守\n\n### 阶段性存档规则\n\n仅在用户**明确要求**某个版本作为阶段性成果时，才创建存档版本：\n- 用户说\"存成 v1\"、\"这是终稿了\"、\"存档\"等类似表述\n- 存档命名：`[小说标题]_v1/`、`[小说标题]_v2/` 等，按创建顺序递增\n\n---\n\n## 📦 版本存档\n\n### 存档流程模板\n\n存档的完整流程定义在以下模板文件中，存档时严格参照执行：\n\n> **模板路径**：`references/archive-template.md`（本 SKILL 内）\n\n该模板包含：\n- 存档目录结构（每个文件的用途）\n- 8 个执行步骤（从创建目录到完成检查）\n- 命名规则（文件编号 = 章编号）\n- 人物画像 JSON 生成指南\n- HTML 导引文件生成要点\n- 反向合并规则\n\n### 存档时的工作方式\n\n1. 先读 `references/archive-template.md` 获取完整流程\n2. 按模板中的步骤逐项执行\n3. 模板中每个步骤都有对应的命令示例，可直接参考执行\n4. 完成后用模板中的「完成检查」清单逐项验证\n\n### 命名规则（文件编号 = 章编号）\n\n> **这是存档流程中的核心规则，已同步到模板中：**\n\n- ❌ **禁止每卷内从第 1 章重新开始编号**（不要出现卷 1 有 1-30 章、卷 2 也有 1-30 章的情况）\n- ✅ **文件名 = 章编号 = 全局连续三位数**：`chapter-001.md`（第 1 章）、`chapter-300.md`（第 300 章）\n- ✅ 卷 1 第 1 章 = `chapter-001.md`，卷 2 第 1 章 = `chapter-031.md`（假设卷 1 有 30 章）\n\n### 人物画像生成\n\n存档时应生成 `char_data.json`，包含主要角色画像：\n\n**主要角色定义**：在正文中出现频率高、推动主线或关键剧情的角色。至少包含：\n- 主角\n- 女主/重要配角\n- 核心死党/对照\n- 关键灵体\n- 关键引导者\n\n**每个角色的画像字段**：\n| 字段 | 说明 |\n|------|------|\n| `name` | 角色名 |\n| `role` | 角色定位（主角/灵体/引导者等） |\n| `portrait` | 角色图片路径（media 目录） |\n| `description` | 简要描述（1-3 句话） |\n| `key_arc` | 角色关键成长线（→ 分隔） |\n| `first_appearance` | 首次出场章节号（如\"第 1 章\"） |\n| `affinity` | 简称/昵称（用于图片文件匹配） |\n\n次要角色（每卷单元灵）可在 `minor_characters` 数组中补充。\n\n### HTML 导引文件\n\n存档时生成 `[小说标题]_导引.html`，这是存档的**核心导航页**：\n\n**页面必须包含四个区域：**\n\n1. **页面头部** — 标题 + 版本 + 统计数据（如\"[小说标题] v3 · N 角色 · M 章\"）\n\n2. **全文简要介绍** — 从 `01-story-premise.md` 和 `02-world-setting.md` 提取，写一段 200-300 字的小说概述，包含核心主题、故事走向、整体氛围\n\n3. **人物卡区域** — 响应式网格，每人一张卡片（图片 + 名字 + 角色定位 + 简述），暗色主题，hover 高亮\n\n4. **章节目录区域** — 按卷分组，**章节号全局连续编号**（不是每卷从 1 开始！），每章超链接指向对应 txt 文件\n\n**样式要求**：\n- 暗色主题（背景 `#0a0a0f`，卡片 `#12121a`）\n- 响应式布局（CSS Grid，移动端适配）\n- 字体：`PingFang SC, Microsoft YaHei, sans-serif`\n- 章节链接 hover 效果\n\n**关键检查**：章节号是否全局连续？每个链接是否能正确导航？\n\n---\n\n## 📐 写作流程（完整生命周期）\n\n> 以下为标准写作流程，按阶段顺序执行。每个阶段输出明确文件，下游阶段依赖上游产出。\n\n### 阶段 1：构思沟通\n\n与用户深入沟通，确定以下核心要素：\n- 故事类型（奇幻/科幻/悬疑/现实/……）\n- 核心主题与想要表达的情感\n- 目标读者群体与文风偏好\n- 预期篇幅（总章数、总字数）\n- 叙事视角（第一人称/第三人称/多视角轮换）\n- 基调（轻松/沉重/悬疑/热血/……）\n\n> **篇幅估算参考**：每章约 4,000 字，每卷约 10 章（~40,000 字）。用户给定总字数后，按此标准反推总章数和卷数。例如：12 万字 → 约 30 章 → 3 卷。\n\n**产出**：`01-story-premise.md`\n\n### 阶段 2：人物设定（含时间线）\n\n根据构思创建角色设定，包含：\n- **主角团**：姓名、年龄、身份、外貌、性格核心、成长弧线、首次出场章\n- **配角群**：核心配角、反派、辅助角色\n- **人物关系**：谁和谁是朋友/敌人/恋人/师徒/对立\n- **时间线**：故事起止时间、关键事件时间锚点、角色年龄变化追踪\n\n**产出**：`references/characters/角色名.md`（每个角色一张卡片）+ `references/character-relationships.md`\n\n### 阶段 3：核对修订人物与时间线（2 遍）\n\n**第 1 遍核对**：\n- 年龄一致性：角色年龄是否随时间线合理变化\n- 关系一致性：A 是 B 的哥哥，B 是 A 的弟弟（双向验证）\n- 首次出场顺序：角色不可能在出场前出现在场景中\n- 时间线逻辑：事件先后顺序是否自洽\n\n**第 2 遍修订**：\n- 根据第 1 遍发现的问题修正\n- 用户确认修改（或自行修正）\n- 最终锁定人物设定与时间线\n\n**产出**：修订后的人物卡片 + 关系表（时间线锁定，后续不再变动基础设定）\n\n### 阶段 4：分卷规划\n\n- 将故事按剧情阶段划分为若干卷\n- 每卷确定：卷编号、卷标题、章节范围、核心冲突、卷内主角弧光\n- 全局章号规划：确定每卷首尾章号（例如卷 1: 001-030，卷 2: 031-060）\n\n**产出**：`03-outline/00-master-outline.md`（总纲）\n\n### 阶段 5：卷级大纲\n\n为每一卷撰写大纲，包含：\n- 卷内章节列表（章号 + 标题 + 简要剧情说明）\n- 卷内节奏规划（开篇/发展/高潮/收尾）\n- 卷内伏笔清单（埋设章节 + 回收章节）\n- 卷内人物变化节点\n\n**产出**：`03-outline/vol-{N}-outline.md`（每卷一个）\n\n### 阶段 6：章级蓝本\n\n为每卷的每一个章节撰写蓝本（blueprint），包含：\n- 场景设定（时间、地点、环境）\n- 出场人物（状态 + 在本章作用）\n- 情节大纲（开场→发展→高潮→收尾，按百分比分配）\n- 关键事件清单\n- 伏笔/线索记录（本章节埋设 + 回收）\n- 技能/设定调用\n\n**产出**：`03-outline/vol-{N}/chapter-{XX}-blueprint.md`（每章一个）\n\n### 阶段 7：撰写前三章（开篇定调）\n\n**先写而非先写全卷**，确保文风和叙事基调正确：\n1. 按章级蓝本撰写第 1-3 章正文\n2. 每章完成后进行 **2 遍校验与润色**：\n - 第 1 遍：逻辑校验（与蓝本是否一致、时间线是否正确）\n - 第 2 遍：文笔润色（节奏、对话、描写质量）\n3. 用户确认前三章定调无误\n\n**产出**：`04-chapters/vol-1/chapter-001.md` ~ `chapter-003.md`（校验润色后的定稿）\n\n### 阶段 8：分卷并行撰写（Sub-Agent 并行）\n\n- 使用 Sub-Agent **并行**撰写同一卷内的各章（而非全卷全章同时，避免上下文过长）\n- 每卷内部章节**按顺序串行**撰写（前一章完成后再写下一章，保证连贯性）\n- 每个 Sub-Agent 负责一个卷内章节，拿到蓝本 + 前文上下文\n- 写完即校验\n\n**产出**：`04-chapters/vol-{N}/chapter-{XX}.md`\n\n### 阶段 9：整卷校验与蓝本核对\n\n卷内所有章节完成后，执行：\n1. **整卷校验**：通读全卷，检查剧情连贯性、角色一致性、伏笔回收情况\n2. **蓝本核对**：对比蓝本与正文，检查是否偏离预设、是否有遗漏的伏笔/设定\n3. 修正发现的问题\n4. 用户确认本卷定稿\n\n**产出**：修订后的正文 + `06-validation/vol-{N}-validation-report.md`（校验报告）\n\n### 阶段 10：重复阶段 4-9，依次完成各卷\n\n- 按卷编号顺序，重复分卷规划 → 章级蓝本 → 前三章式开篇校验 → 分章撰写 → 整卷校验\n- 每卷完成后锁定，不再修改（除非重大设定变更）\n\n### 阶段 11：全卷并行修订（Sub-Agent 并行，2 遍）\n\n所有卷完成后，使用 Sub-Agent **并行**执行修订：\n- 每个卷由一个 Sub-Agent 独立修订\n- **第 1 遍修订**：逻辑/设定一致性校验 + 剧情润色\n- **第 2 遍修订**：文笔打磨 + 细节完善\n\n**产出**：修订后的各卷正文\n\n### 阶段 12：全文校验（3 遍）\n\n全书完成后，执行全文级别校验：\n- **第 1 遍**：全局一致性校验（人物年龄、关系、能力随章节变化是否合理）\n- **第 2 遍**：剧情连贯性校验（跨卷伏笔、悬念回收、节奏分布）\n- **第 3 遍**：文笔终检（风格统一性、对话差异化、描写质量）\n\n**产出**：全文定稿 + `06-validation/full-book-validation-report.md`\n\n### 阶段 13：存档 v0\n\n全书定稿后，执行第一次完整存档：\n- 按 `references/archive-template.md` 执行 8 步存档流程\n- 存档命名：`[小说标题]_v0/`（v0 表示全书完成的首个存档）\n- 生成人物画像 JSON + HTML 导引页 + 全文合并版\n\n**产出**：`[小说标题]_v0/` 完整存档目录\n\n---\n\n## 📏 适用篇幅\n\n| 篇幅 | 章节数 | 字数范围 | 推荐程度 |\n|------|--------|---------|---------|\n| 中篇 | 30-80 章 | 10-25 万字 | ✅ 完全覆盖 |\n| 长篇 | 80-200 章 | 25-60 万字 | ✅ 完美匹配 |\n| 超长篇 | 200-500 章 | 60-150 万字 | ✅ 完全胜任 |\n\n> 💡 **实测标杆**：本项目已用于生成 **420,000 字**（300 章，10 卷），验证了全局连续编号、防崩设定体系、HTML 导引页生成等核心功能在超长篇场景下的可靠性。\n\n## 📏 适用篇幅\n\n| 篇幅 | 章节数 | 字数范围 | 推荐程度 |\n|------|--------|---------|---------|\n| 中篇 | 30-80 章 | 10-25 万字 | ✅ 完全覆盖 |\n| 长篇 | 80-200 章 | 25-60 万字 | ✅ 完美匹配 |\n| 超长篇 | 200-500 章 | 60-150 万字 | ✅ 完全胜任 |\n\n> 💡 **实测标杆**：本项目已用于生成 **420,000 字**（300 章，10 卷），验证了全局连续编号、防崩设定体系、HTML 导引页生成等核心功能在超长篇场景下的可靠性。\n\n## 注意事项\n\n- 不要在存档版本上做任何编辑\n- 不要在 在编辑稿/ 之外创建或修改内容\n- 生成存档时确保所有章节都已正确排序和合并\n- 如果用户没有明确要求存档，不要擅自创建 v1/v2/v3 目录\n- **文件编号 = 章编号 = 全局连续三位数，不要每卷从 1 开始**\n- **存档时务必生成人物画像 JSON 和 HTML 导引文件**\n\nFile v1.1.1:README.md\n\n# epic-novel-writer — Epic Novel Writing Full Workflow\n\n> An AI-driven creative writing SKILL for long-form serialized novels, covering the entire lifecycle from world-building and character design to chapter planning, writing, version archiving, and HTML guide generation.\n\n**Adapted Length: Medium (100-250k words) → Long (250-600k words) → Super Long (600k-1.5m words)**\n> 💡 **Proven Benchmark**: Used to generate **420,000 words** (300 chapters, 10 volumes), validating global chapter numbering, anti-collapse settings system, and HTML guide generation for super-long-form novels.\n\n---\n\n## 🚀 Why This SKILL?\n\nThe hardest part of writing a novel isn't \"starting\" — it's **surviving 300 chapters without things falling apart**. This SKILL solves the most painful problems of long-form writing:\n\n### 1. File Names = Chapter Numbers, Never Get Lost\n```\nchapter-001.md → Chapter 1\nchapter-150.md → Chapter 150 (regardless of which volume)\nchapter-300.md → Chapter 300\n```\n**Restarting from 1 in every volume** is every long-form writer's nightmare. We use **global continuous numbering** — file name IS chapter number, open the folder and you know where you are.\n\n> **文件编号 = 章编号**：`chapter-001.md` 就是第 1 章，`chapter-300.md` 就是第 300 章。不管在哪一卷，文件名直接告诉你章节号。打开文件夹就知道写到哪了。\n\n### 2. One-Click Professional Archive\nFrom `references/archive-template.md`, an 8-step flow auto-generates:\n- ✅ **Full-text merged version** (md + txt dual format)\n- ✅ **Character profile JSON** (char_data.json with name, role, growth arc, first appearance)\n- ✅ **HTML guide page** (dark theme, responsive layout, character card grid, continuous chapter links)\n- ✅ **Plain text table of contents** (chapter numbers + hyperlinks)\n\n> **一键专业存档**：8 步流程自动生成全文合并版（md+txt）、人物画像 JSON、HTML 导引页（暗色主题 + 人物卡网格 + 连续章节链接）、纯文本目录。\n\n### 3. Anti-Collapse Settings System\n- **World-building template** (`world-setting-template.md`) — geography, history, power system, core conflicts\n- **Character card template** (`character-card-template.md`) — personality, background, ability growth arcs, appearance tracking\n- **Chapter blueprint template** (`chapter-blueprint-template.md`) — scene settings, plot outlines, foreshadowing/clue tracking, skill usage records\n\n> **防崩设定体系**：三个模板分别覆盖世界观、角色卡、章纲。章纲模板追踪每章伏笔、线索、技能调用，确保剧情不偏离。\n\n### 4. Read-Only Archives, Free Editing\nAll editing happens in `在编辑稿/` (Work-in-Progress), archive versions (v1/v2/v3…) are **read-only**,可随时对比、回溯、反向合并。\n\n> **只读存档**：所有编辑在 `在编辑稿/` 完成，存档版本（v1/v2/v3…）只读，随时对比、回溯、反向合并。\n\n---\n\n## 📋 Contents\n\n| File | Purpose |\n|------|---------|\n| `SKILL.md` | Core rules, workflow, naming conventions, archive process guide |\n| `references/archive-template.md` | 8-step archive flow (directory structure + command examples + checklists) |\n| `references/world-setting-template.md` | World-building template (geography/history/power system/rhythm planning) |\n| `references/character-card-template.md` | Character card template (personality/background/ability growth/appearance tracking) |\n| `references/chapter-blueprint-template.md` | Chapter blueprint template (scene/plot/foreshadowing/skill usage) |\n\n---\n\n## 🔧 Quick Start\n\n### 1. Initialize Project\n\n```bash\nmkdir -p \"我的小说/在编辑稿/{01-story-premise,02-world-setting,03-outline,04-chapters,05-references}\"\n```\n\n### 2. Fill Core Settings\n\nCopy templates from `references/`:\n```bash\ncp references/world-setting-template.md 在编辑稿/02-world-setting.md\ncp references/character-card-template.md 在编辑稿/references/characters/主角.md\n```\n\n### 3. Start Writing Chapter 1\n\n```bash\ncp references/chapter-blueprint-template.md 在编辑稿/03-outline/chapter-001-blueprint.md\n# Fill blueprint, then create chapter-001.md in 04-chapters/\n```\n\n### 4. Archive\n\nWhen the user says \"存档\" (archive):\n```bash\n# Read references/archive-template.md and execute the 8-step flow\n```\n\n---\n\n## 📐 Project Structure\n\n```\nMyNovel/\n├── 在编辑稿/ ← 所有编辑在此 (all editing happens here)\n│ ├── 01-story-premise.md # 故事设定 (story premise)\n│ ├── 02-world-setting.md # 世界观 (world-building)\n│ ├── 03-chapters-written.md # 章节状态 (chapter status)\n│ ├── 03-outline/ # 大纲 (outlines)\n│ ├── 04-chapters/ # 正文 (manuscript, chapter-001.md ~ chapter-XXX.md)\n│ ├── 05-reports/ # 过程报告 (process reports)\n│ └── references/ # 参考文档 (reference docs)\n├── MyNovel_v1/ ← 存档（只读） (archive, read-only)\n├── MyNovel_v2/ ← 存档（只读） (archive, read-only)\n└── ……\n```\n\n---\n\n## ⚠️ Core Rules\n\n1. **All editing in `在编辑稿/`**, don't touch archive directories\n2. **Archive versions are read-only**, for comparison, tracking\n3. **Global continuous numbering**: `chapter-001.md` = Chapter 1, doesn't reset per volume\n4. **Archive must generate**: Character profile JSON + HTML guide page\n\n> **核心规则**：所有编辑在 `在编辑稿/` 完成；存档只读；文件名=章编号=全局连续；存档必含人物画像 JSON 和 HTML 导引页。\n\n---\n\n## 📏 Suitable Length\n\n| Length | Chapters | Word Count | Fit |\n|--------|----------|------------|-----|\n| Medium (中篇) | 30-80 chapters | 100k-250k words | ✅ Perfect fit |\n| Long (长篇) | 80-200 chapters | 250k-600k words | ✅ Ideal match |\n| Super Long (超长篇) | 200-500 chapters | 600k-1.5m words | ✅ Fully capable |\n\n> 💡 **实测标杆 (Proven Benchmark)**: 已用于生成 **420,000 字**（300 章，10 卷）\n\n**Estimation Reference (篇幅估算参考)**: ~4,000 words/chapter, ~10 chapters/volume (~40,000 words/volume). Given total word count, reverse-calculate chapters and volumes.\n\n---\n\n## 🏷️ Use Cases\n\n- Long-form serialized novels (100+ chapters)\n- Web novels / light novels / fantasy / sci-fi\n- AI-assisted writing (LLM generation + human polishing)\n- Multi-person collaboration (each works in `在编辑稿/`, archives regularly)\n- Complex world-building, many characters\n\n---\n\n## 📦 Installation\n\n```bash\nclawhub install epic-novel-writer\n```\n\n## 🔄 Update\n\n```bash\nclawhub update epic-novel-writer\n```\n\n## 📄 License\n\nMIT License\n\nCopyright (c) 2026, sunshinejnjn@github\n\n---\n\n> 用结构化流程对抗长篇写作的混沌。从第 1 章到第 300 章，每一步都有据可查。\n> **Structure the chaos of long-form writing. Every chapter, every step, traceable.**\n\nFile v1.1.1:_meta.json\n\n{\n \"ownerId\": \"kn7dn131pvgfaveyzzzcrc5xf182yb84\",\n \"slug\": \"epic-novel-writer\",\n \"version\": \"1.1.1\",\n \"publishedAt\": 1777319471230\n}\n\nFile v1.1.1:references/archive-template.md\n\n# 版本存档模板\n\n> 本模板定义了版本存档的标准流程与输出结构。存档时参照此模板执行，生成新的 `[小说标题]_vN/` 目录。\n\n---\n\n## 存档触发条件\n\n仅在用户**明确要求**时执行存档：\n- 用户说\"存成 vN\"、\"这是终稿了\"、\"存档\"等类似表述\n- 按创建顺序递增命名：`[小说标题]_v1/`、`[小说标题]_v2/`…\n\n---\n\n## 命名规则（文件编号 = 章编号）\n\n**所有章节文件名使用全局连续三位数编号，不随卷重置：**\n\n| 卷 | 章节范围 | 文件名 |\n|----|---------|--------|\n| 卷 1 | 第 1-30 章 | `chapter-001.md` ~ `chapter-030.md` |\n| 卷 2 | 第 31-60 章 | `chapter-031.md` ~ `chapter-060.md` |\n| 卷 3 | 第 61-100 章 | `chapter-061.md` ~ `chapter-100.md` |\n| … | … | … |\n| 卷 N | 最后一卷 | `chapter-XXX.md` |\n\n**关键规则：**\n- ❌ 禁止每卷内从第 1 章重新开始编号（不要出现卷 1 有 1-30 章、卷 2 也有 1-30 章的情况）\n- ✅ 文件名直接反映全局章号：`chapter-031.md` = 第 31 章，`chapter-271.md` = 第 271 章\n- ✅ 三位数补零：`chapter-001.md`、`chapter-300.md`\n\n---\n\n## 存档目录结构\n\n```\n[小说标题]_vN/\n├── 01-story-premise.md # 故事设定（复制）\n├── 02-world-setting.md # 世界观设定（复制）\n├── 03-chapters-written.md # 章节完成状态（复制，反映存档时进度）\n├── 03-outline/ # 大纲目录（复制）\n│ ├── 00-master-outline.md\n│ ├── vol-1-outline.md\n│ └── ……\n├── 04-chapters/ # 正文文件（txt，按卷分目录）\n│ ├── vol-1/\n│ │ ├── chapter-001.txt\n│ │ ├── chapter-002.txt\n│ │ └── ……\n│ ├── vol-2/\n│ │ ├── chapter-031.txt\n│ │ └── ……\n│ └── ……\n├── 05-reports/ # 过程报告（复制）\n├── references/ # 参考文件（复制）\n│ ├── ai-ledger/\n│ ├── character-relationships.md\n│ ├── characters/\n│ └── skill-database.md\n├── media/ # 图片（复制）\n│ └── comfyui/images/\n│ └── ……\n├── [小说标题]_全文.md # 全文合并版（md）\n├── [小说标题]_全文.txt # 全文合并版（纯文本）\n├── [小说标题]_目录.txt # 纯文本目录导航\n├── [小说标题]_导引.html # ★ HTML 导引文件（核心导航页）\n└── char_data.json # 人物数据（JSON，供导引页使用）\n```\n\n---\n\n## 执行步骤\n\n### 步骤 1：创建存档目录\n\n```bash\nN=下一个序号（从现有最大序号 +1）\nmkdir -p \"[小说标题]_v${N}/\"\n```\n\n### 步骤 2：复制只读文件\n\n将 `在编辑稿/` 下的非正文文件原样复制到存档目录：\n\n```bash\ncd \"[小说标题]_v${N}/\"\n# 复制根文件\ncp ../在编辑稿/01-story-premise.md ./\ncp ../在编辑稿/02-world-setting.md ./\ncp ../在编辑稿/03-chapters-written.md ./\n\n# 复制大纲目录\ncp -r ../在编辑稿/03-outline/ ./\n\n# 复制参考文件\ncp -r ../在编辑稿/references/ ./\ncp -r ../在编辑稿/media/ ./\n\n# 复制报告\ncp -r ../在编辑稿/05-reports/ ./\n```\n\n### 步骤 3：复制正文为 txt\n\n`在编辑稿/04-chapters/` 下所有章节已使用全局连续三位数编号，直接转为 txt 复制：\n\n```bash\nmkdir -p chapters\nfor vol_dir in ../在编辑稿/04-chapters/vol-*; do\n vol_num=$(basename \"$vol_dir\")\n mkdir -p \"chapters/${vol_num}\"\n for chapter_file in \"$vol_dir\"/*.md; do\n # 文件名已是全局连续三位数（chapter-NNN.md），直接转换格式\n sed 's/^#\\+ //; s/`//g; s/\\*\\*/\\n/g' \"$chapter_file\" > \"chapters/${vol_num}/$(basename \"$chapter_file\" .md).txt\"\n done\ndone\n```\n\n### 步骤 4：生成全文合并版\n\n将 `chapters/vol-*/chapter-*.txt` 按**全局章节号**顺序合并：\n\n```bash\n# 按卷 + 章号排序后合并（文件名已是三位数全局连续编号）\ncat chapters/vol-*/chapter-*.txt > [小说标题]_全文.txt\n```\n\n**文件名 = 章编号 = 全局连续三位数**：`chapter-001.txt`（第 1 章）、`chapter-300.txt`（第 300 章），不随卷重置。\n\n### 步骤 5：生成目录\n\n生成 `[小说标题]_目录.txt`，格式：\n\n```\n# [小说标题] 目录 — vN\n\n## 第 001 章 [章节标题] → chapters/vol-1/chapter-001.txt\n## 第 002 章 [章节标题] → chapters/vol-1/chapter-002.txt\n……\n## 第 300 章 [章节标题] → chapters/vol-10/chapter-300.txt\n```\n\n**关键：章节号全局连续编号，不随卷重置。**\n- 卷 1 第 1 章 = 第 001 章\n- 卷 2 第 1 章 = 第 031 章（如果卷 1 有 30 章）\n- 卷 10 第 1 章 = 第 271 章（以此类推）\n\n### 步骤 6：生成人物画像 JSON\n\n扫描所有章节，提取**主要角色画像**，生成 `char_data.json`：\n\n```json\n{\n \"project\": \"[小说标题]\",\n \"version\": \"vN\",\n \"total_chapters\": 300,\n \"characters\": [\n {\n \"name\": \"主角名\",\n \"role\": \"主角\",\n \"portrait\": \"media/comfyui/images/主角图片.png\",\n \"description\": \"主角的简要描述\",\n \"key_arc\": \"成长线 1 → 成长线 2\",\n \"first_appearance\": \"第 1 章\",\n \"affinity\": \"主角简称\"\n }\n ]\n}\n```\n\n**生成规则：**\n- **主要角色**：指在正文中出现频率高、推动主线/关键剧情的角色\n- 至少包含：主角、女主/重要配角、核心灵体、关键引导者\n- 次要角色（每卷单元灵）可在 `char_data.json` 中以 `minor_characters` 字段补充\n\n### 步骤 7：生成 HTML 导引文件\n\n生成 `[小说标题]_导引.html`，要求：\n\n#### 页面结构\n\n1. **页面头部**\n - 小说标题 + 版本信息 + 统计数据\n - 示例：`[小说标题] v3 · 12 角色 · 300 章`\n\n2. **全文简要介绍**\n - 一段对整个小说的简要概述（200-300 字）\n - 包含核心主题、故事走向、整体氛围\n - 从 `01-story-premise.md` 和 `02-world-setting.md` 提取\n\n3. **人物卡区域**\n - 响应式网格布局（CSS Grid）\n - 每人一张卡片，包含：\n - 角色图片（`portrait` 字段）\n - 角色名 + 角色定位（如\"主角\"、\"灵体\"）\n - 简要描述（1-2 句话）\n - 暗色主题，hover 高亮边框\n\n4. **章节目录区域**\n - 按卷分组，每卷一个区块\n - **章节号全局连续编号**（关键要求）\n - 每章一个超链接指向 `chapters/vol-X/chapter-NNN.txt`\n - 格式：`第 001 章 [标题]`\n\n5. **页脚**\n - 版本信息、生成时间、统计数据\n\n#### 章节编号规则（非常重要）\n\n- ❌ **禁止**：每卷内从第 1 章重新开始编号\n- ✅ **必须**：全局连续编号（卷 1 第 1 章 = 第 001 章，卷 10 第 1 章 = 第 271 章）\n- 编号格式：三位数（第 001 章、第 300 章）\n- HTML 目录中显示为 `第 001 章 · 章节标题`\n\n#### 样式要求\n\n- 暗色主题（背景 `#0a0a0f`，卡片 `#12121a`）\n- 响应式布局（CSS Grid，移动端适配）\n- 字体：`PingFang SC, Microsoft YaHei, sans-serif`\n- 章节链接 hover 效果\n\n### 步骤 8：完成检查\n\n存档完成后验证：\n- [ ] 所有章节已提取为 txt\n- [ ] 全文合并版完整（无缺失、无重复）\n- [ ] 目录章节号全局连续\n- [ ] HTML 导引页人物卡完整\n- [ ] HTML 导引页章节链接全部有效\n- [ ] 全文介绍已添加\n- [ ] 存档目录内无可编辑文件（只读确认）\n\n---\n\n## 反向合并\n\n当存档版本与 `在编辑稿` 不一致时：\n\n1. 先确认以哪个版本为准\n2. **以 `在编辑稿` 为准**：不需要反向合并\n3. **以存档版为准**：将存档版全文按章节拆分，覆盖 `在编辑稿/04-chapters/` 中的对应文件\n\n---\n\n## 注意事项\n\n- ❌ 不要在存档版本上做任何编辑\n- ❌ 不要在 `在编辑稿/` 之外创建或修改内容\n- ✅ 生成存档时确保所有章节已正确排序和合并\n- ✅ 如果用户没有明确要求存档，不要擅自创建 vN 目录\n- ✅ **文件编号 = 章编号 = 全局连续三位数**，不要每卷从 1 开始\n- ✅ HTML 导引文件必须包含：人物卡 + 全文介绍 + 连续编号章节目录\n\nFile v1.1.1:references/chapter-blueprint-template.md\n\n# 章纲模板\n\n> 复制到 [小说项目目录]/03-outline/vol-{N}/chapter-{XX}-blueprint.md\n\n```markdown\n# 第 [X] 章：[章名]\n\n## 基本信息\n- **位置**: 第 [X] 章（卷 [N] 第 [M] 章）\n- **字数目标**: ~1500 字\n- **视角**: [主角/其他角色]\n\n## 场景设定\n- **时间**: \n- **地点**: \n- **天气/环境**: \n\n## 出场人物\n- [角色名]：状态 + 在本章的作用\n\n## 情节大纲\n1. **开场**（~10%）：[快速交代时间/地点/人物状态]\n2. **发展**（~40%）：[核心冲突逐步展开]\n3. **高潮**（~30%）：[冲突爆发/关键转折]\n4. **收尾**（~20%）：[情绪沉淀 + 下章钩子]\n\n## 关键事件\n- [事件 1]\n- [事件 2]\n\n## 伏笔/线索\n- [埋下的伏笔 → 预计在第 X 章回收]\n\n## 技能/设定调用\n- [本章节需要展示/用到的设定]\n\n## 注意事项\n- [遵守的设定限制]\n- [不能做的事情]\n```\n\nFile v1.1.1:references/character-card-template.md\n\n# 角色卡片模板\n\n> 复制此模板创建新角色卡，保存到 [小说项目目录]/references/characters/\n\n```markdown\n# 角色名\n\n## 基本信息\n- **身份**: \n- **年龄**: \n- **性别**: \n- **外貌**: \n- **口头禅/说话风格**: \n\n## 性格\n- **核心性格**: \n- **优点**: \n- **缺点/弱点**: \n- **内在冲突**: \n\n## 背景故事\n- **成长经历**: \n- **动机**: \n- **秘密**: \n- **人际关系**: \n - 与 [角色名] 的关系：\n\n## 能力/技能\n- **初始能力**: \n- **技能变化节点**:\n - 第 X 章：获得 XX 技能\n - 第 Y 章：技能升级/蜕变\n\n## 成长弧线\n- **起点状态**: \n- **转折点**: \n- **终点状态**: \n- **可能的黑化/反转**: \n\n## 登场与退出\n- **首次登场**: 第 [X] 章\n- **最后登场**: 第 [X] 章\n- **缺席期间**: 第 [X] 至 [Y] 章\n\n## 状态追踪\n- **当前状态**: \n- **当前位置**: \n- **当前目标**: \n- **携带物品**: \n```\n\nFile v1.1.1:references/world-setting-template.md\n\n# 世界设定模板\n\n> 复制到 [小说项目目录]/02-world-setting.md 并开始填充\n\n```markdown\n# [世界名称] 设定\n\n## 世界观\n\n### 地理/空间\n- 世界层级：\n- 主要地点：\n- 区域规则：\n\n### 历史/背景\n- 起源：\n- 重大事件：\n- 当前局势：\n\n### 社会/文化\n- 权力结构：\n- 经济体系：\n- 信仰/宗教：\n\n## 力量体系\n\n### 等级\n- 等级 1：[描述]\n- 等级 2：[描述]\n- ...\n\n### 技能\n| 技能名 | 等级 | 效果 | 代价 |\n|--------|------|------|------|\n\n### 规则与限制\n- [限制 1]\n- [限制 2]\n\n## 故事基调\n\n### 核心矛盾\n- \n\n### 主题表达\n- \n\n### 节奏规划\n- 开篇：\n- 总体曲线：\n```\n\nFile v1.1.1:README.zh.md\n\n# epic-novel-writer — 史诗级长篇写作工作流\n\n一个面向长篇连载小说的 AI 驱动创作 SKILL，从世界观设定、人物塑造、章纲规划，到正文写作、版本存档、HTML 导引页生成，覆盖一部小说从零到出版的全生命周期。\n\n**适配篇幅：中篇（10-25 万字）→ 长篇（25-60 万字）→ 超长篇（60-150 万字）**\n> 💡 **实测标杆**：已用于生成 **420,000 字**（300 章，10 卷），验证了全局连续编号、防崩设定体系、HTML 导引页生成在超长篇场景下的可靠性。\n\n## 🚀 为什么需要这个 SKILL？\n\n写小说最难的不是\"开始\"，而是**持续 300 章不崩**。这个 SKILL 解决的是长篇写作中最痛苦的几个问题：\n\n### 1. 文件编号 = 章编号，永远不迷路\n```\nchapter-001.md → 第 1 章\nchapter-150.md → 第 150 章（不管它在哪一卷）\nchapter-300.md → 第 300 章\n```\n**每卷内从 1 重新开始**是每个长篇写作者的噩梦。我们采用**全局连续编号**——文件名即章节号，打开文件夹就知道写到哪了。\n\n### 2. 一键生成专业级存档\n从 `references/archive-template.md` 出发，8 步流程自动生成：\n- ✅ **全文合并版**（md + txt 双格式）\n- ✅ **人物画像 JSON**（char_data.json，含角色名、定位、成长线、首次出场）\n- ✅ **HTML 导引页**（暗色主题、响应式布局、人物卡网格、连续编号章节目录）\n- ✅ **纯文本目录**（章节号 + 超链接）\n\n### 3. 防崩设定体系\n- **世界观模板**（`world-setting-template.md`）— 地理、历史、力量体系、核心矛盾\n- **角色卡片模板**（`character-card-template.md`）— 性格、背景、能力成长弧线、登场退出追踪\n- **章纲模板**（`chapter-blueprint-template.md`）— 每章场景设定、情节大纲、伏笔/线索追踪、技能调用记录\n\n### 4. 只读存档，编辑自由\n所有编辑在 `在编辑稿/` 下完成，存档版本（v1/v2/v3…）**只读**，随时可以对比、回溯、反向合并。\n\n## 📋 包含什么\n\n| 文件 | 用途 |\n|------|------|\n| `SKILL.md` | 核心规则、工作流、命名规范、存档流程指引 |\n| `references/archive-template.md` | 版本存档 8 步完整流程（目录结构 + 命令示例 + 检查清单） |\n| `references/world-setting-template.md` | 世界观设定模板（地理/历史/力量体系/节奏规划） |\n| `references/character-card-template.md` | 角色卡片模板（性格/背景/能力成长/登场追踪） |\n| `references/chapter-blueprint-template.md` | 章纲模板（场景/情节/伏笔/技能调用） |\n\n## 🔧 快速开始\n\n### 1. 初始化项目\n\n```bash\nmkdir -p \"我的小说/在编辑稿/{01-story-premise,02-world-setting,03-outline,04-chapters,05-references}\"\n```\n\n### 2. 填写核心设定\n\n从 `references/` 复制模板：\n```bash\ncp references/world-setting-template.md 在编辑稿/02-world-setting.md\ncp references/character-card-template.md 在编辑稿/references/characters/主角.md\n```\n\n### 3. 开始写第一章\n\n```bash\ncp references/chapter-blueprint-template.md 在编辑稿/03-outline/chapter-001-blueprint.md\n# 填写章纲后，在 04-chapters/ 创建 chapter-001.md\n```\n\n### 4. 存档\n\n用户说\"存成 v1\"时：\n```bash\n# 阅读 references/archive-template.md，按 8 步流程执行\n```\n\n## 📐 项目结构\n\n```\n我的小说/\n├── 在编辑稿/ ← 所有编辑在此\n│ ├── 01-story-premise.md # 故事设定\n│ ├── 02-world-setting.md # 世界观\n│ ├── 03-chapters-written.md # 章节状态\n│ ├── 03-outline/ # 大纲\n│ ├── 04-chapters/ # 正文（chapter-001.md ~ chapter-XXX.md）\n│ ├── 05-reports/ # 过程报告\n│ └── references/ # 参考文档\n├── 我的小说_v1/ ← 存档（只读）\n├── 我的小说_v2/ ← 存档（只读）\n└── ……\n```\n\n## ⚠️ 核心规则\n\n1. **所有编辑在 `在编辑稿/` 下完成**，不碰存档目录\n2. **存档版本只读**，用于对比、回溯\n3. **全局连续编号**：`chapter-001.md` = 第 1 章，不随卷重置\n4. **存档时需生成人物画像 JSON + HTML 导引页**\n\n## 📏 适用篇幅\n\n| 篇幅 | 章节数 | 字数范围 | 推荐程度 |\n|------|--------|---------|---------|\n| 中篇 | 30-80 章 | 10-25 万字 | ✅ 完全覆盖 |\n| 长篇 | 80-200 章 | 25-60 万字 | ✅ 完美匹配 |\n| 超长篇 | 200-500 章 | 60-150 万字 | ✅ 完全胜任 |\n\n> 💡 **实测标杆**：本项目已用于生成 **420,000 字**（300 章，10 卷），验证了全局连续编号、防崩设定体系、HTML 导引页生成等核心功能在超长篇场景下的可靠性。\n\n## 🏷️ 适用场景\n\n- 长篇连载小说（100 章+）\n- 网络文学/轻小说/奇幻/科幻\n- AI 辅助写作（大模型生成 + 人工润色）\n- 多人协作（每人在 `在编辑稿/` 下工作，定期存档）\n- 世界观复杂、角色众多的作品\n\n## 📦 安装\n\n```bash\nclawhub install epic-novel-writer\n```\n\n## 🔄 更新\n\n```bash\nclawhub update epic-novel-writer\n```\n\n## 📄 协议\n\nBSD 3-Clause License\n\nCopyright (c) 2026, sunshinejnjn@github\n\n---\n\n> 用结构化流程对抗长篇写作的混沌。从第 1 章到第 300 章，每一步都有据可查。\n\nArchive v1.1.0: 8 files, 18553 bytes\n\nFiles: README.md (6965b), README.zh.md (5387b), references/archive-template.md (8261b), references/chapter-blueprint-template.md (889b), references/character-card-template.md (930b), references/world-setting-template.md (678b), SKILL.md (14140b), _meta.json (136b)\n\nFile v1.1.0:SKILL.md\n\n---\nname: epic-novel-writer\ndescription: Novel writing full workflow — from world-building and character design to chapter planning, manuscript writing, version archiving, and HTML guide generation. Covers medium (100-250k words) to super-long (600k-1.5m words), proven with 420k words / 300 chapters / 10 volumes. Supports global continuous numbering, read-only archives, character JSON, and HTML guides.\nmetadata:\n openclaw:\n emoji: \"🖊️\"\n version: \"1.1.0\"\nlicense: BSD-3-Clause\ncompatibility: Pure Markdown workflow, no external dependencies. Requires OpenClaw file I/O and shell execution capabilities.\nallowed-tools: Read, Write, Edit, Exec\n---\n\n# epic-novel-writer — 史诗级长篇写作 Skill\n\n---\n\nBSD 3-Clause License\n\nCopyright (c) 2026, sunshinejnjn@github\n\nRedistribution and use in source and binary forms, with or without\nmodification, are permitted provided that the following conditions are met:\n\n1. Redistributions of source code must retain the above copyright notice, this\n list of conditions and the following disclaimer.\n\n2. Redistributions in binary form must reproduce the above copyright notice,\n this list of conditions and the following disclaimer in the documentation\n and/or other materials provided with the distribution.\n\n3. Neither the name of the copyright holder nor the names of its\n contributors may be used to endorse or promote products derived from\n this software without specific prior written permission.\n\nTHIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \"AS IS\"\nAND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE\nIMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE\nDISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE\nFOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL\nDAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR\nSERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER\nCAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,\nOR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE\nOF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n\n## 项目结构\n\n```\n[小说标题]/\n├── 在编辑稿/ ← 所有编辑工作在此目录\n│ ├── 01-story-premise.md # 故事设定\n│ ├── 02-world-setting.md # 世界观设定\n│ ├── 03-chapters-written.md # 章节完成状态\n│ ├── 03-outline/ # 大纲（卷级 + 章级蓝图）\n│ ├── 04-chapters/ # 章节正文（按卷分目录）\n│ ├── 05-reports/ # 过程报告\n│ ├── 06-validation/ # 验证报告\n│ ├── references/ # 参考（人物卡、关系、线索台账）\n│ └── media/ # 图片/media\n├── [小说标题]_v1/ ← 存档版本（只读）\n├── [小说标题]_v2/ ← 存档版本（只读）\n├── [小说标题]_v3/ ← 存档版本（只读）\n└── ……\n```\n\n## ⚠️ 核心规则\n\n### 所有编辑必须在 在编辑稿 目录上完成\n\n- **任何时候**修改章节、大纲、参考文档，操作对象都是 `在编辑稿/` 下的文件\n- 不要修改 `在编辑稿/` 之外的任何文件\n\n### 存档版本（v1/v2/v3...）是只读的\n\n- **禁止**在 v1/v2/v3 等存档目录上做任何编辑\n- 存档版本只用于**对比、核对、历史回溯**\n- 如果需要对比编辑稿和存档，先用存档作为参考，然后修改 在编辑稿 中的内容\n- 违反此规则会导致内容冲突，务必遵守\n\n### 阶段性存档规则\n\n仅在用户**明确要求**某个版本作为阶段性成果时，才创建存档版本：\n- 用户说\"存成 v1\"、\"这是终稿了\"、\"存档\"等类似表述\n- 存档命名：`[小说标题]_v1/`、`[小说标题]_v2/` 等，按创建顺序递增\n\n---\n\n## 📦 版本存档\n\n### 存档流程模板\n\n存档的完整流程定义在以下模板文件中，存档时严格参照执行：\n\n> **模板路径**：`references/archive-template.md`（本 SKILL 内）\n\n该模板包含：\n- 存档目录结构（每个文件的用途）\n- 8 个执行步骤（从创建目录到完成检查）\n- 命名规则（文件编号 = 章编号）\n- 人物画像 JSON 生成指南\n- HTML 导引文件生成要点\n- 反向合并规则\n\n### 存档时的工作方式\n\n1. 先读 `references/archive-template.md` 获取完整流程\n2. 按模板中的步骤逐项执行\n3. 模板中每个步骤都有对应的命令示例，可直接参考执行\n4. 完成后用模板中的「完成检查」清单逐项验证\n\n### 命名规则（文件编号 = 章编号）\n\n> **这是存档流程中的核心规则，已同步到模板中：**\n\n- ❌ **禁止每卷内从第 1 章重新开始编号**（不要出现卷 1 有 1-30 章、卷 2 也有 1-30 章的情况）\n- ✅ **文件名 = 章编号 = 全局连续三位数**：`chapter-001.md`（第 1 章）、`chapter-300.md`（第 300 章）\n- ✅ 卷 1 第 1 章 = `chapter-001.md`，卷 2 第 1 章 = `chapter-031.md`（假设卷 1 有 30 章）\n\n### 人物画像生成\n\n存档时应生成 `char_data.json`，包含主要角色画像：\n\n**主要角色定义**：在正文中出现频率高、推动主线或关键剧情的角色。至少包含：\n- 主角\n- 女主/重要配角\n- 核心死党/对照\n- 关键灵体\n- 关键引导者\n\n**每个角色的画像字段**：\n| 字段 | 说明 |\n|------|------|\n| `name` | 角色名 |\n| `role` | 角色定位（主角/灵体/引导者等） |\n| `portrait` | 角色图片路径（media 目录） |\n| `description` | 简要描述（1-3 句话） |\n| `key_arc` | 角色关键成长线（→ 分隔） |\n| `first_appearance` | 首次出场章节号（如\"第 1 章\"） |\n| `affinity` | 简称/昵称（用于图片文件匹配） |\n\n次要角色（每卷单元灵）可在 `minor_characters` 数组中补充。\n\n### HTML 导引文件\n\n存档时生成 `[小说标题]_导引.html`，这是存档的**核心导航页**：\n\n**页面必须包含四个区域：**\n\n1. **页面头部** — 标题 + 版本 + 统计数据（如\"[小说标题] v3 · N 角色 · M 章\"）\n\n2. **全文简要介绍** — 从 `01-story-premise.md` 和 `02-world-setting.md` 提取，写一段 200-300 字的小说概述，包含核心主题、故事走向、整体氛围\n\n3. **人物卡区域** — 响应式网格，每人一张卡片（图片 + 名字 + 角色定位 + 简述），暗色主题，hover 高亮\n\n4. **章节目录区域** — 按卷分组，**章节号全局连续编号**（不是每卷从 1 开始！），每章超链接指向对应 txt 文件\n\n**样式要求**：\n- 暗色主题（背景 `#0a0a0f`，卡片 `#12121a`）\n- 响应式布局（CSS Grid，移动端适配）\n- 字体：`PingFang SC, Microsoft YaHei, sans-serif`\n- 章节链接 hover 效果\n\n**关键检查**：章节号是否全局连续？每个链接是否能正确导航？\n\n---\n\n## 📐 写作流程（完整生命周期）\n\n> 以下为标准写作流程，按阶段顺序执行。每个阶段输出明确文件，下游阶段依赖上游产出。\n\n### 阶段 1：构思沟通\n\n与用户深入沟通，确定以下核心要素：\n- 故事类型（奇幻/科幻/悬疑/现实/……）\n- 核心主题与想要表达的情感\n- 目标读者群体与文风偏好\n- 预期篇幅（总章数、总字数）\n- 叙事视角（第一人称/第三人称/多视角轮换）\n- 基调（轻松/沉重/悬疑/热血/……）\n\n> **篇幅估算参考**：每章约 4,000 字，每卷约 10 章（~40,000 字）。用户给定总字数后，按此标准反推总章数和卷数。例如：12 万字 → 约 30 章 → 3 卷。\n\n**产出**：`01-story-premise.md`\n\n### 阶段 2：人物设定（含时间线）\n\n根据构思创建角色设定，包含：\n- **主角团**：姓名、年龄、身份、外貌、性格核心、成长弧线、首次出场章\n- **配角群**：核心配角、反派、辅助角色\n- **人物关系**：谁和谁是朋友/敌人/恋人/师徒/对立\n- **时间线**：故事起止时间、关键事件时间锚点、角色年龄变化追踪\n\n**产出**：`references/characters/角色名.md`（每个角色一张卡片）+ `references/character-relationships.md`\n\n### 阶段 3：核对修订人物与时间线（2 遍）\n\n**第 1 遍核对**：\n- 年龄一致性：角色年龄是否随时间线合理变化\n- 关系一致性：A 是 B 的哥哥，B 是 A 的弟弟（双向验证）\n- 首次出场顺序：角色不可能在出场前出现在场景中\n- 时间线逻辑：事件先后顺序是否自洽\n\n**第 2 遍修订**：\n- 根据第 1 遍发现的问题修正\n- 用户确认修改（或自行修正）\n- 最终锁定人物设定与时间线\n\n**产出**：修订后的人物卡片 + 关系表（时间线锁定，后续不再变动基础设定）\n\n### 阶段 4：分卷规划\n\n- 将故事按剧情阶段划分为若干卷\n- 每卷确定：卷编号、卷标题、章节范围、核心冲突、卷内主角弧光\n- 全局章号规划：确定每卷首尾章号（例如卷 1: 001-030，卷 2: 031-060）\n\n**产出**：`03-outline/00-master-outline.md`（总纲）\n\n### 阶段 5：卷级大纲\n\n为每一卷撰写大纲，包含：\n- 卷内章节列表（章号 + 标题 + 简要剧情说明）\n- 卷内节奏规划（开篇/发展/高潮/收尾）\n- 卷内伏笔清单（埋设章节 + 回收章节）\n- 卷内人物变化节点\n\n**产出**：`03-outline/vol-{N}-outline.md`（每卷一个）\n\n### 阶段 6：章级蓝本\n\n为每卷的每一个章节撰写蓝本（blueprint），包含：\n- 场景设定（时间、地点、环境）\n- 出场人物（状态 + 在本章作用）\n- 情节大纲（开场→发展→高潮→收尾，按百分比分配）\n- 关键事件清单\n- 伏笔/线索记录（本章节埋设 + 回收）\n- 技能/设定调用\n\n**产出**：`03-outline/vol-{N}/chapter-{XX}-blueprint.md`（每章一个）\n\n### 阶段 7：撰写前三章（开篇定调）\n\n**先写而非先写全卷**，确保文风和叙事基调正确：\n1. 按章级蓝本撰写第 1-3 章正文\n2. 每章完成后进行 **2 遍校验与润色**：\n - 第 1 遍：逻辑校验（与蓝本是否一致、时间线是否正确）\n - 第 2 遍：文笔润色（节奏、对话、描写质量）\n3. 用户确认前三章定调无误\n\n**产出**：`04-chapters/vol-1/chapter-001.md` ~ `chapter-003.md`（校验润色后的定稿）\n\n### 阶段 8：分卷并行撰写（Sub-Agent 并行）\n\n- 使用 Sub-Agent **并行**撰写同一卷内的各章（而非全卷全章同时，避免上下文过长）\n- 每卷内部章节**按顺序串行**撰写（前一章完成后再写下一章，保证连贯性）\n- 每个 Sub-Agent 负责一个卷内章节，拿到蓝本 + 前文上下文\n- 写完即校验\n\n**产出**：`04-chapters/vol-{N}/chapter-{XX}.md`\n\n### 阶段 9：整卷校验与蓝本核对\n\n卷内所有章节完成后，执行：\n1. **整卷校验**：通读全卷，检查剧情连贯性、角色一致性、伏笔回收情况\n2. **蓝本核对**：对比蓝本与正文，检查是否偏离预设、是否有遗漏的伏笔/设定\n3. 修正发现的问题\n4. 用户确认本卷定稿\n\n**产出**：修订后的正文 + `06-validation/vol-{N}-validation-report.md`（校验报告）\n\n### 阶段 10：重复阶段 4-9，依次完成各卷\n\n- 按卷编号顺序，重复分卷规划 → 章级蓝本 → 前三章式开篇校验 → 分章撰写 → 整卷校验\n- 每卷完成后锁定，不再修改（除非重大设定变更）\n\n### 阶段 11：全卷并行修订（Sub-Agent 并行，2 遍）\n\n所有卷完成后，使用 Sub-Agent **并行**执行修订：\n- 每个卷由一个 Sub-Agent 独立修订\n- **第 1 遍修订**：逻辑/设定一致性校验 + 剧情润色\n- **第 2 遍修订**：文笔打磨 + 细节完善\n\n**产出**：修订后的各卷正文\n\n### 阶段 12：全文校验（3 遍）\n\n全书完成后，执行全文级别校验：\n- **第 1 遍**：全局一致性校验（人物年龄、关系、能力随章节变化是否合理）\n- **第 2 遍**：剧情连贯性校验（跨卷伏笔、悬念回收、节奏分布）\n- **第 3 遍**：文笔终检（风格统一性、对话差异化、描写质量）\n\n**产出**：全文定稿 + `06-validation/full-book-validation-report.md`\n\n### 阶段 13：存档 v0\n\n全书定稿后，执行第一次完整存档：\n- 按 `references/archive-template.md` 执行 8 步存档流程\n- 存档命名：`[小说标题]_v0/`（v0 表示全书完成的首个存档）\n- 生成人物画像 JSON + HTML 导引页 + 全文合并版\n\n**产出**：`[小说标题]_v0/` 完整存档目录\n\n---\n\n## 📏 适用篇幅\n\n| 篇幅 | 章节数 | 字数范围 | 推荐程度 |\n|------|--------|---------|---------|\n| 中篇 | 30-80 章 | 10-25 万字 | ✅ 完全覆盖 |\n| 长篇 | 80-200 章 | 25-60 万字 | ✅ 完美匹配 |\n| 超长篇 | 200-500 章 | 60-150 万字 | ✅ 完全胜任 |\n\n> 💡 **实测标杆**：本项目已用于生成 **420,000 字**（300 章，10 卷），验证了全局连续编号、防崩设定体系、HTML 导引页生成等核心功能在超长篇场景下的可靠性。\n\n## 📏 适用篇幅\n\n| 篇幅 | 章节数 | 字数范围 | 推荐程度 |\n|------|--------|---------|---------|\n| 中篇 | 30-80 章 | 10-25 万字 | ✅ 完全覆盖 |\n| 长篇 | 80-200 章 | 25-60 万字 | ✅ 完美匹配 |\n| 超长篇 | 200-500 章 | 60-150 万字 | ✅ 完全胜任 |\n\n> 💡 **实测标杆**：本项目已用于生成 **420,000 字**（300 章，10 卷），验证了全局连续编号、防崩设定体系、HTML 导引页生成等核心功能在超长篇场景下的可靠性。\n\n## 注意事项\n\n- 不要在存档版本上做任何编辑\n- 不要在 在编辑稿/ 之外创建或修改内容\n- 生成存档时确保所有章节都已正确排序和合并\n- 如果用户没有明确要求存档，不要擅自创建 v1/v2/v3 目录\n- **文件编号 = 章编号 = 全局连续三位数，不要每卷从 1 开始**\n- **存档时务必生成人物画像 JSON 和 HTML 导引文件**\n\nFile v1.1.0:README.md\n\n# epic-novel-writer — Epic Novel Writing Full Workflow\n\n> An AI-driven creative writing SKILL for long-form serialized novels, covering the entire lifecycle from world-building and character design to chapter planning, writing, version archiving, and HTML guide generation.\n\n**Adapted Length: Medium (100-250k words) → Long (250-600k words) → Super Long (600k-1.5m words)**\n> 💡 **Proven Benchmark**: Used to generate **420,000 words** (300 chapters, 10 volumes), validating global chapter numbering, anti-collapse settings system, and HTML guide generation for super-long-form novels.\n\n---\n\n## 🚀 Why This SKILL?\n\nThe hardest part of writing a novel isn't \"starting\" — it's **surviving 300 chapters without things falling apart**. This SKILL solves the most painful problems of long-form writing:\n\n### 1. File Names = Chapter Numbers, Never Get Lost\n```\nchapter-001.md → Chapter 1\nchapter-150.md → Chapter 150 (regardless of which volume)\nchapter-300.md → Chapter 300\n```\n**Restarting from 1 in every volume** is every long-form writer's nightmare. We use **global continuous numbering** — file name IS chapter number, open the folder and you know where you are.\n\n> **文件编号 = 章编号**：`chapter-001.md` 就是第 1 章，`chapter-300.md` 就是第 300 章。不管在哪一卷，文件名直接告诉你章节号。打开文件夹就知道写到哪了。\n\n### 2. One-Click Professional Archive\nFrom `references/archive-template.md`, an 8-step flow auto-generates:\n- ✅ **Full-text merged version** (md + txt dual format)\n- ✅ **Character profile JSON** (char_data.json with name, role, growth arc, first appearance)\n- ✅ **HTML guide page** (dark theme, responsive layout, character card grid, continuous chapter links)\n- ✅ **Plain text table of contents** (chapter numbers + hyperlinks)\n\n> **一键专业存档**：8 步流程自动生成全文合并版（md+txt）、人物画像 JSON、HTML 导引页（暗色主题 + 人物卡网格 + 连续章节链接）、纯文本目录。\n\n### 3. Anti-Collapse Settings System\n- **World-building template** (`world-setting-template.md`) — geography, history, power system, core conflicts\n- **Character card template** (`character-card-template.md`) — personality, background, ability growth arcs, appearance tracking\n- **Chapter blueprint template** (`chapter-blueprint-template.md`) — scene settings, plot outlines, foreshadowing/clue tracking, skill usage records\n\n> **防崩设定体系**：三个模板分别覆盖世界观、角色卡、章纲。章纲模板追踪每章伏笔、线索、技能调用，确保剧情不偏离。\n\n### 4. Read-Only Archives, Free Editing\nAll editing happens in `在编辑稿/` (Work-in-Progress), archive versions (v1/v2/v3…) are **read-only**,可随时对比、回溯、反向合并。\n\n> **只读存档**：所有编辑在 `在编辑稿/` 完成，存档版本（v1/v2/v3…）只读，随时对比、回溯、反向合并。\n\n---\n\n## 📋 Contents\n\n| File | Purpose |\n|------|---------|\n| `SKILL.md` | Core rules, workflow, naming conventions, archive process guide |\n| `references/archive-template.md` | 8-step archive flow (directory structure + command examples + checklists) |\n| `references/world-setting-template.md` | World-building template (geography/history/power system/rhythm planning) |\n| `references/character-card-template.md` | Character card template (personality/background/ability growth/appearance tracking) |\n| `references/chapter-blueprint-template.md` | Chapter blueprint template (scene/plot/foreshadowing/skill usage) |\n\n---\n\n## 🔧 Quick Start\n\n### 1. Initialize Project\n\n```bash\nmkdir -p \"我的小说/在编辑稿/{01-story-premise,02-world-setting,03-outline,04-chapters,05-references}\"\n```\n\n### 2. Fill Core Settings\n\nCopy templates from `references/`:\n```bash\ncp references/world-setting-template.md 在编辑稿/02-world-setting.md\ncp references/character-card-template.md 在编辑稿/references/characters/主角.md\n```\n\n### 3. Start Writing Chapter 1\n\n```bash\ncp references/chapter-blueprint-template.md 在编辑稿/03-outline/chapter-001-blueprint.md\n# Fill blueprint, then create chapter-001.md in 04-chapters/\n```\n\n### 4. Archive\n\nWhen the user says \"存档\" (archive):\n```bash\n# Read references/archive-template.md and execute the 8-step flow\n```\n\n---\n\n## 📐 Project Structure\n\n```\nMyNovel/\n├── 在编辑稿/ ← 所有编辑在此 (all editing happens here)\n│ ├── 01-story-premise.md # 故事设定 (story premise)\n│ ├── 02-world-setting.md # 世界观 (world-building)\n│ ├── 03-chapters-written.md # 章节状态 (chapter status)\n│ ├── 03-outline/ # 大纲 (outlines)\n│ ├── 04-chapters/ # 正文 (manuscript, chapter-001.md ~ chapter-XXX.md)\n│ ├── 05-reports/ # 过程报告 (process reports)\n│ └── references/ # 参考文档 (reference docs)\n├── MyNovel_v1/ ← 存档（只读） (archive, read-only)\n├── MyNovel_v2/ ← 存档（只读） (archive, read-only)\n└── ……\n```\n\n---\n\n## ⚠️ Core Rules\n\n1. **All editing in `在编辑稿/`**, don't touch archive directories\n2. **Archive versions are read-only**, for comparison, tracking\n3. **Global continuous numbering**: `chapter-001.md` = Chapter 1, doesn't reset per volume\n4. **Archive must generate**: Character profile JSON + HTML guide page\n\n> **核心规则**：所有编辑在 `在编辑稿/` 完成；存档只读；文件名=章编号=全局连续；存档必含人物画像 JSON 和 HTML 导引页。\n\n---\n\n## 📏 Suitable Length\n\n| Length | Chapters | Word Count | Fit |\n|--------|----------|------------|-----|\n| Medium (中篇) | 30-80 chapters | 100k-250k words | ✅ Perfect fit |\n| Long (长篇) | 80-200 chapters | 250k-600k words | ✅ Ideal match |\n| Super Long (超长篇) | 200-500 chapters | 600k-1.5m words | ✅ Fully capable |\n\n> 💡 **实测标杆 (Proven Benchmark)**: 已用于生成 **420,000 字**（300 章，10 卷）\n\n**Estimation Reference (篇幅估算参考)**: ~4,000 words/chapter, ~10 chapters/volume (~40,000 words/volume). Given total word count, reverse-calculate chapters and volumes.\n\n---\n\n## 🏷️ Use Cases\n\n- Long-form serialized novels (100+ chapters)\n- Web novels / light novels / fantasy / sci-fi\n- AI-assisted writing (LLM generation + human polishing)\n- Multi-person collaboration (each works in `在编辑稿/`, archives regularly)\n- Complex world-building, many characters\n\n---\n\n## 📦 Installation\n\n```bash\nclawhub install epic-novel-writer\n```\n\n## 🔄 Update\n\n```bash\nclawhub update epic-novel-writer\n```\n\n## 📄 License\n\nBSD 3-Clause License\n\nCopyright (c) 2026, sunshinejnjn@github\n\n---\n\n> 用结构化流程对抗长篇写作的混沌。从第 1 章到第 300 章，每一步都有据可查。\n> **Structure the chaos of long-form writing. Every chapter, every step, traceable.**\n\nFile v1.1.0:_meta.json\n\n{\n \"ownerId\": \"kn7dn131pvgfaveyzzzcrc5xf182yb84\",\n \"slug\": \"epic-novel-writer\",\n \"version\": \"1.1.0\",\n \"publishedAt\": 1777310495109\n}\n\nFile v1.1.0:references/archive-template.md\n\n# 版本存档模板\n\n> 本模板定义了版本存档的标准流程与输出结构。存档时参照此模板执行，生成新的 `[小说标题]_vN/` 目录。\n\n---\n\n## 存档触发条件\n\n仅在用户**明确要求**时执行存档：\n- 用户说\"存成 vN\"、\"这是终稿了\"、\"存档\"等类似表述\n- 按创建顺序递增命名：`[小说标题]_v1/`、`[小说标题]_v2/`…\n\n---\n\n## 命名规则（文件编号 = 章编号）\n\n**所有章节文件名使用全局连续三位数编号，不随卷重置：**\n\n| 卷 | 章节范围 | 文件名 |\n|----|---------|--------|\n| 卷 1 | 第 1-30 章 | `chapter-001.md` ~ `chapter-030.md` |\n| 卷 2 | 第 31-60 章 | `chapter-031.md` ~ `chapter-060.md` |\n| 卷 3 | 第 61-100 章 | `chapter-061.md` ~ `chapter-100.md` |\n| … | … | … |\n| 卷 N | 最后一卷 | `chapter-XXX.md` |\n\n**关键规则：**\n- ❌ 禁止每卷内从第 1 章重新开始编号（不要出现卷 1 有 1-30 章、卷 2 也有 1-30 章的情况）\n- ✅ 文件名直接反映全局章号：`chapter-031.md` = 第 31 章，`chapter-271.md` = 第 271 章\n- ✅ 三位数补零：`chapter-001.md`、`chapter-300.md`\n\n---\n\n## 存档目录结构\n\n```\n[小说标题]_vN/\n├── 01-story-premise.md # 故事设定（复制）\n├── 02-world-setting.md # 世界观设定（复制）\n├── 03-chapters-written.md # 章节完成状态（复制，反映存档时进度）\n├── 03-outline/ # 大纲目录（复制）\n│ ├── 00-master-outline.md\n│ ├── vol-1-outline.md\n│ └── ……\n├── 04-chapters/ # 正文文件（txt，按卷分目录）\n│ ├── vol-1/\n│ │ ├── chapter-001.txt\n│ │ ├── chapter-002.txt\n│ │ └── ……\n│ ├── vol-2/\n│ │ ├── chapter-031.txt\n│ │ └── ……\n│ └── ……\n├── 05-reports/ # 过程报告（复制）\n├── references/ # 参考文件（复制）\n│ ├── ai-ledger/\n│ ├── character-relationships.md\n│ ├── characters/\n│ └── skill-database.md\n├── media/ # 图片（复制）\n│ └── comfyui/images/\n│ └── ……\n├── [小说标题]_全文.md # 全文合并版（md）\n├── [小说标题]_全文.txt # 全文合并版（纯文本）\n├── [小说标题]_目录.txt # 纯文本目录导航\n├── [小说标题]_导引.html # ★ HTML 导引文件（核心导航页）\n└── char_data.json # 人物数据（JSON，供导引页使用）\n```\n\n---\n\n## 执行步骤\n\n### 步骤 1：创建存档目录\n\n```bash\nN=下一个序号（从现有最大序号 +1）\nmkdir -p \"[小说标题]_v${N}/\"\n```\n\n### 步骤 2：复制只读文件\n\n将 `在编辑稿/` 下的非正文文件原样复制到存档目录：\n\n```bash\ncd \"[小说标题]_v${N}/\"\n# 复制根文件\ncp ../在编辑稿/01-story-premise.md ./\ncp ../在编辑稿/02-world-setting.md ./\ncp ../在编辑稿/03-chapters-written.md ./\n\n# 复制大纲目录\ncp -r ../在编辑稿/03-outline/ ./\n\n# 复制参考文件\ncp -r ../在编辑稿/references/ ./\ncp -r ../在编辑稿/media/ ./\n\n# 复制报告\ncp -r ../在编辑稿/05-reports/ ./\n```\n\n### 步骤 3：复制正文为 txt\n\n`在编辑稿/04-chapters/` 下所有章节已使用全局连续三位数编号，直接转为 txt 复制：\n\n```bash\nmkdir -p chapters\nfor vol_dir in ../在编辑稿/04-chapters/vol-*; do\n vol_num=$(basename \"$vol_dir\")\n mkdir -p \"chapters/${vol_num}\"\n for chapter_file in \"$vol_dir\"/*.md; do\n # 文件名已是全局连续三位数（chapter-NNN.md），直接转换格式\n sed 's/^#\\+ //; s/`//g; s/\\*\\*/\\n/g' \"$chapter_file\" > \"chapters/${vol_num}/$(basename \"$chapter_file\" .md).txt\"\n done\ndone\n```\n\n### 步骤 4：生成全文合并版\n\n将 `chapters/vol-*/chapter-*.txt` 按**全局章节号**顺序合并：\n\n```bash\n# 按卷 + 章号排序后合并（文件名已是三位数全局连续编号）\ncat chapters/vol-*/chapter-*.txt > [小说标题]_全文.txt\n```\n\n**文件名 = 章编号 = 全局连续三位数**：`chapter-001.txt`（第 1 章）、`chapter-300.txt`（第 300 章），不随卷重置。\n\n### 步骤 5：生成目录\n\n生成 `[小说标题]_目录.txt`，格式：\n\n```\n# [小说标题] 目录 — vN\n\n## 第 001 章 [章节标题] → chapters/vol-1/chapter-001.txt\n## 第 002 章 [章节标题] → chapters/vol-1/chapter-002.txt\n……\n## 第 300 章 [章节标题] → chapters/vol-10/chapter-300.txt\n```\n\n**关键：章节号全局连续编号，不随卷重置。**\n- 卷 1 第 1 章 = 第 001 章\n- 卷 2 第 1 章 = 第 031 章（如果卷 1 有 30 章）\n- 卷 10 第 1 章 = 第 271 章（以此类推）\n\n### 步骤 6：生成人物画像 JSON\n\n扫描所有章节，提取**主要角色画像**，生成 `char_data.json`：\n\n```json\n{\n \"project\": \"[小说标题]\",\n \"version\": \"vN\",\n \"total_chapters\": 300,\n \"characters\": [\n {\n \"name\": \"主角名\",\n \"role\": \"主角\",\n \"portrait\": \"media/comfyui/images/主角图片.png\",\n \"description\": \"主角的简要描述\",\n \"key_arc\": \"成长线 1 → 成长线 2\",\n \"first_appearance\": \"第 1 章\",\n \"affinity\": \"主角简称\"\n }\n ]\n}\n```\n\n**生成规则：**\n- **主要角色**：指在正文中出现频率高、推动主线/关键剧情的角色\n- 至少包含：主角、女主/重要配角、核心灵体、关键引导者\n- 次要角色（每卷单元灵）可在 `char_data.json` 中以 `minor_characters` 字段补充\n\n### 步骤 7：生成 HTML 导引文件\n\n生成 `[小说标题]_导引.html`，要求：\n\n#### 页面结构\n\n1. **页面头部**\n - 小说标题 + 版本信息 + 统计数据\n - 示例：`[小说标题] v3 · 12 角色 · 300 章`\n\n2. **全文简要介绍**\n - 一段对整个小说的简要概述（200-300 字）\n - 包含核心主题、故事走向、整体氛围\n - 从 `01-story-premise.md` 和 `02-world-setting.md` 提取\n\n3. **人物卡区域**\n - 响应式网格布局（CSS Grid）\n - 每人一张卡片，包含：\n - 角色图片（`portrait` 字段）\n - 角色名 + 角色定位（如\"主角\"、\"灵体\"）\n - 简要描述（1-2 句话）\n - 暗色主题，hover 高亮边框\n\n4. **章节目录区域**\n - 按卷分组，每卷一个区块\n - **章节号全局连续编号**（关键要求）\n - 每章一个超链接指向 `chapters/vol-X/chapter-NNN.txt`\n - 格式：`第 001 章 [标题]`\n\n5. **页脚**\n - 版本信息、生成时间、统计数据\n\n#### 章节编号规则（非常重要）\n\n- ❌ **禁止**：每卷内从第 1 章重新开始编号\n- ✅ **必须**：全局连续编号（卷 1 第 1 章 = 第 001 章，卷 10 第 1 章 = 第 271 章）\n- 编号格式：三位数（第 001 章、第 300 章）\n- HTML 目录中显示为 `第 001 章 · 章节标题`\n\n#### 样式要求\n\n- 暗色主题（背景 `#0a0a0f`，卡片 `#12121a`）\n- 响应式布局（CSS Grid，移动端适配）\n- 字体：`PingFang SC, Microsoft YaHei, sans-serif`\n- 章节链接 hover 效果\n\n### 步骤 8：完成检查\n\n存档完成后验证：\n- [ ] 所有章节已提取为 txt\n- [ ] 全文合并版完整（无缺失、无重复）\n- [ ] 目录章节号全局连续\n- [ ] HTML 导引页人物卡完整\n- [ ] HTML 导引页章节链接全部有效\n- [ ] 全文介绍已添加\n- [ ] 存档目录内无可编辑文件（只读确认）\n\n---\n\n## 反向合并\n\n当存档版本与 `在编辑稿` 不一致时：\n\n1. 先确认以哪个版本为准\n2. **以 `在编辑稿` 为准**：不需要反向合并\n3. **以存档版为准**：将存档版全文按章节拆分，覆盖 `在编辑稿/04-chapters/` 中的对应文件\n\n---\n\n## 注意事项\n\n- ❌ 不要在存档版本上做任何编辑\n- ❌ 不要在 `在编辑稿/` 之外创建或修改内容\n- ✅ 生成存档时确保所有章节已正确排序和合并\n- ✅ 如果用户没有明确要求存档，不要擅自创建 vN 目录\n- ✅ **文件编号 = 章编号 = 全局连续三位数**，不要每卷从 1 开始\n- ✅ HTML 导引文件必须包含：人物卡 + 全文介绍 + 连续编号章节目录\n\nFile v1.1.0:references/chapter-blueprint-template.md\n\n# 章纲模板\n\n> 复制到 [小说项目目录]/03-outline/vol-{N}/chapter-{XX}-blueprint.md\n\n```markdown\n# 第 [X] 章：[章名]\n\n## 基本信息\n- **位置**: 第 [X] 章（卷 [N] 第 [M] 章）\n- **字数目标**: ~1500 字\n- **视角**: [主角/其他角色]\n\n## 场景设定\n- **时间**: \n- **地点**: \n- **天气/环境**: \n\n## 出场人物\n- [角色名]：状态 + 在本章的作用\n\n## 情节大纲\n1. **开场**（~10%）：[快速交代时间/地点/人物状态]\n2. **发展**（~40%）：[核心冲突逐步展开]\n3. **高潮**（~30%）：[冲突爆发/关键转折]\n4. **收尾**（~20%）：[情绪沉淀 + 下章钩子]\n\n## 关键事件\n- [事件 1]\n- [事件 2]\n\n## 伏笔/线索\n- [埋下的伏笔 → 预计在第 X 章回收]\n\n## 技能/设定调用\n- [本章节需要展示/用到的设定]\n\n## 注意事项\n- [遵守的设定限制]\n- [不能做的事情]\n```\n\nFile v1.1.0:references/character-card-template.md\n\n# 角色卡片模板\n\n> 复制此模板创建新角色卡，保存到 [小说项目目录]/references/characters/\n\n```markdown\n# 角色名\n\n## 基本信息\n- **身份**: \n- **年龄**: \n- **性别**: \n- **外貌**: \n- **口头禅/说话风格**: \n\n## 性格\n- **核心性格**: \n- **优点**: \n- **缺点/弱点**: \n- **内在冲突**: \n\n## 背景故事\n- **成长经历**: \n- **动机**: \n- **秘密**: \n- **人际关系**: \n - 与 [角色名] 的关系：\n\n## 能力/技能\n- **初始能力**: \n- **技能变化节点**:\n - 第 X 章：获得 XX 技能\n - 第 Y 章：技能升级/蜕变\n\n## 成长弧线\n- **起点状态**: \n- **转折点**: \n- **终点状态**: \n- **可能的黑化/反转**: \n\n## 登场与退出\n- **首次登场**: 第 [X] 章\n- **最后登场**: 第 [X] 章\n- **缺席期间**: 第 [X] 至 [Y] 章\n\n## 状态追踪\n- **当前状态**: \n- **当前位置**: \n- **当前目标**: \n- **携带物品**: \n```\n\nFile v1.1.0:references/world-setting-template.md\n\n# 世界设定模板\n\n> 复制到 [小说项目目录]/02-world-setting.md 并开始填充\n\n```markdown\n# [世界名称] 设定\n\n## 世界观\n\n### 地理/空间\n- 世界层级：\n- 主要地点：\n- 区域规则：\n\n### 历史/背景\n- 起源：\n- 重大事件：\n- 当前局势：\n\n### 社会/文化\n- 权力结构：\n- 经济体系：\n- 信仰/宗教：\n\n## 力量体系\n\n### 等级\n- 等级 1：[描述]\n- 等级 2：[描述]\n- ...\n\n### 技能\n| 技能名 | 等级 | 效果 | 代价 |\n|--------|------|------|------|\n\n### 规则与限制\n- [限制 1]\n- [限制 2]\n\n## 故事基调\n\n### 核心矛盾\n- \n\n### 主题表达\n- \n\n### 节奏规划\n- 开篇：\n- 总体曲线：\n```\n\nFile v1.1.0:README.zh.md\n\n# epic-novel-writer — 史诗级长篇写作工作流\n\n一个面向长篇连载小说的 AI 驱动创作 SKILL，从世界观设定、人物塑造、章纲规划，到正文写作、版本存档、HTML 导引页生成，覆盖一部小说从零到出版的全生命周期。\n\n**适配篇幅：中篇（10-25 万字）→ 长篇（25-60 万字）→ 超长篇（60-150 万字）**\n> 💡 **实测标杆**：已用于生成 **420,000 字**（300 章，10 卷），验证了全局连续编号、防崩设定体系、HTML 导引页生成在超长篇场景下的可靠性。\n\n## 🚀 为什么需要这个 SKILL？\n\n写小说最难的不是\"开始\"，而是**持续 300 章不崩**。这个 SKILL 解决的是长篇写作中最痛苦的几个问题：\n\n### 1. 文件编号 = 章编号，永远不迷路\n```\nchapter-001.md → 第 1 章\nchapter-150.md → 第 150 章（不管它在哪一卷）\nchapter-300.md → 第 300 章\n```\n**每卷内从 1 重新开始**是每个长篇写作者的噩梦。我们采用**全局连续编号**——文件名即章节号，打开文件夹就知道写到哪了。\n\n### 2. 一键生成专业级存档\n从 `references/archive-template.md` 出发，8 步流程自动生成：\n- ✅ **全文合并版**（md + txt 双格式）\n- ✅ **人物画像 JSON**（char_data.json，含角色名、定位、成长线、首次出场）\n- ✅ **HTML 导引页**（暗色主题、响应式布局、人物卡网格、连续编号章节目录）\n- ✅ **纯文本目录**（章节号 + 超链接）\n\n### 3. 防崩设定体系\n- **世界观模板**（`world-setting-template.md`）— 地理、历史、力量体系、核心矛盾\n- **角色卡片模板**（`character-card-template.md`）— 性格、背景、能力成长弧线、登场退出追踪\n- **章纲模板**（`chapter-blueprint-template.md`）— 每章场景设定、情节大纲、伏笔/线索追踪、技能调用记录\n\n### 4. 只读存档，编辑自由\n所有编辑在 `在编辑稿/` 下完成，存档版本（v1/v2/v3…）**只读**，随时可以对比、回溯、反向合并。\n\n## 📋 包含什么\n\n| 文件 | 用途 |\n|------|------|\n| `SKILL.md` | 核心规则、工作流、命名规范、存档流程指引 |\n| `references/archive-template.md` | 版本存档 8 步完整流程（目录结构 + 命令示例 + 检查清单） |\n| `references/world-setting-template.md` | 世界观设定模板（地理/历史/力量体系/节奏规划） |\n| `references/character-card-template.md` | 角色卡片模板（性格/背景/能力成长/登场追踪） |\n| `references/chapter-blueprint-template.md` | 章纲模板（场景/情节/伏笔/技能调用） |\n\n## 🔧 快速开始\n\n### 1. 初始化项目\n\n```bash\nmkdir -p \"我的小说/在编辑稿/{01-story-premise,02-world-setting,03-outline,04-chapters,05-references}\"\n```\n\n### 2. 填写核心设定\n\n从 `references/` 复制模板：\n```bash\ncp references/world-setting-template.md 在编辑稿/02-world-setting.md\ncp references/character-card-template.md 在编辑稿/references/characters/主角.md\n```\n\n### 3. 开始写第一章\n\n```bash\ncp references/chapter-blueprint-template.md 在编辑稿/03-outline/chapter-001-blueprint.md\n# 填写章纲后，在 04-chapters/ 创建 chapter-001.md\n```\n\n### 4. 存档\n\n用户说\"存成 v1\"时：\n```bash\n# 阅读 references/archive-template.md，按 8 步流程执行\n```\n\n## 📐 项目结构\n\n```\n我的小说/\n├── 在编辑稿/ ← 所有编辑在此\n│ ├── 01-story-premise.md # 故事设定\n│ ├── 02-world-setting.md # 世界观\n│ ├── 03-chapters-written.md # 章节状态\n│ ├── 03-outline/ # 大纲\n│ ├── 04-chapters/ # 正文（chapter-001.md ~ chapter-XXX.md）\n│ ├── 05-reports/ # 过程报告\n│ └── references/ # 参考文档\n├── 我的小说_v1/ ← 存档（只读）\n├── 我的小说_v2/ ← 存档（只读）\n└── ……\n```\n\n## ⚠️ 核心规则\n\n1. **所有编辑在 `在编辑稿/` 下完成**，不碰存档目录\n2. **存档版本只读**，用于对比、回溯\n3. **全局连续编号**：`chapter-001.md` = 第 1 章，不随卷重置\n4. **存档时需生成人物画像 JSON + HTML 导引页**\n\n## 📏 适用篇幅\n\n| 篇幅 | 章节数 | 字数范围 | 推荐程度 |\n|------|--------|---------|---------|\n| 中篇 | 30-80 章 | 10-25 万字 | ✅ 完全覆盖 |\n| 长篇 | 80-200 章 | 25-60 万字 | ✅ 完美匹配 |\n| 超长篇 | 200-500 章 | 60-150 万字 | ✅ 完全胜任 |\n\n> 💡 **实测标杆**：本项目已用于生成 **420,000 字**（300 章，10 卷），验证了全局连续编号、防崩设定体系、HTML 导引页生成等核心功能在超长篇场景下的可靠性。\n\n## 🏷️ 适用场景\n\n- 长篇连载小说（100 章+）\n- 网络文学/轻小说/奇幻/科幻\n- AI 辅助写作（大模型生成 + 人工润色）\n- 多人协作（每人在 `在编辑稿/` 下工作，定期存档）\n- 世界观复杂、角色众多的作品\n\n## 📦 安装\n\n```bash\nclawhub install epic-novel-writer\n```\n\n## 🔄 更新\n\n```bash\nclawhub update epic-novel-writer\n```\n\n## 📄 协议\n\nBSD 3-Clause License\n\nCopyright (c) 2026, sunshinejnjn@github\n\n---\n\n> 用结构化流程对抗长篇写作的混沌。从第 1 章到第 300 章，每一步都有据可查。","readmeExcerpt":"Skill: epic-novel-writer Owner: sunshinejnjn Summary: 史诗级长篇网络小说创作skill，包含13阶段写作流程、人物设定、分卷规划、子Agent并行撰写、全文校验、存档管理等完整工作流。覆盖中篇（10-25万字）到超长篇（60-150万字），实测 420,000 字 / 300 章 / 10 卷。支持全局连续编号、只读存档、人物画像 JSON、HTML 导引页生成。 Tags: creative-writing:1.1.0, latest:1.2.1, longform:1.1.0, novel:1.1.0, storytelling:1.1.0, writer:1.1.0 Version history: v1.2.1 | 2026-09-20T11:30:36.329Z | user v1.2.1: ClawHub security audit remediation. (","codeSnippets":[],"executableExamples":[{"language":"text","snippet":"chapter-001.md → Chapter 1\nchapter-150.md → Chapter 150 (regardless of which volume)\nchapter-300.md → Chapter 300"},{"language":"bash","snippet":"mkdir -p \"我的小说/在编辑稿/{01-story-premise,02-world-setting,03-outline,04-chapters,05-references}\""},{"language":"bash","snippet":"cp references/world-setting-template.md 在编辑稿/02-world-setting.md\ncp references/character-card-template.md 在编辑稿/references/characters/主角.md"},{"language":"bash","snippet":"cp references/chapter-blueprint-template.md 在编辑稿/03-outline/chapter-001-blueprint.md\n# Fill blueprint, then create chapter-001.md in 04-chapters/"},{"language":"bash","snippet":"# Read references/archive-template.md and execute the 8-step flow"},{"language":"text","snippet":"MyNovel/\n├── 在编辑稿/ ← 所有编辑在此 (all editing happens here)\n│ ├── 01-story-premise.md # 故事设定 (story premise)\n│ ├── 02-world-setting.md # 世界观 (world-building)\n│ ├── 03-chapters-written.md # 章节状态 (chapter status)\n│ ├── 03-outline/ # 大纲 (outlines)\n│ ├── 04-chapters/ # 正文 (manuscript, chapter-001.md ~ chapter-XXX.md)\n│ ├── 05-reports/ # 过程报告 (process reports)\n│ └── references/ # 参考文档 (reference docs)\n├── MyNovel_v1/ ← 存档（只读） (archive, read-only)\n├── MyNovel_v2/ ← 存档（只读） (archive, read-only)\n└── ……"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: epic-novel-writer\nversion: 1.2.1\nlicense: BSD-3-Clause\ndescription: 史诗级长篇网络小说创作skill，包含13阶段写作流程、人物设定、分卷规划、子Agent并行撰写、全文校验、存档管理等完整工作流。覆盖中篇（10-25万字）到超长篇（60-150万字），实测 420,000 字 / 300 章 / 10 卷。支持全局连续编号、只读存档、人物画像 JSON、HTML 导引页生成。\ndescription_zh: \"史诗级长篇写作：13 阶段工作流（构思→人物→分卷→章级蓝本→前三章定调→分卷并行撰写→整卷/全文校验→只读存档），全局连续章节编号，人物画像 JSON + HTML 导引页，实测 42 万字 / 300 章 / 10 卷。\"\ndescription_en: \"Novel writing full workflow — from world-building and character design to chapter planning, manuscript writing, version archiving, and HTML guide generation. Covers medium (100-250k words) to super-long (600k-1.5m words), proven with 420k words / 300 chapters / 10 volumes. Supports global continuous numbering, read-only archives, character JSON, and HTML guides.\"\nhomepage: https://clawhub.ai/sunshinejnjn/epic-novel-writer\nmetadata:\n openclaw:\n emoji: \"🖊️\"\ncompatibility: Pure Markdown workflow, no external dependencies. Requires OpenClaw file I/O and shell execution capabilities.\nallowed-tools: Read, Write, Edit, Exec\n---\n\n# epic-novel-writer — 史诗级长篇写作 Skill\n\n> **语言说明**：本 skill 的流程文档以中文编写（面向中文网文创作场景，目录与术语为中文）；产出内容（正文、大纲、报告）的语言跟随用户项目语言，不限于中文。英文文档见 `README.md`。\n\n## 适用篇幅\n\n| 篇幅 | 章节数 | 字数范围 |\n|------|--------|---------|\n| 中篇 | 30-80 章 | 10-25 万字 |\n| 长篇 | 80-200 章 | 25-60 万字 |\n| 超长篇 | 200-500 章 | 60-150 万字 |\n\n> 实测标杆：420,000 字 / 300 章 / 10 卷\n\n## 核心规则\n\n### 所有编辑必须在 `在编辑稿/` 目录上完成\n- 修改 → 操作 `在编辑稿/` 的文件\n- 不要修改该目录外的文件\n\n### 存档版本（v1/v2/v3...）是只读的\n- 用于对比/核对/历史回溯\n- 如需对比先读存档参考，然后修改 `在编辑稿/`\n\n### 存档条件\n仅在用户**明确发出存档指令**时执行（\"存成 v1\"、\"终稿了\"、\"存档\"等）；不得把一般性讨论当作存档意图，拿不准先向用户确认。按顺序递增。\n\n### 安全规则\n- 小说标题**不得直接拼入 shell 命令**（命令注入风险）：先按 `references/archive-template.md` 的白名单净化，路径展开一律加引号\n- 存档/反向合并前必须先向用户确认；反向合并会覆盖 `在编辑稿/`，建议先备份\n\n## 写作流程（13 阶段）\n\n1. **构思沟通** → 故事类型、主题、篇幅、视角 → `01-story-premise.md`\n2. **人物设定** → 主角团/配角/关系/时间线 → `references/characters/`\n3. **核对修订人物** → 2 遍（年龄/关系/出场顺序/时间线）\n4. **分卷规划** → 每卷标题/章节范围/核心冲突 → `03-outline/00-master-outline.md`\n5. **卷级大纲** → 章节列表/节奏/伏笔/人物变化 → `03-outline/vol-{N}-outline.md`\n6. **章级蓝本** → 场景/人物/情节/伏笔 → `03-outline/vol-{N}/chapter-{XX}-blueprint.md`\n7. **撰写前三章** → 2 遍校验 + 润色，用户确认定调\n8. **分卷并行撰写** → Sub-Agent 并行，卷内串行\n9. **整卷校验** → 通读全卷 + 蓝本核对 → `06-validation/vol-{N}-validation-report.md`\n10. **重复 4-9** 依次完成各卷\n11. **全卷并行修订** → Sub-Agent 并行，2 遍\n12. **全文校验** → 3 遍（全局一致性/连贯性/文笔终检）\n13. **存档 v0**（须先经用户明确确认，非自动步骤）→ 按 `references/archive-template.md` 执行（含标题净化、路径加引号、风险确认规则）\n\n**命名规则：** 文件名 = 章编号 = 全局连续三位数。`chapter-001.md`（第 1 章），`chapter-031.md`（卷 2 第 1 章）。\n\n## 存档流程\n\n存档时按 `references/archive-template.md` 执行 8 步：\n- 生成人物画像 `char_data.json`（主要角色 + 次要角色）\n- 生成 HTML 导引页（暗色主题，响应式，章节全局连续编号）\n- 每个存档版本独立只读目录\n\n## 子文件\n\n| 文件 | 内容 |\n|------|------|\n| `references/project-structure.md` | 项目目录结构定义 + 核心规则 |\n| `references/lifecycle.md` | 13 阶段完整流程详情（每阶段产出文件） |\n| `references/name-rules.md` | 命名规则（全局连续编号、各文件命名表） |\n| `references/archive-template.md` | 存档流程模板（8 步 + 命令示例 + 检查清单） |\n| `references/world-setting-template.md` | 世界观设定模板 |\n| `references/character-card-template.md` | 人物卡模板 |\n| `references/chapter"},{"path":"README.md","content":"# epic-novel-writer — Epic Novel Writing Full Workflow\n\n> An AI-driven creative writing SKILL for long-form serialized novels, covering the entire lifecycle from world-building and character design to chapter planning, writing, version archiving, and HTML guide generation.\n\n**Adapted Length: Medium (100-250k words) → Long (250-600k words) → Super Long (600k-1.5m words)**\n> 💡 **Proven Benchmark**: Used to generate **420,000 words** (300 chapters, 10 volumes), validating global chapter numbering, anti-collapse settings system, and HTML guide generation for super-long-form novels.\n\n---\n\n## 🚀 Why This SKILL?\n\nThe hardest part of writing a novel isn't \"starting\" — it's **surviving 300 chapters without things falling apart**. This SKILL solves the most painful problems of long-form writing:\n\n### 1. File Names = Chapter Numbers, Never Get Lost\n```\nchapter-001.md → Chapter 1\nchapter-150.md → Chapter 150 (regardless of which volume)\nchapter-300.md → Chapter 300\n```\n**Restarting from 1 in every volume** is every long-form writer's nightmare. We use **global continuous numbering** — file name IS chapter number, open the folder and you know where you are.\n\n> **文件编号 = 章编号**：`chapter-001.md` 就是第 1 章，`chapter-300.md` 就是第 300 章。不管在哪一卷，文件名直接告诉你章节号。打开文件夹就知道写到哪了。\n\n### 2. One-Click Professional Archive\nFrom `references/archive-template.md`, an 8-step flow auto-generates:\n- ✅ **Full-text merged version** (md + txt dual format)\n- ✅ **Character profile JSON** (char_data.json with name, role, growth arc, first appearance)\n- ✅ **HTML guide page** (dark theme, responsive layout, character card grid, continuous chapter links)\n- ✅ **Plain text table of contents** (chapter numbers + hyperlinks)\n\n> **一键专业存档**：8 步流程自动生成全文合并版（md+txt）、人物画像 JSON、HTML 导引页（暗色主题 + 人物卡网格 + 连续章节链接）、纯文本目录。\n\n### 3. Anti-Collapse Settings System\n- **World-building template** (`world-setting-template.md`) — geography, history, power system, core conflicts\n- **Character card template** (`character-card-template.md`) — personality, background, ability growth arcs, appearance tracking\n- **Chapter blueprint template** (`chapter-blueprint-template.md`) — scene settings, plot outlines, foreshadowing/clue tracking, skill usage records\n\n> **防崩设定体系**：三个模板分别覆盖世界观、角色卡、章纲。章纲模板追踪每章伏笔、线索、技能调用，确保剧情不偏离。\n\n### 4. Read-Only Archives, Free Editing\nAll editing happens in `在编辑稿/` (Work-in-Progress), archive versions (v1/v2/v3…) are **read-only** — compare and trace back anytime; **reverse-merge (overwrites working files) requires explicit user confirmation and a backup first**.\n\n> **只读存档**：所有编辑在 `在编辑稿/` 完成，存档版本（v1/v2/v3…）只读，可随时对比、回溯；反向合并会覆盖编辑稿，需用户明确确认并先备份。\n\n---\n\n## 📋 Contents\n\n| File | Purpose |\n|------|---------|\n| `SKILL.md` | Core rules, workflow, naming conventions, archive process guide |\n| `references/project-structure.md` | Project directory structure + core rules |\n| `references/lifecycle.md` | 13-phase full workflow details (per-phase output files) |\n| `references/name-rules.md` | Naming rules (global continuous nu"},{"path":"_meta.json","content":"{\n \"ownerId\": \"kn7dn131pvgfaveyzzzcrc5xf182yb84\",\n \"slug\": \"epic-novel-writer\",\n \"version\": \"1.2.1\",\n \"publishedAt\": 1789903836329\n}"},{"path":"references/archive-template.md","content":"# 版本存档模板\n\n> 本模板定义了版本存档的标准流程与输出结构。存档时参照此模板执行，生成新的 `[小说标题]_vN/` 目录。\n\n---\n\n## 存档触发条件\n\n仅在用户**明确发出存档指令**时执行存档：\n- 用户消息中明确包含\"存档\"、\"归档\"、\"存成 vN\"等**指令性表述**时才执行\n- **不得**把一般性讨论（如\"这章写得不错\"\"差不多可以了吧\"）理解为存档意图；拿不准就先问用户\"要存档吗？\"\n- 按创建顺序递增命名：`[小说标题]_v1/`、`[小说标题]_v2/`…\n\n## ⚠️ 操作风险与安全规则\n\n存档流程涉及**目录创建、整树复制、文件格式转换**等批量文件操作。执行前必须：\n\n1. **先向用户确认**本次存档的范围（目标目录名、章节范围），确认后再执行\n2. **标题净化（防命令注入）**：用户提供的小说标题**不得直接拼入 shell 命令**——标题中的 shell 元字符（`;`、`|`、`$(`、`>` 等）会被解释为命令。必须先按白名单过滤再引用：\n ```bash\n # $title 为用户提供的小说标题\n # 白名单：字母、数字、汉字、空格、_、-、.（UTF-8 locale 下 tr 的 [:alnum:] 包含汉字）\n safe_title=$(printf '%s' \"$title\" | tr -cd '[:alnum:] _.-')\n if [ -z \"$safe_title\" ]; then\n echo \"Error: 标题净化后为空，请改用不含特殊字符的标题\" >&2\n exit 1\n fi\n ```\n3. **所有路径展开一律加双引号**（`\"$safe_title\"`、`\"$output_file\"`），禁止裸展开\n4. 写入前校验目标路径确实位于存档目录内（防止 `..`、符号链接逃逸）\n5. 能用文件读写工具直接完成的步骤（复制、合并），**优先用文件工具而非拼 shell 命令**\n\n---\n\n## 命名规则（文件编号 = 章编号）\n\n**所有章节文件名使用全局连续三位数编号，不随卷重置：**\n\n| 卷 | 章节范围 | 文件名 |\n|----|---------|--------|\n| 卷 1 | 第 1-30 章 | `chapter-001.md` ~ `chapter-030.md` |\n| 卷 2 | 第 31-60 章 | `chapter-031.md` ~ `chapter-060.md` |\n| 卷 3 | 第 61-100 章 | `chapter-061.md` ~ `chapter-100.md` |\n| … | … | … |\n| 卷 N | 最后一卷 | `chapter-XXX.md` |\n\n**关键规则：**\n- ❌ 禁止每卷内从第 1 章重新开始编号（不要出现卷 1 有 1-30 章、卷 2 也有 1-30 章的情况）\n- ✅ 文件名直接反映全局章号：`chapter-031.md` = 第 31 章，`chapter-271.md` = 第 271 章\n- ✅ 三位数补零：`chapter-001.md`、`chapter-300.md`\n\n---\n\n## 存档目录结构\n\n```\n[小说标题]_vN/\n├── 01-story-premise.md # 故事设定（复制）\n├── 02-world-setting.md # 世界观设定（复制）\n├── 03-chapters-written.md # 章节完成状态（复制，反映存档时进度）\n├── 03-outline/ # 大纲目录（复制）\n│ ├── 00-master-outline.md\n│ ├── vol-1-outline.md\n│ └── ……\n├── 04-chapters/ # 正文文件（txt，按卷分目录）\n│ ├── vol-1/\n│ │ ├── chapter-001.txt\n│ │ ├── chapter-002.txt\n│ │ └── ……\n│ ├── vol-2/\n│ │ ├── chapter-031.txt\n│ │ └── ……\n│ └── ……\n├── 05-reports/ # 过程报告（复制）\n├── references/ # 参考文件（复制）\n│ ├── ai-ledger/\n│ ├── character-relationships.md\n│ ├── characters/\n│ └── skill-database.md\n├── media/ # 图片（复制）\n│ └── comfyui/images/\n│ └── ……\n├── [小说标题]_全文.md # 全文合并版（md）\n├── [小说标题]_全文.txt # 全文合并版（纯文本）\n├── [小说标题]_目录.txt # 纯文本目录导航\n├── [小说标题]_导引.html # ★ HTML 导引文件（核心导航页）\n└── char_data.json # 人物数据（JSON，供导引页使用）\n```\n\n---\n\n## 执行步骤\n\n### 步骤 1：创建存档目录\n\n```bash\nN=下一个序号（从现有最大序号 +1）\n# $title 必须先按上方安全规则净化为 $safe_title\nmkdir -p \"${safe_title}_v${N}/\"\n```\n\n### 步骤 2：复制只读文件\n\n将 `在编辑稿/` 下的非正文文件原样复制到存档目录：\n\n```bash\ncd \"${safe_title}_v${N}/\"\n# 复制根文件\ncp ../在编辑稿/01-story-premise.md ./\ncp ../在编辑稿/02-world-setting.md ./\ncp ../在编辑稿/03-chapters-written.md ./\n\n# 复制大纲目录\ncp -r ../在编辑稿/03-outline/ ./\n\n# 复制参考文件\ncp -r ../在编辑稿/references/ ./\ncp -r ../在编辑稿/media/ ./\n\n# 复制报告\ncp -r ../在编辑稿/05-reports/ ./\n```\n\n### 步骤 3：复制正文为 txt\n\n`在编辑稿/04-chapters/` 下所有章节已使用全局连续三位数编号，直接转为 txt 复制：\n\n```bash\nmkdir -p chapters\nfor vol_dir in ../在编辑稿/04-chapters/vol-*; do\n vol_num=$(basename \"$vol_dir\")\n mkd"},{"path":"references/chapter-blueprint-template.md","content":"# 章纲模板\n\n> 复制到 [小说项目目录]/03-outline/vol-{N}/chapter-{XX}-blueprint.md\n\n```markdown\n# 第 [X] 章：[章名]\n\n## 基本信息\n- **位置**: 第 [X] 章（卷 [N] 第 [M] 章）\n- **字数目标**: ~1500 字\n- **视角**: [主角/其他角色]\n\n## 场景设定\n- **时间**: \n- **地点**: \n- **天气/环境**: \n\n## 出场人物\n- [角色名]：状态 + 在本章的作用\n\n## 情节大纲\n1. **开场**（~10%）：[快速交代时间/地点/人物状态]\n2. **发展**（~40%）：[核心冲突逐步展开]\n3. **高潮**（~30%）：[冲突爆发/关键转折]\n4. **收尾**（~20%）：[情绪沉淀 + 下章钩子]\n\n## 关键事件\n- [事件 1]\n- [事件 2]\n\n## 伏笔/线索\n- [埋下的伏笔 → 预计在第 X 章回收]\n\n## 技能/设定调用\n- [本章节需要展示/用到的设定]\n\n## 注意事项\n- [遵守的设定限制]\n- [不能做的事情]\n```"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"史诗级长篇网络小说创作skill，包含13阶段写作流程、人物设定、分卷规划、子Agent并行撰写、全文校验、存档管理等完整工作流。覆盖中篇（10-25万字）到超长篇（60-150万字），实测 420,000 字 / 300 章 / 10 卷。支持全局连续编号、只读存档、人物画像 JSON、HTML 导引页生成。 Skill: epic-novel-writer Owner: sunshinejnjn Summary: 史诗级长篇网络小说创作skill，包含13阶段写作流程、人物设定、分卷规划、子Agent并行撰写、全文校验、存档管理等完整工作流。覆盖中篇（10-25万字）到超长篇（60-150万字），实测 420,000 字 / 300 章 / 10 卷。支持全局连续编号、只读存档、人物画像 JSON、HTML 导引页生成。 Tags: creative-writing:1.1.0, latest:1.2.1, longform:1.1.0, novel:1.1.0, storytelling:1.1.0, writer:1.1.0 Version history: v1.2.1 | 2026-09-20T11:30:36.329Z | user v1.2.1: ClawHub security audit remediation. (","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1227,"uniquenessScore":49,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-11T06:29:28.766Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-11T06:29:28.766Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-11T08:44:08.577Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}