SuperAPI AI Directory

story

General & other

View repository

Updated 10-16 09:45

About this skill

story: web novel toolbox routing

You are the routing entry point of the web novel toolbox. When the user's request is vague, you dispatch it to the specific skill.

Routing table

In Codex CLI, prefer using $story-* or /skills to trigger; Claude Code / OpenCode continue to use /story-*; Antigravity can select from /skills or name it in natural language; OpenClaw can use /skill story-* or name the skill in natural language. The table below is shown with slash commands; Codex can equivalently replace /story-long-write with $story-long-write, and OpenClaw can equivalently replace it with /skill story-long-write。

User intent Keyword examples Route to
Long-form planning/writing Discuss long-form structure, plan plot, start a book, write outline, supplement detailed outline, long-form, serialization /story-long-write
Write short stories Short story, Yanyan, ten thousand words /story-short-write
Long-form breakdown Breakdown, analyze this book, golden three chapters, inspiration library, cross-book inspiration aggregation /story-long-analyze
Short story breakdown Break down short stories, analyze this story /story-short-analyze
Long-form ranking scan Long-form rankings, what's hot, what new books are emerging, Qidian/Fanqie/Jinjiang/Qimao long-form /story-long-scan
Topic selection decision What can go viral, help me choose a topic, topic direction /story-long-scan
Short story ranking scan Short story rankings, Zhihu Yanyan rankings /story-short-scan
Remove AI flavor Remove AI flavor, too AI, remove flavor /story-deslop
Review manuscript Review, manuscript review, help me review it, consistency check, see if there are any problems /story-review
Cover Cover, cover image /story-cover
Environment setup Prepare to write a book, set up environment, initialize /story-setup
Browser control Browser, scrape, login state /browser-cdp
Import novel Import, reverse parse, import novel, bring my book in /story-import
Workbench dashboard, workbench, view breakdown library, browse project files, open project panel See "Dashboard Workbench" below
Check/update version Check for updates, is there a new version, upgrade, update toolbox See "Version update check" below
Switch/list books Switch book, change book, list my books, which books am I writing, switch project See "Multi-book switching" below
Manage author habits Remember my writing habits, author profile, preferences to be confirmed, forget this preference See "Author memory" below
Look up story information Look up characters, look up foreshadowing, look up progress, look up settings, what status, where has it been written spawn story-explorer agent (structured prompt:项目目录:{dir}\n查询类型:{根据意图选择}\n查询参数:{用户查询}); when agent is unavailable, see "Query fallback" below
Look up information look up information, help me look up information, research, search for it, search spawn story-researcher agent; if the agent is unavailable, see "Query fallback" below

Bare calls and beginners

When only /storyis said, or the intent is unclear, do not paste the routing table; give four plain-language options: "start a long-form book or continue writing" → /story-long-write; "write a short story" → /story-short-write; "make a chapter less AI-like" → /story-deslop; "more (book breakdown, ranking scan, import old drafts, manuscript review, cover)" → then list advanced items. If not yet deployed (no .story-deployedin the project root), first suggest /story-setup。

Import and continuation order

When the user asks "for import and continuation, should I setup or import first", answer directly:Recommended: first /story-setup, after starting/refreshing the session /story-import, and finally /story-long-write 日更 or /story-long-write 写第N章. If the user has already directly triggered /story-import, continue according to story-import's built-in environment detection: if not yet set up, let the user choose whether to go set up first or continue with serial import.

Author memory

When the user asks to remember, view, confirm, replace, or forget author habits, load references/author-memory.md, and use only this skill's scripts/author_memory_commit.py to manage the two levels of .story/作者记忆/: global, genre, and workflow entries in the workspace (AP); this book's entries in the book directory (BP, pass --book-root). For common changes, use the single event record; before the tool returns ok: true and Author Memory Receipt , do not claim it has been remembered. When telling the author, first say in one plain sentence what was remembered (e.g. "Remembered: this book's dialogue always uses 「」"), and put the receipt on the last line; for how to write it, see the protocol "How to tell the author the receipt". Displaying the profile or pending-confirmation items is a read-only operation; if none exists, directly state that it has not been established yet.

New habits must preserve the user's original words and scope of application. One-time requests are only executed, not recorded; novel facts are written into this book's settings/tracking; do not infer preferences from repeated revisions or finished drafts, record only what the author explicitly says, and only put it into pending confirmation if the scope of the original words is ambiguous; when it conflicts with an already effective habit, explicitly replace, do not rewrite history in place. Load migrate --book-rootagain when the author says "organize author memory", the receipt indicates too many habits have accumulated, the tool reports a single-book layout error, or the project-level profile still has "this book:" entries (recommended to run references/author-memory-maintenance.mdfor that book). When the user has not specified a workspace, locate the nearest ancestor with existing author memory or the current writing workspace according to the protocol; it is forbidden to default to writing into the user's home directory.

Dashboard workbench

When the user executes /story dashboard(for Codex, $story dashboard), or explicitly says "open the workbench / view project files", directly start the local Dashboard distributed with this skill, and do not forward to other skills:

  1. Usethe current working directoryas the default workspace; if the user explicitly gives a directory, use that directory instead. The directory must exist.

  2. From the currently loaded story skill directory, locate scripts/dashboard-server.mjs, do not hardcode the repository path, global skill path, or user home directory.

  3. After checking that node is available, execute as a long-running process:

    node "<story-skill-dir>/scripts/dashboard-server.mjs" --root "<workspace>" --open
    
  4. Wait for the output to show "local address", and return the full URL to the user. When the tool supports background processes/PTY, keep the service running; being unable to automatically launch the browser does not count as failure, still return the clickable URL.

  5. By default, Dashboard only listens on 127.0.0.1. Do not proactively add --allow-network, and do not expose the workspace to the LAN or the public internet.

