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/opencode/plugin.ts

View on GitHub
import type { Plugin } from "@opencode/plugin"
import * as fs from "node:fs"
import * as path from "node:path"
import { execSync } from "node:child_process"
import {
  discoverActiveBook,
  resolveTarget,
  extractProseTargets,
  extractPatchTargets,
  proseBlockReason,
  proseAfterWrite,
} from "./lib/story_hook_core.js"

// 只支持 OpenCode 2.x 插件 API(default export `{ id, setup }`)。1.x 的 loader 读不了这个形状,
// 会记一行 "failed to load plugin" 后继续跑——守卫整场静默失效,所以 story-setup 部署前先查版本。
//
// 写正文守卫的检测逻辑(去 AI 味轻量确定性网、大纲/细纲守卫、字数/落盘/标题去重、
// 正文写入目标抽取)与 ZCode hook 共享同一份 story_hook_core.js,随本插件一起部署到
// .opencode/plugins/lib/story_hook_core.js。放 lib/ 子目录而非平铺:plugins/ 下每个 .ts/.js 都会被
// 当成插件加载;子目录只有含 server.* / index.* / tui.* / rpc.* 入口时才算插件包,lib/ 里不得放这些
// 文件名。这里只保留 OpenCode 宿主相关的部分:项目根定位、事件模型(tool execute.before/after、
// session compaction)、以及把发现追加进写工具返回内容的输出信封。
// 共享核以 bash hook 为 oracle,parity 由 test-prose-net-parity.sh 守卫。

type ToolInput = Record<string, unknown>
type TextPart = { type: "text"; text: string }

// 2.x 的后台服务一个进程服务多个项目,process.cwd() 不是用户项目:一切路径都以插件所在
// location(ctx.location.directory,会话工作目录)为起点。项目根是它的 git toplevel。
function projectRoot(directory: string): string {
  try {
    return execSync("git rev-parse --show-toplevel", {
      cwd: directory,
      encoding: "utf-8",
      stdio: ["pipe", "pipe", "pipe"],
    }).trim()
  } catch {
    return directory
  }
}

// 相对路径的解析起点:工具自带 workdir(shell)时按会话目录解析它,且不得逃出项目根;否则就是会话目录。
function targetBase(root: string, directory: string, input: ToolInput): string {
  const raw = input.workdir
  if (typeof raw !== "string" || !raw.trim()) return directory
  let candidate = path.resolve(directory, raw)
  let canonicalRoot = path.resolve(root)
  try {
    if (!fs.statSync(candidate).isDirectory()) return directory
    candidate = fs.realpathSync(candidate)
    canonicalRoot = fs.realpathSync(root)
  } catch {
    return directory
  }
  const relative = path.relative(canonicalRoot, candidate)
  return relative === ".." || relative.startsWith(`..${path.sep}`) || path.isAbsolute(relative)
    ? directory
    : candidate
}

function tryGit(root: string, args: string): string {
  try {
    return execSync(`git ${args}`, {
      cwd: root,
      encoding: "utf-8",
      stdio: ["pipe", "pipe", "pipe"],
    }).trim()
  } catch {
    return ""
  }
}

function asInput(value: unknown): ToolInput {
  return value && typeof value === "object" ? (value as ToolInput) : {}
}

function text(input: ToolInput, key: string): string {
  const value = input[key]
  return typeof value === "string" ? value : ""
}

// 文件变更类工具的落盘目标。patch 是 edit 类工具(permission 与 write/edit 同为 edit),
// 部分模型只暴露它、隐藏 write/edit——不接这个分支等于守卫整场失效。目标抽取(*** Add/Update File:
// 与 *** Move to: 的目的地)复用共享核,与 ZCode/Codex adapter 同一份判据;Move 必须走目的地,
// 否则搬家式补丁能把无细纲草稿搬进 正文/。
function mutationTargets(tool: string, input: ToolInput): string[] {
  if (tool === "write" || tool === "edit") {
    const filePath = text(input, "path")
    return filePath ? [filePath] : []
  }
  if (tool === "patch") return extractPatchTargets(text(input, "patchText"))
  return []
}

