Skip to content

zjs105910/workbuddy-market / bundled/novel-writing-suite/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 md18.3 KB
UPGRADING.mdmarkdown33.9 KB
references/agent-references/agent-quality.mdmarkdown3.6 KB
references/agent-references/agent-reference-profiles.mdmarkdown3.9 KB
references/agent-references/anti-ai-writing.mdmarkdown36.3 KB
references/agent-references/banned-words.mdmarkdown10.2 KB
references/agent-references/benchmark-style-load.mdmarkdown9.9 KB
references/agent-references/character-basics.mdmarkdown16.5 KB
references/agent-references/character-design-methods.mdmarkdown15.9 KB
references/agent-references/character-relations.mdmarkdown17.4 KB
references/agent-references/deslop-gates.mdmarkdown14.1 KB
references/agent-references/dialogue-mastery.mdmarkdown11.5 KB
references/agent-references/emotion-on-page.mdmarkdown4.6 KB
references/agent-references/emotional-arc-design.mdmarkdown12.0 KB
references/agent-references/format-and-structure.mdmarkdown10.4 KB
references/agent-references/genre-prose-cards.mdmarkdown7.0 KB
references/agent-references/genre-prose-cards/东方仙侠.mdmarkdown2.7 KB
references/agent-references/genre-prose-cards/传统玄幻.mdmarkdown2.7 KB
references/agent-references/genre-prose-cards/历史古代.mdmarkdown2.6 KB
references/agent-references/genre-prose-cards/历史脑洞.mdmarkdown2.9 KB
references/agent-references/genre-prose-cards/双男主.mdmarkdown3.2 KB
references/agent-references/genre-prose-cards/古言脑洞.mdmarkdown2.6 KB
references/agent-references/genre-prose-cards/古风世情.mdmarkdown2.6 KB
references/agent-references/genre-prose-cards/女频悬疑.mdmarkdown2.6 KB
references/agent-references/genre-prose-cards/女频种田.mdmarkdown2.6 KB
references/agent-references/genre-prose-cards/宫斗宅斗.mdmarkdown2.5 KB
references/agent-references/genre-prose-cards/年代.mdmarkdown3.0 KB
references/agent-references/genre-prose-cards/快穿.mdmarkdown2.8 KB
references/agent-references/genre-prose-cards/悬疑灵异.mdmarkdown2.6 KB
references/agent-references/genre-prose-cards/悬疑脑洞.mdmarkdown2.7 KB
references/agent-references/genre-prose-cards/战神赘婿.mdmarkdown2.7 KB
references/agent-references/genre-prose-cards/抗战谍战.mdmarkdown2.7 KB
references/agent-references/genre-prose-cards/星光璀璨.mdmarkdown2.7 KB
references/agent-references/genre-prose-cards/民国言情.mdmarkdown2.8 KB
references/agent-references/genre-prose-cards/游戏体育.mdmarkdown2.8 KB
references/agent-references/genre-prose-cards/玄幻脑洞.mdmarkdown2.9 KB
references/agent-references/genre-prose-cards/玄幻言情.mdmarkdown2.5 KB
references/agent-references/genre-prose-cards/现言脑洞.mdmarkdown2.7 KB
references/agent-references/genre-prose-cards/科幻末世.mdmarkdown2.6 KB
references/agent-references/genre-prose-cards/职场婚恋.mdmarkdown2.6 KB
references/agent-references/genre-prose-cards/西方奇幻.mdmarkdown2.8 KB
references/agent-references/genre-prose-cards/豪门总裁.mdmarkdown3.3 KB
references/agent-references/genre-prose-cards/都市修真.mdmarkdown2.5 KB
references/agent-references/genre-prose-cards/都市日常.mdmarkdown3.7 KB
references/agent-references/genre-prose-cards/都市种田.mdmarkdown2.5 KB
references/agent-references/genre-prose-cards/都市脑洞.mdmarkdown3.4 KB
references/agent-references/genre-prose-cards/都市高武.mdmarkdown2.9 KB
references/agent-references/genre-prose-cards/青春甜宠.mdmarkdown2.7 KB
references/agent-references/genre-readers.mdmarkdown10.8 KB
references/agent-references/long-chapter-hooks.mdmarkdown8.6 KB
references/agent-references/long-emotional-methods.mdmarkdown10.1 KB
references/agent-references/long-genre-catalog.mdmarkdown17.0 KB
references/agent-references/long-genre-mechanics.mdmarkdown17.0 KB
references/agent-references/long-quality.mdmarkdown3.1 KB
references/agent-references/long-reversal.mdmarkdown15.2 KB
references/agent-references/long-suspense.mdmarkdown15.2 KB
references/agent-references/opening-design.mdmarkdown12.5 KB
references/agent-references/outline-conflict.mdmarkdown17.2 KB
references/agent-references/outline-methods.mdmarkdown10.6 KB
references/agent-references/outline-rhythm.mdmarkdown12.6 KB
references/agent-references/plot-core-methods.mdmarkdown19.8 KB
references/agent-references/short-chapter-hooks.mdmarkdown8.4 KB
references/agent-references/short-emotional-methods.mdmarkdown7.7 KB
references/agent-references/short-genre-formulas.mdmarkdown20.1 KB
references/agent-references/short-paragraph-hooks.mdmarkdown6.7 KB
references/agent-references/short-quality.mdmarkdown2.7 KB
references/agent-references/short-reversal.mdmarkdown16.3 KB
references/agent-references/short-suspense.mdmarkdown15.6 KB
references/agent-references/style-combat-face.mdmarkdown16.9 KB
references/agent-references/style-genre-modules.mdmarkdown24.2 KB
references/agent-references/style-resolution.mdmarkdown3.9 KB
references/agent-references/writing-craft.mdmarkdown28.1 KB
references/antigravity/hooks/hooks.jsonconfig994 B
references/antigravity/hooks/story_antigravity_hook.jsscript8.2 KB
references/antigravity/hooks/story_hook_core.jsscript57.3 KB
references/antigravity/rules/oh-story.mdmarkdown3.0 KB
references/codex/AGENTS.md.tmplother3.6 KB
references/codex/agents/chapter-extractor.tomlconfig16.5 KB
references/codex/agents/character-designer.tomlconfig9.7 KB
references/codex/agents/consistency-checker.tomlconfig12.2 KB
references/codex/agents/narrative-writer.tomlconfig15.5 KB
references/codex/agents/story-architect.tomlconfig11.1 KB
references/codex/agents/story-explorer.tomlconfig11.8 KB
references/codex/agents/story-researcher.tomlconfig12.7 KB
references/codex/hooks/hooks.jsonconfig6.8 KB
references/codex/hooks/run-story-hook.cmdscript699 B
references/codex/hooks/run-story-hook.shscript769 B
references/codex/hooks/story_codex_hook.pyscript71.9 KB
references/deploy-antigravity.mdmarkdown9.5 KB
references/deploy-claude-code.mdmarkdown8.3 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.3 KB
references/deploy-zcode.mdmarkdown6.7 KB
references/diagnostics.mdmarkdown4.4 KB
references/generic/AGENTS.md.tmplother4.2 KB
references/openclaw/AGENTS.md.tmplother4.7 KB
references/opencode/AGENTS.md.tmplother3.0 KB
references/opencode/agents/chapter-extractor.mdmarkdown16.4 KB
references/opencode/agents/character-designer.mdmarkdown9.3 KB
references/opencode/agents/consistency-checker.mdmarkdown11.7 KB
references/opencode/agents/narrative-writer.mdmarkdown15.0 KB
references/opencode/agents/story-architect.mdmarkdown10.6 KB
references/opencode/agents/story-explorer.mdmarkdown11.3 KB
references/opencode/agents/story-researcher.mdmarkdown12.2 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-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.tsscript8.0 KB
references/opencode/pre-commit.shscript4.3 KB
references/opencode/story_hook_core.jsscript57.3 KB
references/reasonix/AGENTS.md.tmplother5.0 KB
references/templates/.gitkeepother0 B
references/templates/CLAUDE.md.tmplother3.0 KB
references/templates/agents/chapter-extractor.mdmarkdown16.4 KB
references/templates/agents/character-designer.mdmarkdown9.1 KB
references/templates/agents/consistency-checker.mdmarkdown11.7 KB
references/templates/agents/narrative-writer.mdmarkdown15.0 KB
references/templates/agents/story-architect.mdmarkdown10.5 KB
references/templates/agents/story-explorer.mdmarkdown11.2 KB
references/templates/agents/story-researcher.mdmarkdown12.1 KB
references/templates/hooks/check-prose-after-write.shscript6.0 KB
references/templates/hooks/detect-story-gaps.shscript7.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.shscript698 B
references/templates/hooks/pre-compact.shscript1.0 KB
references/templates/hooks/session-end.shscript946 B
references/templates/hooks/session-start.shscript10.7 KB
references/templates/hooks/story_hook_cli.jsscript10.6 KB
references/templates/hooks/story_hook_core.jsscript57.3 KB
references/templates/hooks/validate-story-commit.shscript6.4 KB
references/templates/rules/story-consistency.mdmarkdown2.7 KB
references/templates/rules/story-format.mdmarkdown3.2 KB
references/templates/rules/story-narrative.mdmarkdown2.9 KB
references/templates/rules/story-outline.mdmarkdown6.3 KB
references/templates/settings-hooks.jsonconfig2.0 KB
references/zcode/AGENTS.md.tmplother4.0 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-review.mdmarkdown216 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.jsscript57.3 KB
references/zcode/hooks/story_zcode_hook.jsscript6.7 KB
scripts/copy-path-safety.pyscript3.1 KB
scripts/deploy-antigravity-skills.pyscript4.5 KB
scripts/generate-antigravity-agents.mjsscript12.1 KB
scripts/merge-antigravity-hooks.pyscript2.3 KB
scripts/merge-claude-settings.pyscript4.6 KB
scripts/merge-codex-hooks.pyscript5.2 KB

