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/templates/hooks/validate-story-commit.sh

View on GitHub
#!/bin/bash
# validate-story-commit.sh — 在 git commit 时检查格式问题(WARNING only, no BLOCKING)
set -euo pipefail

source "$(dirname "$0")/lib/common.sh"

HOOK_INPUT="${CLAUDE_TOOL_INPUT:-}"
if [ -z "$HOOK_INPUT" ] && [ ! -t 0 ]; then
  HOOK_INPUT="$(cat)"
fi
# 故意不 export:export 会把负载塞进本脚本每个子进程的 envp(git/grep/basename 全算上),
# 负载一大 execve 就 E2BIG(Linux 单个环境变量上限 128 KiB)。只在真正读它的那一次 node 调用上
# 做单命令赋值(is-git-commit 只认 HOOK_INPUT 环境变量,不读 stdin),把暴露面收到一处。
# 本 hook 挂 Bash 工具,负载只是命令串,实际都很小;收紧是为了对齐另两个 hook 的同一约定。

is_git_commit_command() {
  # 走 node 共享核 isGitCommitCommand:命令优先取 STORY_COMMIT_COMMAND,缺省从 HOOK_INPUT
  # 挖 command/cmd/script。js 分词语义,与 OpenCode/ZCode 一致;对「引号内分隔符」这类边界
  # 与旧 python shlex 有已文档化、仅 advisory 的差异(不影响本 hook 的 exit 0 非阻塞语义)。
  # node 探测不到就当「非 commit」,让下方静默放行(兜底不反噬提交流程;native 安装可能
  # 无 node,此时 commit 格式提示停用,session-start.sh 会在会话起点提示一次)。
  node -e "" >/dev/null 2>&1 || return 1
  local CLI; CLI="$(dirname "$0")/story_hook_cli.js"
  [ -f "$CLI" ] || return 1
  HOOK_INPUT="$HOOK_INPUT" node "$CLI" is-git-commit >/dev/null 2>&1
}

# PreToolUse matcher 可能过宽或目标 CLI 不支持 if 字段;脚本必须内部自检。
# 没有明确 git commit 命令时完全静默退出,避免 echo/grep 等命令误触发。
if ! is_git_commit_command; then
  exit 0
fi

# 后续 case + grep 在中文路径/正文内容上做匹配。Windows 中文系统若导出 GBK 区域设置,
# grep 按 GBK 多字节解码 UTF-8 内容会乱。强制 C 区域走字节匹配才稳定(issue #164 同类)。
# 放在 is_git_commit_command(node 共享核)之后,避免影响其输入解码。
export LC_ALL=C

ROOT=$(project_root)
GIT_ROOT=$(git -C "$ROOT" rev-parse --show-toplevel 2>/dev/null || printf '%s\n' "$ROOT")
# 警告串用真实换行拼接(NL),不用字面 `\n` 占位:输出端必须 printf '%s',见文末注释。
NL=$'\n'
WARNINGS=""

