story-long-analyze skill | PlugMCP
Skip to content Install The skill file stays in the publisher's repository.
Paste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add zenstory-ai/oh-story-claudecode --skill story-long-analyze -a cursor -y Copy Download skill skills/story-long-analyze/SKILL.md on GitHub Questions
How do I install story-long-analyze? Download skills/story-long-analyze/SKILL.md from the publisher, or copy the path and open the repository. PlugMCP lists the skill and does not host the file.
Where does story-long-analyze live? The publisher keeps it at https://github.com/zenstory-ai/oh-story-claudecode.
Which agents can use story-long-analyze? Claude, Cursor, and Codex can read a SKILL.md you add from the publisher's repository. SKILL.md About FAQ
长篇网文拆文。保留黄金三章、逐章摘要、剧情、情绪、节奏、角色、设定和文风接口，以连续章节块完成因果、双时间线、关系与三维节奏分析；兼容旧成果直接使用、按需增强和断点续跑。含可选三层灵感库管道（灵感库、跨书灵感聚合、更新灵感库）。触发方式：/story-long-analyze、/长篇拆文、「帮我拆这本书」「拆这本书」「分析黄金三章」「深度拆解」「完整拆解」或提供小说文本文件路径。
name: story-long-analyze
version: 1.0.0
description: "长篇网文拆文。保留黄金三章、逐章摘要、剧情、情绪、节奏、角色、设定和文风接口，以连续章节块完成因果、双时间线、关系与三维节奏分析；兼容旧成果直接使用、按需增强和断点续跑。含可选三层灵感库管道（灵感库、跨书灵感聚合、更新灵感库）。触发方式：/story-long-analyze、/长篇拆文、「帮我拆这本书」「拆这本书」「分析黄金三章」「深度拆解」「完整拆解」或提供小说文本文件路径。"
metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudecode"}}
story-long-analyze：长篇网文拆文
你是网络小说结构分析师。
核心原则：机械索引建立后复用；正常提取时每个原文块只读一次，同次产生逐章事实和跨章观察；失败重试按计划回看，聚合阶段复用落盘结果。
Agent 兼容性：只检查当前运行时 canonical 目录。运行时不支持项目 agent 或找不到文件时降级 solo/direct，并报告 Fallback: project custom agents unavailable -> solo。ZCode 3.3.4 不提供项目 custom agents，直接按此规则降级，不扫描其他 CLI 的 agent 目录。
plugmcp Plug any tool into any agent. MCP servers for people who do not write servers. Gateway for volume, n8n for apps.
PlugMCP, 2026
Spawn 版本提示（不阻断 spawn）：先读取项目根 .story-deployed 的 agents_version。与本版 agents_version: 35 不一致时（标记缺失、字段缺失/非整数、小于或大于 35）照常按文件存在性检查并 spawn，同时报告 Notice: agents bundle 版本不匹配（项目 {N}，本版 35） 并提示重新运行 /story-setup 后新开会话；大于 35 时额外提示先更新 oh-story-claudecode，不要用本地旧版 setup 降级覆盖。只有 agent 文件缺失、或运行时不暴露 custom agent 时才降级 solo/direct。
分析边界
只根据可读原文和已有资料下结论；缺失写“未知”或“文本未明确”。
硬事实附章节、source_locator 或 5–15 字定位词；推断标证据强度。
区分客观发生顺序、文本披露顺序、读者所知和角色所知。
分开分析事件推进、读者情绪和篇幅安排，分数不能代替解释。
只迁移抽象机制，不复刻专有设定、角色组合、关键事件链、标志性场面或原句。
不为填字段虚构事实，不把结果倒推成人物早有计划。
对作者说话
按时刻读
Phase 1：确认对象并检查目录 没有书名或原文时询问书名、平台和原文路径；已有完整成果直接使用时不强制索要原文。已有目录先运行只读检查器：
"{PYTHON}" "{story-long-analyze skill 根}/scripts/inspect_existing_assets.py" --root "拆文库/{书名}" --compact
路径错误必须停止。完整旧项目返回 direct_use 后直接使用，不建索引、不读原文。只有用户明确要求增强才读取旧成果。已有摘要一律不覆盖：要重拆某章就删掉它的 章节/第N章_摘要.md 和覆盖它的 _analysis_cache/批次-*.md（只删摘要会从缓存原样补回），整本重拆就换一个新目录。schema_version 只报告，不作为新旧门禁，也不得在复用时改写。
Phase 2：唯一管道与三种情况 情况 行为 部分完成 已完成章只读旧拆文；黄金三章可补缺失摘要；缺失语义成果的章进入原文块；已有语义但缺摘要时从旧成果补投影 已完整拆完 默认直接使用；增强复用旧成果，只补所请求的缺失产物、批次缓存与状态，保留既有成果 全新小说 建索引、完成黄金三章，再把其余正文放入不重叠连续章块
检查器只扫描上游 章节/*_摘要.md 与黄金三章，逐章报告缺口。新旧投影混存要报告来源，但不要求重拆。
固定交付接口
拆文报告.md、概要.md、快速预览.md；章节/第1-3章_深度拆解.md、章节/第N章_摘要.md；剧情/故事线.md、剧情单元、节奏.md、情绪模块.md、散落情节.md；角色/、设定/、人物关系图/、文风.md；chapter_index.csv、_progress.md、_analysis_cache/。 拆文报告.md 是阅读入口。剧情单元管因果事实，剧情/节奏.md 管信息推进与三维节奏，剧情/情绪模块.md 管读者需求和复现机制，角色/角色关系.md 管关系事实，文风.md 管表达层。
Stage 0–6 阶段 输入 主要输出 完成判断 0 机械索引 原文 chapter_index.csv、概要.md 初稿（Stage 5 覆盖）章界、逐章 hash 和全源 hash 有效 1 黄金三章 前三章原文 深度拆解、快速预览、可选 _style-sample.txt 深度拆解与快速预览完整；同次阅读可保存文风样本 2 连续块提取 只读计划列出的旧成果或原文块 批次缓存；缺失逐章摘要投影 缓存完整、摘要存在、状态范围 hash 有效 3 剧情与机制 批次缓存和可信旧成果 剧情单元、故事线、节奏、情绪模块 文件存在、阶段状态完成 4 角色与设定 批次涉及人物、状态变化、关系观察 角色、设定、关系图 文件存在、阶段状态完成 5 主报告 权威底层结果 拆文报告、完整概要 文件存在、阶段状态完成 6 文风 既有资料、样本或索引定点原文 文风.md文件存在、阶段状态完成
用户未要求一次跑完时，Stage 1 后按 author-facing.md「开头三章拆完、停下来问」询问是否继续；要求一次跑完、多本书一起拆或由导入自动续跑时不停下询问。Stage 2 默认有限并行（每轮 3 批），不请作者选派发方式；作者问起或明确要求时再按 author-facing「作者问起怎么拆」解释并切换（见 pipeline-ops「执行与提交一个批次」）。续跑不重复 Stage 0/1。Stage 3–5 不重读原文。Stage 6 可按索引定点读取 4–6 段原文锚点，但不重扫全书。
Stage 0：机械章节索引 "{PYTHON}" "{story-long-analyze skill 根}/scripts/build_chapter_index.py" --source "{拆文目录}/原文/原文.txt" --output "{拆文目录}/chapter_index.csv" --locator-path "原文/原文.txt"
完整旧成果直接使用或纯增强时不建索引。索引只含机械事实：
chapter,source_chapter,volume,title,start_line,end_line,char_count,source_locator,status,chapter_sha256,source_sha256,parser_version
只按 LF 计物理行。支持楔子、序章、第0章、任意正文起始章、番外、后记、中文大数、英文章号、多卷重置和卷章组合。目录与正文标题重复时先剔掉目录块；落表前校验章号连续、无重复和边界有效，其中特殊章独立编号，正文允许从任意首章开始。原文变化先拒绝；脚本因原文变化、章号对不上而停下并返回 author_message 时，读 references/index-rebuild.md ，把说明和选项转告作者（默认推荐按旧章号继续）。
Stage 1：黄金三章 按索引读前三章原文，同一次阅读写三份单章深度拆解、可选 _style-sample.txt，再写 快速预览.md（模板在 author-facing.md「快速预览.md」）；深度拆解与文风样本模板见 references/stage1-golden-chapters.md 。黄金三章与快速预览落盘后运行 manage_analysis_run.py mark-stage --stage stage1，再按上方规则停下来问或继续。
Stage 2：计划、提取、提交 按 references/pipeline-ops.md 执行：manage_analysis_run.py plan 出只读计划（用户明确增强用 --intent enhance，逐批加 --next，只拆一段加 --chapters 起-止），每批派一个 chapter-extractor，只照抄计划里这一批的字段；子代理自己读原文、把结果写进 _analysis_cache/输入-{批次ID}.md、只回一行回执，主会话不转贴原文、不读这份输入，直接 commit。批次过大或连续失败用 split，中断用 repair-progress。计划不再有批次、全部摘要落盘后运行 manage_analysis_run.py mark-stage --stage stage2。
Stage 3：剧情、双时间线与三维节奏 按 references/stage3-plot-rhythm.md 生成剧情单元、故事线、剧情/节奏.md 与 剧情/情绪模块.md，取料用 digest（见 synthesis-inputs.md）。两份权威文件都落盘后运行 manage_analysis_run.py mark-stage --stage stage3 --output "剧情/节奏.md"。
Stage 4：角色、设定与关系
Stage 5：主报告 报告按 author-facing.md「拆文报告.md」写：拆到哪、核心发现、读者在追什么、故事怎么推进、人物与关系、读者与角色的信息差、节奏、核心机制、可借鉴套路、不建议模仿、文风一句话、还不确定的地方。生成新报告前运行 manage_analysis_run.py mark-stage --stage stage5 --prepare，新报告与完整概要落盘后再运行 manage_analysis_run.py mark-stage --stage stage5（细则见 references/stage5-report.md ）。报告只综合底层结果，不再次阅读全文。
如项目存在 选题决策.md，只回填仍标记“待拆文验证”且题材匹配的项。没有「推荐选题」一节（只扫了榜）就跳过回填，不算无效；有推荐选题但缺少当前契约必需的“能爆的原因”等字段时返回 invalid_topic_decision_contract，提示重跑 story-long-scan Phase 5；文件不存在不影响拆文。
Stage 6：文风与单独重建
三层灵感库管道（可选后置） 用户提出「灵感库 / 提炼灵感 / 跨书灵感聚合 / 更新灵感库」时加载 references/inspiration-library.md 。复用 Stage 3 的 EM 机制卡：inspiration_index.py register-atoms 机械登记原子灵感索引（无 IA 文件），再按该文档做单书合并与带受控标签的跨书聚合；卡内只用 书名/EM-xxx 裸 ID，禁路径引用。缺情绪模块的书先走上方按需增强，不在灵感层代拆。单书拆文不自动入库。
状态与旧项目 运行状态只有 _progress.md 受管区；既有 schema_version: 2 原值保留；chapter_index.csv 是机械索引；缓存是恢复证据。有阶段记录后，受管区的 最终状态 由脚本按 Stage 3–6 的阶段状态写出（都完成为 completed，否则 pending）；旧项目沿用自己原有的 最终状态 行，全部完成时由脚本改为 completed，不写第二行，会话 hooks 靠它判断拆文是否完成，不要手改。不得创建运行计划、checkpoint、逐批 JSON receipt 或 Stage receipt。
How do I install story-long-analyze? Download skills/story-long-analyze/SKILL.md from the publisher, or copy the path and open the repository. PlugMCP lists the skill and does not host the file.
Where does story-long-analyze live? The publisher keeps it at https://github.com/zenstory-ai/oh-story-claudecode.
Which agents can use story-long-analyze? Claude, Cursor, and Codex can read a SKILL.md you add from the publisher's repository.