references/antigravity/hooks/story_antigravity_hook.js

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

// Antigravity 2.0 hook adapter for oh-story writing projects. The shared story
// guard logic lives in story_hook_core.js; this file only translates the
// Antigravity camelCase hook contract and bridges PostToolUse (which must return
// {}) to the next PreInvocation through the session artifact directory.

const fs = require("node:fs")
const os = require("node:os")
const path = require("node:path")
const core = require("./story_hook_core.js")

function readInput() {
  try {
    const raw = fs.readFileSync(0, "utf8")
    const value = raw.trim() ? JSON.parse(raw) : {}
    return value && typeof value === "object" && !Array.isArray(value) ? value : {}
  } catch {
    return {}
  }
}

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

const hookInput = readInput()

function deployedRoot() {
  try {
    const hooks = path.resolve(__dirname)
    if (path.basename(hooks) === "hooks" && path.basename(path.dirname(hooks)) === ".agents") {
      return path.dirname(path.dirname(hooks))
    }
  } catch {}
  return null
}

function projectRoot() {
  const deployed = deployedRoot()
  if (deployed && fs.existsSync(deployed)) return deployed
  for (const candidate of Array.isArray(hookInput.workspacePaths) ? hookInput.workspacePaths : []) {
    const existing = core.existingDir(candidate)
    if (existing) return existing
  }
  return path.resolve(process.cwd())
}

