mcpField
B
book-writer

book-writer

github.com/kshanxs创意与媒体26215 次安装16 周前更新
代码仓库

关于 book-writer

book-writer 是面向作者的图书规划与写作技能,围绕图书记忆库组织项目,并提供起草、修订、编译和连续性检查流程。

主要功能

  1. 01按任务延迟加载参考文件
  2. 02初始化图书记忆库
  3. 03指导大纲与章节起草
  4. 04写作后更新项目记忆
  5. 05审阅章节并检查连续性
  6. 06将章节编译为手稿

适用场景

  1. 01启动新的图书项目
  2. 02持续规划或起草章节
  3. 03在保留原有风格的同时修订章节
  4. 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.md
assets/book-memory-bank/Core/
activeContext.md
progress.md
projectbrief.md
story_structure.md
world_and_characters.md
assets/book-memory-bank/Core/Templates/
beta_reader_log_template.md
chapter_outline_template.md
chapter_titles_guide_template.md
character_arcs_template.md
master_outline_template.md
pacing_blueprint_template.md
README.md
research_tracker_template.md
scene_card_template.md
themes_and_motifs_template.md
world_gita_template.md
assets/book-memory-bank/Production/
README.md
assets/book-memory-bank/Production/AI_Generation/
cover_prompts.md
assets/book-memory-bank/Production/Scripts/
combine_chapters.ps1
combine_chapters.sh
generate_docx.bat
generate_docx.sh
prepare_word_template.ps1
assets/book-memory-bank/Style/
style_guide.md
references/
author_rules.md
book_memory_protocol.md
chapter_craft.md
chapter_titles_guide.md
character_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. 初始化:启动新书项目

当用户要求启动新书项目或“初始化记忆库”时,请按以下步骤操作:

  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 文件已存在,则完全跳过此步骤——只需阅读记忆库并提供帮助。

  2. 将 assets/book-memory-bank/ 目录复制到用户项目工作区的根目录。
  3. 阅读 references/author_rules.md,采用大师级小说家的角色设定和文风。
  4. 通过讨论图书计划,帮助用户确立基础要素(概念、文风、角色)。
  5. 构建角色和设定时,使用 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)。
  6. 提供节奏蓝图。 询问用户是否希望现在预先规划图书的结构弧线,并使用 assets/book-memory-bank/Core/Templates/pacing_blueprint_template.md。将完成的文件保存为 Core/pacing_blueprint.md。建议小说采用此方案——短篇项目可跳过。
  7. 将这些要素记录到新建的 book-memory-bank/Core/ 和 book-memory-bank/Style/ Markdown 文件中。
  8. 生成项目 README。 阅读 references/readme_template.md,根据头脑风暴环节的回答和新编写的记忆库文件填写所有 {{TOKEN}} 占位符,并在项目根目录中将完成的文件写入 README.md。不要请用户审核——直接静默创建。
2. 写作与大纲

当用户要求编写大纲或章节时:

  1. 初始化 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 中记录当前集成状态。
    • 查阅记忆状态索引,检查哪些文件已更改,或当前是否为全新会话。仅在其他文件(如角色、世界观或风格指南)已更新,或任务直接涉及其特定领域时,才加载这些文件。
  2. 遵循 references/author_rules.md 中的指示,创作高质量的叙事文本、真实的对话和引人入胜的场景。
  3. 查阅 references/chapter_craft.md,了解适用于该书类型的章节结构模板、开篇与结尾公式,以及增强吸引力的技巧。
  4. 对于儿童读物(2–9 岁): 还需查阅 references/childrens_book_craft.md,了解适龄词汇、押韵与韵律、插图说明和教育内容整合。
  5. 将大纲写入 Outlines/Chapter_Outlines/ 目录。
  6. 创建所有章节大纲后,在 Outlines/ 目录中自动生成 chapter-titles-guide.md(请参阅下文的章节标题指南)。
  7. 将章节写入 Chapters/ 目录。
  8. **对于多章节工作流,**请查阅 references/parallel_workflows.md。建议按顺序起草散文章节,以保持叙事连贯;并严格将并行工作流(后台 Agent)用于编写大纲、创建场景卡片,以及进行编辑/审阅。
3. 合并

如果用户要求你(AI)合并或组合全书(而不是自行运行所附脚本):

  1. 确定用户的操作系统。如果是 Mac/Linux,尝试运行提供的 bash 脚本 book-memory-bank/Production/Scripts/combine_chapters.sh。如果是 Windows,则运行 combine_chapters.ps1。
  2. 如果脚本运行失败或不可用,且项目根目录中尚不存在 Manuscript/ 目录,则创建该目录。
  3. 按数字顺序读取 Chapters/ 中的所有文件,将它们合并为一个文件,并保存到 Manuscript/ 文件夹中(例如 Manuscript/Complete_Manuscript.md)。
