Skip to content

zenstory-ai/oh-story-claudecode / skills/story-setup

story-setup

Flagged

网文写作工具集基础设施部署与检查。为 Claude Code / OpenCode / Codex / Google Antigravity / ZCode / OpenClaw / Reasonix 提供内置适配;Web AI / 通用 Agent 可走 skills + AGENTS.md 文件模式。触发方式:/story-setup、$story-setup、「准备写书」「帮我搭一下环境」「配置写作项目」「检查写作环境」。

FileKindSize
SKILL.mdskill md16.8 KB
UPGRADING.mdmarkdown17.1 KB
references/agent-references/agent-quality.mdmarkdown3.7 KB
references/agent-references/agent-reference-profiles.mdmarkdown4.3 KB
references/agent-references/banned-words.mdmarkdown10.9 KB
references/agent-references/benchmark-style-load.mdmarkdown10.1 KB
references/agent-references/character-basics.mdmarkdown12.3 KB
references/agent-references/character-relations.mdmarkdown10.2 KB
references/agent-references/cross-book-recall.mdmarkdown3.9 KB
references/agent-references/deslop-gates.mdmarkdown2.3 KB
references/agent-references/dialogue-mastery.mdmarkdown11.0 KB
references/agent-references/expression.mdmarkdown9.6 KB
references/agent-references/female-audience-writing.mdmarkdown7.5 KB
references/agent-references/format-and-structure.mdmarkdown8.0 KB
references/agent-references/genre-prose-cards.mdmarkdown7.0 KB
references/agent-references/genre-prose-cards/东方仙侠.mdmarkdown2.3 KB
references/agent-references/genre-prose-cards/传统玄幻.mdmarkdown1.9 KB
references/agent-references/genre-prose-cards/历史古代.mdmarkdown1.7 KB
references/agent-references/genre-prose-cards/历史脑洞.mdmarkdown2.0 KB
references/agent-references/genre-prose-cards/双男主.mdmarkdown2.3 KB
references/agent-references/genre-prose-cards/古言脑洞.mdmarkdown1.8 KB
references/agent-references/genre-prose-cards/古风世情.mdmarkdown2.3 KB
references/agent-references/genre-prose-cards/女频悬疑.mdmarkdown1.8 KB
references/agent-references/genre-prose-cards/女频种田.mdmarkdown1.8 KB
references/agent-references/genre-prose-cards/宫斗宅斗.mdmarkdown1.6 KB
references/agent-references/genre-prose-cards/年代.mdmarkdown2.1 KB
references/agent-references/genre-prose-cards/快穿.mdmarkdown1.9 KB
references/agent-references/genre-prose-cards/悬疑灵异.mdmarkdown1.7 KB
references/agent-references/genre-prose-cards/悬疑脑洞.mdmarkdown1.9 KB
references/agent-references/genre-prose-cards/战神赘婿.mdmarkdown1.9 KB
references/agent-references/genre-prose-cards/抗战谍战.mdmarkdown1.8 KB
references/agent-references/genre-prose-cards/星光璀璨.mdmarkdown1.8 KB
references/agent-references/genre-prose-cards/民国言情.mdmarkdown1.9 KB
references/agent-references/genre-prose-cards/流派兜底.mdmarkdown8.4 KB
references/agent-references/genre-prose-cards/游戏体育.mdmarkdown1.9 KB
references/agent-references/genre-prose-cards/玄幻脑洞.mdmarkdown2.0 KB
references/agent-references/genre-prose-cards/玄幻言情.mdmarkdown1.7 KB
references/agent-references/genre-prose-cards/现言脑洞.mdmarkdown1.8 KB
references/agent-references/genre-prose-cards/科幻末世.mdmarkdown1.7 KB
references/agent-references/genre-prose-cards/职场婚恋.mdmarkdown1.7 KB
references/agent-references/genre-prose-cards/西方奇幻.mdmarkdown1.9 KB
references/agent-references/genre-prose-cards/豪门总裁.mdmarkdown2.3 KB
references/agent-references/genre-prose-cards/都市修真.mdmarkdown1.7 KB
references/agent-references/genre-prose-cards/都市日常.mdmarkdown2.8 KB
references/agent-references/genre-prose-cards/都市种田.mdmarkdown1.7 KB
references/agent-references/genre-prose-cards/都市脑洞.mdmarkdown2.4 KB
references/agent-references/genre-prose-cards/都市高武.mdmarkdown2.0 KB
references/agent-references/genre-prose-cards/青春甜宠.mdmarkdown1.8 KB
references/agent-references/genre-readers.mdmarkdown6.9 KB
references/agent-references/long-chapter-hooks.mdmarkdown6.5 KB
references/agent-references/long-emotional-methods.mdmarkdown7.9 KB
references/agent-references/long-genre-catalog.mdmarkdown11.9 KB
references/agent-references/long-genre-mechanics.mdmarkdown8.3 KB
references/agent-references/long-quality.mdmarkdown3.2 KB
references/agent-references/long-reversal.mdmarkdown12.3 KB
references/agent-references/long-suspense.mdmarkdown9.2 KB
references/agent-references/narrative-focus.mdmarkdown6.7 KB
references/agent-references/opening-design.mdmarkdown4.5 KB
references/agent-references/outline-methods.mdmarkdown12.5 KB
references/agent-references/plot-core-methods.mdmarkdown5.3 KB
references/agent-references/short-chapter-hooks.mdmarkdown8.0 KB
references/agent-references/short-emotional-methods.mdmarkdown4.6 KB
references/agent-references/short-genre-formulas.mdmarkdown18.8 KB
references/agent-references/short-quality.mdmarkdown2.8 KB
references/agent-references/short-reversal.mdmarkdown12.7 KB
references/agent-references/story-logic.mdmarkdown5.9 KB
references/agent-references/style-combat-face.mdmarkdown9.1 KB
references/agent-references/style-resolution.mdmarkdown3.0 KB
references/agent-references/writing-craft.mdmarkdown23.6 KB
references/antigravity/hooks/hooks.jsonconfig1.0 KB
references/antigravity/hooks/story_antigravity_hook.jsscript8.3 KB
references/antigravity/hooks/story_hook_core.jsscript59.9 KB
references/antigravity/rules/oh-story.mdmarkdown3.7 KB
references/codex/AGENTS.md.tmplother3.8 KB
references/codex/agents/chapter-extractor.tomlconfig14.0 KB
references/codex/agents/character-designer.tomlconfig5.1 KB
references/codex/agents/consistency-checker.tomlconfig12.0 KB
references/codex/agents/narrative-writer.tomlconfig15.7 KB
references/codex/agents/story-architect.tomlconfig9.0 KB
references/codex/agents/story-explorer.tomlconfig11.7 KB
references/codex/agents/story-researcher.tomlconfig10.6 KB
references/codex/hooks/hooks.jsonconfig6.8 KB
references/codex/hooks/run-story-hook.cmdscript699 B
references/codex/hooks/run-story-hook.shexecutablescript769 B
references/codex/hooks/story_codex_hook.pyexecutablescript74.2 KB
references/deploy-antigravity.mdmarkdown8.8 KB
references/deploy-claude-code.mdmarkdown7.6 KB
references/deploy-codex.mdmarkdown6.0 KB
references/deploy-generic.mdmarkdown2.5 KB
references/deploy-openclaw.mdmarkdown3.0 KB
references/deploy-opencode.mdmarkdown14.7 KB
references/deploy-reasonix.mdmarkdown3.5 KB
references/deploy-zcode.mdmarkdown7.5 KB
references/diagnostics.mdmarkdown4.3 KB
references/generic/AGENTS.md.tmplother4.4 KB
references/openclaw/AGENTS.md.tmplother5.0 KB
references/opencode/AGENTS.md.tmplother3.2 KB
references/opencode/agents/chapter-extractor.mdmarkdown13.8 KB
references/opencode/agents/character-designer.mdmarkdown4.7 KB
references/opencode/agents/consistency-checker.mdmarkdown11.5 KB
references/opencode/agents/narrative-writer.mdmarkdown15.3 KB
references/opencode/agents/story-architect.mdmarkdown8.5 KB
references/opencode/agents/story-explorer.mdmarkdown11.2 KB
references/opencode/agents/story-researcher.mdmarkdown10.1 KB
references/opencode/commands/browser-cdp.mdmarkdown284 B
references/opencode/commands/story-cover.mdmarkdown189 B
references/opencode/commands/story-deslop.mdmarkdown222 B
references/opencode/commands/story-import.mdmarkdown235 B
references/opencode/commands/story-long-analyze.mdmarkdown214 B
references/opencode/commands/story-long-scan.mdmarkdown232 B
references/opencode/commands/story-long-write.mdmarkdown200 B
references/opencode/commands/story-publish.mdmarkdown224 B
references/opencode/commands/story-review.mdmarkdown212 B
references/opencode/commands/story-setup.mdmarkdown322 B
references/opencode/commands/story-short-analyze.mdmarkdown209 B
references/opencode/commands/story-short-scan.mdmarkdown215 B
references/opencode/commands/story-short-write.mdmarkdown192 B
references/opencode/commands/story.mdmarkdown243 B
references/opencode/plugin.tsscript12.2 KB
references/opencode/pre-commit.shscript4.3 KB
references/opencode/story_hook_core.jsscript59.9 KB
references/reasonix/AGENTS.md.tmplother5.3 KB
references/templates/.gitkeepother0 B
references/templates/CLAUDE.md.tmplother3.2 KB
references/templates/agents/chapter-extractor.mdmarkdown13.9 KB
references/templates/agents/character-designer.mdmarkdown4.5 KB
references/templates/agents/consistency-checker.mdmarkdown11.3 KB
references/templates/agents/narrative-writer.mdmarkdown15.2 KB
references/templates/agents/story-architect.mdmarkdown8.4 KB
references/templates/agents/story-explorer.mdmarkdown10.9 KB
references/templates/agents/story-researcher.mdmarkdown10.0 KB
references/templates/hooks/check-prose-after-write.shscript6.0 KB
references/templates/hooks/detect-story-gaps.shexecutablescript7.0 KB
references/templates/hooks/guard-outline-before-prose.shscript14.4 KB
references/templates/hooks/lib/common.shscript7.7 KB
references/templates/hooks/lib/sentinel.shscript1.5 KB
references/templates/hooks/post-compact.shexecutablescript698 B
references/templates/hooks/pre-compact.shexecutablescript1.0 KB
references/templates/hooks/session-end.shexecutablescript946 B
references/templates/hooks/session-start.shexecutablescript11.2 KB
references/templates/hooks/story_hook_cli.jsscript10.6 KB
references/templates/hooks/story_hook_core.jsscript59.9 KB
references/templates/hooks/validate-story-commit.shexecutablescript6.4 KB
references/templates/rules/story-consistency.mdmarkdown2.5 KB
references/templates/rules/story-format.mdmarkdown3.4 KB
references/templates/rules/story-narrative.mdmarkdown1.5 KB
references/templates/rules/story-outline.mdmarkdown3.5 KB
references/templates/settings-hooks.jsonconfig2.0 KB
references/zcode/AGENTS.md.tmplother4.4 KB
references/zcode/agents/chapter-extractor.mdmarkdown13.5 KB
references/zcode/agents/character-designer.mdmarkdown4.4 KB
references/zcode/agents/consistency-checker.mdmarkdown11.3 KB
references/zcode/agents/narrative-writer.mdmarkdown15.0 KB
references/zcode/agents/story-architect.mdmarkdown8.3 KB
references/zcode/agents/story-explorer.mdmarkdown11.0 KB
references/zcode/agents/story-researcher.mdmarkdown9.9 KB
references/zcode/commands/browser-cdp.mdmarkdown221 B
references/zcode/commands/story-cover.mdmarkdown204 B
references/zcode/commands/story-deslop.mdmarkdown234 B
references/zcode/commands/story-import.mdmarkdown200 B
references/zcode/commands/story-long-analyze.mdmarkdown218 B
references/zcode/commands/story-long-scan.mdmarkdown206 B
references/zcode/commands/story-long-write.mdmarkdown202 B
references/zcode/commands/story-publish.mdmarkdown247 B
references/zcode/commands/story-review.mdmarkdown217 B
references/zcode/commands/story-setup.mdmarkdown363 B
references/zcode/commands/story-short-analyze.mdmarkdown214 B
references/zcode/commands/story-short-scan.mdmarkdown217 B
references/zcode/commands/story-short-write.mdmarkdown204 B
references/zcode/commands/story.mdmarkdown221 B
references/zcode/config.json.patchother1.7 KB
references/zcode/hooks/hooks.jsonconfig1.6 KB
references/zcode/hooks/story_hook_core.jsscript59.9 KB
references/zcode/hooks/story_zcode_hook.jsexecutablescript6.7 KB
scripts/copy-path-safety.pyexecutablescript5.1 KB
scripts/deploy-antigravity-skills.pyexecutablescript4.5 KB
scripts/generate-antigravity-agents.mjsexecutablescript12.4 KB
scripts/merge-antigravity-hooks.pyexecutablescript2.3 KB
scripts/merge-claude-settings.pyexecutablescript4.6 KB
scripts/merge-codex-hooks.pyscript5.2 KB
scripts/merge-project-instructions.pyscript10.5 KB

