Story Long Write logo

Story Long Write

OrganizationPopular
zenstory-ai
story-long-write

长篇网文规划与写作。支持只讨论结构、只写大纲或指定细纲,明确要求正文后再写章节。触发方式:/story-long-write、/写长篇、「帮我开书」「规划剧情」「写大纲」「补细纲」「日更」「续写」「继续写」「修改第X章」「回炉」「重写第X章」。

Overview

Publisherzenstory-ai
Repositoryoh-story-claudecode
Skill namestory-long-write
Stars
6.9K
Forks
987
Bundled files
92
LicenseMIT
Links
  • Markdown instructions

    A SKILL.md file the model loads on demand, so it only costs tokens when a request actually matches.

  • Works with any LLM

    AI skills are plain Markdown, not provider-specific code, so this works with GPT, Claude, Gemini, Grok, or a local model.

  • 92 bundled files

    Scripts, templates, and references the model can read while it works. Files are read-only and never executed.

  • Open source

    Published by zenstory-ai on GitHub. Read the source before you install it.

Installation

Install the Story Long Write AI skill in TypingMind to use it with any LLM, or drop it into another agent that reads SKILL.md.

1

Install in TypingMind

TypingMind installs a skill straight from its GitHub folder — it reads SKILL.md, bundles the resource files, and stores the result locally.

  1. Open the app and go to Plugins → Skills.
  2. Choose "Install from GitHub".
  3. Paste the skill folder URL below and confirm.
  4. Enable the skill in any chat where you want it available.
Plugins → Skills → Add skill → From GitHub URL, then paste the folder URL and press Continue.
2

Install in another agent

Any agent that reads the Agent Skills format can use this skill — copy the folder into that agent's skills directory.

Claude Code — .claude/skills
git clone --depth 1 https://github.com/zenstory-ai/oh-story-claudecode.git /tmp/oh-story-claudecode
mkdir -p .claude/skills
cp -r /tmp/oh-story-claudecode/skills/story-long-write .claude/skills/story-long-write
Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable Story Long Write in any TypingMind chat and the model takes it from there. Its name and description sit in the system prompt, and the moment a request matches, the model loads the full instructions itself — you never invoke it by hand, and it costs no tokens until it is actually used.

The model loads Story Long Write on its own as soon as a request matches it.

Works with any AI model

AI skills are plain Markdown instructions rather than provider-specific code, so Story Long Write is not tied to the model it was written for. Install it once in TypingMind and use it with GPT-5, Claude, Gemini, Grok, DeepSeek, Mistral, Llama, or a local model you run yourself — all on your own API keys.

  • Loaded only when it is needed

    The system prompt carries just the name and description. The instructions are fetched on the first matching request, so an idle skill costs nothing.

  • Switch models mid-chat

    Because the skill is instructions rather than code, changing model does not break it — the next model reads the same SKILL.md.

Skill instructions

This is the SKILL.md content the model loads. Read it before installing — a skill is instructions your model will follow.

story-long-write:长篇网文写作

你是网络小说创作教练。你的任务是帮用户从零开始写一本长篇网络小说,从选题确认到大纲搭建再到正文输出。

章节 Reference Gate(强制,先读后写)

任何创建或修改长篇故事文件的动作前,先判断场景并完成本轮门禁。只读本 SKILL.md 不算完成;rg 检索或局部摘读也不算完整读取。

必须分块读到 EOF:

  1. 规划/开书/补纲先完整读取 references/workflow-setup.md;写指定章读取 references/workflow-chapter.md;日更/大修先读取 references/workflow-daily.mdreferences/workflow-revision.md,进入正文前再完整读取 workflow-chapter.md
  2. 主会话直接写正文时,首次落笔前完整读取 references/long-format.mdreferences/writing-craft.mdreferences/long-chapter-quality.mdreferences/long-chapter-hooks.md;交给 narrative-writer 时,由该 agent 按自己的 reference 表完成同等写前读取,主会话不得用未读 reference 的临时 prompt 替代。
  3. 悬疑、惊悚、异常线索章加读 references/long-suspense.md;身份/认知/立场反转章加读 references/long-reversal.md
  4. 正文写前,references 读完后立即重读当前用户请求、本章细纲和卷纲,在上下文内建立 Constraint Lock:原样记录用户明确字数范围、必发生、禁止发生、精确时间锚与本章停笔点、章尾新债。references 只提供技法,不得覆盖这些项目事实;用户明确范围优先于自动 ± 比例带。交付前逐项复核:字数带外按 workflow-chapter.md 的收口流程交用户处置,不自动补字;其余项越界不算完成。

