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

scripts/deploy-antigravity-skills.js

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

// Materialize oh-story skills into a project-local Antigravity skill root.
//
// Only the 14 known oh-story directories are replaced. Unknown user skills are
// preserved. An existing `.agents/skills` symlink is never followed for writes;
// it can be materialized only after the caller explicitly opts in.

const fs = require("node:fs");
const path = require("node:path");

const KNOWN_SKILLS = Object.freeze([
  "browser-cdp",
  "story",
  "story-cover",
  "story-deslop",
  "story-import",
  "story-long-analyze",
  "story-long-scan",
  "story-long-write",
  "story-publish",
  "story-review",
  "story-setup",
  "story-short-analyze",
  "story-short-scan",
  "story-short-write",
]);

class DeployError extends Error {
  constructor(message) {
    super(message);
    this.name = "DeployError";
  }
}

function lstatSafe(targetPath) {
  try {
    return fs.lstatSync(targetPath);
  } catch (err) {
    if (err && (err.code === "ENOENT" || err.code === "ENOTDIR")) return null;
    throw err;
  }
}

function statSafe(targetPath) {
  try {
    return fs.statSync(targetPath, { bigint: true });
  } catch (err) {
    if (err && (err.code === "ENOENT" || err.code === "ENOTDIR")) return null;
    throw err;
  }
}

function sameFile(a, b) {
  const s1 = statSafe(a);
  const s2 = statSafe(b);
  if (!s1 || !s2) return false;
  if (s1.ino !== 0n && s2.ino !== 0n) {
    return s1.dev === s2.dev && s1.ino === s2.ino;
  }
  return fs.realpathSync(a) === fs.realpathSync(b);
}

function symlinkTypeForTarget(sourcePath) {
  if (process.platform !== "win32") return undefined;
  const st = statSafe(sourcePath);
  return st && st.isDirectory() ? "dir" : "file";
}

function copyEntry(source, destination, { dereference }) {
  const lstat = fs.lstatSync(source);
  if (lstat.isSymbolicLink() && !dereference) {
    const linkTarget = fs.readlinkSync(source);
    fs.symlinkSync(linkTarget, destination, symlinkTypeForTarget(source));
    return;
  }

  const stat = dereference ? fs.statSync(source) : lstat;
  if (stat.isDirectory()) {
    fs.mkdirSync(destination, { recursive: true });
    for (const entry of fs.readdirSync(source)) {
      copyEntry(path.join(source, entry), path.join(destination, entry), { dereference });
    }
    try {
      fs.chmodSync(destination, stat.mode & 0o777);
    } catch (_) {
      // Ignore chmod quirks on Windows filesystems.
    }
    return;
  }

  fs.copyFileSync(source, destination);
  try {
    fs.chmodSync(destination, stat.mode & 0o777);
  } catch (_) {
    // Ignore chmod quirks on Windows filesystems.
  }
  try {
    fs.utimesSync(destination, stat.atime, stat.mtime);
  } catch (_) {
    // Ignore timestamp preservation failures on restricted filesystems.
  }
}

function validateSource(source) {
  const rootStat = statSafe(source);
  if (!rootStat || !rootStat.isDirectory()) {
    throw new DeployError(`source skill root is missing: ${source}`);
  }
  for (const name of KNOWN_SKILLS) {
    const skillDir = path.join(source, name);
    const dirStat = statSafe(skillDir);
    const skillMdStat = statSafe(path.join(skillDir, "SKILL.md"));
    if (!dirStat || !dirStat.isDirectory() || !skillMdStat || !skillMdStat.isFile()) {
      throw new DeployError(`source skill is incomplete: ${skillDir}`);
    }
  }
}

function unlinkSymlink(targetPath) {
  try {
    fs.unlinkSync(targetPath);
  } catch (err) {
    if (err && (err.code === "EPERM" || err.code === "EISDIR")) {
      fs.rmdirSync(targetPath);
      return;
    }
    throw err;
  }
}

function removeEntry(targetPath) {
  const lst = lstatSafe(targetPath);
  if (!lst) return;
  if (lst.isDirectory() && !lst.isSymbolicLink()) {
    fs.rmSync(targetPath, { recursive: true, force: true });
  } else if (lst.isSymbolicLink()) {
    unlinkSymlink(targetPath);
  } else {
    fs.unlinkSync(targetPath);
  }
}