function toolCall() {
  const value = hookInput.toolCall
  return value && typeof value === "object" && !Array.isArray(value) ? value : null
}

function callArgs(call) {
  const value = call && call.args
  return value && typeof value === "object" && !Array.isArray(value) ? value : {}
}

function firstString(object, keys) {
  for (const key of keys) {
    if (typeof object[key] === "string" && object[key]) return object[key]
  }
  return ""
}

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

function targetPaths(call) {
  if (!call) return []
  const root = projectRoot()
  const args = callArgs(call)
  const requestedCwd = core.existingDir(firstString(args, ["Cwd", "cwd", "WorkingDirectory"]))
  const base = requestedCwd && isInside(root, requestedCwd) ? requestedCwd : root
  const raw = []
  const direct = firstString(args, ["TargetFile", "targetFile", "FilePath", "filePath", "path"])
  if (direct) raw.push(direct)
  if (call.name === "run_command") {
    const command = firstString(args, ["CommandLine", "command", "cmd"])
    raw.push(...core.extractProseTargets(command), ...core.extractPatchTargets(command))
  }
  return [...new Set(raw.filter(Boolean).map((value) => core.resolveTarget(root, value, base)))]
}

function pendingPath() {
  const artifact = core.existingDir(hookInput.artifactDirectoryPath)
  if (artifact) return path.join(artifact, "oh-story-pending.json")
  const conversation = String(hookInput.conversationId || "").replace(/[^A-Za-z0-9_-]/g, "")
  return conversation ? path.join(os.tmpdir(), `oh-story-antigravity-${conversation}.json`) : null
}

function readPending() {
  const file = pendingPath()
  if (!file) return { findings: {}, stopAttempts: 0 }
  try {
    const value = JSON.parse(fs.readFileSync(file, "utf8"))
    if (!value || typeof value !== "object" || Array.isArray(value)) throw new Error("invalid pending state")
    const findings = value.findings && typeof value.findings === "object" && !Array.isArray(value.findings) ? value.findings : {}
    return { findings, stopAttempts: Number.isInteger(value.stopAttempts) ? value.stopAttempts : 0 }
  } catch {
    return { findings: {}, stopAttempts: 0 }
  }
}