references/agent-references/short-chapter-hooks.md

View on GitHub
# 短篇钩子:节尾、节首、段落与全文悬念

> 谁读:构思时付费点断点或节尾落点拿不准,主会话只读「2. 节尾」;story-architect 辅助构思时读副本。写正文不读,按小节大纲「节尾停在哪」执行。

> 节尾怎么停、要不要每节都下强钩子,只在「2. 节尾」定,别的文件只指到这里。其余各节在设计对应写法时按需查;示例标点仅作示意,写正文时按本篇的格式规范改写。

---

## 1. 全文悬念的承接与收束

先确定全文最终要回答的核心问题。副悬念为它提供证据、误导或情绪代价,不另开独立支线。

局部问题揭晓后,让答案改变下一步行动、关系立场或读者对核心问题的判断。延迟揭晓时,也要交付新证据、误判修正或局部反击,避免一直抬问题。

舒缓的小节可用局部兑现和明确行动承接。进入终局时回答核心问题,不用无关的新谜题延长故事。

---

## 2. 节尾:停在答案出来之前

非末节节尾多停在狠话条件、动作打断、来人或物件刚打开的一刻:

| 落点 | 怎么停 | 示例 |
|---|---|---|
| 动作被打断 | 关键动作做到一半,结果放到下一节 | 绑匪举刀刺向我腹部的瞬间,紧闭的房门突然被人一脚踹开。 |
| 来人或来电 | 关键人物到场,或电话那头换了人 | 我正拿着离婚协议等丈夫回家签字,他的手机终于打通,接电话的却是派出所民警! |
| 证据只亮一处 | 文件、物件刚翻开,只亮最扎眼的一处 | 我翻开那份被改成意外的尸检报告,在鉴定人签名栏里,看到了我法医妻子的名字。 |
| 狠话或条件落尾 | 对方把话说绝或开出条件,主角怎么回应留到下一节 | 婆婆把病危通知书摔在我脸上:“要想拿钱给你妈治病,先把你名下的婚房过户给你小叔子!” |
| 身份将揭 | 有人问出关键问题,或说漏一句 | 门外巡查的大姐听见禁闭室里敲出的儿时暗号,脚步猛地顿住:“这里面关着的到底是谁?!” |
| 主角留了后手 | 读者看见主角的准备,对手还不知道 | 丈夫叫私人医生给我打镇定剂封口时,我借着袖子遮挡,不动声色按下了录音键。 |
| 后果预告 | 叙述者提前说这一步会出事,或谁后来会后悔 | 我冷着脸让讹人的租客趁早搬走,可我没想到,就因为这句话,第二天全网都在骂我是逼死穷人的恶房东。 |
| 心死定格 | 一句话把主角从忍让切到决裂 | 看着他护在白月光身前的背影,我心里最后的一束光,也彻底熄灭了。 |
| 异常出现 | 悬疑、民俗里不该动的东西动了 | 半夜我把女儿新买的洋娃娃锁进柜子,刚转身,原本背对我的娃娃脑袋突然咔哒一声转向了我。 |