4. 记忆更新协议(关键)

维护 Book Memory Bank 对保持内容一致性至关重要。每当完成实质性写作时,必须无缝且自动更新记忆库。无需使用脚本或要求用户手动操作。

  1. 查阅 references/book_memory_protocol.md,了解更新记忆库文件的严格规则及更新时机。
  2. 查阅 references/memory_update_prompts.md,了解哪些更改应触发文件修改的具体标准(例如角色特征、情节发展、世界观)。
  3. 如果用户明确说“update memory bank”,请根据最近的章节或大纲,对所有记忆文件进行全面审查和更新。务必清楚说明更新了哪些文件以及具体更改内容。
5. 章节审阅与修订

当用户要求审阅、修订或润色章节时:

  1. 阅读章节草稿、大纲、相邻章节(以确保连贯性)以及所有上下文文件(风格、角色、世界构建)。
  2. 参阅 references/revision_checklist.md,了解质量门槛和审阅重点。
  3. 如果审阅的是第 1 章,还要加载 references/opening_chapter_checklist.md,并执行其中的额外检查。
  4. 进行场景张力图分析,确保结构节奏恰当。
  5. 按以下顺序审阅:语言 → 情感 → 对话 → 节奏 → 连贯性。
    • 高级风格润色与校对: 如果已安装 calligraph-sensei,可使用 Creative/Fiction 模式(或根据书籍体裁使用 General/Academic-Formal)委托其进行创意性文字调整;也可使用其 Proofreading / Correction 模式进行保守的错误修正,不改动故事风格和角色的对话语气。
  6. 应用修订原则:始终优先保留原有风格,轻柔修订,在不作解释的情况下澄清情感,尊重模糊之处。
  7. 绝不在审阅时引入新场景、事件或角色。绝不解决作者有意留白的冲突。
  8. 保存修订后的版本,并说明所做的更改。

(用户可以要求专门的修订:对话、感官描写、文字润色或张力与节奏——请参阅 references/revision_checklist.md。)

6. 连贯性检查

当用户要求“检查连贯性”“运行连贯性检查”或“检查一致性”时:

  1. 按照 references/book_memory_protocol.md 中的连贯性诊断报告流程操作。
  2. 对照记忆库检查所有章节在时间线、角色、世界构建、情感和主题方面的一致性。
  3. 生成诊断报告并保存至 Research/continuity_diagnostic_report.md。
  4. 使用提问式措辞——指出问题,不强加修正方案。
7. 并行章节起草与审阅

当需要起草、拟定大纲或审阅多个章节时:

  1. 参阅 references/parallel_workflows.md,了解完整的工作流限制。
  2. 起草: 为保持连贯性,连续叙事章节的正文必须按顺序起草。并行起草严格限于非连续的场景卡或大纲。
  3. 审阅: 章节起草完成后,提供并行(使用后台 Agent)或顺序审阅与编辑的选项。
  4. 启动后台任务前,务必解释连贯性要求,并询问用户偏好的处理方式。
8. 完成并呈现

所有章节起草、审阅并检查连贯性后:

  1. 扫描所有章节文件,查找 [NEED RESEARCH] 标记,并与 Research/research_tracker.md 交叉核对。定稿前,必须解决所有未完成事项,或明确标出这些事项。
  2. 提供最终核验摘要,列出所有已创建的文件:
  • 基础文件(角色、世界构建、故事梗概、时间线、冲突、风格)
  • 章节大纲和章节标题指南
  • 已起草和审阅的章节
  • 连贯性诊断报告
  1. 建议后续步骤(处理连贯性问题、完善章节、汇编稿件)。
  2. 提供持续协助:修订章节、构思场景、完善故事线。
9. 开始创作衍生作品

当用户提到“衍生作品”“伴随书籍”“同一个世界,不同的故事”“支线故事”,或要求创作关于现有项目中次要角色的故事时:

  1. 首先完整阅读 references/spinoff_guide.md。
  2. 运行 衍生作品 Forge——该文件中定义的轻量级引导对话。每次只问一个问题;所有问题都可以跳过。
  3. 获得批准后,在父项目根目录中初始化衍生作品目录结构:
  • 创建 <spinoff-name>/book-memory-bank/,并添加 Core 和 Style 子目录
  • 根据 references/spinoff_guide.md 中基于引用的继承模型设置记忆库文件
  • 使用相对 Markdown 链接,从父项目的 world_and_characters.md 链接共享角色和世界设定章节,而不是复制整块内容。
  1. 每次后续衍生作品会话开始时,读取衍生作品的记忆库文件,并按需解析/读取父项目 world_and_characters.md 中的任何引用章节。
  2. 每写完一章衍生作品,都要运行 交叉引用协议,在保存前标记可能与正史设定冲突的内容。

边界协议(与 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

评论

支持 Markdown