# 获取即将 commit 的文件列表(使用 -z null 分隔避免空格路径问题)
while IFS= read -r -d '' file; do
  # 跳过非 md 文件
  case "$file" in
    *.md) ;;
    *) continue ;;
  esac

  FULL_PATH="$ROOT/$file"
  if [ ! -f "$FULL_PATH" ]; then
    FULL_PATH="$GIT_ROOT/$file"
  fi

  # 检查正文文件是否包含硬编码的情节值
  # 匹配语义与警告文案对齐 JS core(story_hook_core.js stagedMarkdownWarnings,跨 CLI 的
  # 权威实现;py↔js 由 scripts/test-prose-net-parity.sh Part E 锁 parity)。
  # 冒号/空白都用交替而不是把全角字符塞进方括号字符组:含全角字符的字符组在 C 区域会被
  # 拆成单字节、漏匹配;(:|:) 同时命中全角「:」和半角「:」,([[:space:]]| ) 在 LC_ALL=C 下
  # 也认全角空格 U+3000(否则全角空格分隔的写法会漏检/误判)。
  case "$file" in
    正文.md|*/正文.md|正文/*|*/正文/*)
      HARDCODED=$(grep -nE "(身高|体重|年龄)([[:space:]]| )*(:|:)([[:space:]]| )*[0-9]+" "$FULL_PATH" 2>/dev/null || true)
      if [ -n "$HARDCODED" ]; then
        WARNINGS="$WARNINGS${NL}⚠ $file: 正文硬编码角色属性,应引用设定文件:${NL}$HARDCODED"
      fi
      ;;
  esac

  # 检查角色卡的必填字段(结构化匹配:key:value 格式)。grep -i 对齐 JS core 的 /i:
  # 大小写不敏感命中 name/NAME/Name(LC_ALL=C 下 -i 只折叠 ASCII,中文字节不受影响)。
  #
  # 只查角色卡:设定/ 下还住着一批项目级设定件——artifact-protocols.md 规定的 关系.md
  # (正文是「# 角色关系图」)、题材定位.md(「# 题材定位」),以及 文风.md、题材正文提示卡.md、
  # 世界观/*、势力/* 等,它们本来就没有 名字/姓名 字段。整棵 设定/ 一刀切会让每次碰设定的提交
  # 都刷一屏假警告,把同框的「正文硬编码角色属性」真警告埋掉。判定:设定/角色|人物 子目录内的
  # 文件 + 设定/ 直属的扁平角色卡(角色.md/主角.md/配角.md/反派.md 等自定义命名)才查;
  # 其余子目录与已知项目级文件跳过。
  # 四端同口径:本脚本(Claude)、OpenCode 的 .git/hooks/pre-commit、JS core 的
  # isCharacterSheetPath / stagedMarkdownWarnings、codex 的 _is_character_sheet_path /
  # staged_markdown_warnings 已全部收窄到同一判定。改任一端都要四端一起改,否则
  # 同一次提交在不同 CLI 上会给出不同警告(parity 测试 Part E 锁 py↔js 两端)。
  # 别为了「对齐权威实现」把这段改回去——那会把假警告一起改回来。
  IS_CHARACTER_SHEET=false
  case "$file" in
    设定/角色/*|*/设定/角色/*|设定/人物/*|*/设定/人物/*)
      IS_CHARACTER_SHEET=true
      ;;
    设定/*/*|*/设定/*/*)
      # 世界观/势力/报告/原理/人物关系 等非角色子目录:整目录跳过
      ;;
    设定/*|*/设定/*)
      case "${file##*/}" in
        关系.md|题材定位.md|题材正文提示卡.md|文风.md|世界规则.md|世界观.md|金手指.md|背景设定.md) ;;
        *) IS_CHARACTER_SHEET=true ;;
      esac
      ;;
  esac
  if [ "$IS_CHARACTER_SHEET" = true ] \
    && ! grep -qiE "^([[:space:]]| )*(名字|姓名|名称|name)([[:space:]]| )*(:|:)" "$FULL_PATH" 2>/dev/null; then
    WARNINGS="$WARNINGS${NL}⚠ $file: 设定文件缺少 name/名字 必填字段。"
  fi
done < <(git -C "$ROOT" -c core.quotepath=false diff --cached --relative --name-only --diff-filter=ACM -z -- . 2>/dev/null || true)

if [ -n "$WARNINGS" ]; then
  echo "=== Story Commit Warnings(advisory only)==="
  # 必须 %s 不能 %b:$WARNINGS 里嵌着 grep -n 抓出的作者正文原文。%b 会把正文里的 `\n`、`\b`
  # 当转义展开,`\c`(Windows 路径 C:\code 就带)更会直接终止 printf,把后面所有文件的警告
  # 连同收尾框线一起吞掉。分隔换行由上面拼接时的 ${NL} 真实换行承担。
  printf '%s\n' "$WARNINGS"
  echo "=== End Warnings ==="
fi

# Always exit 0 — 写作流程不能被 hook 卡住
exit 0
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 CodeCodexUnverifiedInstall
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: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated 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: 322kUpdated Claude CodeCodexVerifiedInstall