前言¶
用對話模型寫長篇，常見痛點不是「某一章寫不出來」，而是寫到第十幾章時，人物關係、道具狀態、信息獲知路徑和前文設定開始對不上。換一個新會話續寫，模型往往只能憑摘要猜，改了一處又牽動別處。若把大綱、角色卡、章節正文散落在聊天記錄裏，也很難做可回滾的版本管理。
下面介紹 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