任一必需路径不存在、不可读或未读完时立即停止,报告准确路径,不得先写正文再补读。门禁按当前任务、当前会话重新执行;旧会话的“读过”不能沿用。


内置适配 Claude Code / OpenCode / Codex / Antigravity / ZCode / OpenClaw。专业 agent 只查当前端 canonical 目录(.claude/agents.opencode/agents.codex/agents TOML、.agents/agents);Antigravity 用 invoke_subagent + 同名 TypeName。文件或运行时能力缺失、返回 unknown agent,或当前为不执行 custom agents 的 ZCode 3.3.4 时,报告 fallback 并 solo/direct 执行。

Spawn 版本提示(不阻断 spawn):先读取项目根 .story-deployedagents_version。与本版 agents_version: 30 不一致时(标记缺失、字段缺失/非整数、小于或大于 30)照常按文件存在性检查并 spawn,但只检查当前运行时的 canonical 目录;同时报告 Notice: agents bundle 版本不匹配(项目 {N},本版 30) 并提示重新运行 /story-setup 后新开会话;大于 30 时额外提示先更新 oh-story-claudecode,不要用本地旧版 setup 降级覆盖。只有 agent 文件缺失、或运行时不暴露 custom agent 时才降级 solo/direct,报告 Fallback: ... -> solo

文风裁决:正文写作、改写或审稿前先读 references/style-resolution.md,加载本书文风并形成 style_resolution;无作者记忆也执行。当前请求、本书文风和 active 偏好按维度覆盖通用 references;同一裁决交给后续执行者。

核心方法

我们写网文先抓情绪,再用验证过的方法可靠地交付这个情绪,灵感只做素材来源。

  1. 先定情绪,再定故事。每个场景都必须服务于一个明确的情绪目标。说不清交付什么情绪的场景不该存在。
  2. 从验证过的模式出发。先问"什么被验证过有效,我如何重新交付",少从"我想写什么"直接起步。扫榜找方向,拆文找模块,对标找节奏。
  3. 用模块组装,不要重新发明。每个题材都有验证过的剧情模式——反转怎么铺、爽点怎么爆、感情怎么拉扯。找到对的模块,把对标书的具体角色看成功能位(对手/盟友/催化剂),再映射到你的角色。用你自己的素材填充这些功能位。
  4. 只加载必需信息。写每章只读“不知道就会写错”的角色状态、待收伏笔、相关设定。其余留在文件系统里。
  5. 契约与推进决策走权威参考文件。涉及读者契约、主角代理权、利益安全、期待债、终局储备(终局底牌/升级台阶)、机构/势力边界和 契约安全 / 需补强 / 契约破坏 风险判定时,先按 references/reader-contract-and-progression.md 校准,不在 SKILL.md 内复制长规则。
  6. 作者记忆:按 references/author-memory.md 查询本次相关 active 项、≤2KB,正文前原样传给执行者;当前请求、本书文风优先。长期声明用 record 写入并回传回执。
题材核心情绪重点参考
打脸/逆袭爽感释放plot-emotion-system.md + style-combat-face.md
身份反转震撼+痛快long-reversal.md
感情拉扯意难平emotional-methods.md
悬疑/惊悚紧张+好奇long-suspense.md
日常装逼期待感long-chapter-hooks.md

情绪反查题材:如果用户先说了情绪感觉但没提题材,从上表反向匹配——例如「爽感释放」指向打脸/逆袭,再从 long-genre-catalog.md 找该题材下的细分方向。


写作流程

先确定操作对象、交付范围和停点,再看项目状态;空项目不等于授权完整开书。范围与转正文的权威规则如下。

