Skip to content

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

story-setup

Unverified

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

FileKindSize
SKILL.mdskill md16.7 KB
UPGRADING.mdmarkdown17.4 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.4 KB
references/antigravity/hooks/story_hook_core.jsscript67.0 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.cmdscript717 B
references/codex/hooks/run-story-hook.shexecutablescript805 B
references/codex/hooks/story_codex_hook.jsexecutablescript10.4 KB
references/codex/hooks/story_hook_core.jsscript67.0 KB
references/deploy-antigravity.mdmarkdown8.9 KB
references/deploy-claude-code.mdmarkdown7.6 KB
references/deploy-codex.mdmarkdown6.1 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.6 KB
references/opencode/pre-commit.shexecutablescript525 B
references/opencode/story_hook_core.jsscript67.0 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/run-story-hook.shexecutablescript1.2 KB
references/templates/hooks/story_hook_cli.jsexecutablescript19.3 KB
references/templates/hooks/story_hook_core.jsscript67.0 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.1 KB
references/zcode/AGENTS.md.tmplother4.3 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.jsscript67.0 KB
references/zcode/hooks/story_zcode_hook.jsexecutablescript6.9 KB
scripts/copy-path-safety.jsexecutablescript8.9 KB
scripts/deploy-antigravity-skills.jsexecutablescript9.3 KB
scripts/generate-antigravity-agents.mjsexecutablescript12.4 KB
scripts/merge-hooks.jsexecutablescript9.5 KB
scripts/merge-project-instructions.jsexecutablescript12.8 KB

references/codex/hooks/story_codex_hook.js

View on GitHub
#!/usr/bin/env node
"use strict"

// Codex hook adapter for oh-story writing projects. It has no third-party
// dependencies and delegates all story guardrails to the shared story_hook_core.js
// module while preserving Codex's stdin/stdout JSON envelopes.

const fs = require("node:fs")
const path = require("node:path")
const { spawnSync } = require("node:child_process")

const VALID_EVENTS = new Set([
  "session-start",
  "pre-tool-prose-guard",
  "pre-tool-commit-advisory",
  "pre-compact",
  "post-compact",
  "stop",
])

let cachedCore = null
function loadCore() {
  if (!cachedCore) cachedCore = require("./story_hook_core.js")
  return cachedCore
}

let hookInput = {}

function readHookInput() {
  if (process.stdin.isTTY) return {}
  try {
    const raw = fs.readFileSync(0, "utf8")
    if (raw.trim()) {
      const parsed = JSON.parse(raw)
      if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) return parsed
    }
  } catch {}
  return {}
}

function emit(value) {
  if (value && typeof value === "object") process.stdout.write(JSON.stringify(value))
}

function hookContext(event, text) {
  return {
    hookSpecificOutput: {
      hookEventName: event,
      additionalContext: text,
    },
  }
}

function deployedWorkspaceRoot() {
  try {
    const hooksDir = path.resolve(__dirname)
    if (path.basename(hooksDir) === "hooks" && path.basename(path.dirname(hooksDir)) === ".codex") {
      const root = path.dirname(path.dirname(hooksDir))
      if (fs.existsSync(root) && fs.statSync(root).isDirectory()) return fs.realpathSync(root)
    }
  } catch {}
  return null
}

function projectRoot() {
  const { existingDir } = loadCore()
  for (const name of ["CODEX_PROJECT_DIR", "CLAUDE_PROJECT_DIR"]) {
    const candidate = existingDir(process.env[name])
    if (candidate) return candidate
  }
  const deployed = deployedWorkspaceRoot()
  if (deployed) return deployed
  const inputCwd = existingDir(hookInput.cwd)
  const cwd = inputCwd || process.cwd()
  try {
    const result = spawnSync("git", ["rev-parse", "--show-toplevel"], {
      cwd,
      encoding: "utf8",
      stdio: ["ignore", "pipe", "ignore"],
      windowsHide: true,
    })
    if (result.status === 0 && result.stdout.trim()) {
      const gitRoot = existingDir(result.stdout.trim())
      if (gitRoot) return gitRoot
    }
  } catch {}
  return existingDir(cwd) || path.resolve(cwd)
}