function deploy(sourceRaw, destinationRaw, { migrateSymlink = false } = {}) {
  const sourceResolvedPath = path.resolve(String(sourceRaw));
  let source;
  try {
    source = fs.realpathSync(sourceResolvedPath);
  } catch (err) {
    if (err && (err.code === "ENOENT" || err.code === "ENOTDIR")) {
      throw new DeployError(`source skill root is missing: ${sourceResolvedPath}`);
    }
    throw err;
  }
  validateSource(source);

  const destination = path.resolve(String(destinationRaw));
  const destLstat = lstatSafe(destination);
  const destIsSymlink = Boolean(destLstat && destLstat.isSymbolicLink());
  const destStat = statSafe(destination);

  if (destStat && !destIsSymlink && sameFile(destination, source)) {
    return "same-object no-op";
  }
  if (destIsSymlink && !migrateSymlink) {
    throw new DeployError(
      `destination is a symlink: ${destination}; rerun only after explicit symlink migration approval`
    );
  }
  if (destStat && !destStat.isDirectory()) {
    throw new DeployError(`destination must be a directory: ${destination}`);
  }

  const destParent = path.dirname(destination);
  const destName = path.basename(destination);
  fs.mkdirSync(destParent, { recursive: true });
  const staging = fs.mkdtempSync(path.join(destParent, `.${destName}.staging-`));
  const backup = path.join(destParent, `${destName}.backup-${process.pid}`);
  const originalLink = destIsSymlink ? fs.readlinkSync(destination) : null;

  let existingRoot = destination;
  if (destIsSymlink) {
    try {
      existingRoot = fs.realpathSync(destination);
    } catch (err) {
      if (err && (err.code === "ENOENT" || err.code === "ENOTDIR")) {
        existingRoot = null;
      } else {
        throw err;
      }
    }
  }

  let movedExisting = false;
  try {
    if (existingRoot !== null) {
      const existingStat = statSafe(existingRoot);
      if (existingStat) {
        if (!existingStat.isDirectory()) {
          throw new DeployError(`symlink target must be a directory: ${existingRoot}`);
        }
        for (const entry of fs.readdirSync(existingRoot)) {
          copyEntry(path.join(existingRoot, entry), path.join(staging, entry), {
            dereference: false,
          });
        }
      }
    }

    for (const name of KNOWN_SKILLS) {
      const target = path.join(staging, name);
      removeEntry(target);
      copyEntry(path.join(source, name), target, { dereference: true });
    }

    if (lstatSafe(backup) !== null) {
      throw new DeployError(`stale deployment backup exists: ${backup}`);
    }
    if (destIsSymlink) {
      unlinkSymlink(destination);
    } else if (destStat !== null) {
      fs.renameSync(destination, backup);
      movedExisting = true;
    }
    fs.renameSync(staging, destination);
    if (movedExisting) {
      fs.rmSync(backup, { recursive: true, force: true });
    }
    return "materialized";
  } catch (err) {
    if (lstatSafe(destination) === null) {
      if (movedExisting && lstatSafe(backup) !== null) {
        fs.renameSync(backup, destination);
      } else if (originalLink !== null) {
        fs.symlinkSync(
          originalLink,
          destination,
          process.platform === "win32" ? "dir" : undefined
        );
      }
    }
    throw err;
  } finally {
    if (lstatSafe(staging) !== null) {
      fs.rmSync(staging, { recursive: true, force: true });
    }
    if (movedExisting && lstatSafe(destination) !== null && lstatSafe(backup) !== null) {
      fs.rmSync(backup, { recursive: true, force: true });
    }
  }
}

class CliUsageError extends Error {
  constructor(message) {
    super(message);
    this.name = "CliUsageError";
  }
}

const USAGE = "usage: deploy-antigravity-skills.js --source <dir> --dest <dir> [--migrate-symlink]\n";

function parseArgs(argv) {
  let source = null;
  let dest = null;
  let migrateSymlink = false;
  for (let i = 0; i < argv.length; i++) {
    const arg = argv[i];
    if (arg === "--source" || arg.startsWith("--source=")) {
      const value = arg.startsWith("--source=") ? arg.slice("--source=".length) : argv[++i];
      if (value === undefined) {
        throw new CliUsageError("deploy-antigravity-skills: --source requires a value\n");
      }
      source = value;
    } else if (arg === "--dest" || arg.startsWith("--dest=")) {
      const value = arg.startsWith("--dest=") ? arg.slice("--dest=".length) : argv[++i];
      if (value === undefined) {
        throw new CliUsageError("deploy-antigravity-skills: --dest requires a value\n");
      }
      dest = value;
    } else if (arg === "--migrate-symlink") {
      migrateSymlink = true;
    } else if (arg === "-h" || arg === "--help") {
      return { help: true };
    } else {
      throw new CliUsageError(`deploy-antigravity-skills: unknown argument: ${arg}\n`);
    }
  }
  if (!source || !dest) {
    throw new CliUsageError(USAGE);
  }
  return { help: false, source, dest, migrateSymlink };
}

function main(argv = process.argv.slice(2)) {
  let args;
  try {
    args = parseArgs(argv);
  } catch (err) {
    if (err instanceof CliUsageError) {
      process.stderr.write(err.message);
      return 2;
    }
    throw err;
  }
  if (args.help) {
    process.stdout.write(USAGE);
    return 0;
  }
  try {
    const status = deploy(args.source, args.dest, { migrateSymlink: args.migrateSymlink });
    process.stdout.write(status + "\n");
    return 0;
  } catch (err) {
    process.stderr.write(`ERROR: ${err.message || err}\n`);
    return 1;
  }
}

if (require.main === module) {
  process.exit(main());
}

module.exports = {
  DeployError,
  KNOWN_SKILLS,
  deploy,
  main,
  validateSource,
};
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