- 付费点所在节停在答案未出的一刻,如不知女主已死的未婚夫还在酒店向白月光求婚,「载着我遗体的灵车停到酒店门口时,他刚好捧着鲜花下车。」
- 过渡节可用局部兑现或下一步收住,相邻几节换落点。甜宠、轻喜与日常向不必硬套凶案背叛,可用「悬着的糖」、好意被误会或约定收节(如死对头亮出昨晚误拨的电话录音,追问她酒后答应的事算不算数;或男主让人连夜搬空女主偏房的行李,女主以为被赶出门,推门才发现全搬进了男主主卧)。
- 别用「或许」「她知道,明天会是新的开始」这类总结或抒情句收节。

---

## 3. 节首:接住上一节

短篇节首不到一成用对白开场;非对白节首约七成直接写上一节尾的结果或接下来那一拍,其余先用一句话交代时间或地点变化(如「没过几天」「再次听到她的消息,是在三年后」),再进事件。

- 第一句接住上一节留下的问题:写那一下的结果、谁的反应,或对白的回应。
  - 如上一节停在「我抬手,当着全家人的面,狠狠给了婆婆一耳光!」,下一节开头接「这一耳光让祠堂里的吵闹声瞬间安静了下来。」
- 要跳时间或换地点,一句交代完就进事件,不用风景、天气开场,也不用不带事件的抒情独白开场;接住上一节或带出新信息的独白可以。
- 全文第一节的开头不受本条限制,按题材的开篇写法,第一句就是事件。