function isPathInside(root, candidate, pathApi = path) {
  const relation = pathApi.relative(root, candidate)
  return relation === "" || (
    !pathApi.isAbsolute(relation)
    && relation !== ".."
    && !relation.startsWith(`..${pathApi.sep}`)
  )
}

function findCommand(value) {
  if (value && typeof value === "object" && !Array.isArray(value)) {
    for (const key of ["command", "cmd", "script"]) {
      if (typeof value[key] === "string") return value[key]
    }
    for (const key of ["tool_input", "input", "parameters", "args"]) {
      const found = findCommand(value[key])
      if (found) return found
    }
  }
  return ""
}

function targetPaths(input) {
  const { existingDir, extractProseTargets, extractPatchTargets, resolveTarget } = loadCore()
  const root = projectRoot()
  const inputCwd = existingDir(input.cwd)
  const base = inputCwd && isPathInside(root, inputCwd) ? inputCwd : root
  const name = String(input.tool_name || "")
  const payload = input.tool_input && typeof input.tool_input === "object" && !Array.isArray(input.tool_input)
    ? input.tool_input
    : {}
  const rawTargets = []
  for (const key of ["file_path", "filePath", "path", "target", "filename"]) {
    if (typeof payload[key] === "string") rawTargets.push(payload[key])
  }
  const command = typeof payload.command === "string" ? payload.command : ""
  if (command) {
    if (name === "Bash") rawTargets.push(...extractProseTargets(command))
    else rawTargets.push(...extractPatchTargets(command), ...extractProseTargets(command))
  }
  return [...new Set(rawTargets.filter(Boolean).map((value) => resolveTarget(root, value, base)))]
}

function sessionStart() {
  const { readSentinel, agentsVersionNotice, discoverActiveBook, safeRelative, continuityFindings } = loadCore()
  const root = projectRoot()
  const messages = []
  const sentinel = readSentinel(root)
  if (sentinel !== null) {
    const versionNotice = agentsVersionNotice(root, { sentinel, setupCommand: "$story-setup" })
    if (versionNotice) messages.push(versionNotice)
    const targetCli = sentinel.target_cli || ""
    if (!targetCli) {
      messages.push("[story-setup] .story-deployed 缺少 target_cli 字段;建议重新运行 $story-setup。")
    } else if (!targetCli.split(",").map((item) => item.trim()).includes("codex")) {
      messages.push("[story-setup] 当前部署标记未包含 codex;如需 Codex hooks/agents,请重新运行 $story-setup 并选择 Codex。")
    }
  }
  const book = discoverActiveBook(root)
  if (book) {
    const context = path.join(book, "追踪", "上下文.md")
    if (fs.existsSync(context)) {
      messages.push(`[story context] Active book: ${safeRelative(root, book)}. Read ${safeRelative(root, context)} before continuing long-form writing.`)
    } else {
      messages.push(`[story context] Active story project detected: ${safeRelative(root, book)}.`)
    }
  }
  messages.push(...continuityFindings(root))
  if (messages.length) emit(hookContext("SessionStart", messages.join("\n")))
}

function preToolProseGuard() {
  const { proseBlockReason } = loadCore()
  const root = projectRoot()
  for (const target of targetPaths(hookInput)) {
    const reason = proseBlockReason(root, target)
    if (reason) {
      emit({
        hookSpecificOutput: {
          hookEventName: "PreToolUse",
          permissionDecision: "deny",
          permissionDecisionReason: reason,
        },
      })
      return
    }
  }
}

function preToolCommitAdvisory() {
  const { isGitCommitCommand, stagedMarkdownWarnings } = loadCore()
  const command = findCommand(hookInput)
  if (!command || !isGitCommitCommand(command)) return
  const warnings = stagedMarkdownWarnings(projectRoot())
  if (warnings) emit(hookContext("PreToolUse", warnings))
}

function gitNullList(root, args) {
  try {
    const result = spawnSync("git", ["-C", root, "-c", "core.quotepath=false", ...args], {
      encoding: "buffer",
      stdio: ["ignore", "pipe", "ignore"],
      windowsHide: true,
    })
    if (result.status !== 0 || !result.stdout) return null
    return result.stdout.toString("utf8").split("\0").filter(Boolean)
  } catch {
    return null
  }
}

