Claude/Codex 写小说 skill：从安装到第一章

Claude Code 写小说 skill 安装步骤

开始前准备三样东西：一个能正常使用的 Claude Code 或 Codex CLI；本机装好 Node.js 和 Python 3（安装命令用 npx，本地检查脚本用 Node 和 Python 运行）；一个只放这本书的空文件夹。

1. 打开终端，运行 npx skills add zenstory-ai/oh-story-claudecode -y -g。-g 是全局安装，任何文件夹都能用；以后更新重跑同一条命令。
2. 新建一个文件夹给这本书，在这个文件夹里启动 Claude Code 或 Codex。
3. 运行 /story-setup（Codex 输入 $story-setup）。它会问你用哪个 Agent、部署到哪里；文件夹里已有的 CLAUDE.md 或配置会合并保留。
4. 先核对安装报告。Codex CLI 还要信任本项目的 .codex/ 配置层，在 /hooks 审核并信任新增或变更的 hooks；随后在同一个项目文件夹新开会话。
5. 在新会话里说「帮我开书」，直接进入长篇开书流程；拿不准写长篇还是短篇，就运行 /story 说「我想写小说」，它先问篇幅再分派。
6. 看过第 1 章细纲，说「写第1章」。正文写进 正文/，随后跑章级检查；字数落在目标范围内就提交追踪，偏短或偏长时先把处理选项交给你。

也可以在 Agent 里直接说 安装这个 skill https://github.com/zenstory-ai/oh-story-claudecode，能导入 GitHub 仓库的 Agent 都能照做。习惯用 Claude Code 插件市场的，依次运行 claude plugin marketplace add https://github.com/zenstory-ai/oh-story-claudecode 和 claude plugin install oh-story@oh-story-skills，之后命令带前缀，形如 /oh-story:story-setup。Oh Story 的完整介绍见项目页，源码在 GitHub。

安装包、项目部署和会话加载是三步：安装命令更新可用的 skill 包；story-setup 把当前本地包部署到这本书；新会话再发现可用的写作助手。只有部署报告不能证明 hooks 已运行。2026-09-30 核对的 OpenAI 官方技能说明支持用 $ 或 /skills 显式选择技能；hooks 说明要求信任项目配置及当前 hook 定义，变更后的 hook 要重新审核。不要因为安装结束就假定大纲守卫已生效。

Codex 写小说 skill 怎么用：各 Agent 差异

Codex 部署会写入 .codex/agents/、.codex/hooks.json、.codex/hooks/ 和根目录 AGENTS.md。各 Agent 的完整差异和已知限制见仓库的各编程 Agent 部署说明。

上表记录本文所引用 Oh Story 部署版本的适配路线，不能据此宣布所有宿主最新版本的能力。文件已部署、当前会话已加载、hooks 已信任分别核对；技能未发现时先做环境检查，再决定是否重新部署。

Windows 和 Mac 安装写小说 skill 的注意事项

• 两个系统用同一条安装命令，都需要 Node.js 和 Python 3。setup 依次找 python3、python、py，一个都找不到就停止部署；装好 Python 3 后重跑 /story-setup。
• Windows 安装时可能出现 ENOENT ... mkdir 报错，末尾却显示 Done!，这说明有 skill 没装全。先重跑同一条安装命令，再用 story-setup 检查参考资料包是否完整；仍缺失时保留实际报错，不把末尾 Done! 当成修复证据。
• 在 Windows 上把本仓库克隆下来直接给 Codex 用，git 要打开 core.symlinks=true；按本页步骤安装、再用 $story-setup 部署到写作项目的，照常可用。Codex 的 hooks 在 Windows 上由 setup 注册的 .cmd 启动器运行，信任 .codex/ 和 hooks 的步骤与其他系统相同。
• Claude Code 的 hooks 是 .sh 脚本，setup 部署时会给它们加上执行权限。

Claude Code 写的小说存在哪：项目文件一览

书稿都是书文件夹里的普通 Markdown 文件，用任何编辑器都能打开。环境文件和书稿文件分开放：

Codex 部署的环境文件在 .codex/ 和根目录 AGENTS.md。短篇项目更简单：一个目录里放 设定.md、小节大纲.md 和 正文.md。想在浏览器里翻这些文件，运行 /story dashboard，工作台只在本机 127.0.0.1 打开，书稿留在你的电脑上。

Oh Story 有哪些写小说 skill：13 个命令速查

Codex 里把开头的 / 换成 $，例如 $story-long-write。长篇的路线是扫榜、拆文、写作，短篇同理；去 AI 味、审稿和封面两条线共用。分不清 skill、插件和 MCP 的区别，先看写作 Skill 入门。

AI 写长篇为什么要用 skill：文件记忆和写前门禁

在一个长对话里写长篇，前面的设定迟早被压缩掉。Oh Story 让一本书分四个文件夹存放：设定/、大纲/、正文/、追踪/，各管一类信息；会话专心写这一章，前情都记在文件夹里。每写一章，只读这一章用得到的角色状态、待收伏笔和相关设定，其余留在文件里。