---

## 4. 段落钩子:节内的期待

节内也要让读者等着看点什么。下面几种在短篇里最常见:

| 名称 | 做法 | 示例 |
|---|---|---|
| 信息差 | 读者知道、对手不知道的事,写成一句具体事实 | 前夫得意地笑:“如今我已是尚书,你若肯低头认错,我还准你回府做妾。”他不知道,昨日宫里刚下旨封我为国公夫人。 |
| 暗牌 | 主角悄悄留证据,读者等亮牌 | 看着丈夫和婆婆脸上虚伪的笑意,我知道他们是冲着拆迁款来的,默默打开了口袋里的手机录音。 |
| 假意顺从 | 主角主动让出对方想要的东西,读者知道她另有打算 | 未婚妻在股东会上逼我把副总职位让给她竹马,我平静签字:“既然你想要,让出来就是了。”反正答应她亡父替她守公司的三年之约今天到期,我也该走了。 |
| 倒计时 | 给出到期的日子,到期必须兑现 | 看着诊断书上的晚期字样,我把离婚协议放进抽屉。熬过最后两天,我就彻底解脱了。 |
| 灵魂旁观 | 主角已死,看得见改变不了 | 我飘在半空想告诉他凶手是谁,声音却被风吹散,他什么都听不到。 |
| 异常物件 | 不该出现的东西出现在这里 | 拆开女儿玩偶的肚子后,里面的填充棉里竟塞着一张求救字条。 |
| 弱者一句话 | 孩子或弱者一句话戳穿施害者 | 丈夫以为绑匪撕票的是外人,还在陪白月光庆生,五岁女儿突然指着电视里的新闻问:“爸爸,那个被抬上救护车的阿姨,戴的不是妈妈的手链吗?” |