function compactSummary() {
  const { discoverActiveBook, safeRelative } = loadCore()
  const root = projectRoot()
  const lines = ["=== Story Compact Summary ==="]
  const book = discoverActiveBook(root)
  if (book) {
    const ctx = path.join(book, "追踪", "上下文.md")
    if (fs.existsSync(ctx)) {
      let lineCount = 0
      try {
        const text = fs.readFileSync(ctx, "utf8")
        lineCount = text ? text.replace(/\r\n/g, "\n").replace(/\n$/, "").split("\n").length : 0
      } catch {}
      lines.push(`Writing context: ${safeRelative(root, ctx)} (${lineCount} lines)`)
    } else {
      lines.push(`Active story project: ${safeRelative(root, book)}`)
    }
  } else {
    lines.push("Active state: not found")
  }
  const changed = gitNullList(root, ["diff", "--relative", "--name-only", "-z", "--", "."])
  const staged = gitNullList(root, ["diff", "--relative", "--name-only", "--cached", "-z", "--", "."])
  if (changed !== null && staged !== null) {
    lines.push(`Git: ${changed.length} unstaged, ${staged.length} staged`)
  }
  emit({ systemMessage: lines.join("\n") })
}

function findChangedProseFiles(root) {
  const { isProsePath } = loadCore()
  const out = []
  const seen = new Set()
  const commands = [
    ["diff", "--relative", "--name-only", "-z", "--diff-filter=ACM", "--", "."],
    ["diff", "--relative", "--name-only", "--cached", "-z", "--diff-filter=ACM", "--", "."],
    ["ls-files", "--others", "--exclude-standard", "-z"],
  ]
  for (const args of commands) {
    const entries = gitNullList(root, args)
    if (!entries) continue
    for (const rel of entries) {
      if (!rel.endsWith(".md")) continue
      const abs = path.resolve(root, rel)
      if (seen.has(abs) || !fs.existsSync(abs)) continue
      if (isProsePath(abs)) {
        seen.add(abs)
        out.push(abs)
      }
    }
  }
  return out
}

function stopEvent() {
  // Codex 无 PostToolUse,正文内容网在回合结束的 Stop 事件兜底:对本回合 git 改动过的正文
  // 复扫硬信号。非阻塞、无发现静默;解析失败一律 {continue:true}。
  try {
    const { proseNetFindings, loadStyleWhitelist, toxicRescanHint, safeRelative } = loadCore()
    const root = projectRoot()
    const blocks = []
    for (const abs of findChangedProseFiles(root)) {
      let text
      try { text = fs.readFileSync(abs, "utf8") } catch { continue }
      const findings = proseNetFindings(text, loadStyleWhitelist(abs), toxicRescanHint(abs))
      if (findings.length) {
        blocks.push(`=== ${safeRelative(root, abs)} ===\n${findings.join("\n")}`)
      }
    }
    if (blocks.length) {
      emit({
        continue: true,
        systemMessage: "=== 正文兜底检测(回合结束复扫,模型无关)===\n硬信号命中即回正文改掉、复扫到净:\n" + blocks.join("\n"),
      })
      return
    }
  } catch {}
  emit({ continue: true })
}

function main() {
  const event = process.argv[2] || ""
  if (!VALID_EVENTS.has(event)) {
    process.stderr.write(`unknown oh-story Codex hook event: ${event}\n`)
    process.exitCode = 2
    return
  }
  hookInput = readHookInput()
  try {
    loadCore()
  } catch (error) {
    process.stderr.write(`[oh-story codex hook] failed to load story_hook_core.js: ${error instanceof Error ? error.message : String(error)}\n`)
    if (event === "stop") emit({ continue: true })
    return
  }
  try {
    if (event === "session-start") sessionStart()
    else if (event === "pre-tool-prose-guard") preToolProseGuard()
    else if (event === "pre-tool-commit-advisory") preToolCommitAdvisory()
    else if (event === "pre-compact") compactSummary()
    else if (event === "post-compact") compactSummary()
    else if (event === "stop") stopEvent()
  } catch (error) {
    process.stderr.write(`[oh-story codex hook] ${error instanceof Error ? error.message : String(error)}\n`)
    if (event === "stop") emit({ continue: true })
  }
}

if (require.main === module) main()

module.exports = {
  isPathInside,
  findChangedProseFiles,
}
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