关于 book-writer
book-writer 是面向作者的图书规划与写作技能,围绕图书记忆库组织项目,并提供起草、修订、编译和连续性检查流程。
主要功能
- 01按任务延迟加载参考文件
- 02初始化图书记忆库
- 03指导大纲与章节起草
- 04写作后更新项目记忆
- 05审阅章节并检查连续性
- 06将章节编译为手稿
适用场景
- 01启动新的图书项目
- 02持续规划或起草章节
- 03在保留原有风格的同时修订章节
- 04检查各章节之间的连续性
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ kshanxs/ book-writer-skill --skill book-writer安装后在 Claude Code 中输入/book-writer确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
assets/book-memory-bank/README.mdassets/book-memory-bank/Core/activeContext.mdprogress.mdprojectbrief.mdstory_structure.mdworld_and_characters.mdassets/book-memory-bank/Core/Templates/beta_reader_log_template.mdchapter_outline_template.mdchapter_titles_guide_template.mdcharacter_arcs_template.mdmaster_outline_template.mdpacing_blueprint_template.mdREADME.mdresearch_tracker_template.mdscene_card_template.mdthemes_and_motifs_template.mdworld_gita_template.mdassets/book-memory-bank/Production/README.mdassets/book-memory-bank/Production/AI_Generation/cover_prompts.mdassets/book-memory-bank/Production/Scripts/combine_chapters.ps1combine_chapters.shgenerate_docx.batgenerate_docx.shprepare_word_template.ps1assets/book-memory-bank/Style/style_guide.mdreferences/author_rules.mdbook_memory_protocol.mdchapter_craft.mdchapter_titles_guide.mdcharacter_worldbuilding_tables.md详细介绍
图书撰写
上下文效率规则
重要——读取任何文件前,请先阅读此处。
此技能包含许多参考文件。不要预先加载所有文件。采用按需加载——仅在需要某项特定功能时读取相应参考文件:
| 仅在以下情况下加载此文件…… | 适用情形…… |
|---|---|
references/author_rules.md | 开始会话、起草或审阅时 |
references/chapter_craft.md | 撰写或构思章节时 |
references/revision_checklist.md | 审阅或修改章节时 |
references/book_memory_protocol.md | 更新记忆库或运行连续性检查时 |
references/memory_update_prompts.md | 执行全面记忆审查时 |
references/story_forge.md | 仅在初始化期间 |
references/readme_template.md | 仅在生成项目 README 时 |
references/character_worldbuilding_tables.md | 构建角色档案或世界观表格时 |
references/childrens_book_craft.md | 仅用于儿童读物项目 |
references/parallel_workflows.md | 仅在并行起草时 |
references/punctuation_guide.md | 进行标点检查或润色文稿时 |
references/spinoff_guide.md | 仅用于衍生作品项目 |
references/opening_chapter_checklist.md | 仅在审阅第 1 章时 |
references/query_letter_guide.md | 仅当用户要求撰写宣传文案、概要或投稿信时 |
references/popscience_history_rules.md | 撰写或审阅科普、技术史或叙事类非虚构作品时 |
Core/world_gita.md(或 tech_gita.md) | 查阅世界技术、魔法或设定规则时 |
| 模板文件 | 仅在生成相应文档时 |
除非任务明确要求,否则一次加载的参考文件不得超过 3–4 个。
工作流
1. 初始化:启动新书项目
当用户要求启动新书项目或“初始化记忆库”时,请按以下步骤操作:
- 评估类型和技能:
- 阅读根目录中的
skills-lock.json(如果存在),并询问项目的类型。 - 如果这本书属于叙事类非虚构、科普、传记或历史题材,请检查是否已安装
research-dojo。 - 如果尚未安装,建议用户安装该技能,以便核实事实和论断:
"我注意到这是一个非虚构类图书项目。
research-dojo技能可以帮助核实历史日期和科学论文的详细信息。需要我安装它吗?" 提议使用run_command工具执行:npx skills add https://github.com/kshanxs/skill-dojo --skill research-dojo。 - 评估风格辅助技能: 检查是否已安装
calligraph-sensei。如果尚未安装,建议用户安装该技能,以实现更高级的拟人化、文风润色和写作节奏诊断:"需要我安装
calligraph-sensei吗?它与 Book Writer 集成,可润色章节、增强感官描写,并为小说和非小说调整句式结构。" 提议使用run_command工具执行:npx skills add https://github.com/kshanxs/skill-dojo --skill calligraph-sensei。 0a. 运行故事铸造流程。 完整阅读references/story_forge.md并遵循其中的说明。每次只问一个问题,以收集图书详情。每个问题都可以跳过。如果记忆库的 Core 文件已存在,则完全跳过此步骤——只需阅读记忆库并提供帮助。
- 阅读根目录中的
- 将
assets/book-memory-bank/目录复制到用户项目工作区的根目录。 - 阅读
references/author_rules.md,采用大师级小说家的角色设定和文风。 - 通过讨论图书计划,帮助用户确立基础要素(概念、文风、角色)。
- 构建角色和设定时,使用
references/character_worldbuilding_tables.md中的结构化角色档案和世界观构建表格。提议使用assets/book-memory-bank/Core/Templates/中的模板创建character_arcs.md、themes_and_motifs.md或world_gita.md(详细技术、魔法或设定可使用tech_gita.md/lore_gita.md)。 - 提供节奏蓝图。 询问用户是否希望现在预先规划图书的结构弧线,并使用
assets/book-memory-bank/Core/Templates/pacing_blueprint_template.md。将完成的文件保存为Core/pacing_blueprint.md。建议小说采用此方案——短篇项目可跳过。 - 将这些要素记录到新建的
book-memory-bank/Core/和book-memory-bank/Style/Markdown 文件中。 - 生成项目 README。 阅读
references/readme_template.md,根据头脑风暴环节的回答和新编写的记忆库文件填写所有{{TOKEN}}占位符,并在项目根目录中将完成的文件写入README.md。不要请用户审核——直接静默创建。
2. 写作与大纲
当用户要求编写大纲或章节时:
- 初始化 Smart-Reading Protocol:
- 阅读
book-memory-bank/Core/activeContext.md,并检查根目录中的skills-lock.json。 - Dojo 协同: 如果已安装
research-dojo,启用 Factual Audit Mode。扫描项目的Research/目录,查找 Dojo 审计文件(例如dojo_dossier.md或paper_audit_[name].md)。将这些文件作为主要事实来源,并在activeContext.md中记录当前集成状态。 - 查阅记忆状态索引,检查哪些文件已更改,或当前是否为全新会话。仅在其他文件(如角色、世界观或风格指南)已更新,或任务直接涉及其特定领域时,才加载这些文件。
- 阅读
- 遵循
references/author_rules.md中的指示,创作高质量的叙事文本、真实的对话和引人入胜的场景。 - 查阅
references/chapter_craft.md,了解适用于该书类型的章节结构模板、开篇与结尾公式,以及增强吸引力的技巧。 - 对于儿童读物(2–9 岁): 还需查阅
references/childrens_book_craft.md,了解适龄词汇、押韵与韵律、插图说明和教育内容整合。 - 将大纲写入
Outlines/Chapter_Outlines/目录。 - 创建所有章节大纲后,在
Outlines/目录中自动生成chapter-titles-guide.md(请参阅下文的章节标题指南)。 - 将章节写入
Chapters/目录。 - **对于多章节工作流,**请查阅
references/parallel_workflows.md。建议按顺序起草散文章节,以保持叙事连贯;并严格将并行工作流(后台 Agent)用于编写大纲、创建场景卡片,以及进行编辑/审阅。
3. 合并
如果用户要求你(AI)合并或组合全书(而不是自行运行所附脚本):
- 确定用户的操作系统。如果是 Mac/Linux,尝试运行提供的 bash 脚本
book-memory-bank/Production/Scripts/combine_chapters.sh。如果是 Windows,则运行combine_chapters.ps1。 - 如果脚本运行失败或不可用,且项目根目录中尚不存在
Manuscript/目录,则创建该目录。 - 按数字顺序读取
Chapters/中的所有文件,将它们合并为一个文件,并保存到Manuscript/文件夹中(例如Manuscript/Complete_Manuscript.md)。
4. 记忆更新协议(关键)
维护 Book Memory Bank 对保持内容一致性至关重要。每当完成实质性写作时,必须无缝且自动更新记忆库。无需使用脚本或要求用户手动操作。
- 查阅
references/book_memory_protocol.md,了解更新记忆库文件的严格规则及更新时机。 - 查阅
references/memory_update_prompts.md,了解哪些更改应触发文件修改的具体标准(例如角色特征、情节发展、世界观)。 - 如果用户明确说“update memory bank”,请根据最近的章节或大纲,对所有记忆文件进行全面审查和更新。务必清楚说明更新了哪些文件以及具体更改内容。
5. 章节审阅与修订
当用户要求审阅、修订或润色章节时:
- 阅读章节草稿、大纲、相邻章节(以确保连贯性)以及所有上下文文件(风格、角色、世界构建)。
- 参阅
references/revision_checklist.md,了解质量门槛和审阅重点。 - 如果审阅的是第 1 章,还要加载
references/opening_chapter_checklist.md,并执行其中的额外检查。 - 进行场景张力图分析,确保结构节奏恰当。
- 按以下顺序审阅:语言 → 情感 → 对话 → 节奏 → 连贯性。
- 高级风格润色与校对: 如果已安装
calligraph-sensei,可使用 Creative/Fiction 模式(或根据书籍体裁使用 General/Academic-Formal)委托其进行创意性文字调整;也可使用其 Proofreading / Correction 模式进行保守的错误修正,不改动故事风格和角色的对话语气。
- 高级风格润色与校对: 如果已安装
- 应用修订原则:始终优先保留原有风格,轻柔修订,在不作解释的情况下澄清情感,尊重模糊之处。
- 绝不在审阅时引入新场景、事件或角色。绝不解决作者有意留白的冲突。
- 保存修订后的版本,并说明所做的更改。
(用户可以要求专门的修订:对话、感官描写、文字润色或张力与节奏——请参阅 references/revision_checklist.md。)
6. 连贯性检查
当用户要求“检查连贯性”“运行连贯性检查”或“检查一致性”时:
- 按照
references/book_memory_protocol.md中的连贯性诊断报告流程操作。 - 对照记忆库检查所有章节在时间线、角色、世界构建、情感和主题方面的一致性。
- 生成诊断报告并保存至
Research/continuity_diagnostic_report.md。 - 使用提问式措辞——指出问题,不强加修正方案。
7. 并行章节起草与审阅
当需要起草、拟定大纲或审阅多个章节时:
- 参阅
references/parallel_workflows.md,了解完整的工作流限制。 - 起草: 为保持连贯性,连续叙事章节的正文必须按顺序起草。并行起草严格限于非连续的场景卡或大纲。
- 审阅: 章节起草完成后,提供并行(使用后台 Agent)或顺序审阅与编辑的选项。
- 启动后台任务前,务必解释连贯性要求,并询问用户偏好的处理方式。
8. 完成并呈现
所有章节起草、审阅并检查连贯性后:
- 扫描所有章节文件,查找
[NEED RESEARCH]标记,并与Research/research_tracker.md交叉核对。定稿前,必须解决所有未完成事项,或明确标出这些事项。 - 提供最终核验摘要,列出所有已创建的文件:
- 基础文件(角色、世界构建、故事梗概、时间线、冲突、风格)
- 章节大纲和章节标题指南
- 已起草和审阅的章节
- 连贯性诊断报告
- 建议后续步骤(处理连贯性问题、完善章节、汇编稿件)。
- 提供持续协助:修订章节、构思场景、完善故事线。
9. 开始创作衍生作品
当用户提到“衍生作品”“伴随书籍”“同一个世界,不同的故事”“支线故事”,或要求创作关于现有项目中次要角色的故事时:
- 首先完整阅读
references/spinoff_guide.md。 - 运行 衍生作品 Forge——该文件中定义的轻量级引导对话。每次只问一个问题;所有问题都可以跳过。
- 获得批准后,在父项目根目录中初始化衍生作品目录结构:
- 创建
<spinoff-name>/book-memory-bank/,并添加 Core 和 Style 子目录 - 根据
references/spinoff_guide.md中基于引用的继承模型设置记忆库文件 - 使用相对 Markdown 链接,从父项目的
world_and_characters.md链接共享角色和世界设定章节,而不是复制整块内容。
- 每次后续衍生作品会话开始时,读取衍生作品的记忆库文件,并按需解析/读取父项目
world_and_characters.md中的任何引用章节。 - 每写完一章衍生作品,都要运行 交叉引用协议,在保存前标记可能与正史设定冲突的内容。
边界协议(与 Research Dojo 协同)
在同时安装了 book-writer 和 research-dojo 的项目中工作时:
- 将
research-dojo在Research/目录中生成的所有文件视为事实来源参考资料。 - 撰写叙事正文或修订章节时,不要采用 Dojo 那种对抗性、极度怀疑的评论者人设。始终保持首席作者的叙事风格(Walter Isaacson 的笔调、叙事的温度和情感共鸣)。
- 按照风格指南中的 80–90% 叙事比例和公式预算,让技术细节重点突出且易于理解;将 Dojo 的深度分析转化为简单直观的类比。
章节标题指南
章节大纲定稿后,自动在 Outlines/ 目录中生成 chapter-titles-guide.md。 无需另行征求用户批准。
→ 完整说明和列指南: references/chapter_titles_guide.md
→ 模板: assets/book-memory-bank/Core/Templates/chapter_titles_guide_template.md