- 「他不知道」后面必须跟一件具体的事;只写「他不知道的是,一切才刚刚开始」没有信息,删掉。
- 信息差悬着的时候,持续给新证据、局部答案或行动后果;暗牌在能改变局势时亮。
- 倒计时一旦设下,到期必须兑现。灵魂视角只能看、不能动,全篇守住。
- 代价要真影响选择;最后躲过损失,也写清付出了什么。弱者要有影响主线的行动或选择,不只当受害道具。
- 常见组合:信息差加暗牌(读者知道主角在憋大招,复仇、世情)、倒计时加代价(选哪个都亏,悬疑、婚恋)、暗牌加打脸(复仇、逆袭)、弱者加代价(追妻、世情、死人文学);甜宠与沙雕轻喜则常用「心思错位加反差动作」(对方以为在施压或拿捏,主角心里在盘算年终奖或加班费;或冰山男主一本正经做离谱暖心事)。组合里每种都要带来信息、选择或情绪变化,没用的去掉。

---

## 5. 伤害与围观

- **不公平的伤害最拉仇恨**:主角无辜,伤害落在身上也落在心上。「不患寡而患不均」:月例大家都减是公平,唯独主角的药材降了一等才是不公平。伤害可以是掠夺逼迫(反派不想自己吃亏)、嫁祸顶罪(反派把惩罚推给主角)、陷害算计(主角打破了反派的秩序)。
- **围观要选人**:围观者用判断说明对手多强,结果出来后改变立场。熟人震惊比陌生人有力,懂行的人能说出赢在哪里,比只会惊叫的路人有用;多种身份、多个层级各有不同反应,比一群人同声惊叹好。围观只放大结果,不替主角的行动出力。

---

## 6. 钩子禁忌

| 禁忌 | 说明 |
|---|---|
| 假悬念 | 威胁不存在或下一节开头立刻解除,读者被骗一次就不再信 |
| 巧合解围 | 节尾抛出危机,下一节靠巧合解决 |
| 过度留白 | 连续几节不揭示任何信息 |
| 低风险钩 | 用无关紧要的事制造悬念 |
| 机械复用 | 连续用同一种手法问同一个问题,没有新信息或局部兑现 |
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 323kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 323kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 323kUpdated Claude CodeCodexVerifiedInstall