• 写正文前必须有这一章的细纲。缺细纲时，guard-outline-before-prose.sh 会拦住第一次创建正文文件；这是该宿主部署后的守卫行为；Codex 未信任 hooks、或宿主只支持 skill 内检查时，不能把它当成已经生效的运行时拦截。
• 每份细纲都要写明「字数目标」；这一栏空着，流程就停下来等你补上。
• 写完一章按流程执行字数、AI 句式、复读和截断、标点检查；以本次实际结果为准，检查通过不证明小说一定好读。
• 追踪由工具从 _tracking-state.json 整份重建；上下文.md 固定 7 栏、上限 12KB，写到后面每章读的状态量也差不多。
• 「开书」默认做到设定、卷纲和首批 10 章细纲就停；要正文得点名章节（如「写第1章」）或说「日更」，单轮最多写 3 章。

部署后新开会话也有原因：story-architect、narrative-writer、consistency-checker 等 7 个专业 Agent 由 /story-setup 写进项目，只在会话启动时注册。旧会话里调用它们，会退回单线程写作。细纲怎么写才好用，见章节细纲模板；长篇怎样少忘伏笔，见长篇连续性指南。

正文、细纲、追踪和宿主诊断分别使用现有流程。环境检查不为证明安装成功而自动写一章；未验证的会话能力仍标为未验证。

示例：用 Claude Code 从空文件夹写出第一章

下面是原创说明性示例，展示预期的交互和文件去向；没有在本次编辑中实际安装或写成这本书。

准备：新建文件夹 夜班洗衣店/，在里面启动 Claude Code，运行 /story-setup，目标环境选 Claude Code。看到安装报告后退出，新开会话。

你说：我想写一部长篇都市悬疑。主角是通宵洗衣店的夜班店员，每晚三点有位客人来洗同一件沾着河泥的雨衣，从不开口。帮我开书。

落盘：书名目录里的 设定/角色/ 出现店员和雨衣客人两个文件，大纲/ 出现全书大纲、第一卷卷纲和首批细纲。流程在这里停下，等你看。

你改：打开 大纲/细纲_第001章.md，把客人第一次开口挪到章尾，确认「字数目标」一栏已经填好。

你说：写第1章。

落盘：正文写进 正文/第001章_章名.md；检查结果报出字数和句式命中；追踪/上下文.md 的当前位置更新到第 1 章，雨衣上的河泥作为未回收的伏笔记进追踪。

第二天接着写，在同一文件夹新开会话，说「写第2章」或「日更」。手上已经有前几章草稿的，走导入续写，把旧稿先整理成项目。

写小说 skill 装好后的常见问题和修法

• **输入 /story-setup 没反应**：从插件市场装的，命令是 /oh-story:story-setup；Codex 用 $story-setup 或 /skills；OpenCode 首次用自然语言让它运行 story-setup；OpenClaw 用 /skill story-setup 或直接点名 story-setup，部署后新 skill 没出现就新开一次会话。
• setup 提示参考资料包不完整：Oh Story 没装全。用 npx 装的就重跑那条安装命令，从插件市场装的就到插件面板里重新安装，然后再运行 /story-setup。
• **/story-review 报告头是 Fallback: ... -> solo**：还在部署前的旧会话里，或 Agent 没注册成功。新开会话再试。
• 说了「帮我开书」却没有正文：开书的默认停点就是细纲。看完细纲，明确说「写第1章」。
• 写正文被拦下：这一章缺细纲，先补 大纲/细纲_第NNN章.md。
• **手改了 追踪/上下文.md，检查报错**：上下文.md、伏笔、角色状态和时间线都由工具从 _tracking-state.json 整份生成，手改会被检查拒绝。让 skill 按修订流程为这一章重新提交一次追踪，工具会整份重建这些文件；想改已写章节里发生的事，说「修改第N章」，修订流程会连同追踪一起更新。
• 升级后行为没变：在书文件夹重跑 /story-setup，然后新开会话。
• 想确认环境装好没有：对 Agent 说「用 story-setup 检查写作环境」，它只做检查、给出建议，项目文件保持原样。

常见问题

Claude Code 写的小说保存在哪里？

保存在你启动 Claude Code 的书文件夹里。正文在书名目录的 正文/ 下，一章一个 Markdown 文件；细纲在 大纲/，设定在 设定/。skill 写完一章就直接存进对应的文件，备份整个文件夹就备份了整本书。

Claude Code 写小说 skill 需要 GPU 或另配模型吗？

写正文使用你当前 Agent 的模型，不要求本机 GPU；本地确定性检查使用 Node 和 Python。封面另走生成通路：Codex 当前会话实际有内置生图工具时可用它，无需另填 API Key；工具不可用或作者明确选择 API 时，story-cover 的 API 回退需要 GPT_IMAGE_API_KEY。先核对可用工具，再选择通路。

Codex 能用写小说 skill 吗？

能。安装命令和 Claude Code 相同，在 Codex 里用 $story-setup 部署，信任项目的 .codex/ 配置和 hooks，新开会话后用 $story-long-write 等命令写作。

相关阅读

• Oh Story（网文写作 skill 包）→
• 写作 Skill 是什么：和提示词、插件、MCP 怎么分→
• 小说细纲怎么写：章节模板与填写范例→
• 按大纲写小说怎么避免流水账：从细纲到正文→
• AI续写已有书稿：导入 Oh Story，接上设定与前史→