前言¶
用对话模型写长篇，常见痛点不是「某一章写不出来」，而是写到第十几章时，人物关系、道具状态、信息获知路径和前文设定开始对不上。换一个新会话续写，模型往往只能凭摘要猜，改了一处又牵动别处。若把大纲、角色卡、章节正文散落在聊天记录里，也很难做可回滚的版本管理。
下面介绍 SkillHub 上的社区 Skill「长篇小说写作工作流 V2」（坐标 @user_59dee265/d-writer，当前版本 4.2.0）。它把书项目落成一套约定好的目录与 Markdown / JSON 文件，用章节串行事务和多层门禁约束写作与审计，适合需要持久故事状态、跨会话续写和连续性检查的长篇虚构项目。
这是什么¶
一句话定位：工具无关的长篇虚构小说写作工作流，以「文件优先」维护故事圣经与运行时状态，并配套机械门禁、风格契约、知情连续性与无背景冷读等质量环节。
维护与来源：由 SkillHub 社区用户 user_59dee265 发布，分类为 content-creation，来源标记为 community；标签标明 requires_api_key=false，不依赖额外 API Key。Skill 包内元数据名称为 dragon-writer，对外展示名称为「长篇小说写作工作流 V2」。
解决什么问题：官方简介写明，它面向需要持久故事状态与连续性审计的长篇虚构小说——创建新书、续写章节、导入旧稿、调整方向、改写章节、安全回滚，或在多会话间阅读 / 重建大纲与设定文件。明确不用于一次性短文生成或仅做普通文案润色。
核心功能¶
以下能力均来自 Skill 包内 SKILL.md 与各 references/workflow-*.md 的说明。
七种工作模式¶
Agent 按用户意图识别模式并读取对应参考文档：
- 模式 A · 新书：从灵感 / 书名 / 题材建书，初始化目录与基础设定文件。
- 模式 B · 续写：在已有大纲、设定、章节与状态文件上续写下一章。
- 模式 C · 导入：旧章节已有、状态文件薄弱时，导入并补齐契约文件。
- 模式 D · 转向 / 修订：换方向、从指定位置续写或修补叙事。
- 模式 E · 改写 / 修复：重写某一章正文。
- 模式 F · 仪表盘：查看进度、设定完成度、人物关系或本地阅读章节（
dashboard.html）。 - 模式 G · 合并审核：多章写完后，对选定章节做章际冷读合并审核。
文件契约与 Foundation / Runtime 分离¶
- 文件优先：大纲、设定、角色、规则、章节、状态文件为权威来源。
- 不覆写 canon：除非用户明确要求改写，不改写已成文内容；不确定时追加带日期备注。
- 静态基础与运行时态分开：Foundation（前提、世界法则、卷章地图、角色稳定属性、规则书）仅在用户要求或方向性转向时改；Runtime（当前状态、钩子、摘要、焦点、审计漂移、道具账本、空间锚点、角色卡时间线等）按章更新。
章节串行事务与四道质量门¶
每章状态机为 prepared → drafted → gated → audited → closed，由 scripts/chapter_txn.py 推进；只有完整 closed 才能准备下一章。强制环节包括：
- 机械门禁：字数下限与 intent 场景节点证据。
- 风格契约门禁：
scripts/check_style_contract.py校验story/style_guide.md是否含实物样本，并比对句长等统计指纹。 - 知情连续性门禁：主代理对照项目文件检查时间、空间、信息权限、关系权限等，报告须带可追溯的文件与段落引用。
- 无背景冷读：全新子代理只读正文，只报告读者可见问题，不改正文。
建书时需从 references/style-presets/ 的 30 种声音中选定（或按层混搭，语体层只取一套），写入 story/style_guide.md 与 story/style_exemplars.md；Skill 要求「没有声音契约的书不要开写」。
本地仪表盘¶
init_book.py 会把 assets/dashboard.html 复制到书目录。用户可在 Chrome / Edge 中双击打开，首次授权本书根目录后，在浏览器本地读取 book.json、chapters/*.md、story/*.md，查看总览、设定完成度、人物关系与章节阅读等；数据不上传，仪表盘不修改书文件。
Skill 自身更新（可选）¶
_meta.json 默认 update.auto_check=false。用户明确要求更新时，可在 Skill 目录内执行：
python scripts/auto_update.py status --verbose # 只查远程版本，不下载
python scripts/auto_update.py check --force # 检查并应用更新（会修改 skill）
远程版本查询来源为 SkillHub API（slug=d-writer）。可将 _meta.json 中 update.enabled 设为 false 以完全禁用更新能力。
安装与启用¶
官方 SkillHub 页面给出的安装指引是：按 SkillHub 安装文档 安装坐标 @user_59dee265/d-writer。
1、安装 SkillHub CLI（若尚未安装）¶
command -v skillhub && skillhub --version
未安装时可执行完整安装脚本（文档推荐）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2、安装本 Skill 到当前 Agent 的 skills 目录¶
安装时必须用 --dir 指向 Agent 识别的 skills 目录，否则默认落到 ./skills/ 可能无法被加载。文档记载的常见路径如下：
| Agent | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
在 Cursor 下的示例：
skillhub install @user_59dee265/d-writer --dir ~/.cursor/skills/
安装完成后，按所用客户端要求重启或刷新 Agent，使新 Skill 被加载。本 Skill 不绑定某一款写作 CLI，读写与脚本执行依赖 Agent 自带的文件与命令能力。
典型用法¶
以下步骤摘自 references/workflow-new-book.md 与 SKILL.md 的「从这里开始」，可在对话中用自然语言触发，由 Agent 按模式执行。
创建新书（模式 A）¶
- 约定项目根目录，默认
books/<slug>/，避免覆盖已有目录。 - 初始化空白模板（不带入示例小说正文）：
在 Skill 包目录下执行（--title 必填，其余有默认值）：
python scripts/init_book.py --title "书名" --genre "都市异能" --chapter-word-count 4000 --root books
- 填写
book.json（书名、语言、题材、chapterMinChars等硬下限）、author_intent.md、story_frame.md、volume_map.md、角色档案与book_rules.md、current_state.md等基础文件。 - 选定风格预设并写好
style_guide.md/style_exemplars.md。 - 基础文件就绪后保存第 0 章 closed 快照：
python scripts/snapshot_book.py <book-dir> --chapter 0 --type closed
python scripts/snapshot_book.py <book-dir> --chapter 0 --type closed --verify
若用户要求立刻写正文，再进入模式 B 写第一章。
续写一章（模式 B）¶
动文件前先读 references/file-contract.md、references/chapter-protocol.md 与 references/chapter-craft.md。续写前可运行 build_work_packet.py 从磁盘重建当前章工作包。每章须走完事务与四道门，由 chapter_txn.py 登记；未 closed 不得开写下一章。
查看进度（模式 F）¶
确认 books/<book-id>/dashboard.html 存在（缺失时从 assets/dashboard.html 复制一次，不覆盖已有文件）。告知用户双击该 HTML，在浏览器中选择书根目录授权后即可本地查看。
对话示例（示意，非固定命令）：
- 「用 d-writer 在
books/my-xuanhuan开一本新书，都市异能，单章不少于 4000 字。」 - 「续写
books/my-xuanhuan下一章，先读 audit-drift 里未解决的 warning。」 - 「打开这本书的仪表盘，我想看人物关系和章节列表。」
适用场景与注意¶
适合谁
- 计划写多章、多卷，且需要在多个会话间保持设定与正文一致的小说作者。
- 愿意把项目放在磁盘上、接受文件契约与脚本门禁的团队或个人。
- 需要导入旧稿、改写单章、快照回滚，而不是单次生成短文的用户。
不适合什么
- 一次性短文、口号文案或只做润色而不维护书项目的任务（Skill 简介已明确排除）。
使用注意
- 单写手串行：连续写作期间禁止子代理写正文或提前写后章；冷读子代理必须在草稿冻结且通过机械门禁后、以无背景方式启动。
- 风格契约是硬前置：仅有形容词清单的风格文件会被判不合格，无法通过风格门禁封板。
- 漂移要回读：续写 / 改写前应阅读
audit-drift.md中未解决项，避免「只写不读」绕过门禁。 - 平台规则与题材：Skill 说明
genre仅作技法提示，不用于拒绝用户题材；宿主平台内容政策仍独立适用。 - 统计口径：SkillHub 页面与抓取资料中的评分、下载量会变动；撰写时以 SkillHub 列表页实时数据为准（抓取记录为评分 100000、下载 3486）。
结尾¶
长篇小说写作工作流 V2 把「书」当成一套可审计的文件工程：状态在磁盘上持久化，章节以事务封板，质量靠门禁与冷读分层把关，而不是依赖单次对话记忆。若你的项目是长篇虚构且重视连续性，可以从 SkillHub 安装 @user_59dee265/d-writer 试用。
- SkillHub 页面：https://www.skillhub.cn/skills/user_59dee265/d-writer
- 官方坐标页：https://api.skillhub.cn/user_59dee265/d-writer
- 安装说明：https://skillhub.cn/install/skillhub.md
