story-long-analyze Skill: Web Novel Teardown in Claude Code

• Starts a teardown of a long novel from a text file or an existing analysis folder

  Also triggered by /长篇拆文 or phrases like "拆这本书". Asks for the book title, platform and text file path if you did not give them.

  Try: “/story-long-analyze 帮我拆这本书，原文在 ~/novels/盘龙.txt”

  Write · /story-long-analyze

• Runs inspect_existing_assets.py to see what is already analysed

  Checks an existing analysis folder and picks a path: new analysis, continue a partial one, use finished results as they are, or repair missing stages.

  Runs code · Inspect existing results

• Runs build_chapter_index.py to write chapter_index.csv

  Saves your text as 原文/原文.txt (converted to UTF-8 if it is GBK), then lists chapter boundaries and a hash for each chapter.

  Runs code · Stage 0: chapter index

• Deep breakdown of chapters 1 to 3 plus a quick preview

  Writes one deep-dive file per opening chapter and 快速预览.md, then stops to ask you before the long run, unless you asked for it all at once.

  Write · Stage 1: golden three chapters

• Hands chapter batches to chapter-extractor helper agents, 3 batches per round

  Each batch is read once and produces chapter summaries. If helper agents are not available it falls back to doing the work in the main session.

  Write · Stage 2: batch extraction

• Plot units, storyline, rhythm and reader-emotion modules

  Works from the saved summaries without re-reading the book. Writes the 剧情/ folder.

  Write · Stage 3: plot and rhythm

• Character files, setting files and a relation chart

  Writes 角色/ and 设定/, then render_relation_chart.py draws the chart from 角色/角色关系.md.

  Runs code · Stage 4: characters and settings

• Writes 拆文报告.md, the file to read first

  Also fills in matching items in a 选题决策.md left by story-long-scan, if one exists.

  Write · Stage 5: main report

• Writes 文风.md from quotes taken from the book

  Needs verifiable original sentences; if it cannot get them it fails instead of guessing.

  Write · Stage 6: style profile

• Three-layer idea library; only writes under 灵感库/

  Runs only when you ask for 灵感库, cross-book aggregation or an update. Uses inspiration_index.py.

  Runs code · Inspiration library (optional)

• Plan, commit, split, repair and mark stages in _progress.md

  The progress keeper. Its subcommands are plan, commit, split, repair-progress, mark-stage and digest.

  Runs code · manage_analysis_run.py

Watch out for

• It runs Python scripts and writes many files

  Five bundled scripts index chapters, track progress and draw the relation chart. Run it inside a project folder you can review, and keep your original novel file elsewhere. github.com

• Setup step adds hooks and agents to your project

  The README says /story-setup deploys hooks, helper agents and references for your agent. Read what it adds before you run it. github.com

• Redoing a chapter means deleting its files yourself

  SKILL.md says to delete the chapter summary and the batch cache that covers it, then run again. github.com