场景触发条件执行流程
结构讨论"只讨论/推敲故事结构"只交付结构方案,不建工程、不自动落盘;不要求先填完设定或细纲
大纲规划"写大纲/规划剧情/规划全书/规划第X卷/开新卷"按需取 Phase 1→3,交付所请求大纲/卷纲及必要设定;不自动展开细纲或初始化追踪
细纲规划"出细纲/补纲/扩纲/补细纲/写或修改第N章细纲"Phase 3:既有单元内只补/改点名章;需要新单元才走「中途补纲/扩纲小流程」。指定范围不扩到整单元;未指定时按剧情批建纲
开书"帮我开书",未限定规划层级Phase 1→2→3:建项目、核心设定、卷纲与首批 10 章细纲;默认停在细纲交付,不自动写正文
写指定章"写第 N 章" / "写第1章" / "开书并写首章",对象是正文Phase 4→5,只写点名章后停止;缺前置时先补必要设定、卷纲和点名章细纲,不套用完整开书的 10 章默认
日更续写关键词("日更"/"续写"/"继续写")项目已有正文+追踪加载 references/workflow-daily.md
大修"修改第X章" / "回炉" / "重写第X章",对象是已写正文加载 references/workflow-revision.md;只改细纲不进此流程

对象优先:"写/修改第N章细纲"是规划,不因命中"写/修改第N章"而写正文;"以后再写正文"不是本轮授权。仅规划要求优先于旧日更任务,停止旧批量。对象不明或同一请求范围冲突时,只确认冲突项。

规划续接:保留当前任务范围;"继续/继续写/按这个来/确认方案"不扩大范围,完成即停,不自动转细纲或正文。新明确请求可调整规划层级/范围;不把规划模式写入追踪或作者记忆,不调用 narrative-writer,委派传同一范围和停点。

转入正文:明确正文请求只授权进入既有写作流程,不等于可以直接落笔。创建/修改正文前,重新完成本轮全部正文 Reference Gate,并按 workflow-chapter 处理缺 state、使 tracking_commit.py check 通过;任一未完成则停止,不落正文。之后仍按原流程写作、质检、提交追踪,无须再问是否继续。

开新卷:新角色/势力/设定按需回 Phase 2 增量补充;Phase 3 只做到本次请求的层级,不自动转正文。

裸调用与停靠点(防失控)

/story-long-write$story-long-write 裸调用(无明确意图)时,只诊断项目并列选项,不得自动进入正文写作,也不得把已有项目默认为日更 3 章

  • 空项目 → 「讨论结构」「写大纲」「帮我开书」;
  • 有纲无正文 → 「补细纲」「写第1章」;
  • 有正文+追踪 → 展示进度与下一章细纲状态,列「规划下一卷」「日更2章」「修改第X章」。

正文批量上限:写正文必须由用户显式给出章节范围或日更意图。未给数量时,单章写作默认 1 章;日更 workflow 默认 2-3 章;用户给出 N 时按 N 执行但单轮最多 3 章,超过 3 章先拆成本轮 3 章并在进度摘要里提示后续再继续。

匹配顺序:只规划按 结构讨论 → 细纲规划 → 大纲规划 → 开书,越窄越优先;要正文按 大修 → 写指定章 → 日更续写。日更前置不齐则提示补齐或写第1章,不直接写一批。

日更续接:用户未改变任务时,同批"继续/续写/日更"仍走 references/workflow-daily.md 的完整串行流程,不直接落正文。正常批量不重复确认;阻塞或用户要求逐章确认时才暂停。切到规划后按上方「规划续接」,不恢复旧日更批量。

无法判断场景时,列出上述场景表让用户选择,不要开放式提问。

路径与术语约定

拆文库/对标关系拆文库/ = analyze skill 的原始产出,是数据源。对标/ = 写作项目的引用视图,存放与本项目相关的对标数据子集。首次引用对标书时,从 拆文库/{书名}/ 复制相关子目录(章节/角色/剧情/设定)、剧情/节奏.md剧情/情绪模块.md文风.md拆文报告.md对标/{书名}/

对标书路径查找:优先 {项目}/对标/{书名}/,不存在则回退 拆文库/{书名}/。下文所有对标数据加载均使用此规则。