function writePending(state) {
  const file = pendingPath()
  if (!file) return
  const keys = Object.keys(state.findings || {})
  if (!keys.length) {
    try { fs.unlinkSync(file) } catch {}
    return
  }
  try {
    fs.mkdirSync(path.dirname(file), { recursive: true })
    const temporary = `${file}.${process.pid}.tmp`
    fs.writeFileSync(temporary, JSON.stringify({ findings: state.findings, stopAttempts: state.stopAttempts || 0 }), "utf8")
    fs.renameSync(temporary, file)
  } catch {}
}

function pendingMessage(state) {
  const notes = Object.values(state.findings || {}).filter((value) => typeof value === "string" && value)
  if (!notes.length) return ""
  return "[oh-story deterministic prose check]\n" + notes.join("\n\n") +
    "\nResolve these findings in the affected prose files and write the fixes before moving to another chapter or ending the task."
}

function preToolUse() {
  const call = toolCall()
  const root = projectRoot()
  for (const target of targetPaths(call)) {
    const reason = core.proseBlockReason(root, target)
    if (reason) return emit({ decision: "deny", reason })
  }

  if (call && call.name === "run_command") {
    const command = firstString(callArgs(call), ["CommandLine", "command", "cmd"])
    if (command && core.isGitCommitCommand(command)) {
      const warnings = core.stagedMarkdownWarnings(root)
      if (warnings) return emit({ decision: "allow", reason: warnings })
    }
  }
  emit({ decision: "allow" })
}

function postToolUse() {
  const call = toolCall()
  if (!call || hookInput.error) return emit({})
  const root = projectRoot()
  const state = readPending()
  let changed = false
  for (const target of targetPaths(call)) {
    const key = path.resolve(target)
    const finding = core.proseAfterWrite(root, key)
    if (finding) state.findings[key] = finding
    else delete state.findings[key]
    changed = true
  }
  if (changed) {
    state.stopAttempts = 0
    writePending(state)
  }
  emit({})
}

function sessionContext() {
  if (hookInput.invocationNum !== 0) return ""
  const root = projectRoot()
  const messages = []
  const sentinel = path.join(root, ".story-deployed")
  if (fs.existsSync(sentinel)) {
    let text = ""
    try { text = fs.readFileSync(sentinel, "utf8") } catch {}
    const target = text.match(/^target_cli:\s*(.+)$/m)
    if (!target) messages.push("[story-setup] .story-deployed is missing target_cli; rerun story-setup.")
    else if (!target[1].split(",").map((value) => value.trim()).includes("antigravity")) {
      messages.push("[story-setup] This deployment does not include antigravity; rerun story-setup and select Antigravity.")
    }
  }
  const book = core.discoverActiveBook(root)
  if (book) {
    const context = path.join(book, "追踪", "上下文.md")
    if (fs.existsSync(context)) messages.push(`[story context] Active book: ${core.safeRelative(root, book)}. Read ${core.safeRelative(root, context)} before continuing long-form writing.`)
    else messages.push(`[story context] Detected writing project: ${core.safeRelative(root, book)}.`)
  }
  messages.push(...core.continuityFindings(root))
  return messages.join("\n")
}

function preInvocation() {
  const messages = [sessionContext(), pendingMessage(readPending())].filter(Boolean)
  emit(messages.length ? { injectSteps: messages.map((message) => ({ ephemeralMessage: message })) } : {})
}

function stop() {
  const state = readPending()
  const message = pendingMessage(state)
  const termination = String(hookInput.terminationReason || "")
  const mayContinue = termination === "" || termination === "model_stop"
  if (message && hookInput.fullyIdle !== false && mayContinue && state.stopAttempts < 1) {
    state.stopAttempts += 1
    writePending(state)
    return emit({ decision: "continue", reason: message })
  }
  emit({ decision: "stop" })
}

function main() {
  const event = process.argv[2] || ""
  try {
    if (event === "pre-tool-use") preToolUse()
    else if (event === "post-tool-use") postToolUse()
    else if (event === "pre-invocation") preInvocation()
    else if (event === "stop") stop()
    else {
      process.stderr.write(`unknown oh-story Antigravity hook event: ${event}\n`)
      process.exitCode = 2
    }
  } catch (error) {
    process.stderr.write(`[oh-story antigravity hook] ${error instanceof Error ? error.message : String(error)}\n`)
    if (event === "pre-tool-use") emit({ decision: "allow" })
    else if (event === "stop") emit({ decision: "stop" })
    else emit({})
  }
}

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

module.exports = { isInside, targetPaths, pendingMessage }
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