The workbench recognizes standard 拆文库/{书名}/, and is compatible with existing 拆文库-{书名}/. Writing project recognition also supports:

  • Long-form directory structure: the directory contains 正文/、大纲/、设定/ or 追踪/ any ordinary subdirectory.
  • Short-form single-file structure: the directory contains the ordinary file 正文.md, and also contains 小节大纲.md or 设定.md。

Symbolic links are not treated as project markers, and only a single 正文.md ordinary resource directory will not be misidentified either. The browser can edit .md、.txt、.json、.yaml、.yml、.toml, and before saving or confirming deletion, use the modification time to prevent accidental external updates.

To stop the service, simply terminate the corresponding long-running Node process. If the user only asks about usage, do not start it for them; provide /story dashboard / $story dashboard the corresponding entry points for the two platforms.

Routing flow

  1. Analyze the user request and extract intent keywords
  2. Match against the table above to find the corresponding skill
  3. If a clear match can be made, directly call the corresponding skill (Claude/OpenCode can use Skill("skill-name") or slash command; Codex uses $skill-name / /skills; Antigravity uses /skills or names it in natural language; OpenClaw uses /skill skill-name or names it in natural language)
  4. If no match can be made, ask the user what they want to do (choose from the table above)
  5. If the user says "I want to write a novel" but does not specify long-form/short-form, ask for the length type before routing

Query degradation

Spawn version notice (does not block spawn): first read the project root .story-deployed of agents_version. If it is inconsistent with this version's agents_version: 34 (marker missing, field missing/non-integer, less than or greater than 34)check by file existence as usual and spawn, but only check the canonical directory of the current runtime; at the same time report Notice: agents bundle 版本不匹配(项目 {N},本版 34) and prompt to rerun /story-setup and then start a new session; if greater than 34, additionally prompt to first update oh-story-claudecode, and do not use the local old setup to downgrade and overwrite. Only degrade to solo/direct when agent files are missing, or the runtime does not expose custom agents; report Fallback: ... -> solo。

"Look up story materials" and "Look up materials" should do a lightweight availability check before going through the agent (routing only does this layer, and does not assume the global deployment policy): currently not in a sub-agent context, the current runtime's Agent/Task or invoke_subagent tool is available, and the corresponding deployment files exist (Claude .claude/agents/*.md、OpenCode .opencode/agents/*.md、Codex .codex/agents/*.toml、Antigravity .agents/agents/agent-name/agent.md, where agent-name is the target agent name) → spawn can be attempted. Antigravity uses invoke_subagent + same-named TypeName, and must not be misjudged because files for other platforms exist. If any condition is not met, or the runtime returns unknown agent / does not expose the custom-agent registry, then degrade, do not hard fail:

  • story-explorer unavailable → the main session directly uses Read/Grep to retrieve from project files (character status/foreshadowing/progress/settings), and before answering says "The materials lookup assistant is not enabled, so this time I'll go through the project files directly"; if the project is not yet deployed, prompt to first /story-setup(in Codex use $story-setup)。
  • story-researcher unavailable → the main session completes it with existing retrieval/answering capabilities, or prompts the user to switch to /browser-cdp collection, likewise with a plain-language explanation.

When answering the author, talk about things in the story (who, in which chapter, what happened); file field names and foreshadowing/event numbers do not appear alone, and numbers must accompany the story description.

Project status awareness

Check the current project status before routing:

  • No project directory(no title directory containing 追踪/ or 设定/ , and no short-story directory with both 正文.md and 小节大纲.md(or 设定.md)):
    • If the user wants to write, the next step is to first run /story-setup to initialize the environment (in Codex use $story-setup)
    • If the user wants to scan rankings/split texts, route directly
  • Existing project: check the .story-deployed marker, and if not deployed, first run /story-setup(in Codex use $story-setup)

Multi-book switching

When the user wants to switch or view the book(s) being written (one project can have multiple books at once):

  1. Find all book directories at the project root: directories containing 追踪/ or 设定/ subdirectories, or directories with both 正文.md and 小节大纲.md(or 设定.md) (including subdirectories under 长篇/、短篇/ ).
  2. List the book titles and mark the one that the current .active-book points to.
  3. Let the user choose, and write the relative path of the selected book to the project root .active-book(overwriting the original content).
  4. When only one is found, directly confirm it as the active book without asking.

Version update check

Execute when the user asks "is there a new version", "check for updates", or "upgrade".Only notify; whether to update is up to the user, do not auto-install.

  1. Current version: read the VERSION file in the same directory as this skill; if missing, treat as unknown.
  2. Latest version: prefer gh release view --json tagName,name,url -R zenstory-ai/oh-story-claudecode to get tagName; without gh use curl -fsS --max-time 5 https://api.github.com/repos/zenstory-ai/oh-story-claudecode/releases/latest to get .tag_name(jq or grep). If it can't be found → tell them "can't fetch the latest version right now, you can check manually at Releases", do not error.
  3. Compare: strip the v prefix and compare by semantic version (major.minor.patch).gh release defaults to the latest stable release, excluding pre-release.
  4. Notify:
    • Already latest → "Already the latest version vX.Y.Z".
    • New version available → list current vA → latest vB + Releases/CHANGELOG(attach this release's key points if release notes are available), then use AskUserQuestion to ask "Update now?":
      • Choose update → run npx skills add zenstory-ai/oh-story-claudecode -y -g(-g globally; removing it updates only the current directory); after completion prompt: for already deployed projects, rerun at the project root /story-setup(in Codex use $story-setup) to sync hooks/agents/references, andopen a new sessionto let agents re-register.
      • Choose not now → do nothing, tell them they can come back anytime.