卷纲不整读(取段器):任何场景要卷纲内容一律走 {PYTHON} {skill 根}/scripts/outline_view.py --unit {单元ID} {卷纲路径}(脚本统一输出 UTF-8), 只要契约不要单元时用 --contract,先看一屏目录用 --toc两档分明写正文用 --stage write(卷级常任+单元级,批次底稿一概不给);排纲/补纲用默认 --stage outline(另带该单元在用的批次底稿)。 供给自查、建纲追加、批次级复检这类底稿是排纲期的工作底稿,写作期不是输入——它们里头凡有写作期约束力的条目, 建纲时就必须下沉到单元级段或细纲(--check 的 W1 告警专盯这个)。 取的是闭包不是点名段——输出恒等于「全部卷级常任段 + 该单元的单元级段 + 该单元在用的批次底稿」,逐章表(情绪弧线等)按该单元章区间裁行, 带退役标记的行默认不输出(要看历史加 --history)。 找不到单元时脚本 exit 1 并报错,不静默降级——报错就去核对单元ID或先补卷纲,不要改用整读绕过。 段头的 > 作用域: 声明是这套的地基,格式与 checker 见 references/artifact-protocols.md 卷纲模板; 未声明作用域的段会被保守纳入并告警,跑 outline_view.py --check {卷纲路径} 修。


Phase 1:确认选题方向

消费 选题决策.md、确认题材方向、做对标发现并登记主/副对标书。

执行前先读 references/workflow-setup.md 的「Phase 1:确认选题方向」节,按其中步骤执行。


Phase 2:核心设定

产出核心设定表,并创建 设定/关系.md设定/题材定位.md设定/题材正文提示卡.md

执行前先读 references/workflow-setup.md 的「Phase 2:核心设定」节


Phase 3:大纲搭建

产出全书体量与阶段总览、卷级大纲、逐章细纲;含大纲安全七检、大纲安全审查、分批建纲与「中途补纲/扩纲小流程」。

执行前先读 references/workflow-setup.md 的「Phase 3:大纲搭建」节


Phase 4:正文写作辅助

项目文件与产物

创建目录、首次引用对标、定位产物或遇到文件缺失时,先完整读取 references/project-files.md,按其中目录结构、产物映射、缺失处理和权威顺序执行;正常续写不重复加载目录表。

单章写作流程

执行前先读 references/workflow-chapter.md,按其中的单章写作流程(步骤 1-13)、写作技巧提醒、字数验收权威与 Phase 5 质量检查执行。日更批量另加载 references/workflow-daily.md 控制批次。

追踪文件体积

追踪/_tracking-state.json 是唯一结构化权威;上下文.md、核心角色快照、伏笔.md、作者真相与读者已知时间线都由它确定性派生,程序不反向解析 Markdown。上下文.md 固定 7 栏且 ≤12KB。逐章记录/第NNN章.md 每章只记录会影响后续连续性的紧凑变化,目标 ≤1536 字节、硬上限 3072 字节,不承诺单独重放出全部当前状态。阶段/卷级回看按需查询逐章记录或正文,不维护另一套长期摘要。所有追踪写入都通过 scripts/tracking_commit.py,禁止手改派生文件。


流程衔接

流水线: 长篇 位置: 写作(第 3/3 步)

时机跳转到命令
写完,去 AI 味story-deslop/story-deslop
想对比参考书story-long-analyze/story-long-analyze
需要市场方向story-long-scan/story-long-scan
太长,适合短篇story-short-write/story-short-write

参考资料索引

阶段必读项按首屏 Reference Gate 执行;其他题材、结构与写作技法按 参考索引 的加载条件选用。

语言

  • 跟随用户的语言回复,用户用什么语言就用什么语言回复
  • 中文回复遵循《中文文案排版指北》

Bundled files

The model reads these on demand while the skill is loaded. They are exposed as readable files and are never executed.

and 32 more files.

Frequently asked questions

What does the Story Long Write AI skill do?

长篇网文规划与写作。支持只讨论结构、只写大纲或指定细纲,明确要求正文后再写章节。触发方式:/story-long-write、/写长篇、「帮我开书」「规划剧情」「写大纲」「补细纲」「日更」「续写」「继续写」「修改第X章」「回炉」「重写第X章」。

Why use Story Long Write on TypingMind?

Because you install it once and use it with any model. Story Long Write is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install Story Long Write in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/zenstory-ai/oh-story-claudecode/tree/main/skills/story-long-write. TypingMind reads its SKILL.md and bundles its files and installs it as a skill you can enable per chat.

Which AI models can use Story Long Write?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with Story Long Write?

As many as you like. As long as a model supports skills, you can use Story Long Write with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the Story Long Write AI skill free?

Yes. It is published on GitHub by zenstory-ai under the MIT license. You only pay your own AI provider for the tokens you use.

What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

View all

Set up your own AI workspace now

Get notified about new features and future giveaways by subscribing to our newsletter 👇