function preCompactOutput(directory: string): string {
  const root = projectRoot(directory)
  const lines = ["=== Pre-Compact Summary ==="]
  const bookDir = discoverActiveBook(root)
  if (bookDir) {
    const ctxPath = path.join(bookDir, "追踪", "上下文.md")
    if (fs.existsSync(ctxPath)) {
      const lineCount = fs.readFileSync(ctxPath, "utf-8").split("\n").length
      const relPath = path.relative(root, ctxPath)
      lines.push(`Writing context: ${relPath} (${lineCount} lines)`)
    } else {
      lines.push("Active state: not found")
    }
  } else {
    lines.push("Active state: not found")
  }

  const changed = tryGit(root, "diff --name-only")
  const staged = tryGit(root, "diff --name-only --cached")
  const changedCount = changed ? changed.split("\n").filter(Boolean).length : 0
  const stagedCount = staged ? staged.split("\n").filter(Boolean).length : 0
  lines.push(`Git: ${changedCount} unstaged, ${stagedCount} staged`)

  lines.push("=== Pre-Compact Complete ===")
  return lines.join("\n")
}

// 把发现追加到模型读到的工具返回内容后面。content 缺省时 OpenCode 会把 output 序列化成文本给模型,
// 这里照同一规则补齐再追加,不吞掉原结果。
function appendNote(
  result: { content?: string | ReadonlyArray<unknown>; output?: unknown },
  note: string
): string | ReadonlyArray<unknown> {
  const content = result.content
  if (typeof content === "string") return `${content}\n\n${note}`
  const base: ReadonlyArray<unknown> =
    content && content.length > 0
      ? content
      : [{ type: "text", text: typeof result.output === "string" ? result.output : JSON.stringify(result.output ?? "") }]
  return [...base, { type: "text", text: note } satisfies TextPart]
}

export default {
  id: "oh-story.story-hooks",
  async setup(ctx) {
    const directory = ctx.location.directory

    // 压缩前把当前写作上下文位置写进摘要请求的 system,摘要才会带上「接着写哪本、状态文件在哪」。
    // OpenCode 无压缩后 hook,不注入 post-compact 信息。
    await ctx.session.hook("compaction", (event) => {
      const preMsg = preCompactOutput(directory)
      if (preMsg) event.system.push({ type: "text", text: preMsg })
    })

    await ctx.tool.hook("execute.before", (event) => {
      const input = asInput(event.input)
      const targets =
        event.tool === "shell" ? extractProseTargets(text(input, "command")) : mutationTargets(event.tool, input)

      // 非写类工具(read/grep/glob/…)到这里 targets 为空直接返回:projectRoot() 是同步 execSync,
      // 插件常驻在 OpenCode 服务进程里,只有确认有目标要查时才 fork git。
      if (targets.length === 0) return

      const root = projectRoot(directory)
      const base = targetBase(root, directory, input)
      for (const target of [...new Set(targets)]) {
        const reason = proseBlockReason(root, resolveTarget(root, target, base))
        if (reason) {
          const source = event.tool === "shell" ? "已从 Shell 命令识别到正文写入目标。" : "已识别到正文写入目标。"
          throw new Error(`${reason}(${source})`)
        }
      }
    })

    // 正文落盘兜底:写正文后跑轻量确定性网(截断/拒绝语/工程词/复读 + 落盘/字数/标题去重),
    // 把发现追加进写工具的返回内容让模型读到。非正文文件、无发现一律不动结果(静默放行)。
    await ctx.tool.hook("execute.after", (event) => {
      if (event.status !== "completed") return
      const input = asInput(event.input)
      const targets = mutationTargets(event.tool, input)
      if (targets.length === 0) return
      const root = projectRoot(directory)
      const base = targetBase(root, directory, input)
      try {
        const notes: string[] = []
        for (const target of [...new Set(targets)]) {
          const note = proseAfterWrite(root, resolveTarget(root, target, base))
          if (note) notes.push(note)
        }
        if (notes.length) {
          event.result = { ...event.result, content: appendNote(event.result, notes.join("\n\n")) }
        }
      } catch {
        // 兜底不能反过来卡流程:解析失败一律放行
      }
    })
  },
} satisfies Plugin.Plugin
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: 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