[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M79HAYKVD7RN04VTGETKGBAF":3,"skill-same:01M79HAYKVD7RN04VTGETKGBAF":699},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":28,"commitSha":29,"skillDirectory":30,"forksCount":31,"repositoryHtmlUrl":32,"repositoryHomepageUrl":6,"ownerHtmlUrl":33,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":34,"install":35,"resources":48},"01M79HAYKVD7RN04VTGETKGBAF","story-setup",null,"网文写作工具集基础设施部署与检查。为 Claude Code \u002F OpenCode \u002F Codex \u002F Google Antigravity \u002F ZCode \u002F OpenClaw \u002F Reasonix 提供内置适配；Web AI \u002F 通用 Agent 可走 skills + AGENTS.md 文件模式。触发方式：\u002Fstory-setup、$story-setup、「准备写书」「帮我搭一下环境」「配置写作项目」「检查写作环境」。","rtiy1\u002FYeMuAINoval","rtiy1","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F127036314?v=4","01M79H8EJAVPM0H2VBVBKSSYJ7","moych","01M79H8EJY9NJPDQQKYTNVJ8B4",2,"MIT","https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: story-setup\nversion: 1.2.10\ndescription: \"网文写作工具集基础设施部署与检查。为 Claude Code \u002F OpenCode \u002F Codex \u002F Google Antigravity \u002F ZCode \u002F OpenClaw \u002F Reasonix 提供内置适配；Web AI \u002F 通用 Agent 可走 skills + AGENTS.md 文件模式。触发方式：\u002Fstory-setup、$story-setup、「准备写书」「帮我搭一下环境」「配置写作项目」「检查写作环境」。\"\nmetadata: {\"openclaw\":{\"source\":\"https:\u002F\u002Fgithub.com\u002Fzenstory-ai\u002Foh-story-claudecode\"}}\n---\n# story-setup：网文写作工具集基础设施部署\n\n你是写作基础设施部署器。将网文写作工具集部署到用户项目目录：已适配的 CLI 走专用 hooks\u002Fagents\u002Fconfig；NarraFork、Web AI、自定义 Agent 等环境走通用文件模式。\n\n**执行铁律：不覆盖用户已有配置，合并而非替换。**\n\n## 选择模式\n\n- 参数为 `check`，或用户只要求检查部署、诊断环境、排查 agent 不可用时：完整读取 [references\u002Fdiagnostics.md](references\u002Fdiagnostics.md)，按其中流程仅检查并报告；不进入下面的部署流程。\n- 用户要求安装、更新或修复时：执行下面的部署流程。检查后已明确授权的修复沿用本文件的部署与合并规则。\n\n---\n\n## Phase 1：检测项目状态\n\n**先自检参考目录**：以正在执行的本 `SKILL.md` 所在目录为准，列出与它同级的 `references\u002F` 下的子目录，核对下面 9 个名字是否都在**且都非空**——`agent-references`、`templates`、`opencode`、`codex`、`antigravity`、`zcode`、`openclaw`、`reasonix`、`generic`；同级 `scripts\u002Fmerge-claude-settings.py`、`scripts\u002Fmerge-codex-hooks.py`、`scripts\u002Fmerge-antigravity-hooks.py`、`scripts\u002Fgenerate-antigravity-agents.mjs`、`scripts\u002Fdeploy-antigravity-skills.py` 与 `scripts\u002Fcopy-path-safety.py` 也必须存在（Claude\u002FCodex\u002FAntigravity hooks 合并、Antigravity Skills 物化与 agent 生成、递归复制安全检查依赖它们）。有缺即 skill 包没装全，**立即停止，不写任何部署文件**，报告里区分「缺目录」「目录为空」和「缺脚本」，并给修复指令：「story-setup 参考资料包不完整，缺 {路径}。按你的安装方式重装 oh-story-claudecode（命令行装的重跑 `npx skills add zenstory-ai\u002Foh-story-claudecode -y -g`，marketplace \u002F Plugin Management 装的在面板里重装），再执行 \u002Fstory-setup。」\n\n> 判据是「有没有 `SKILL.md`」：只看正在执行的 `SKILL.md` 同级的 `references\u002F`。项目内 `.claude\u002Fskills\u002Fstory-setup\u002F`、`.codex\u002Fskills\u002Fstory-setup\u002F` 和 OpenCode 的 `skills\u002Fstory-setup\u002F` 只有 `references\u002Fagent-references\u002F`、不含 `SKILL.md`，不会是执行目录，也不要拿它们核对。Antigravity \u002F ZCode \u002F OpenClaw \u002F Reasonix \u002F generic 的项目副本是整份 skill 拷贝、自带 `SKILL.md`，9 个子目录本就齐全，照常核对即可。\n\n1. 检查当前目录是否已部署过（存在 `.story-deployed`）\n   - `agents_version` 缺失、非整数或小于 `30` → 标记为待更新，继续执行当前部署\n   - `agents_version: 30` → 使用 AskUserQuestion 确认是否重新部署；提示里写明重新部署只用**当前本地 skill 包**刷新项目文件，要拿 skill 本身的新版本得先更新 oh-story-claudecode（`npx skills add` 或 marketplace），再回来重跑\n   - `agents_version` 大于 `30` → 当前 story-setup 比项目部署旧；停止以避免降级覆盖，提示先更新 oh-story-claudecode，不写任何部署文件\n   - 同时读 `target_cli` 字段。**已部署项目以 sentinel 里的值为准**：非空时（逗号分隔的多端组合原样保留）跳过下面第 5-12 步的环境探测与选择，直接按这些端重新部署。只有字段缺失或为空，才回落到探测。用户明确要求增删目标端时，用 AskUserQuestion 在现有值基础上改，改完的值写回 sentinel。\n2. 检查是否有书名目录（包含 `追踪\u002F` 子目录的目录，或用户自定义结构）\n   - 有 → 识别为长篇项目，显示当前项目信息\n   - 无 → 识别为新项目或短篇项目\n3. 检查 `.claude\u002Fsettings.local.json` 是否存在\n   - 存在 → 读取现有配置，后续合并\n   - 不存在 → 后续创建新文件\n4. 检查 `.active-book` 文件是否存在\n   - 存在 → 显示当前活跃书目\n   - 不存在 → 跳过\n5. 检查 `opencode.json` 或 `.opencode\u002F` 是否存在\n   - 存在 → 识别为 opencode 项目，`target_cli = opencode`\n   - 不存在 → 跳过\n6. 检查 `.codex\u002F`、`.codex\u002Fconfig.toml`、`.codex\u002Fagents\u002F`、`.codex\u002Fhooks.json`、`AGENTS.md` 中的 Codex 段\n   - 存在 → 识别为 Codex 项目，`target_cli = codex`\n   - 不存在 → 跳过\n7. 检查 `.agents\u002Fhooks.json`、`.agents\u002Fagents\u002F`，或 `.agents\u002Frules\u002Foh-story.md` 中的 Antigravity 标记\n   - 存在 → 识别为 Google Antigravity 项目，`target_cli = antigravity`\n   - 不存在 → 跳过\n8. 检查 `.zcode\u002F`、`.zcode\u002Fconfig.json`、`zcode.json`、`.zcode\u002Fskills\u002F`、`.zcode\u002Fcommands\u002F`、`AGENTS.md` 中的 ZCode 段\n   - 存在 → 识别为 ZCode 项目，`target_cli = zcode`\n   - 不存在 → 跳过\n9. 检查 `openclaw.json`、`.openclaw\u002F`，或 `AGENTS.md` 中的 OpenClaw 段（标题行含 `网文写作工具集（OpenClaw）`）\n   - 存在 → 识别为 OpenClaw 项目，`target_cli = openclaw`\n   - 不存在 → 跳过\n10. 检查 `.reasonix\u002F`、`reasonix-plugin.json`、`REASONIX.md`，或 `AGENTS.md` 中的 Reasonix 段（标题行含 `网文写作工具集（Reasonix）`）\n   - 存在 → 识别为 Reasonix 项目，`target_cli = reasonix`\n   - 不存在 → 跳过\n11. 检查 `AGENTS.md` 中的通用段（标题行含 `网文写作工具集（通用 Agent \u002F Web AI）`）\n   - 存在 → 识别为通用 Web AI 项目，`target_cli = generic`\n   - 不存在 → 跳过\n\n   > 第 9-11 步只认各端**互斥**的标记。`skills\u002F*\u002FSKILL.md` 的 `metadata.openclaw` 不作 OpenClaw 信号：13 个 skill 全都带这个字段，而 OpenClaw \u002F Reasonix \u002F generic 三条 skills-only 路径部署出的 `skills\u002F` 长得一样，用它判定会把后两者一律误认成 OpenClaw。`.agents\u002Fskills\u002F` 由 Antigravity、Codex 与 Reasonix 共用，也不单独作准；Antigravity 必须由 hooks\u002Fagents\u002Frule 专属标记识别。后三端真正的分辨点是各自 `AGENTS.md` 模板的标题行。\n\n12. 如 `.claude\u002F` 或 `CLAUDE.md`、OpenCode、Codex、Antigravity、ZCode、OpenClaw、Reasonix、generic 标记同时存在 → 使用 AskUserQuestion 让用户选择目标环境（选项：Claude Code \u002F OpenCode \u002F Codex \u002F Google Antigravity \u002F ZCode \u002F OpenClaw \u002F Reasonix \u002F 通用 Web AI 或其他 Agent \u002F 任意组合）\n13. 如八类标记都不存在（全新项目）→ 使用 AskUserQuestion 让用户选择目标环境\n   - 用户选择 opencode → `target_cli = opencode`，部署时创建 `opencode.json` 和 `.opencode\u002F`\n   - 用户选择 claude-code → 按现有逻辑处理\n   - 用户选择 codex → `target_cli = codex`，部署时创建 `.codex\u002F`\n   - 用户选择 antigravity → `target_cli = antigravity`，部署时创建 `.agents\u002Fskills`、`.agents\u002Fagents`、`.agents\u002Frules`、`.agents\u002Fhooks` 并合并 `.agents\u002Fhooks.json`\n   - 用户选择 zcode → `target_cli = zcode`，部署时创建 `.zcode\u002F`、合并根 `AGENTS.md`，不创建项目 custom agents\n   - 用户选择 openclaw → `target_cli = openclaw`，部署时复制 OpenClaw 兼容 skills 到项目 `skills\u002F`\n   - 用户选择 reasonix → `target_cli = reasonix`，部署时复制 skills 到项目 `skills\u002F`、写入 Reasonix 版 `AGENTS.md`，不创建项目 custom agents\u002Fhooks\n   - 用户选择通用 Web AI \u002F 其他 Agent → `target_cli = generic`，部署通用 `AGENTS.md` 与项目本地 `skills\u002F`；不写平台专属 hooks\u002Fagents\n   - 用户选择多端 → `target_cli = claude-code,opencode,codex,antigravity,zcode,openclaw,reasonix,generic` 的子集（仅包含用户选择的端）\n\n## Phase 2：部署基础设施\n\n使用 AskUserQuestion 确认部署位置后，依次执行。\n\n整个 Phase 2 幂等：目录复制、文件写入和下表各合并算法重复执行结果一致。因环境原因（工具不可用、权限被拒、网络失败）中途失败时，直接从头重跑本 Phase，不需要先清理半成品；`create only if absent` 的用户状态文件（见下表 Owner class）不会被二次覆盖。\n\n**两列基准目录不同**：`Source path` 相对正在执行的这份 skill 包，`Target path` 相对用户项目根。执行每一行（以及下面各端部署算法里的每个递归复制步骤）之前，先把通配符具体化为单个源\u002F目标，再用本 `SKILL.md` 同级的 `scripts\u002Fcopy-path-safety.py` 检查。该脚本按 `Path.resolve` \u002F `realpath` 语义跟随已有 symlink，并在两侧都存在时用 `samefile` 核对文件系统对象；**只转绝对路径或比较字符串不算检查完成**。读取其 JSON：`status: same` 时 no-op，禁止复制；仅 `copy_allowed: true` 时可以复制；`source_missing`、`unsafe_target_within_source` 或 `filesystem_identity_error` 必须停止该步骤并报告。无法运行脚本时只能用当前环境的文件系统 API 做完全相同的 canonical realpath、same-object 与 target-descendant 检查；无法确认就停止，不得尝试复制。OpenClaw \u002F Reasonix \u002F generic 的项目副本是整份 skill 拷贝，重跑时执行的就是项目里那份；Reasonix \u002F Codex 还可能经 `.agents\u002Fskills → ..\u002Fskills` symlink 加载，路径文本不同也可能指向同一目录，照字面复制会把目录嵌进自身并撑满磁盘。\n\n**部署前清理自嵌套残留**：`{.claude,.codex,.zcode}\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002F` 与项目根 `skills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002F` 里若多出 `agent-references\u002F` 层（可能嵌了多层），以及 `skills\u002Fstory-setup\u002Fskills\u002F`，整段删掉再部署，并在安装报告里列出删掉的路径。\n\n### Step 1：部署清单（机械可检查）\n\n| Source path | Target path | Owner class | Merge mode | Validation check |\n|-------------|-------------|-------------|------------|------------------|\n| `skills\u002Fstory-setup\u002Freferences\u002Ftemplates\u002FCLAUDE.md.tmpl` | `CLAUDE.md` | user+managed | marker\u002Fsection merge | contains story skill routing sections |\n| `skills\u002Fstory-setup\u002Freferences\u002Ftemplates\u002Fhooks\u002F` | `.claude\u002Fhooks\u002F` | story-setup managed | recursive replace | `session-*.sh`, `detect-story-gaps.sh`, `validate-story-commit.sh`, `guard-outline-before-prose.sh`, `check-prose-after-write.sh`, `story_hook_core.js`, `story_hook_cli.js`, `lib\u002Fcommon.sh`, `lib\u002Fsentinel.sh` exist；`story_hook_core.js` 与 OpenCode\u002FZCode 副本字节一致 |\n| `skills\u002Fstory-setup\u002Freferences\u002Ftemplates\u002Frules\u002F*.md` | `.claude\u002Frules\u002F*.md` | story-setup managed | replace | every rule contains `paths` frontmatter |\n| `skills\u002Fstory-setup\u002Freferences\u002Ftemplates\u002Fagents\u002F*.md` | `.claude\u002Fagents\u002F*.md` | story-setup managed | replace | 7 agent files exist |\n| `skills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002F*.md` | `.claude\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002F*.md` | story-setup managed | replace | every `story-setup\u002Freferences\u002Fagent-references\u002F*.md` reference resolves |\n| `skills\u002Fstory-setup\u002Freferences\u002Ftemplates\u002Fsettings-hooks.json` | `.claude\u002Fsettings.local.json` | user+managed | replace managed registrations by stable hook identity | hook JSON valid；旧 matcher 注册已迁移、当前模板命令各一份、用户 hook 保留 |\n| `skills\u002Fstory-setup\u002Fscripts\u002Fmerge-claude-settings.py` | 部署时执行，不复制到项目 | story-setup helper | execute | 替换已知 story hook 注册、保留用户 hooks\u002F顶层字段，v24→v25 迁移与重复执行幂等 |\n| `skills\u002Fstory-setup\u002Fscripts\u002Fcopy-path-safety.py` | 每个递归复制步骤前执行，不复制到项目专用目录 | story-setup helper | execute | JSON 仅 `copy_allowed: true` 时允许复制；symlink 同对象 no-op；target 位于 source 内时停止 |\n| generated sentinel | `.story-deployed` | story-setup managed | replace | contains `agents_version`, `setup_skill_version`, `target_cli`, `resolver_strategy`, `references_dir` |\n| `skills\u002Fstory-setup\u002Freferences\u002Fopencode\u002FAGENTS.md.tmpl` | `AGENTS.md` | user+managed | marker\u002Fsection merge | contains story skill routing sections | target_cli 含 opencode |\n| `skills\u002Fstory-setup\u002Freferences\u002Fopencode\u002Fagents\u002F` | `.opencode\u002Fagents\u002F` | story-setup managed | replace | 7 agent files exist（replace 前按「配置 OpenCode Agent 模型」中的「保留已有模型配置」缓存现有 `model:`，避免覆盖用户已配模型） | target_cli 含 opencode |\n| `skills\u002Fstory-setup\u002Freferences\u002Fopencode\u002Fplugin.ts` | `.opencode\u002Fplugins\u002Fstory-hooks.ts` | story-setup managed | replace | TypeScript plugin file exists | target_cli 含 opencode |\n| `skills\u002Fstory-setup\u002Freferences\u002Fopencode\u002Fstory_hook_core.js` | `.opencode\u002Fplugins\u002Flib\u002Fstory_hook_core.js` | story-setup managed | replace | Node syntax valid；与 ZCode 副本字节一致；被 story-hooks.ts import | target_cli 含 opencode |\n| `skills\u002Fstory-setup\u002Freferences\u002Fopencode\u002Fcommands\u002F` | `.opencode\u002Fcommands\u002F` | story-setup managed | replace | 13 command files exist | target_cli 含 opencode |\n| `skills\u002Fstory-setup\u002Freferences\u002Fopencode\u002Fopencode.json.patch` | merge into `opencode.json` | user+managed | merge by plugin\u002Fpermission key | plugin entry registered | target_cli 含 opencode |\n| repository `skills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002F` | `skills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002F` | story-setup managed | replace | every reference resolves | target_cli 含 opencode |\n| `skills\u002Fstory-setup\u002Freferences\u002Fopencode\u002Fpre-commit.sh` | `.git\u002Fhooks\u002Fpre-commit` | user+managed | append or create | file exists and is executable；含 marker 块则替换块内容，不含则检测 exit 0 位置智能插入 | target_cli 含 opencode |\n| `skills\u002Fstory-setup\u002Freferences\u002Fcodex\u002FAGENTS.md.tmpl` | `AGENTS.md` | user+managed | marker\u002Fsection merge | contains Codex story skill routing sections | target_cli 含 codex |\n| `skills\u002Fstory-setup\u002Freferences\u002Fcodex\u002Fagents\u002F` | `.codex\u002Fagents\u002F` | story-setup managed | replace | 7 TOML agent files parse and contain `name`\u002F`description`\u002F`developer_instructions` | target_cli 含 codex |\n| `skills\u002Fstory-setup\u002Freferences\u002Fcodex\u002Fhooks\u002Fhooks.json` | `.codex\u002Fhooks.json` | user+managed | replace managed registrations by stable hook identity | hook JSON valid; all stale direct\u002Flauncher registrations removed, current 6 registrations present exactly once | target_cli 含 codex |\n| `skills\u002Fstory-setup\u002Freferences\u002Fcodex\u002Fhooks\u002F{story_codex_hook.py,run-story-hook.sh,run-story-hook.cmd}` | `.codex\u002Fhooks\u002F` 同名文件 | story-setup managed | replace | Python\u002Fshell\u002Fcmd launcher 文件齐全 | target_cli 含 codex |\n| `skills\u002Fstory-setup\u002Fscripts\u002Fmerge-codex-hooks.py` | 部署时执行，不复制到项目 | story-setup helper | execute | 替换已知管理注册、保留用户 hooks 与未知顶层字段，结果幂等 | target_cli 含 codex |\n| `skills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002F` | `.codex\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002F` | story-setup managed | replace | every reference resolves | target_cli 含 codex |\n| current package skill root + `scripts\u002Fdeploy-antigravity-skills.py` | `.agents\u002Fskills\u002F{browser-cdp,story*}\u002F` | story-setup managed for 13 known skill names | atomically replace known dirs; preserve unknown skills; never write through symlink | 13 real skill directories with valid `SKILL.md` exist | target_cli 含 antigravity |\n| `skills\u002Fstory-setup\u002Fscripts\u002Fgenerate-antigravity-agents.mjs` + Claude agent sources | `.agents\u002Fagents\u002Fagent-name\u002Fagent.md`（`agent-name` 为实际名称） | story-setup managed for 7 known agent definitions | generate then atomically replace known definitions; preserve unknown user agents | 7 Markdown agents parse; exact Antigravity tool names; `mainAgent: false`, `subagent: true` | target_cli 含 antigravity |\n| `skills\u002Fstory-setup\u002Freferences\u002Fantigravity\u002Frules\u002Foh-story.md` | `.agents\u002Frules\u002Foh-story.md` | story-setup managed | replace | `trigger: always_on`; under 12,000 characters | target_cli 含 antigravity |\n| `skills\u002Fstory-setup\u002Freferences\u002Fantigravity\u002Fhooks\u002Fhooks.json` | `.agents\u002Fhooks.json` | user+managed | replace only top-level `oh-story` group | valid Antigravity named-group schema; user groups preserved; idempotent | target_cli 含 antigravity |\n| `skills\u002Fstory-setup\u002Freferences\u002Fantigravity\u002Fhooks\u002F{story_antigravity_hook.js,story_hook_core.js}` | `.agents\u002Fhooks\u002F` same names | story-setup managed | replace | Node syntax valid; core byte-identical to shared source; hook contract tests pass | target_cli 含 antigravity |\n| `skills\u002Fstory-setup\u002Fscripts\u002Fmerge-antigravity-hooks.py` | deployment helper only | story-setup helper | execute | atomically replaces only `oh-story`, preserves user groups, idempotent | target_cli 含 antigravity |\n| `skills\u002Fstory-setup\u002Freferences\u002Fzcode\u002FAGENTS.md.tmpl` | `AGENTS.md` | user+managed | marker\u002Fsection merge | contains ZCode `$story-*` routing and solo fallback | target_cli 含 zcode |\n| repository `skills\u002F{browser-cdp,story*}\u002F` | `.zcode\u002Fskills\u002F{browser-cdp,story*}\u002F` | story-setup managed for known skill names | replace known skill dirs only | 13 `SKILL.md` files exist and satisfy ZCode frontmatter limits | target_cli 含 zcode |\n| `skills\u002Fstory-setup\u002Freferences\u002Fzcode\u002Fcommands\u002F` | `.zcode\u002Fcommands\u002F` | story-setup managed for known command names | replace known command files only | 13 commands have valid names\u002Ffrontmatter | target_cli 含 zcode |\n| `skills\u002Fstory-setup\u002Freferences\u002Fzcode\u002Fhooks\u002Fstory_zcode_hook.js` | `.zcode\u002Fhooks\u002Fstory_zcode_hook.js` | story-setup managed | replace | Node syntax valid; hook contract tests pass | target_cli 含 zcode |\n| `skills\u002Fstory-setup\u002Freferences\u002Fzcode\u002Fhooks\u002Fstory_hook_core.js` | `.zcode\u002Fhooks\u002Fstory_hook_core.js` | story-setup managed | replace | Node syntax valid; hook contract tests pass | target_cli 含 zcode |\n| `skills\u002Fstory-setup\u002Freferences\u002Fzcode\u002Fconfig.json.patch` | merge into `.zcode\u002Fconfig.json` | user+managed | merge by event+matcher+process args | JSON valid; 按「ZCode 部署算法」第 4 步 hooks 互斥分支校验——未装 oh-story 插件时 `hooks.enabled=true`、only supported events；已装插件时校验 `.zcode\u002Fconfig.json` 不含（或已移除）这批 oh-story hooks 注册 | target_cli 含 zcode |\n| `skills\u002Fstory-setup\u002Freferences\u002Fopenclaw\u002FAGENTS.md.tmpl` | `AGENTS.md` | user+managed | marker\u002Fsection merge | contains OpenClaw story skill routing sections | target_cli 含 openclaw |\n| `skills\u002Fstory-setup\u002Freferences\u002Fgeneric\u002FAGENTS.md.tmpl` | `AGENTS.md` | user+managed | marker\u002Fsection merge | contains generic story skill routing sections | target_cli 含 generic |\n| `skills\u002Fstory-setup\u002Freferences\u002Freasonix\u002FAGENTS.md.tmpl` | `AGENTS.md` | user+managed | marker\u002Fsection merge | contains Reasonix story skill routing sections and solo\u002Fdirect fallback | target_cli 含 reasonix |\n| repository `skills\u002F{browser-cdp,story*}\u002F` | `skills\u002F{browser-cdp,story*}\u002F` | story-setup managed for known skill names | replace known skill dirs only | 13 `SKILL.md` files exist; OpenClaw-compatible frontmatter | target_cli 含 openclaw 或 generic 或 reasonix |\n| repository `skills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002F` | 随上一行整份 skill 拷贝落地，本行 no-op | story-setup managed | 不单独复制 | every reference resolves | target_cli 含 openclaw 或 generic 或 reasonix |\n\n### opencode.json 合并算法\n\n部署 `opencode.json.patch` 时按以下规则合并：\n\n1. 读取现有 `opencode.json`（如存在），解析 JSON\n2. 合并 `plugin` 数组：将 `.\u002F.opencode\u002Fplugins\u002Fstory-hooks.ts` 加入数组，去重\n3. 保留用户已有的其他配置字段（`permission`、`model`、`provider` 等），不覆盖\n4. 写入合并后的 `opencode.json`\n\n### Step 2：部署 CLAUDE.md\n\n- 读取 `skills\u002Fstory-setup\u002Freferences\u002Ftemplates\u002FCLAUDE.md.tmpl`\n- 替换占位符（见下方「模板占位符」段）\n- 写入项目根目录 `CLAUDE.md`（如已存在，按「CLAUDE.md 合并策略」处理）\n\n### Step 3：部署 Hooks\n\n- **递归复制完整目录树**：将 `skills\u002Fstory-setup\u002Freferences\u002Ftemplates\u002Fhooks\u002F` 复制到用户项目 `.claude\u002Fhooks\u002F`\n- 必须保留子目录 `lib\u002F`，其中：\n  - `lib\u002Fcommon.sh` 提供 `project_root`、`discover_active_book`、`discover_all_books`\n  - `lib\u002Fsentinel.sh` 提供 `.story-deployed` 字段读取\n- 只需对 `.claude\u002Fhooks\u002F*.sh` 设置执行权限（`chmod +x`）；`lib\u002F*.sh` 由 hook `source`，不要求可执行位\n\n### Step 4：部署 Rules\n\n- 读取 `skills\u002Fstory-setup\u002Freferences\u002Ftemplates\u002Frules\u002F` 下所有 `.md` 文件\n- 复制到用户项目的 `.claude\u002Frules\u002F` 目录\n\n### Step 5：部署 Agents\n\n- 读取 `skills\u002Fstory-setup\u002Freferences\u002Ftemplates\u002Fagents\u002F` 下所有 `.md` 文件\n- 复制到用户项目的 `.claude\u002Fagents\u002F` 目录\n- Agent 文件属于 story-setup 管理文件，可安全覆盖；版本升级时按 `UPGRADING.md` 的版本检测结果重新部署\n- **`target_cli` 含 opencode 时，覆盖 `.opencode\u002Fagents\u002F` 之前先执行下面「配置 OpenCode Agent 模型」的 Step 1 缓存现有 `model:`**。那一步写在本节后面，但必须先跑——照顺序读到哪做到哪会先覆盖再缓存，用户已配的模型就没了。\n- **部署后必须新开会话**：agent 只在会话启动时注册；原因与必须输出的报告文案见「验证安装」中的「输出安装报告」。\n\n#### Agent 兼容性处理\n\n- Agent 正文以 Claude Code Markdown 为真源；OpenCode 的 `.opencode\u002Fagents\u002F*.md` 与 Codex 的 `.codex\u002Fagents\u002F*.toml` 由 `references\u002Fopencode\u002Fagents\u002F`、`references\u002Fcodex\u002Fagents\u002F` 下的预生成产物直接复制。Antigravity 的 `.agents\u002Fagents\u002Fagent-name\u002Fagent.md`（`agent-name` 为实际名称）则在部署时调用随 story-setup 下发的 `scripts\u002Fgenerate-antigravity-agents.mjs`，把 Claude 工具名、模型档、reference 根和调用术语确定性转换为 Antigravity 2.0 契约；不得把 Claude frontmatter 原样复制过去。\n- **ZCode 3.3.4 不部署项目 agents**：其自定义子智能体只支持用户级 `~\u002F.zcode\u002Fagents\u002F`，plugin manifest 中的 `agents` 当前不执行。不要创建 `.zcode\u002Fagents\u002F` 或修改用户 home；相关 Skill 必须直接 solo\u002Fdirect 并报告 fallback。\n- **OpenClaw Phase 1 不部署 agents**：OpenClaw 只部署 skills，agent 协作相关 skill 必须按既有 fallback 规则降级 solo\u002Fdirect，不要把 Claude\u002FOpenCode agent frontmatter 直接复制成 OpenClaw agent。\n- 部署到项目后，agent 内引用的参考资料必须走 `story-setup\u002Freferences\u002Fagent-references\u002F*.md` 这一本 skill 内复制路径；不要跨 skill 引用其他 skill 的 references。各 adapter 只使用当前规范前缀：Claude Code 为 `.claude\u002Fskills\u002F`，Antigravity 为 `.agents\u002Fskills\u002F`，OpenCode \u002F OpenClaw \u002F Reasonix \u002F generic 为 `skills\u002F`，Codex 为 `.codex\u002Fskills\u002F`，ZCode 为 `.zcode\u002Fskills\u002F`；不在运行时遍历历史备选路径。\n\n#### 部署 Agent References\n\n- 将 `skills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002F` 下所有 `.md` 复制到项目内 `.claude\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002F`\n- 校验：凡 agent 或 reference 中出现 `story-setup\u002Freferences\u002Fagent-references\u002F\u003Cfile>.md`，源包与目标包都必须存在 `\u003Cfile>.md`\n\n#### 部署 Codex Agents（target_cli 含 codex 时）\n\n- 读取 `skills\u002Fstory-setup\u002Freferences\u002Fcodex\u002Fagents\u002F` 下所有 `.toml` 文件，复制到用户项目 `.codex\u002Fagents\u002F`\n- Agent 文件属于 story-setup 管理文件，可安全覆盖；`references\u002Fcodex\u002Fagents\u002F` 里的 TOML 由仓库根的 `scripts\u002Fgenerate-codex-agents.py` 从 Claude agent 模板确定性生成后提交入库，部署只做复制\n- 校验每个 TOML 都能解析，且包含 Codex 必需字段：`name`、`description`、`developer_instructions`\n- 只读职责 agent（`chapter-extractor`、`consistency-checker`、`story-explorer`）必须保留 `sandbox_mode = \"read-only\"`\n- **部署后必须 trust + 新开 Codex 会话**（报告文案与 fallback 规则见「验证 Codex 部署」）；若运行时返回 `unknown agent_type`，调用方必须降级 solo\u002Fdirect 并报告 fallback。\n- 将 `skills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002F` 同步复制到 `.codex\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002F`，作为 Codex agent 的项目内参考资料主路径\n\n#### 部署 Antigravity Agents（target_cli 含 antigravity 时）\n\n- 先确认 `node` 在 PATH；Antigravity agent 生成与项目 hooks 都依赖 Node。缺失时停止 Antigravity 这一目标的部署，不留下半成品，并提示安装 Node 后重跑。\n- 执行 `node \"{story-setup skill目录}\u002Fscripts\u002Fgenerate-antigravity-agents.mjs\" --source \"{story-setup skill目录}\u002Freferences\u002Ftemplates\u002Fagents\" --dest \"{项目}\u002F.agents\u002Fagents\"`。生成器先渲染全部 7 个 agent，再原子替换这 7 个已知 `.agents\u002Fagents\u002Fagent-name\u002Fagent.md` 定义（`agent-name` 为实际名称），并清理旧版同名扁平 `.md`；保留其他用户 agent，任一源 frontmatter 异常时不得留下半更新目录，也不得沿 managed agent symlink 写出项目外。\n- 校验 7 个 `.md`：`name` 与文件名一致；`mainAgent: false`、`subagent: true`；模型只使用 `flash` \u002F `pro`；工具只来自 Antigravity 官方名称 `view_file`、`find_by_name`、`grep_search`、`write_to_file`、`replace_file_content`、`multi_replace_file_content`、`run_command`；不得残留 Claude 的 `Read\u002FGlob\u002FGrep\u002FWrite\u002FEdit\u002FBash` 工具名或 `.claude\u002Fskills\u002F` reference 前缀。\n- 只读 agent（`chapter-extractor`、`consistency-checker`、`story-explorer`）不得包含写文件或命令工具；其他 agent 按 Claude 真源的能力边界映射。\n- Antigravity 通过 `invoke_subagent` 的 `TypeName` 调用这些 agent。部署后新开 Antigravity conversation，再用 `story-review` 验证 full\u002Flean；运行时无法解析某个 custom agent 时按 skill 的 solo\u002Fdirect fallback 执行。\n\n#### 配置 OpenCode Agent 模型\n\n> 仅当 `target_cli` 含 `opencode` 时执行。OpenCode 子代理不指定模型时继承主模型，导致低成本 Agent 也消耗主模型额度。此步骤自动检测用户模型并写入 `model:` 字段。\n\n##### Step 1：保留已有模型配置（必须在 `.opencode\u002Fagents\u002F` 的 replace 之前执行）\n\nOpenCode agents 部署是 `replace`，会覆盖上次写入的 `model:`。所以在执行该 replace **之前**先扫描现有 `.opencode\u002Fagents\u002F*.md`，缓存每个 agent 的 `model:`（agent 名 → 模型 ID）。后续检测失败\u002F超时、或用户跳过某一级时，用缓存值回填，避免把用户上次配好的低成本模型抹成主模型。若 replace 已先发生、缓存为空，则按全新部署处理，并在安装报告中提示\"未能保留上次模型配置\"。\n\n##### Step 2：获取模型列表\n\n优先执行 `opencode models --verbose`，它输出含 cost（input\u002Foutput\u002Fcache 单价）、context、capabilities 的 metadata；不可用或解析失败时回退到 `opencode models` 纯文本（每行 `provider\u002Fmodel`）。两者都用 60000ms（60 秒）超时，因为首次运行需加载 models.dev 缓存。\n\n- 成功 → 进入「模型分级」\n- 超时 → 重试一次（缓存可能未预热）；仍然超时则按「保留已有模型配置」缓存回填已有 `model:`、跳过自动配置，在安装报告中输出手动配置指南\n- 失败（命令不存在、输出为空等）→ 同上：回填「保留已有模型配置」缓存、跳过自动配置、输出手动配置指南\n\n##### Step 3：模型分级\n\n**优先按成本分级（有 `--verbose` 时）**：按每模型实际 cost 从低到高分档——低端取最便宜\u002F免费档、中端取中价档、高端取最贵或上下文\u002F能力最强档。免费模型按真实 cost=0 归低端，**不按名字里的营销词**（如 `nemotron-3-ultra-free` 名含 `ultra` 但 cost=0，应归低端）。无 cost 数据的模型也据此进入候选，不被丢弃。\n\n**回退按关键词分级（无 `--verbose` 或无 cost 时）**：按模型 ID 中最后一个 `\u002F` 之后的模型名按 `-`、`.`、`_` 分割为段，逐段精确匹配关键词（不区分大小写）。例如 `minimax-m3` 拆为 `[minimax, m3]`，不匹配 `mini` 也不匹配 `max`；`claude-haiku-4.5` 拆为 `[claude, haiku, 4, 5]`，匹配 `haiku`。关键词分级是启发式，安装报告中标注 `分级依据：关键词（heuristic）`。\n\n| 等级 | 匹配关键词 | 对应 Agent |\n|------|-----------|-----------|\n| 低端 | `haiku`, `flash`, `mini`, `nano`, `lite` | chapter-extractor, consistency-checker, story-explorer |\n| 中端 | `sonnet`, `plus` | story-researcher, narrative-writer, character-designer |\n| 高端 | `opus`, `pro`, `ultra`, `max` | story-architect |\n\n- 一个模型可能匹配多个等级的关键词，取最高等级\n- 关键词回退下未匹配任何关键词的模型仍列入候选附加建议（按成本分级则一律纳入），并在安装报告列出，提示\"可通过自定义输入使用\"\n- 同一等级内，如果包含多个模型供应商，优先列出知名供应商（anthropic、openai、google、deepseek）的模型\n\n##### Step 4：逐级交互选择\n\n按 低端 → 中端 → 高端 顺序，每级用 AskUserQuestion 让用户选择。\n\n**低端选项结构：**\n\n```\n问题：\"为低成本 Agent（chapter-extractor, consistency-checker, story-explorer）选择模型：\"\n选项：\n  - provider\u002Fmodel-id\n  - provider\u002Fmodel-id\n  - 自定义输入（手动输入完整模型 ID，ID 拼写错误要到运行时才会暴露）\n  - 跳过，使用主模型（成本可能较高）\n```\n\n**中端选项结构：**\n\n```\n问题：\"为写作质量关键 Agent（narrative-writer, character-designer, story-researcher）选择模型：\"\n选项：\n  - provider\u002Fmodel-id\n  - provider\u002Fmodel-id\n  - 自定义输入（请勿使用低端模型，会影响正文质量；ID 拼写错误要到运行时才会暴露）\n  - 跳过，使用主模型（主模型质量通常足够）\n```\n\n**高端选项结构：**\n\n```\n问题：\"为总指挥 Agent（story-architect）选择模型：\"\n选项：\n  - provider\u002Fmodel-id\n  - provider\u002Fmodel-id\n  - 自定义输入（手动输入完整模型 ID，ID 拼写错误要到运行时才会暴露）\n  - 跳过，使用主模型（成本可能较高）\n```\n\n规则：\n- 候选最多显示 5 个，超过则截断并提示\"更多模型请使用自定义输入\"。**每一级无论候选数是否为 0 都用 AskUserQuestion 弹出**，选项至少含：候选模型（如有）、`自定义输入`、`保留现有模型`（「保留已有模型配置」缓存到该 agent 的 model，无则不显示此项）、`跳过，用主模型`。候选为 0 时仍弹窗，并在问题说明里给出对应警告 + 列出未分级\u002F未入档模型供参考——不再静默跳过交互（否则用户够不到自定义输入）。\n- `自定义输入`：用户输入 `provider\u002Fmodel-id` 完整 ID；写入前校验为单行、无控制字符、匹配 `^[A-Za-z0-9._-]+\u002F[A-Za-z0-9._:+-]+$`，不符则提示重输或改选跳过。\n- `保留现有模型`：写回「保留已有模型配置」缓存的该 agent model（重新部署时保住用户上次配置），不算\"跳过\"。\n- `跳过，用主模型`：显式清除——不写该 agent 的 `model:`，agent 继承主模型。想保留上次配置请选 `保留现有模型`。\n- 各级候选为 0 时在问题说明里给出提示：\n  - 低端：\"未检测到低成本模型，这 3 个 agent 将使用主模型，成本可能较高\"\n  - 中端：\"未检测到匹配的中端模型。narrative-writer、character-designer、story-researcher 将使用主模型。如主模型质量足够此配置合理；如需降本，请用自定义输入指定不低于主模型质量的中端模型，或从下方未分级模型里选。\"\n  - 高端：\"未检测到高端模型，story-architect 将使用主模型\"\n\n##### Step 5：写入 model 字段\n\n对应用户选择的 agent 文件（`.opencode\u002Fagents\u002F*.md`，由部署清单中 OpenCode agents 部署步骤在此步骤之前已部署），在 frontmatter 末尾、closing `---` 之前，以**零缩进的顶层字段**插入 `model:`（不要插进 `permission:` 等多行 map 的缩进块内部）。值含 YAML 特殊字符时加引号，确保不破坏 frontmatter：\n\n```yaml\n---\ndescription: ...\nmode: subagent\npermission:\n  read: allow\n  edit: deny\nsteps: 12\nmodel: provider\u002Fmodel-id\n---\n```\n\n- 如果 agent 文件已有 `model:` 字段（重新部署场景），替换该顶层 `model:` 的值，不新增重复键\n- `保留现有模型`：写回「保留已有模型配置」缓存的该 agent model\n- `跳过，用主模型`：不写入 `model:` 字段\n- 检测失败\u002F超时、没走到本步骤的等级：用「保留已有模型配置」缓存回填 `model:`，避免 replace 抹掉用户上次配置\n\n### Step 6：合并 Hooks 注册到 settings.local.json\n\n1. 按现有跨平台规则探测 Python：`for PYBIN in python3 python py; do \"$PYBIN\" -c \"\" 2>\u002Fdev\u002Fnull && break; done`；无可用解释器时停止，不手写或简化合并。\n2. 调用 `\"$PYBIN\" \"{story-setup skill目录}\u002Fscripts\u002Fmerge-claude-settings.py\" --existing \"{项目}\u002F.claude\u002Fsettings.local.json\" --template \"{story-setup skill目录}\u002Freferences\u002Ftemplates\u002Fsettings-hooks.json\" --output \"{项目}\u002F.claude\u002Fsettings.local.json\"`。\n3. helper 会移除所有已知 story-setup hook 的历史注册，再追加当前模板；因此 matcher\u002Ftimeout\u002Fif 能随版本升级，同时混在旧 block 中的用户 hook 与未知顶层字段原样保留。写后解析 JSON，验证模板命令各一份、用户配置仍在，再复跑 helper 比较文件字节确认幂等。\n\n### Codex hooks.json 合并算法（target_cli 含 codex 时）\n\nCodex 项目 hooks 部署到 `.codex\u002Fhooks.json`；运行脚本部署到 `.codex\u002Fhooks\u002Fstory_codex_hook.py`、`run-story-hook.sh`、`run-story-hook.cmd`。JSON 只负责定位项目根与传递 event，解释器探测由平台 launcher 统一处理。\n\n1. 定位当前 story-setup skill 目录，读取 `references\u002Fcodex\u002Fhooks\u002Fhooks.json` 作为唯一当前模板，读取项目 `.codex\u002Fhooks.json`（不存在时视为空对象）。\n2. 按现有跨平台规则探测可用 Python：`for PYBIN in python3 python py; do \"$PYBIN\" -c \"\" 2>\u002Fdev\u002Fnull && break; done`；无可用解释器时停止，不手写或简化 JSON 合并。\n3. 调用 `\"$PYBIN\" \"{story-setup skill目录}\u002Fscripts\u002Fmerge-codex-hooks.py\" --existing \"{项目}\u002F.codex\u002Fhooks.json\" --template \"{story-setup skill目录}\u002Freferences\u002Fcodex\u002Fhooks\u002Fhooks.json\" --output \"{项目}\u002F.codex\u002Fhooks.json\"`。该 helper 会识别旧直调 `story_codex_hook.py`、当前 `run-story-hook.sh` 和 `run-story-hook.cmd` 三类管理身份，先移除所有已知管理注册，再追加当前模板。\n4. 保留用户已有的非 story-setup hooks、matcher 块与未知顶层字段。重复执行必须幂等；禁止再按原始 `command` 字符串追加去重，否则 v17 直调命令会与 v18 launcher 双重注册。\n5. 写入后解析 JSON 验证：旧直调 `story_codex_hook.py` 命令数为 0，当前模板 6 个注册各存在且仅存在一次，用户 hook 与未知顶层字段仍在。然后提示用户：项目 `.codex\u002F` 层需要被 Codex trust，非 managed command hooks 还需要在 `\u002Fhooks` 中 review\u002Ftrust 后才会运行；Windows 下走 `commandWindows`，launcher 从当前目录向上定位项目 `.codex\u002Fhooks\u002F`，与 POSIX 路径的嵌套目录行为一致。\n\n### Antigravity 部署算法（target_cli 含 antigravity 时）\n\nAntigravity 2.0 使用项目 `.agents\u002F` customization 根。部署 Skills、Always-On Rule、7 个 custom subagents 与 workspace Hooks；不修改用户 home 下的 `~\u002F.gemini\u002F`。\n\n1. 找到当前 skill 包的 13 个已知 skill 目录（`browser-cdp` 与 `story*`），调用 `deploy-antigravity-skills.py --source \"{当前 skill 包根}\" --dest \"{项目}\u002F.agents\u002Fskills\"` 原子物化。helper 只替换 13 个已知名称、保留用户其他 skills，并在源目标同一 realpath 时 no-op。目标必须是**真实目录**，不要新建顶层 `.agents\u002Fskills → ..\u002Fskills` symlink：Antigravity 2.0 项目部署以真实目录作为受支持路径。\n   - 若已有 `.agents\u002Fskills` 是 symlink，helper 必须先停止且不沿链接写入。用 AskUserQuestion 说明：迁移会把链接当前可见的所有 skills 复制到新的项目内真实目录、只更新 13 个 oh-story 名称、保留链接目标原样，但会把 symlink 本身替换成目录；这可能形成较大的 git diff。只有用户明确同意后才加 `--migrate-symlink` 重跑，拒绝则停止 Antigravity 部署并报告未获得完整支持。这个确认不得被“多端部署”或已有 Codex symlink 跳过。\n2. 按上方「部署 Antigravity Agents」运行生成器，原子更新 `.agents\u002Fagents\u002F` 中 7 个已知 `.agents\u002Fagents\u002Fagent-name\u002Fagent.md` 定义（`agent-name` 为实际名称）并保留其他用户 agent；不从用户 home 搬运 agent。\n3. 复制 `references\u002Fantigravity\u002Frules\u002Foh-story.md` 到 `.agents\u002Frules\u002Foh-story.md`，验证 `trigger: always_on` 且文件小于 Antigravity 12,000 字符上限。该 rule 承担 skill 路由、写作硬约束与 compact 后恢复；Antigravity IDE 不以根 `AGENTS.md` 作为 workspace rule，所以不要用 AGENTS 模板代替。\n4. 复制 `references\u002Fantigravity\u002Fhooks\u002Fstory_antigravity_hook.js` 与同目录 `story_hook_core.js` 到 `.agents\u002Fhooks\u002F`，验证 `node --check`。hook 命令以 `.agents\u002F`（`hooks.json` 所在目录）为工作目录，必须使用 `hooks\u002Fstory_antigravity_hook.js`，不得写成 `.agents\u002Fhooks\u002F...`。共享 core 必须与 Claude\u002FOpenCode\u002FZCode 源字节一致。\n5. 合并 `references\u002Fantigravity\u002Fhooks\u002Fhooks.json` 到 `.agents\u002Fhooks.json`：按跨平台规则探测 Python 3，调用 `merge-antigravity-hooks.py {项目}\u002F.agents\u002Fhooks.json {skill目录}\u002Freferences\u002Fantigravity\u002Fhooks\u002Fhooks.json`。helper 只替换顶层 `oh-story` named group，保留其他用户 hook groups；写后复跑并比较字节确认幂等。禁止把 Claude\u002FCodex 的外层 `{ \"hooks\": ... }` schema 写入 Antigravity。\n6. 校验事件边界：只注册 `PreToolUse`、`PostToolUse`、`PreInvocation`、`Stop`。PreToolUse 必须为每次调用输出 `decision`；PostToolUse 必须只输出 `{}`，正文 findings 经 session `artifactDirectoryPath` 暂存并由下一次 PreInvocation 注入；若模型准备直接结束，Stop 最多强制继续一次，避免无限循环。Antigravity 外部 hooks 没有 SessionStart\u002FPreCompact\u002FPostCompact，首次上下文由 `invocationNum=0` 的 PreInvocation 注入，compact 后由 Always-On Rule 强制读取 `追踪\u002F上下文.md`。\n7. `.story-deployed` 的 `target_cli` 写 `antigravity` 或多端组合，`references_dir` 写 `.agents\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references`。安装报告提示新开 conversation 使 Skills\u002FRules\u002FAgents\u002FHooks 重新扫描；同时明确 Node 是 hook 运行时依赖。\n\nAntigravity IDE 与交互式 `agy` 共用这套 workspace `.agents\u002F` 产物，但仍需分别实机 smoke test。不要依赖 `npx skills add -g` 当前把全局 skill 写到哪个 `~\u002F.gemini\u002F*` 目录；`story-setup` 的支持承诺只覆盖上述项目内真实目录部署。\n\n### ZCode 部署算法（target_cli 含 zcode 时）\n\nZCode 首版部署 Skills、Commands、AGENTS.md 和支持事件内的 Hooks；不部署 `.zcode\u002Fagents` 或 `.zcode\u002Frules`。\n\n1. 复制仓库当前 `skills\u002F` 下 13 个包含 `SKILL.md` 的目录到 `.zcode\u002Fskills\u002F{skill-name}\u002F`；仅替换这些已知目录，保留用户其他 Skills。\n2. 复制 `references\u002Fzcode\u002Fcommands\u002F*.md` 到 `.zcode\u002Fcommands\u002F`；仅替换 13 个同名命令，保留用户其他 Commands。\n3. 复制 `references\u002Fzcode\u002Fhooks\u002Fstory_zcode_hook.js` 和 `references\u002Fzcode\u002Fhooks\u002Fstory_hook_core.js` 到 `.zcode\u002Fhooks\u002F`。\n4. 读取 `references\u002Fzcode\u002Fconfig.json.patch` 和现有 `.zcode\u002Fconfig.json`（如只有根 `zcode.json`，仍创建 `.zcode\u002Fconfig.json` 承载 oh-story 项目 Hooks，不改写根文件）：\n   - 保留用户所有未知字段、MCP、plugins、skills\u002Fcommands disable overrides；\n   - **hooks 互斥（避免双触发）**：若本项目经已安装的 oh-story 插件运行（marketplace 安装，仓库根 `.zcode-plugin\u002Fplugin.json` 的 `hooks.json` 已全局注册 SessionStart\u002FPreToolUse\u002FPostToolUse），则**跳过**下面把 `config.json.patch` 的 `hooks` 块合并进 `.zcode\u002Fconfig.json`——插件 manifest 已注册这批 hooks，再合并会让同一事件跑两遍（PreToolUse 拦两次、PostToolUse 注入两次）。只有未装插件（直接克隆 \u002F 手动导入 references）时才合并 hooks。不确定时以「ZCode 是否已通过本插件注册这套 hooks」为准；skills\u002Fcommands\u002Fhook 文件\u002FAGENTS 与 config 的非 hook 字段两条路径都照常部署。\n   - 合并 hooks（仅未装插件时）：设置 `hooks.enabled: true`；用户已有更大的 `timeoutMs` 时保留，否则取模板值；对 `hooks.events` 的 SessionStart、PreToolUse、PostToolUse 按 `event + matcher + process command + args` 去重追加；不复制 ZCode 不支持的 PreCompact、PostCompact、SessionEnd、SubagentStop、Notification。\n5. 将 `references\u002Fzcode\u002FAGENTS.md.tmpl` 按「AGENTS.md 合并策略」写入根 `AGENTS.md`。\n6. `.story-deployed` 的 `target_cli` 写入 `zcode` 或多端组合，`references_dir` 写 `.zcode\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references`。\n7. 安装报告明确说明：ZCode 3.3.4 的项目\u002Fplugin custom agents 不执行，所有专业角色走 solo\u002Fdirect；系统需要可用的 `node` 命令运行项目 Hook。\n\nPlugin 安装不经过本算法：仓库根 `.zcode-plugin\u002Fplugin.json` 直接暴露同一组 Skills\u002FCommands\u002FHooks。Plugin Skills 优先级低于 workspace `.zcode\u002Fskills`；两者同时存在时项目快照优先，升级项目快照需重新运行 `$story-setup`。**Hooks 只能注册一份**：插件 manifest 与 workspace `.zcode\u002Fconfig.json` 注册的是同一批事件，装了插件就不要再把 `config.json.patch` 的 hooks 合并进 `.zcode\u002Fconfig.json`（见上算法第 4 步的 hooks 互斥），否则 PreToolUse\u002FPostToolUse 会双触发；插件在场时以插件 manifest 为 hooks 唯一注册源。\n\n### OpenClaw skills-only 部署算法（target_cli 含 openclaw 时）\n\nOpenClaw Phase 1 只部署 skills，不部署 OpenClaw agents\u002Fhooks\u002Fplugin。\n\n1. 读取仓库当前 `skills\u002F` 下所有包含 `SKILL.md` 的 story skill 目录（13 个：`browser-cdp` 与 `story*`）。\n2. 写入目标项目 `skills\u002F{skill-name}\u002F`，仅替换这些 story-setup 管理的已知 skill 目录；保留用户在 `skills\u002F` 下的其他目录。\n3. 每个 `SKILL.md` 必须满足 OpenClaw frontmatter 约束：`name` \u002F `description` 是单行键值，`metadata` 是单行 JSON 对象且含 `metadata.openclaw`。\n4. 复制 `skills\u002Fstory-setup\u002Freferences\u002Fopenclaw\u002FAGENTS.md.tmpl` 到项目 `AGENTS.md`，按「AGENTS.md 合并策略」合并。\n5. `.story-deployed` 的 `target_cli` 写入 `openclaw` 或多端组合；`references_dir` 对 OpenClaw 写 `skills\u002Fstory-setup\u002Freferences\u002Fagent-references`。\n6. 安装报告提示项见 Phase 3 第 10 步。\n\n### Reasonix skills-only 部署算法（target_cli 含 reasonix 时）\n\nReasonix（DeepSeek-Reasonix CLI）当前只部署 skills 与 `AGENTS.md`，不部署 Reasonix hooks\u002Fcustom agents（hook I\u002FO 契约与子代理行为缺少可校验的真实 CLI，留待后续阶段）。\n\n1. 读取仓库当前 `skills\u002F` 下所有包含 `SKILL.md` 的 story skill 目录（13 个：`browser-cdp` 与 `story*`）到目标项目 `skills\u002F{skill-name}\u002F`；仅替换这些 story-setup 管理的已知 skill 目录，保留用户其他目录。\n2. 在项目根创建 `.agents\u002Fskills → ..\u002Fskills` 相对 symlink（与 Codex 共用的 skill root），使 Reasonix 原生扫描 `.agents\u002Fskills` 时发现这些 skill；若已是指向 `skills\u002F` 的 symlink 则保留，若被占用为普通目录则不覆盖并在安装报告提示。Windows 未启用 symlink 时跳过本步，改走根 `reasonix-plugin.json` 的 `reasonix plugin install`。\n3. 复制 `skills\u002Fstory-setup\u002Freferences\u002Freasonix\u002FAGENTS.md.tmpl` 到项目 `AGENTS.md`，按「AGENTS.md 合并策略」合并。\n4. `.story-deployed` 的 `target_cli` 写入 `reasonix` 或多端组合；`references_dir` 对 Reasonix 写 `skills\u002Fstory-setup\u002Freferences\u002Fagent-references`。\n5. 安装报告提示项见 Phase 3 第 12 步。\n\n### 通用 Web AI \u002F 其他 Agent 部署算法（target_cli 含 generic 时）\n\n通用路径面向 NarraFork、Web AI、自定义 Agent 等可读取项目文件的环境，只部署通用文件，不声明平台原生 hooks\u002Fagents 能力。\n\n1. 复制仓库当前 `skills\u002F` 下所有包含 `SKILL.md` 的 story skill 目录（13 个：`browser-cdp` 与 `story*`）到目标项目 `skills\u002F{skill-name}\u002F`；仅替换这些 story-setup 管理的已知 skill 目录，保留用户其他目录。\n2. 复制 `skills\u002Fstory-setup\u002Freferences\u002Fgeneric\u002FAGENTS.md.tmpl` 到项目 `AGENTS.md`，按「AGENTS.md 合并策略」合并。\n3. `.story-deployed` 的 `target_cli` 写入 `generic` 或多端组合；`references_dir` 对 generic 写 `skills\u002Fstory-setup\u002Freferences\u002Fagent-references`。\n4. 安装报告提示项见 Phase 3 第 11 步。\n\n### Step 7：创建部署标记\n\n- 创建 `.story-deployed` 文件（sentinel file）\n- 写入以下字段（YAML `key: value` 格式，hook 用 `references\u002Ftemplates\u002Fhooks\u002Flib\u002Fsentinel.sh` 读取）：\n  ```\n  deployed_at: \u003Cdate -u +\"%Y-%m-%dT%H:%M:%SZ\">\n  agents_version: 30\n  setup_skill_version: 1.2.10\n  target_cli: claude-code（或 opencode、codex、antigravity、zcode、openclaw、reasonix、generic，或其任意组合）\n  resolver_strategy: project-local-skill-reference\n  references_dir: .claude\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references（Codex 写 .codex\u002Fskills\u002F...；Antigravity 写 .agents\u002Fskills\u002F...；ZCode 写 .zcode\u002Fskills\u002F...；OpenClaw \u002F Reasonix \u002F generic 写 skills\u002F...；多端用逗号分隔）\n  ```\n- 此文件供 session-start.sh 和写作 skill 检测部署状态，避免重复提示\n- target_cli 含 claude-code 时，同时创建一次性标记文件 `.claude\u002F.agents-pending-restart`（空文件即可）。session-start.sh 在下一个会话启动时据此确认 agents 已随新会话注册，并自动删除该标记——用来向用户确认「重启已生效」。ZCode 不创建该标记，因为它不部署项目 agents。\n- 如果 `.story-deployed` 已存在但 `agents_version` 缺失、非整数或小于 `30`，按本次流程更新 hooks\u002Fagents\u002Frules\u002Freference bundle（具体变更见 `UPGRADING.md`）；大于 `30` 时已在 Phase 1 停止，不得降级覆盖\n\n## Phase 3：验证安装\n\n按 `.story-deployed.target_cli` 选择对应端的检查：第 1–4 项仅用于 Claude Code，第 5 项是所有端共有的部署标记检查，第 6 项是部署报告，第 7–13 项按目标端各选其一。仅检查模式复用第 1–5 项与对应端的第 7–13 项，跳过第 6 项，且其中要求实际执行 hook 或写入 fixture 的子项改为只做静态校验（文件存在、语法有效、注册项齐全），不运行会写入项目的 hook，也不创建部署标记。\n\n1. 验证 hooks 注册：\n   - 检查 `.claude\u002Fsettings.local.json` 中的 hooks 字段是否正确\n   - 检查 `.claude\u002Fhooks\u002F` 下的脚本是否存在且有执行权限\n   - 检查 `.claude\u002Fhooks\u002Flib\u002Fcommon.sh` 与 `.claude\u002Fhooks\u002Flib\u002Fsentinel.sh` 是否存在\n2. 验证 rules 路径：\n   - 检查 `.claude\u002Frules\u002F` 下的规则文件是否存在且包含 `paths` frontmatter\n3. 验证 agents：\n   - 检查 `.claude\u002Fagents\u002F` 下的 7 个 agent 定义文件是否存在\n4. 验证 agent reference bundle：\n   - 检查 `.claude\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002F` 下 reference 文件完整\n   - 检查所有 `story-setup\u002Freferences\u002Fagent-references\u002F\u003Cfile>.md` 都能解析到 deployed bundle\n5. 验证部署标记：\n   - 检查 `.story-deployed` 是否存在且包含时间戳、`agents_version: 30`、`setup_skill_version: 1.2.10`、`target_cli`、`resolver_strategy`、`references_dir`\n6. 输出安装报告：\n   - 列出所有已部署的文件\n   - 列出需要注意的事项（如已有配置已合并）\n    - **⚠️ 重启提示（必须醒目输出）**：本次部署写入了 `.claude\u002Fagents\u002F`，但这些 custom agent 只在「会话启动」时才会被 Claude Code 注册成 `subagent_type`。**请新开一个 Claude Code 会话再开始写作**，否则当前会话里 story-review \u002F story-long-write 等想 spawn `story-architect`、`narrative-writer` 等时会拿到「subagent_type 不可用」并降级 solo（单视角，失去多 agent 协作）。判断是否生效：新会话里跑 `\u002Fstory-review`，报告头若是 `Effective Mode: full\u002Flean` 即注册成功；若是 `Fallback: ... -> solo` 说明还在旧会话或未注册。\n    - 重启后即可使用 `\u002Fstory-long-write` 或 `\u002Fstory-short-write`\n    - 如果执行了「配置 OpenCode Agent 模型」，输出 Agent 模型配置摘要：\n      ```\n      Agent 模型配置：\n        story-architect          → \u003C高端模型>（provider\u002Fmodel-id）\n        narrative-writer         → \u003C中端模型>（provider\u002Fmodel-id）\n        character-designer       → \u003C中端模型>（provider\u002Fmodel-id）\n        story-researcher         → \u003C中端模型>（provider\u002Fmodel-id）\n        chapter-extractor        → \u003C低端模型>（provider\u002Fmodel-id）\n        consistency-checker      → \u003C低端模型>（provider\u002Fmodel-id）\n        story-explorer           → \u003C低端模型>（provider\u002Fmodel-id）\n      ```\n    - 如果自动检测失败（`opencode models` 不可用），输出手动配置指南：\n      ```\n      无法自动检测模型列表。以下 Agent 未配置模型，将使用主模型，成本可能较高：\n        - chapter-extractor（建议使用低成本模型）\n        - consistency-checker（建议使用低成本模型）\n        - story-explorer（建议使用低成本模型）\n\n      手动配置方法：编辑 .opencode\u002Fagents\u002F{agent名}.md，在 frontmatter 中添加：\n        model: provider\u002Fmodel-id\n\n      可用模型列表与成本可通过 opencode models --verbose 查看（输出含每模型 cost\u002Fcontext）。\n      模型库与定价见 OpenCode 官方模型源 https:\u002F\u002Fmodels.dev\u002F。\n      ```\n7. 验证 opencode 部署（仅当 target_cli 含 opencode 时）：\n    - 检查 `.opencode\u002Fagents\u002F` 下的 7 个 agent 定义文件是否存在，且 frontmatter 包含 `mode: subagent` 和 `permission` 字段\n    - 检查 `.opencode\u002Fplugins\u002Fstory-hooks.ts` 是否存在\n    - 检查 `.opencode\u002Fplugins\u002Flib\u002Fstory_hook_core.js` 存在且 `node --check` 通过（story-hooks.ts import 之，与 `.zcode` 副本字节一致的共享写正文守卫核；置于 `lib\u002F` 子目录以避开 OpenCode 单层 `.opencode\u002Fplugins\u002F*.js` 插件自动发现）\n     - 检查 `.opencode\u002Fcommands\u002F` 下的 13 个 command 文件是否存在\n    - 检查 `skills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002F` 下 reference 文件完整且数量与源目录一致\n    - 检查 `opencode.json` 的 `plugin` 数组是否包含 story-hooks 条目\n    - 检查 `.git\u002Fhooks\u002Fpre-commit` 是否存在且有执行权限（Windows 上跳过执行权限检查）\n    - 检查 `.opencode\u002Fagents\u002F` 下 agent 文件 frontmatter 可被 YAML 解析、`model:`（如有配置）是合法顶层标量，而非仅 grep 到 `model:` 子串\n8. 验证 Codex 部署（仅当 target_cli 含 codex 时）：\n    - 检查 `AGENTS.md` 含 Codex story skill routing sections\n    - 检查 `.codex\u002Fagents\u002F` 下 7 个 `.toml` agent 定义文件存在并可解析\n    - 检查 `.codex\u002Fhooks.json` 存在且 JSON 有效，Unix `command` 仅通过 `run-story-hook.sh` 启动，Windows `commandWindows` 仅通过 `run-story-hook.cmd` 启动；不存在直调 `story_codex_hook.py` 的注册\n   - 检查 `.codex\u002Fhooks\u002Fstory_codex_hook.py`、`run-story-hook.sh`、`run-story-hook.cmd` 存在，Python 语法有效，POSIX\u002FWindows launcher 能从嵌套 cwd 定位项目根\n    - 检查 `.codex\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002F` 下 reference 文件完整且数量与源目录一致\n    - 安装报告必须提示：Codex 需要 trust 项目 `.codex\u002F` 配置层，并在 `\u002Fhooks` review\u002Ftrust 非 managed hooks；部署后新开 Codex 会话让 custom agents 生效；若当前运行时仍返回 `unknown agent_type`，按各 skill 的 fallback 规则降级 solo\u002Fdirect\n9. 验证 Antigravity 部署（仅当 target_cli 含 antigravity 时）：\n    - 检查 `.agents\u002Fskills\u002F` 下 13 个 story skills 为真实目录且 `SKILL.md` 可读；`.agents\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002F` 完整\n    - 检查 `.agents\u002Fagents\u002F` 下 7 个 Markdown agent 可解析，名称、模型档、官方工具白名单、只读边界与 `.agents\u002Fskills\u002F` reference 前缀正确\n    - 检查 `.agents\u002Frules\u002Foh-story.md` 为 `trigger: always_on` 且未超过 12,000 字符\n    - 检查 `.agents\u002Fhooks.json` 有效、顶层 `oh-story` group 恰有 PreToolUse\u002FPostToolUse\u002FPreInvocation\u002FStop，用户 hook groups 保留；检查 `.agents\u002Fhooks\u002Fstory_antigravity_hook.js` 与 `story_hook_core.js` 语法有效\n    - 用 fixture 验证：PreToolUse 缺纲\u002F追踪时 deny、普通写入 allow、commit advisory；PostToolUse stdout 恒为 `{}` 且把正文 findings 写进 session artifact；下一次 PreInvocation 注入 findings；Stop 对未处理 findings 最多 continue 一次；干净正文清除 pending state\n    - 安装报告必须提示：新开 Antigravity conversation 刷新 customization；Hooks 依赖 PATH 中的 `node`；外部 hook API 没有 PreCompact\u002FPostCompact，compact 恢复由 Always-On Rule 读取 `追踪\u002F上下文.md`；IDE 与交互式 `agy` 仍建议分别实机 smoke test；`agy 1.1.22 -p` 每次 headless 启动都可能在静默鉴权前扫描 workspace，鉴权后不重载 custom agents\u002Fhooks，因此当前不在支持面内，可能报 `subagent not found` 或回退写入 `~\u002F.gemini\u002Fantigravity-cli\u002Fscratch\u002F`；命令行写作从项目目录进入交互式 `agy`，确认 `\u002Fskills`、`\u002Fagents`、`\u002Fhooks` 已发现 oh-story 后再发任务，测试后检查 scratch 无意外小说产物\n10. 验证 ZCode 部署（仅当 target_cli 含 zcode 时）：\n    - 检查根 `AGENTS.md` 含 ZCode `$story-*` 路由、大纲守卫和 solo\u002Fdirect fallback\n    - 检查 `.zcode\u002Fskills\u002F` 下 13 个 Skills 与 `.zcode\u002Fcommands\u002F` 下 13 个 Commands，验证 frontmatter 和命名\n    - 检查 `.zcode\u002Fhooks\u002Fstory_zcode_hook.js`、`.zcode\u002Fhooks\u002Fstory_hook_core.js` 存在且 `node --check` 通过\n    - 检查 `.zcode\u002Fconfig.json` JSON 有效，并按「ZCode 部署算法」第 4 步的 hooks 互斥分支校验：未装 oh-story 插件时，`hooks.enabled=true`、仅注册 ZCode 支持事件、所有 `process` args 指向项目 Hook；已装 oh-story 插件（`.zcode-plugin\u002Fplugin.json` 已全局注册这批 hooks）时，改为校验 `.zcode\u002Fconfig.json` 不含（或已移除）这批 oh-story hooks 注册——**不得**为了让校验通过而把 `config.json.patch` 的 hooks 块合并回去，否则同一事件双触发\n    - 检查 `.zcode\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002F` 完整且所有 reference 路径可解析\n    - 用 fixture 调用 SessionStart、PreToolUse deny\u002Fallow、PostToolUse，确认无发现时 stdout 为空、有输出时符合 ZCode 严格 JSON\n    - 安装报告必须提示：ZCode 3.3.4 不执行项目\u002Fplugin custom agents，full\u002Flean 多 Agent 请求会稳定降级 solo\u002Fdirect；Hook 依赖 PATH 中的 `node`；部署后新开 ZCode session 刷新 Skills\u002FCommands\u002FAGENTS.md\n11. 验证 OpenClaw 部署（仅当 target_cli 含 openclaw 时）：\n    - 检查 `AGENTS.md` 含 OpenClaw story skill routing sections\n    - 检查 `skills\u002F` 下 13 个 story skill 目录存在，且每个 `SKILL.md` 包含单行 `name`、单行 `description`、单行 JSON `metadata.openclaw`\n    - 检查 `skills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002F` 下 reference 文件完整且数量与源目录一致\n    - 安装报告必须提示：OpenClaw Phase 1 是 skills-only；未部署 OpenClaw agents\u002Fhooks，运行时硬拦截不可用，写正文前大纲守卫、commit 提醒、session\u002Fcompact 自动注入只作为 skill 内软约束；OpenClaw 在 session 启动时 snapshot eligible skills，部署后如命令\u002Fskills 未出现，需新开 OpenClaw session 或等待 skills watcher 刷新\n12. 验证通用 Web AI \u002F 其他 Agent 部署（仅当 target_cli 含 generic 时）：\n    - 检查 `AGENTS.md` 含通用 story skill routing sections\n    - 检查 `skills\u002F` 下 13 个 story skill 目录存在，且每个 `SKILL.md` 可读\n    - 检查 `skills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002F` 下 reference 文件完整且数量与源目录一致\n    - 安装报告必须提示：generic 不部署平台专属 hooks\u002Fcustom agents；大纲守卫、commit 提醒、session\u002Fcompact 注入等硬拦截与多 agent 协作都按 skill 内软约束或 solo\u002Fdirect fallback 执行\n13. 验证 Reasonix 部署（仅当 target_cli 含 reasonix 时）：\n    - 检查 `AGENTS.md` 含 Reasonix story skill routing sections 与 solo\u002Fdirect fallback 说明\n    - 检查 `skills\u002F` 下 13 个 story skill 目录存在，且每个 `SKILL.md` 可读\n    - 检查项目 `.agents\u002Fskills` 为指向 `skills\u002F` 的 symlink（POSIX；使 Reasonix 原生扫描发现 skill）；Windows 未建 symlink 时改为确认根 `reasonix-plugin.json` 可用于 `reasonix plugin install`\n    - 检查 `skills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002F` 下 reference 文件完整且数量与源目录一致\n    - 安装报告必须提示：Reasonix 当前是 skills-only；未部署 Reasonix hooks\u002Fcustom agents，写正文前大纲守卫、commit 提醒、session\u002Fcompact 自动注入只作为 skill 内软约束，涉及专业 Agent 的 Skill 走 solo\u002Fdirect fallback；可用 `reasonix doctor capabilities` 校验 skill 发现，部署后如未显示新 skills，新开 Reasonix session 或走根 `reasonix-plugin.json` 原生 plugin 安装\n\n---\n\n## 模板占位符\n\n| 占位符 | 替换规则 | 示例 |\n|--------|----------|------|\n| `{项目名}` | 用户项目名称或目录名 | 《剑来》、《暗卫》 |\n| `{书名}` | 书名目录名（与目录一致） | 与 `{项目名}` 相同，或用户自定义 |\n| `{目标平台}` | 目标发布平台 | 起点、番茄、晋江、知乎盐言 |\n| `{作者名}` | 用户笔名或昵称 | 未指定时用「作者」 |\n\n替换时去掉花括号。如果用户未指定项目名，用当前目录名。未指定的占位符保留原样不替换。\n\n## CLAUDE.md 合并策略\n\n用户已有 CLAUDE.md 时，按 marker\u002Fsection 合并：\n1. 优先识别 story-setup 管理块标记（如果旧项目已有标记，只替换标记内内容）\n2. 无标记时，读取用户现有 CLAUDE.md，按 `##` 标题切分为 section map\n3. 读取模板 CLAUDE.md.tmpl，同样切分\n4. 模板中的标准 section（Skill 路由表、文件结构、协作规则、Compact 后恢复上下文）**覆盖**用户同名 section\n5. 用户独有的 section（自定义内容）**保留**不动\n6. 未知冲突用 AskUserQuestion 让用户选择保留哪个版本\n\n## AGENTS.md 合并策略（OpenCode \u002F Codex \u002F ZCode \u002F OpenClaw \u002F Reasonix \u002F generic）\n\n用户已有 AGENTS.md 时，按 marker\u002Fsection 合并：\n1. 优先识别 story-setup 管理块标记（如果旧项目已有标记，只替换标记内内容）\n2. 无标记时，读取用户现有 AGENTS.md，按 `##` 标题切分为 section map\n3. OpenCode 使用 `skills\u002Fstory-setup\u002Freferences\u002Fopencode\u002FAGENTS.md.tmpl`；Codex 使用 `skills\u002Fstory-setup\u002Freferences\u002Fcodex\u002FAGENTS.md.tmpl`；ZCode 使用 `skills\u002Fstory-setup\u002Freferences\u002Fzcode\u002FAGENTS.md.tmpl`；OpenClaw 使用 `skills\u002Fstory-setup\u002Freferences\u002Fopenclaw\u002FAGENTS.md.tmpl`；Reasonix 使用 `skills\u002Fstory-setup\u002Freferences\u002Freasonix\u002FAGENTS.md.tmpl`；通用 Web AI \u002F 其他 Agent 使用 `skills\u002Fstory-setup\u002Freferences\u002Fgeneric\u002FAGENTS.md.tmpl`\n4. 模板中的标准 section（Skill 路由表、文件结构、协作规则、Compact 后恢复上下文）覆盖同名 section；用户独有 section 保留\n5. 多端同时部署时，Codex\u002FOpenCode\u002FZCode\u002FOpenClaw\u002FReasonix\u002Fgeneric 共同可用的通用段落只保留一份；工具特有说明以小节区分，避免互相覆盖\n\n## 重新部署\n\n- `.story-deployed` 不存在 → 全新安装，Phase 2 全部执行\n- `.story-deployed` 存在且 `agents_version: 30` → 提示已部署，AskUserQuestion 确认是否重新部署；提示里写明重新部署只用当前本地 skill 包刷新项目文件，skill 本身的更新走 `npx skills add` 或 marketplace\n- `.story-deployed` 存在但 `agents_version` 缺失、非整数或小于 `30` → 提示需要更新，重新执行 Phase 2 覆盖 agents\u002Fhooks\u002Frules\u002Freference bundle，CLAUDE.md \u002F AGENTS.md \u002F settings.local.json \u002F .codex\u002Fhooks.json \u002F `.agents\u002Fhooks.json` \u002F .zcode\u002Fconfig.json 走合并策略\n- `.story-deployed` 存在且 `agents_version` 大于 `30` → 当前 skill 版本过旧，停止并提示先更新 oh-story-claudecode；不覆盖项目中的更新部署\n\n---\n\n## 参考资料\n\n| 文件 | 用途 |\n|------|------|\n| references\u002Ftemplates\u002Fhooks\u002F | 8 个 hook 脚本模板 + `story_hook_core.js`（正文网\u002F大纲守卫\u002F连续性\u002Fcommit 侦测的共享实现，与 OpenCode\u002FZCode 同一份）+ `story_hook_cli.js`（bash hook 调核的 node 桥）+ `lib\u002Fcommon.sh`\u002F`lib\u002Fsentinel.sh`（正文兜底 `check-prose-after-write.sh` 限 PostToolUse Write\u002FEdit；`cat>`\u002F`tee` 等 Bash 写正文由 Codex Stop 回合末 git 扫描兜，Claude\u002FOpenCode 的 Bash 仅 pre-guard） |\n| references\u002Fantigravity\u002F | Antigravity 2.0 Always-On Rule、named-group hooks 模板与 I\u002FO adapter；正文写后 findings 经 session artifact 桥接到 PreInvocation\u002FStop |\n| references\u002Fzcode\u002F | ZCode AGENTS、13 Commands、workspace config patch 与严格 JSON Hook runner |\n\n---\n\n## 流程衔接\n\n**流水线：** 部署\n**位置：** 初始化（最前置）\n\n| 时机 | 跳转到 | 命令 |\n|---|---|---|\n| 部署完成，开始写作 | story-long-write \u002F story-short-write | `\u002Fstory-long-write` 或 `\u002Fstory-short-write` |\n| 导入已有小说做拆解 | story-import | `\u002Fstory-import` |\n| 需要浏览器登录态（扫榜\u002F拆文取原文） | browser-cdp | `\u002Fbrowser-cdp`；generic 需平台允许本地脚本\u002F浏览器控制 |\n\n各端调用语法：Claude `\u002F名`、Codex\u002FZCode `$名`、Antigravity 通过 `\u002Fskills` 浏览或直接点名、OpenClaw `\u002Fskill 名`、Reasonix \u002F generic 直接点名 skill。\n","# story-setup：网文写作工具集基础设施部署\n\n你是写作基础设施部署器。将网文写作工具集部署到用户项目目录：已适配的 CLI 走专用 hooks\u002Fagents\u002Fconfig；NarraFork、Web AI、自定义 Agent 等环境走通用文件模式。\n\n**执行铁律：不覆盖用户已有配置，合并而非替换。**\n\n## 选择模式\n\n- 参数为 `check`，或用户只要求检查部署、诊断环境、排查 agent 不可用时：完整读取 [references\u002Fdiagnostics.md](references\u002Fdiagnostics.md)，按其中流程仅检查并报告；不进入下面的部署流程。\n- 用户要求安装、更新或修复时：执行下面的部署流程。检查后已明确授权的修复沿用本文件的部署与合并规则。\n\n---\n\n## Phase 1：检测项目状态\n\n**先自检参考目录**：以正在执行的本 `SKILL.md` 所在目录为准，列出与它同级的 `references\u002F` 下的子目录，核对下面 9 个名字是否都在**且都非空**——`agent-references`、`templates`、`opencode`、`codex`、`antigravity`、`zcode`、`openclaw`、`reasonix`、`generic`；同级 `scripts\u002Fmerge-claude-settings.py`、`scripts\u002Fmerge-codex-hooks.py`、`scripts\u002Fmerge-antigravity-hooks.py`、`scripts\u002Fgenerate-antigravity-agents.mjs`、`scripts\u002Fdeploy-antigravity-skills.py` 与 `scripts\u002Fcopy-path-safety.py` 也必须存在（Claude\u002FCodex\u002FAntigravity hooks 合并、Antigravity Skills 物化与 agent 生成、递归复制安全检查依赖它们）。有缺即 skill 包没装全，**立即停止，不写任何部署文件**，报告里区分「缺目录」「目录为空」和「缺脚本」，并给修复指令：「story-setup 参考资料包不完整，缺 {路径}。按你的安装方式重装 oh-story-claudecode（命令行装的重跑 `npx skills add zenstory-ai\u002Foh-story-claudecode -y -g`，marketplace \u002F Plugin Management 装的在面板里重装），再执行 \u002Fstory-setup。」\n\n> 判据是「有没有 `SKILL.md`」：只看正在执行的 `SKILL.md` 同级的 `references\u002F`。项目内 `.claude\u002Fskills\u002Fstory-setup\u002F`、`.codex\u002Fskills\u002Fstory-setup\u002F` 和 OpenCode 的 `skills\u002Fstory-setup\u002F` 只有 `references\u002Fagent-references\u002F`、不含 `SKILL.md`，不会是执行目录，也不要拿它们核对。Antigravity \u002F ZCode \u002F OpenClaw \u002F Reasonix \u002F generic 的项目副本是整份 skill 拷贝、自带 `SKILL.md`，9 个子目录本就齐全，照常核对即可。\n\n1. 检查当前目录是否已部署过（存在 `.story-deployed`）\n   - `agents_version` 缺失、非整数或小于 `30` → 标记为待更新，继续执行当前部署\n   - `agents_version: 30` → 使用 AskUserQuestion 确认是否重新部署；提示里写明重新部署只用**当前本地 skill 包**刷新项目文件，要拿 skill 本身的新版本得先更新 oh-story-claudecode（`npx skills add` 或 marketplace），再回来重跑\n   - `agents_version` 大于 `30` → 当前 story-setup 比项目部署旧；停止以避免降级覆盖，提示先更新 oh-story-claudecode，不写任何部署文件\n   - 同时读 `target_cli` 字段。**已部署项目以 sentinel 里的值为准**：非空时（逗号分隔的多端组合原样保留）跳过下面第 5-12 步的环境探测与选择，直接按这些端重新部署。只有字段缺失或为空，才回落到探测。用户明确要求增删目标端时，用 AskUserQuestion 在现有值基础上改，改完的值写回 sentinel。\n2. 检查是否有书名目录（包含 `追踪\u002F` 子目录的目录，或用户自定义结构）\n   - 有 → 识别为长篇项目，显示当前项目信息\n   - 无 → 识别为新项目或短篇项目\n3. 检查 `.claude\u002Fsettings.local.json` 是否存在\n   - 存在 → 读取现有配置，后续合并\n   - 不存在 → 后续创建新文件\n4. 检查 `.active-book` 文件是否存在\n   - 存在 → 显示当前活跃书目\n   - 不存在 → 跳过\n5. 检查 `opencode.json` 或 `.opencode\u002F` 是否存在\n   - 存在 → 识别为 opencode 项目，`target_cli = opencode`\n   - 不存在 → 跳过\n6. 检查 `.codex\u002F`、`.codex\u002Fconfig.toml`、`.codex\u002Fagents\u002F`、`.codex\u002Fhooks.json`、`AGENTS.md` 中的 Codex 段\n   - 存在 → 识别为 Codex 项目，`target_cli = codex`\n   - 不存在 → 跳过\n7. 检查 `.agents\u002Fhooks.json`、`.agents\u002Fagents\u002F`，或 `.agents\u002Frules\u002Foh-story.md` 中的 Antigravity 标记\n   - 存在 → 识别为 Google Antigravity 项目，`target_cli = antigravity`\n   - 不存在 → 跳过\n8. 检查 `.zcode\u002F`、`.zcode\u002Fconfig.json`、`zcode.json`、`.zcode\u002Fskills\u002F`、`.zcode\u002Fcommands\u002F`、`AGENTS.md` 中的 ZCode 段\n   - 存在 → 识别为 ZCode 项目，`target_cli = zcode`\n   - 不存在 → 跳过\n9. 检查 `openclaw.json`、`.openclaw\u002F`，或 `AGENTS.md` 中的 OpenClaw 段（标题行含 `网文写作工具集（OpenClaw）`）\n   - 存在 → 识别为 OpenClaw 项目，`target_cli = openclaw`\n   - 不存在 → 跳过\n10. 检查 `.reasonix\u002F`、`reasonix-plugin.json`、`REASONIX.md`，或 `AGENTS.md` 中的 Reasonix 段（标题行含 `网文写作工具集（Reasonix）`）\n   - 存在 → 识别为 Reasonix 项目，`target_cli = reasonix`\n   - 不存在 → 跳过\n11. 检查 `AGENTS.md` 中的通用段（标题行含 `网文写作工具集（通用 Agent \u002F Web AI）`）\n   - 存在 → 识别为通用 Web AI 项目，`target_cli = generic`\n   - 不存在 → 跳过\n\n   > 第 9-11 步只认各端**互斥**的标记。`skills\u002F*\u002FSKILL.md` 的 `metadata.openclaw` 不作 OpenClaw 信号：13 个 skill 全都带这个字段，而 OpenClaw \u002F Reasonix \u002F generic 三条 skills-only 路径部署出的 `skills\u002F` 长得一样，用它判定会把后两者一律误认成 OpenClaw。`.agents\u002Fskills\u002F` 由 Antigravity、Codex 与 Reasonix 共用，也不单独作准；Antigravity 必须由 hooks\u002Fagents\u002Frule 专属标记识别。后三端真正的分辨点是各自 `AGENTS.md` 模板的标题行。\n\n12. 如 `.claude\u002F` 或 `CLAUDE.md`、OpenCode、Codex、Antigravity、ZCode、OpenClaw、Reasonix、generic 标记同时存在 → 使用 AskUserQuestion 让用户选择目标环境（选项：Claude Code \u002F OpenCode \u002F Codex \u002F Google Antigravity \u002F ZCode \u002F OpenClaw \u002F Reasonix \u002F 通用 Web AI 或其他 Agent \u002F 任意组合）\n13. 如八类标记都不存在（全新项目）→ 使用 AskUserQuestion 让用户选择目标环境\n   - 用户选择 opencode → `target_cli = opencode`，部署时创建 `opencode.json` 和 `.opencode\u002F`\n   - 用户选择 claude-code → 按现有逻辑处理\n   - 用户选择 codex → `target_cli = codex`，部署时创建 `.codex\u002F`\n   - 用户选择 antigravity → `target_cli = antigravity`，部署时创建 `.agents\u002Fskills`、`.agents\u002Fagents`、`.agents\u002Frules`、`.agents\u002Fhooks` 并合并 `.agents\u002Fhooks.json`\n   - 用户选择 zcode → `target_cli = zcode`，部署时创建 `.zcode\u002F`、合并根 `AGENTS.md`，不创建项目 custom agents\n   - 用户选择 openclaw → `target_cli = openclaw`，部署时复制 OpenClaw 兼容 skills 到项目 `skills\u002F`\n   - 用户选择 reasonix → `target_cli = reasonix`，部署时复制 skills 到项目 `skills\u002F`、写入 Reasonix 版 `AGENTS.md`，不创建项目 custom agents\u002Fhooks\n   - 用户选择通用 Web AI \u002F 其他 Agent → `target_cli = generic`，部署通用 `AGENTS.md` 与项目本地 `skills\u002F`；不写平台专属 hooks\u002Fagents\n   - 用户选择多端 → `target_cli = claude-code,opencode,codex,antigravity,zcode,openclaw,reasonix,generic` 的子集（仅包含用户选择的端）\n\n## Phase 2：部署基础设施\n\n使用 AskUserQuestion 确认部署位置后，依次执行。\n\n整个 Phase 2 幂等：目录复制、文件写入和下表各合并算法重复执行结果一致。因环境原因（工具不可用、权限被拒、网络失败）中途失败时，直接从头重跑本 Phase，不需要先清理半成品；`create only if absent` 的用户状态文件（见下表 Owner class）不会被二次覆盖。\n\n**两列基准目录不同**：`Source path` 相对正在执行的这份 skill 包，`Target path` 相对用户项目根。执行每一行（以及下面各端部署算法里的每个递归复制步骤）之前，先把通配符具体化为单个源\u002F目标，再用本 `SKILL.md` 同级的 `scripts\u002Fcopy-path-safety.py` 检查。该脚本按 `Path.resolve` \u002F `realpath` 语义跟随已有 symlink，并在两侧都存在时用 `samefile` 核对文件系统对象；**只转绝对路径或比较字符串不算检查完成**。读取其 JSON：`status: same` 时 no-op，禁止复制；仅 `copy_allowed: true` 时可以复制；`source_missing`、`unsafe_target_within_source` 或 `filesystem_identity_error` 必须停止该步骤并报告。无法运行脚本时只能用当前环境的文件系统 API 做完全相同的 canonical realpath、same-object 与 target-descendant 检查；无法确认就停止，不得尝试复制。OpenClaw \u002F Reasonix \u002F generic 的项目副本是整份 skill 拷贝，重跑时执行的就是项目里那份；Reasonix \u002F Codex 还可能经 `.agents\u002Fskills → ..\u002Fskills` symlink 加载，路径文本不同也可能指向同一目录，照字面复制会把目录嵌进自身并撑满磁盘。\n\n**部署前清理自嵌套残留**：`{.claude,.codex,.zcode}\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002F` 与项目根 `skills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002F` 里若多出 `agent-references\u002F` 层（可能嵌了多层），以及 `skills\u002Fstory-setup\u002Fskills\u002F`，整段删掉再部署，并在安装报告里列出删掉的路径。\n\n### Step 1：部署清单（机械可检查）\n\n| Source path | Target path | Owner class | Merge mode | Validation check |\n|-------------|-------------|-------------|------------|------------------|\n| `skills\u002Fstory-setup\u002Freferences\u002Ftemplates\u002FCLAUDE.md.tmpl` | `CLAUDE.md` | user+managed | marker\u002Fsection merge | contains story skill routing sections |\n| `skills\u002Fstory-setup\u002Freferences\u002Ftemplates\u002Fhooks\u002F` | `.claude\u002Fhooks\u002F` | story-setup managed | recursive replace | `session-*.sh`, `detect-story-gaps.sh`, `validate-story-commit.sh`, `guard-outline-before-prose.sh`, `check-prose-after-write.sh`, `story_hook_core.js`, `story_hook_cli.js`, `lib\u002Fcommon.sh`, `lib\u002Fsentinel.sh` exist；`story_hook_core.js` 与 OpenCode\u002FZCode 副本字节一致 |\n| `skills\u002Fstory-setup\u002Freferences\u002Ftemplates\u002Frules\u002F*.md` | `.claude\u002Frules\u002F*.md` | story-setup managed | replace | every rule contains `paths` frontmatter |\n| `skills\u002Fstory-setup\u002Freferences\u002Ftemplates\u002Fagents\u002F*.md` | `.claude\u002Fagents\u002F*.md` | story-setup managed | replace | 7 agent files exist |\n| `skills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002F*.md` | `.claude\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002F*.md` | story-setup managed | replace | every `story-setup\u002Freferences\u002Fagent-references\u002F*.md` reference resolves |\n| `skills\u002Fstory-setup\u002Freferences\u002Ftemplates\u002Fsettings-hooks.json` | `.claude\u002Fsettings.local.json` | user+managed | replace managed registrations by stable hook identity | hook JSON valid；旧 matcher 注册已迁移、当前模板命令各一份、用户 hook 保留 |\n| `skills\u002Fstory-setup\u002Fscripts\u002Fmerge-claude-settings.py` | 部署时执行，不复制到项目 | story-setup helper | execute | 替换已知 story hook 注册、保留用户 hooks\u002F顶层字段，v24→v25 迁移与重复执行幂等 |\n| `skills\u002Fstory-setup\u002Fscripts\u002Fcopy-path-safety.py` | 每个递归复制步骤前执行，不复制到项目专用目录 | story-setup helper | execute | JSON 仅 `copy_allowed: true` 时允许复制；symlink 同对象 no-op；target 位于 source 内时停止 |\n| generated sentinel | `.story-deployed` | story-setup managed | replace | contains `agents_version`, `setup_skill_version`, `target_cli`, `resolver_strategy`, `references_dir` |\n| `skills\u002Fstory-setup\u002Freferences\u002Fopencode\u002FAGENTS.md.tmpl` | `AGENTS.md` | user+managed | marker\u002Fsection merge | contains story skill routing sections | target_cli 含 opencode |\n| `skills\u002Fstory-setup\u002Freferences\u002Fopencode\u002Fagents\u002F` | `.opencode\u002Fagents\u002F` | story-setup managed | replace | 7 agent files exist（replace 前按「配置 OpenCode Agent 模型」中的「保留已有模型配置」缓存现有 `model:`，避免覆盖用户已配模型） | target_cli 含 opencode |\n| `skills\u002Fstory-setup\u002Freferences\u002Fopencode\u002Fplugin.ts` | `.opencode\u002Fplugins\u002Fstory-hooks.ts` | story-setup managed | replace | TypeScript plugin file exists | target_cli 含 opencode |\n| `skills\u002Fstory-setup\u002Freferences\u002Fopencode\u002Fstory_hook_core.js` | `.opencode\u002Fplugins\u002Flib\u002Fstory_hook_core.js` | story-setup managed | replace | Node syntax valid；与 ZCode 副本字节一致；被 story-hooks.ts import | target_cli 含 opencode |\n| `skills\u002Fstory-setup\u002Freferences\u002Fopencode\u002Fcommands\u002F` | `.opencode\u002Fcommands\u002F` | story-setup managed | replace | 13 command files exist | target_cli 含 opencode |\n| `skills\u002Fstory-setup\u002Freferences\u002Fopencode\u002Fopencode.json.patch` | merge into `opencode.json` | user+managed | merge by plugin\u002Fpermission key | plugin entry registered | target_cli 含 opencode |\n| repository `skills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002F` | `skills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002F` | story-setup managed | replace | every reference resolves | target_cli 含 opencode |\n| `skills\u002Fstory-setup\u002Freferences\u002Fopencode\u002Fpre-commit.sh` | `.git\u002Fhooks\u002Fpre-commit` | user+managed | append or create | file exists and is executable；含 marker 块则替换块内容，不含则检测 exit 0 位置智能插入 | target_cli 含 opencode |\n| `skills\u002Fstory-setup\u002Freferences\u002Fcodex\u002FAGENTS.md.tmpl` | `AGENTS.md` | user+managed | marker\u002Fsection merge | contains Codex story skill routing sections | target_cli 含 codex |\n| `skills\u002Fstory-setup\u002Freferences\u002Fcodex\u002Fagents\u002F` | `.codex\u002Fagents\u002F` | story-setup managed | replace | 7 TOML agent files parse and contain `name`\u002F`description`\u002F`developer_instructions` | target_cli 含 codex |\n| `skills\u002Fstory-setup\u002Freferences\u002Fcodex\u002Fhooks\u002Fhooks.json` | `.codex\u002Fhooks.json` | user+managed | replace managed registrations by stable hook identity | hook JSON valid; all stale direct\u002Flauncher registrations removed, current 6 registrations present exactly once | target_cli 含 codex |\n| `skills\u002Fstory-setup\u002Freferences\u002Fcodex\u002Fhooks\u002F{story_codex_hook.py,run-story-hook.sh,run-story-hook.cmd}` | `.codex\u002Fhooks\u002F` 同名文件 | story-setup managed | replace | Python\u002Fshell\u002Fcmd launcher 文件齐全 | target_cli 含 codex |\n| `skills\u002Fstory-setup\u002Fscripts\u002Fmerge-codex-hooks.py` | 部署时执行，不复制到项目 | story-setup helper | execute | 替换已知管理注册、保留用户 hooks 与未知顶层字段，结果幂等 | target_cli 含 codex |\n| `skills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002F` | `.codex\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002F` | story-setup managed | replace | every reference resolves | target_cli 含 codex |\n| current package skill root + `scripts\u002Fdeploy-antigravity-skills.py` | `.agents\u002Fskills\u002F{browser-cdp,story*}\u002F` | story-setup managed for 13 known skill names | atomically replace known dirs; preserve unknown skills; never write through symlink | 13 real skill directories with valid `SKILL.md` exist | target_cli 含 antigravity |\n| `skills\u002Fstory-setup\u002Fscripts\u002Fgenerate-antigravity-agents.mjs` + Claude agent sources | `.agents\u002Fagents\u002Fagent-name\u002Fagent.md`（`agent-name` 为实际名称） | story-setup managed for 7 known agent definitions | generate then atomically replace known definitions; preserve unknown user agents | 7 Markdown agents parse; exact Antigravity tool names; `mainAgent: false`, `subagent: true` | target_cli 含 antigravity |\n| `skills\u002Fstory-setup\u002Freferences\u002Fantigravity\u002Frules\u002Foh-story.md` | `.agents\u002Frules\u002Foh-story.md` | story-setup managed | replace | `trigger: always_on`; under 12,000 characters | target_cli 含 antigravity |\n| `skills\u002Fstory-setup\u002Freferences\u002Fantigravity\u002Fhooks\u002Fhooks.json` | `.agents\u002Fhooks.json` | user+managed | replace only top-level `oh-story` group | valid Antigravity named-group schema; user groups preserved; idempotent | target_cli 含 antigravity |\n| `skills\u002Fstory-setup\u002Freferences\u002Fantigravity\u002Fhooks\u002F{story_antigravity_hook.js,story_hook_core.js}` | `.agents\u002Fhooks\u002F` same names | story-setup managed | replace | Node syntax valid; core byte-identical to shared source; hook contract tests pass | target_cli 含 antigravity |\n| `skills\u002Fstory-setup\u002Fscripts\u002Fmerge-antigravity-hooks.py` | deployment helper only | story-setup helper | execute | atomically replaces only `oh-story`, preserves user groups, idempotent | target_cli 含 antigravity |\n| `skills\u002Fstory-setup\u002Freferences\u002Fzcode\u002FAGENTS.md.tmpl` | `AGENTS.md` | user+managed | marker\u002Fsection merge | contains ZCode `$story-*` routing and solo fallback | target_cli 含 zcode |\n| repository `skills\u002F{browser-cdp,story*}\u002F` | `.zcode\u002Fskills\u002F{browser-cdp,story*}\u002F` | story-setup managed for known skill names | replace known skill dirs only | 13 `SKILL.md` files exist and satisfy ZCode frontmatter limits | target_cli 含 zcode |\n| `skills\u002Fstory-setup\u002Freferences\u002Fzcode\u002Fcommands\u002F` | `.zcode\u002Fcommands\u002F` | story-setup managed for known command names | replace known command files only | 13 commands have valid names\u002Ffrontmatter | target_cli 含 zcode |\n| `skills\u002Fstory-setup\u002Freferences\u002Fzcode\u002Fhooks\u002Fstory_zcode_hook.js` | `.zcode\u002Fhooks\u002Fstory_zcode_hook.js` | story-setup managed | replace | Node syntax valid; hook contract tests pass | target_cli 含 zcode |\n| `skills\u002Fstory-setup\u002Freferences\u002Fzcode\u002Fhooks\u002Fstory_hook_core.js` | `.zcode\u002Fhooks\u002Fstory_hook_core.js` | story-setup managed | replace | Node syntax valid; hook contract tests pass | target_cli 含 zcode |\n| `skills\u002Fstory-setup\u002Freferences\u002Fzcode\u002Fconfig.json.patch` | merge into `.zcode\u002Fconfig.json` | user+managed | merge by event+matcher+process args | JSON valid; 按「ZCode 部署算法」第 4 步 hooks 互斥分支校验——未装 oh-story 插件时 `hooks.enabled=true`、only supported events；已装插件时校验 `.zcode\u002Fconfig.json` 不含（或已移除）这批 oh-story hooks 注册 | target_cli 含 zcode |\n| `skills\u002Fstory-setup\u002Freferences\u002Fopenclaw\u002FAGENTS.md.tmpl` | `AGENTS.md` | user+managed | marker\u002Fsection merge | contains OpenClaw story skill routing sections | target_cli 含 openclaw |\n| `skills\u002Fstory-setup\u002Freferences\u002Fgeneric\u002FAGENTS.md.tmpl` | `AGENTS.md` | user+managed | marker\u002Fsection merge | contains generic story skill routing sections | target_cli 含 generic |\n| `skills\u002Fstory-setup\u002Freferences\u002Freasonix\u002FAGENTS.md.tmpl` | `AGENTS.md` | user+managed | marker\u002Fsection merge | contains Reasonix story skill routing sections and solo\u002Fdirect fallback | target_cli 含 reasonix |\n| repository `skills\u002F{browser-cdp,story*}\u002F` | `skills\u002F{browser-cdp,story*}\u002F` | story-setup managed for known skill names | replace known skill dirs only | 13 `SKILL.md` files exist; OpenClaw-compatible frontmatter | target_cli 含 openclaw 或 generic 或 reasonix |\n| repository `skills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002F` | 随上一行整份 skill 拷贝落地，本行 no-op | story-setup managed | 不单独复制 | every reference resolves | target_cli 含 openclaw 或 generic 或 reasonix |\n\n### opencode.json 合并算法\n\n部署 `opencode.json.patch` 时按以下规则合并：\n\n1. 读取现有 `opencode.json`（如存在），解析 JSON\n2. 合并 `plugin` 数组：将 `.\u002F.opencode\u002Fplugins\u002Fstory-hooks.ts` 加入数组，去重\n3. 保留用户已有的其他配置字段（`permission`、`model`、`provider` 等），不覆盖\n4. 写入合并后的 `opencode.json`\n\n### Step 2：部署 CLAUDE.md\n\n- 读取 `skills\u002Fstory-setup\u002Freferences\u002Ftemplates\u002FCLAUDE.md.tmpl`\n- 替换占位符（见下方「模板占位符」段）\n- 写入项目根目录 `CLAUDE.md`（如已存在，按「CLAUDE.md 合并策略」处理）\n\n### Step 3：部署 Hooks\n\n- **递归复制完整目录树**：将 `skills\u002Fstory-setup\u002Freferences\u002Ftemplates\u002Fhooks\u002F` 复制到用户项目 `.claude\u002Fhooks\u002F`\n- 必须保留子目录 `lib\u002F`，其中：\n  - `lib\u002Fcommon.sh` 提供 `project_root`、`discover_active_book`、`discover_all_books`\n  - `lib\u002Fsentinel.sh` 提供 `.story-deployed` 字段读取\n- 只需对 `.claude\u002Fhooks\u002F*.sh` 设置执行权限（`chmod +x`）；`lib\u002F*.sh` 由 hook `source`，不要求可执行位\n\n### Step 4：部署 Rules\n\n- 读取 `skills\u002Fstory-setup\u002Freferences\u002Ftemplates\u002Frules\u002F` 下所有 `.md` 文件\n- 复制到用户项目的 `.claude\u002Frules\u002F` 目录\n\n### Step 5：部署 Agents\n\n- 读取 `skills\u002Fstory-setup\u002Freferences\u002Ftemplates\u002Fagents\u002F` 下所有 `.md` 文件\n- 复制到用户项目的 `.claude\u002Fagents\u002F` 目录\n- Agent 文件属于 story-setup 管理文件，可安全覆盖；版本升级时按 `UPGRADING.md` 的版本检测结果重新部署\n- **`target_cli` 含 opencode 时，覆盖 `.opencode\u002Fagents\u002F` 之前先执行下面「配置 OpenCode Agent 模型」的 Step 1 缓存现有 `model:`**。那一步写在本节后面，但必须先跑——照顺序读到哪做到哪会先覆盖再缓存，用户已配的模型就没了。\n- **部署后必须新开会话**：agent 只在会话启动时注册；原因与必须输出的报告文案见「验证安装」中的「输出安装报告」。\n\n#### Agent 兼容性处理\n\n- Agent 正文以 Claude Code Markdown 为真源；OpenCode 的 `.opencode\u002Fagents\u002F*.md` 与 Codex 的 `.codex\u002Fagents\u002F*.toml` 由 `references\u002Fopencode\u002Fagents\u002F`、`references\u002Fcodex\u002Fagents\u002F` 下的预生成产物直接复制。Antigravity 的 `.agents\u002Fagents\u002Fagent-name\u002Fagent.md`（`agent-name` 为实际名称）则在部署时调用随 story-setup 下发的 `scripts\u002Fgenerate-antigravity-agents.mjs`，把 Claude 工具名、模型档、reference 根和调用术语确定性转换为 Antigravity 2.0 契约；不得把 Claude frontmatter 原样复制过去。\n- **ZCode 3.3.4 不部署项目 agents**：其自定义子智能体只支持用户级 `~\u002F.zcode\u002Fagents\u002F`，plugin manifest 中的 `agents` 当前不执行。不要创建 `.zcode\u002Fagents\u002F` 或修改用户 home；相关 Skill 必须直接 solo\u002Fdirect 并报告 fallback。\n- **OpenClaw Phase 1 不部署 agents**：OpenClaw 只部署 skills，agent 协作相关 skill 必须按既有 fallback 规则降级 solo\u002Fdirect，不要把 Claude\u002FOpenCode agent frontmatter 直接复制成 OpenClaw agent。\n- 部署到项目后，agent 内引用的参考资料必须走 `story-setup\u002Freferences\u002Fagent-references\u002F*.md` 这一本 skill 内复制路径；不要跨 skill 引用其他 skill 的 references。各 adapter 只使用当前规范前缀：Claude Code 为 `.claude\u002Fskills\u002F`，Antigravity 为 `.agents\u002Fskills\u002F`，OpenCode \u002F OpenClaw \u002F Reasonix \u002F generic 为 `skills\u002F`，Codex 为 `.codex\u002Fskills\u002F`，ZCode 为 `.zcode\u002Fskills\u002F`；不在运行时遍历历史备选路径。\n\n#### 部署 Agent References\n\n- 将 `skills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002F` 下所有 `.md` 复制到项目内 `.claude\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002F`\n- 校验：凡 agent 或 reference 中出现 `story-setup\u002Freferences\u002Fagent-references\u002F\u003Cfile>.md`，源包与目标包都必须存在 `\u003Cfile>.md`\n\n#### 部署 Codex Agents（target_cli 含 codex 时）\n\n- 读取 `skills\u002Fstory-setup\u002Freferences\u002Fcodex\u002Fagents\u002F` 下所有 `.toml` 文件，复制到用户项目 `.codex\u002Fagents\u002F`\n- Agent 文件属于 story-setup 管理文件，可安全覆盖；`references\u002Fcodex\u002Fagents\u002F` 里的 TOML 由仓库根的 `scripts\u002Fgenerate-codex-agents.py` 从 Claude agent 模板确定性生成后提交入库，部署只做复制\n- 校验每个 TOML 都能解析，且包含 Codex 必需字段：`name`、`description`、`developer_instructions`\n- 只读职责 agent（`chapter-extractor`、`consistency-checker`、`story-explorer`）必须保留 `sandbox_mode = \"read-only\"`\n- **部署后必须 trust + 新开 Codex 会话**（报告文案与 fallback 规则见「验证 Codex 部署」）；若运行时返回 `unknown agent_type`，调用方必须降级 solo\u002Fdirect 并报告 fallback。\n- 将 `skills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002F` 同步复制到 `.codex\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002F`，作为 Codex agent 的项目内参考资料主路径\n\n#### 部署 Antigravity Agents（target_cli 含 antigravity 时）\n\n- 先确认 `node` 在 PATH；Antigravity agent 生成与项目 hooks 都依赖 Node。缺失时停止 Antigravity 这一目标的部署，不留下半成品，并提示安装 Node 后重跑。\n- 执行 `node \"{story-setup skill目录}\u002Fscripts\u002Fgenerate-antigravity-agents.mjs\" --source \"{story-setup skill目录}\u002Freferences\u002Ftemplates\u002Fagents\" --dest \"{项目}\u002F.agents\u002Fagents\"`。生成器先渲染全部 7 个 agent，再原子替换这 7 个已知 `.agents\u002Fagents\u002Fagent-name\u002Fagent.md` 定义（`agent-name` 为实际名称），并清理旧版同名扁平 `.md`；保留其他用户 agent，任一源 frontmatter 异常时不得留下半更新目录，也不得沿 managed agent symlink 写出项目外。\n- 校验 7 个 `.md`：`name` 与文件名一致；`mainAgent: false`、`subagent: true`；模型只使用 `flash` \u002F `pro`；工具只来自 Antigravity 官方名称 `view_file`、`find_by_name`、`grep_search`、`write_to_file`、`replace_file_content`、`multi_replace_file_content`、`run_command`；不得残留 Claude 的 `Read\u002FGlob\u002FGrep\u002FWrite\u002FEdit\u002FBash` 工具名或 `.claude\u002Fskills\u002F` reference 前缀。\n- 只读 agent（`chapter-extractor`、`consistency-checker`、`story-explorer`）不得包含写文件或命令工具；其他 agent 按 Claude 真源的能力边界映射。\n- Antigravity 通过 `invoke_subagent` 的 `TypeName` 调用这些 agent。部署后新开 Antigravity conversation，再用 `story-review` 验证 full\u002Flean；运行时无法解析某个 custom agent 时按 skill 的 solo\u002Fdirect fallback 执行。\n\n#### 配置 OpenCode Agent 模型\n\n> 仅当 `target_cli` 含 `opencode` 时执行。OpenCode 子代理不指定模型时继承主模型，导致低成本 Agent 也消耗主模型额度。此步骤自动检测用户模型并写入 `model:` 字段。\n\n##### Step 1：保留已有模型配置（必须在 `.opencode\u002Fagents\u002F` 的 replace 之前执行）\n\nOpenCode agents 部署是 `replace`，会覆盖上次写入的 `model:`。所以在执行该 replace **之前**先扫描现有 `.opencode\u002Fagents\u002F*.md`，缓存每个 agent 的 `model:`（agent 名 → 模型 ID）。后续检测失败\u002F超时、或用户跳过某一级时，用缓存值回填，避免把用户上次配好的低成本模型抹成主模型。若 replace 已先发生、缓存为空，则按全新部署处理，并在安装报告中提示\"未能保留上次模型配置\"。\n\n##### Step 2：获取模型列表\n\n优先执行 `opencode models --verbose`，它输出含 cost（input\u002Foutput\u002Fcache 单价）、context、capabilities 的 metadata；不可用或解析失败时回退到 `opencode models` 纯文本（每行 `provider\u002Fmodel`）。两者都用 60000ms（60 秒）超时，因为首次运行需加载 models.dev 缓存。\n\n- 成功 → 进入「模型分级」\n- 超时 → 重试一次（缓存可能未预热）；仍然超时则按「保留已有模型配置」缓存回填已有 `model:`、跳过自动配置，在安装报告中输出手动配置指南\n- 失败（命令不存在、输出为空等）→ 同上：回填「保留已有模型配置」缓存、跳过自动配置、输出手动配置指南\n\n##### Step 3：模型分级\n\n**优先按成本分级（有 `--verbose` 时）**：按每模型实际 cost 从低到高分档——低端取最便宜\u002F免费档、中端取中价档、高端取最贵或上下文\u002F能力最强档。免费模型按真实 cost=0 归低端，**不按名字里的营销词**（如 `nemotron-3-ultra-free` 名含 `ultra` 但 cost=0，应归低端）。无 cost 数据的模型也据此进入候选，不被丢弃。\n\n**回退按关键词分级（无 `--verbose` 或无 cost 时）**：按模型 ID 中最后一个 `\u002F` 之后的模型名按 `-`、`.`、`_` 分割为段，逐段精确匹配关键词（不区分大小写）。例如 `minimax-m3` 拆为 `[minimax, m3]`，不匹配 `mini` 也不匹配 `max`；`claude-haiku-4.5` 拆为 `[claude, haiku, 4, 5]`，匹配 `haiku`。关键词分级是启发式，安装报告中标注 `分级依据：关键词（heuristic）`。\n\n| 等级 | 匹配关键词 | 对应 Agent |\n|------|-----------|-----------|\n| 低端 | `haiku`, `flash`, `mini`, `nano`, `lite` | chapter-extractor, consistency-checker, story-explorer |\n| 中端 | `sonnet`, `plus` | story-researcher, narrative-writer, character-designer |\n| 高端 | `opus`, `pro`, `ultra`, `max` | story-architect |\n\n- 一个模型可能匹配多个等级的关键词，取最高等级\n- 关键词回退下未匹配任何关键词的模型仍列入候选附加建议（按成本分级则一律纳入），并在安装报告列出，提示\"可通过自定义输入使用\"\n- 同一等级内，如果包含多个模型供应商，优先列出知名供应商（anthropic、openai、google、deepseek）的模型\n\n##### Step 4：逐级交互选择\n\n按 低端 → 中端 → 高端 顺序，每级用 AskUserQuestion 让用户选择。\n\n**低端选项结构：**\n\n```\n问题：\"为低成本 Agent（chapter-extractor, consistency-checker, story-explorer）选择模型：\"\n选项：\n  - provider\u002Fmodel-id\n  - provider\u002Fmodel-id\n  - 自定义输入（手动输入完整模型 ID，ID 拼写错误要到运行时才会暴露）\n  - 跳过，使用主模型（成本可能较高）\n```\n\n**中端选项结构：**\n\n```\n问题：\"为写作质量关键 Agent（narrative-writer, character-designer, story-researcher）选择模型：\"\n选项：\n  - provider\u002Fmodel-id\n  - provider\u002Fmodel-id\n  - 自定义输入（请勿使用低端模型，会影响正文质量；ID 拼写错误要到运行时才会暴露）\n  - 跳过，使用主模型（主模型质量通常足够）\n```\n\n**高端选项结构：**\n\n```\n问题：\"为总指挥 Agent（story-architect）选择模型：\"\n选项：\n  - provider\u002Fmodel-id\n  - provider\u002Fmodel-id\n  - 自定义输入（手动输入完整模型 ID，ID 拼写错误要到运行时才会暴露）\n  - 跳过，使用主模型（成本可能较高）\n```\n\n规则：\n- 候选最多显示 5 个，超过则截断并提示\"更多模型请使用自定义输入\"。**每一级无论候选数是否为 0 都用 AskUserQuestion 弹出**，选项至少含：候选模型（如有）、`自定义输入`、`保留现有模型`（「保留已有模型配置」缓存到该 agent 的 model，无则不显示此项）、`跳过，用主模型`。候选为 0 时仍弹窗，并在问题说明里给出对应警告 + 列出未分级\u002F未入档模型供参考——不再静默跳过交互（否则用户够不到自定义输入）。\n- `自定义输入`：用户输入 `provider\u002Fmodel-id` 完整 ID；写入前校验为单行、无控制字符、匹配 `^[A-Za-z0-9._-]+\u002F[A-Za-z0-9._:+-]+$`，不符则提示重输或改选跳过。\n- `保留现有模型`：写回「保留已有模型配置」缓存的该 agent model（重新部署时保住用户上次配置），不算\"跳过\"。\n- `跳过，用主模型`：显式清除——不写该 agent 的 `model:`，agent 继承主模型。想保留上次配置请选 `保留现有模型`。\n- 各级候选为 0 时在问题说明里给出提示：\n  - 低端：\"未检测到低成本模型，这 3 个 agent 将使用主模型，成本可能较高\"\n  - 中端：\"未检测到匹配的中端模型。narrative-writer、character-designer、story-researcher 将使用主模型。如主模型质量足够此配置合理；如需降本，请用自定义输入指定不低于主模型质量的中端模型，或从下方未分级模型里选。\"\n  - 高端：\"未检测到高端模型，story-architect 将使用主模型\"\n\n##### Step 5：写入 model 字段\n\n对应用户选择的 agent 文件（`.opencode\u002Fagents\u002F*.md`，由部署清单中 OpenCode agents 部署步骤在此步骤之前已部署），在 frontmatter 末尾、closing `---` 之前，以**零缩进的顶层字段**插入 `model:`（不要插进 `permission:` 等多行 map 的缩进块内部）。值含 YAML 特殊字符时加引号，确保不破坏 frontmatter：\n\n```yaml\n---\ndescription: ...\nmode: subagent\npermission:\n  read: allow\n  edit: deny\nsteps: 12\nmodel: provider\u002Fmodel-id\n---\n```\n\n- 如果 agent 文件已有 `model:` 字段（重新部署场景），替换该顶层 `model:` 的值，不新增重复键\n- `保留现有模型`：写回「保留已有模型配置」缓存的该 agent model\n- `跳过，用主模型`：不写入 `model:` 字段\n- 检测失败\u002F超时、没走到本步骤的等级：用「保留已有模型配置」缓存回填 `model:`，避免 replace 抹掉用户上次配置\n\n### Step 6：合并 Hooks 注册到 settings.local.json\n\n1. 按现有跨平台规则探测 Python：`for PYBIN in python3 python py; do \"$PYBIN\" -c \"\" 2>\u002Fdev\u002Fnull && break; done`；无可用解释器时停止，不手写或简化合并。\n2. 调用 `\"$PYBIN\" \"{story-setup skill目录}\u002Fscripts\u002Fmerge-claude-settings.py\" --existing \"{项目}\u002F.claude\u002Fsettings.local.json\" --template \"{story-setup skill目录}\u002Freferences\u002Ftemplates\u002Fsettings-hooks.json\" --output \"{项目}\u002F.claude\u002Fsettings.local.json\"`。\n3. helper 会移除所有已知 story-setup hook 的历史注册，再追加当前模板；因此 matcher\u002Ftimeout\u002Fif 能随版本升级，同时混在旧 block 中的用户 hook 与未知顶层字段原样保留。写后解析 JSON，验证模板命令各一份、用户配置仍在，再复跑 helper 比较文件字节确认幂等。\n\n### Codex hooks.json 合并算法（target_cli 含 codex 时）\n\nCodex 项目 hooks 部署到 `.codex\u002Fhooks.json`；运行脚本部署到 `.codex\u002Fhooks\u002Fstory_codex_hook.py`、`run-story-hook.sh`、`run-story-hook.cmd`。JSON 只负责定位项目根与传递 event，解释器探测由平台 launcher 统一处理。\n\n1. 定位当前 story-setup skill 目录，读取 `references\u002Fcodex\u002Fhooks\u002Fhooks.json` 作为唯一当前模板，读取项目 `.codex\u002Fhooks.json`（不存在时视为空对象）。\n2. 按现有跨平台规则探测可用 Python：`for PYBIN in python3 python py; do \"$PYBIN\" -c \"\" 2>\u002Fdev\u002Fnull && break; done`；无可用解释器时停止，不手写或简化 JSON 合并。\n3. 调用 `\"$PYBIN\" \"{story-setup skill目录}\u002Fscripts\u002Fmerge-codex-hooks.py\" --existing \"{项目}\u002F.codex\u002Fhooks.json\" --template \"{story-setup skill目录}\u002Freferences\u002Fcodex\u002Fhooks\u002Fhooks.json\" --output \"{项目}\u002F.codex\u002Fhooks.json\"`。该 helper 会识别旧直调 `story_codex_hook.py`、当前 `run-story-hook.sh` 和 `run-story-hook.cmd` 三类管理身份，先移除所有已知管理注册，再追加当前模板。\n4. 保留用户已有的非 story-setup hooks、matcher 块与未知顶层字段。重复执行必须幂等；禁止再按原始 `command` 字符串追加去重，否则 v17 直调命令会与 v18 launcher 双重注册。\n5. 写入后解析 JSON 验证：旧直调 `story_codex_hook.py` 命令数为 0，当前模板 6 个注册各存在且仅存在一次，用户 hook 与未知顶层字段仍在。然后提示用户：项目 `.codex\u002F` 层需要被 Codex trust，非 managed command hooks 还需要在 `\u002Fhooks` 中 review\u002Ftrust 后才会运行；Windows 下走 `commandWindows`，launcher 从当前目录向上定位项目 `.codex\u002Fhooks\u002F`，与 POSIX 路径的嵌套目录行为一致。\n\n### Antigravity 部署算法（target_cli 含 antigravity 时）\n\nAntigravity 2.0 使用项目 `.agents\u002F` customization 根。部署 Skills、Always-On Rule、7 个 custom subagents 与 workspace Hooks；不修改用户 home 下的 `~\u002F.gemini\u002F`。\n\n1. 找到当前 skill 包的 13 个已知 skill 目录（`browser-cdp` 与 `story*`），调用 `deploy-antigravity-skills.py --source \"{当前 skill 包根}\" --dest \"{项目}\u002F.agents\u002Fskills\"` 原子物化。helper 只替换 13 个已知名称、保留用户其他 skills，并在源目标同一 realpath 时 no-op。目标必须是**真实目录**，不要新建顶层 `.agents\u002Fskills → ..\u002Fskills` symlink：Antigravity 2.0 项目部署以真实目录作为受支持路径。\n   - 若已有 `.agents\u002Fskills` 是 symlink，helper 必须先停止且不沿链接写入。用 AskUserQuestion 说明：迁移会把链接当前可见的所有 skills 复制到新的项目内真实目录、只更新 13 个 oh-story 名称、保留链接目标原样，但会把 symlink 本身替换成目录；这可能形成较大的 git diff。只有用户明确同意后才加 `--migrate-symlink` 重跑，拒绝则停止 Antigravity 部署并报告未获得完整支持。这个确认不得被“多端部署”或已有 Codex symlink 跳过。\n2. 按上方「部署 Antigravity Agents」运行生成器，原子更新 `.agents\u002Fagents\u002F` 中 7 个已知 `.agents\u002Fagents\u002Fagent-name\u002Fagent.md` 定义（`agent-name` 为实际名称）并保留其他用户 agent；不从用户 home 搬运 agent。\n3. 复制 `references\u002Fantigravity\u002Frules\u002Foh-story.md` 到 `.agents\u002Frules\u002Foh-story.md`，验证 `trigger: always_on` 且文件小于 Antigravity 12,000 字符上限。该 rule 承担 skill 路由、写作硬约束与 compact 后恢复；Antigravity IDE 不以根 `AGENTS.md` 作为 workspace rule，所以不要用 AGENTS 模板代替。\n4. 复制 `references\u002Fantigravity\u002Fhooks\u002Fstory_antigravity_hook.js` 与同目录 `story_hook_core.js` 到 `.agents\u002Fhooks\u002F`，验证 `node --check`。hook 命令以 `.agents\u002F`（`hooks.json` 所在目录）为工作目录，必须使用 `hooks\u002Fstory_antigravity_hook.js`，不得写成 `.agents\u002Fhooks\u002F...`。共享 core 必须与 Claude\u002FOpenCode\u002FZCode 源字节一致。\n5. 合并 `references\u002Fantigravity\u002Fhooks\u002Fhooks.json` 到 `.agents\u002Fhooks.json`：按跨平台规则探测 Python 3，调用 `merge-antigravity-hooks.py {项目}\u002F.agents\u002Fhooks.json {skill目录}\u002Freferences\u002Fantigravity\u002Fhooks\u002Fhooks.json`。helper 只替换顶层 `oh-story` named group，保留其他用户 hook groups；写后复跑并比较字节确认幂等。禁止把 Claude\u002FCodex 的外层 `{ \"hooks\": ... }` schema 写入 Antigravity。\n6. 校验事件边界：只注册 `PreToolUse`、`PostToolUse`、`PreInvocation`、`Stop`。PreToolUse 必须为每次调用输出 `decision`；PostToolUse 必须只输出 `{}`，正文 findings 经 session `artifactDirectoryPath` 暂存并由下一次 PreInvocation 注入；若模型准备直接结束，Stop 最多强制继续一次，避免无限循环。Antigravity 外部 hooks 没有 SessionStart\u002FPreCompact\u002FPostCompact，首次上下文由 `invocationNum=0` 的 PreInvocation 注入，compact 后由 Always-On Rule 强制读取 `追踪\u002F上下文.md`。\n7. `.story-deployed` 的 `target_cli` 写 `antigravity` 或多端组合，`references_dir` 写 `.agents\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references`。安装报告提示新开 conversation 使 Skills\u002FRules\u002FAgents\u002FHooks 重新扫描；同时明确 Node 是 hook 运行时依赖。\n\nAntigravity IDE 与交互式 `agy` 共用这套 workspace `.agents\u002F` 产物，但仍需分别实机 smoke test。不要依赖 `npx skills add -g` 当前把全局 skill 写到哪个 `~\u002F.gemini\u002F*` 目录；`story-setup` 的支持承诺只覆盖上述项目内真实目录部署。\n\n### ZCode 部署算法（target_cli 含 zcode 时）\n\nZCode 首版部署 Skills、Commands、AGENTS.md 和支持事件内的 Hooks；不部署 `.zcode\u002Fagents` 或 `.zcode\u002Frules`。\n\n1. 复制仓库当前 `skills\u002F` 下 13 个包含 `SKILL.md` 的目录到 `.zcode\u002Fskills\u002F{skill-name}\u002F`；仅替换这些已知目录，保留用户其他 Skills。\n2. 复制 `references\u002Fzcode\u002Fcommands\u002F*.md` 到 `.zcode\u002Fcommands\u002F`；仅替换 13 个同名命令，保留用户其他 Commands。\n3. 复制 `references\u002Fzcode\u002Fhooks\u002Fstory_zcode_hook.js` 和 `references\u002Fzcode\u002Fhooks\u002Fstory_hook_core.js` 到 `.zcode\u002Fhooks\u002F`。\n4. 读取 `references\u002Fzcode\u002Fconfig.json.patch` 和现有 `.zcode\u002Fconfig.json`（如只有根 `zcode.json`，仍创建 `.zcode\u002Fconfig.json` 承载 oh-story 项目 Hooks，不改写根文件）：\n   - 保留用户所有未知字段、MCP、plugins、skills\u002Fcommands disable overrides；\n   - **hooks 互斥（避免双触发）**：若本项目经已安装的 oh-story 插件运行（marketplace 安装，仓库根 `.zcode-plugin\u002Fplugin.json` 的 `hooks.json` 已全局注册 SessionStart\u002FPreToolUse\u002FPostToolUse），则**跳过**下面把 `config.json.patch` 的 `hooks` 块合并进 `.zcode\u002Fconfig.json`——插件 manifest 已注册这批 hooks，再合并会让同一事件跑两遍（PreToolUse 拦两次、PostToolUse 注入两次）。只有未装插件（直接克隆 \u002F 手动导入 references）时才合并 hooks。不确定时以「ZCode 是否已通过本插件注册这套 hooks」为准；skills\u002Fcommands\u002Fhook 文件\u002FAGENTS 与 config 的非 hook 字段两条路径都照常部署。\n   - 合并 hooks（仅未装插件时）：设置 `hooks.enabled: true`；用户已有更大的 `timeoutMs` 时保留，否则取模板值；对 `hooks.events` 的 SessionStart、PreToolUse、PostToolUse 按 `event + matcher + process command + args` 去重追加；不复制 ZCode 不支持的 PreCompact、PostCompact、SessionEnd、SubagentStop、Notification。\n5. 将 `references\u002Fzcode\u002FAGENTS.md.tmpl` 按「AGENTS.md 合并策略」写入根 `AGENTS.md`。\n6. `.story-deployed` 的 `target_cli` 写入 `zcode` 或多端组合，`references_dir` 写 `.zcode\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references`。\n7. 安装报告明确说明：ZCode 3.3.4 的项目\u002Fplugin custom agents 不执行，所有专业角色走 solo\u002Fdirect；系统需要可用的 `node` 命令运行项目 Hook。\n\nPlugin 安装不经过本算法：仓库根 `.zcode-plugin\u002Fplugin.json` 直接暴露同一组 Skills\u002FCommands\u002FHooks。Plugin Skills 优先级低于 workspace `.zcode\u002Fskills`；两者同时存在时项目快照优先，升级项目快照需重新运行 `$story-setup`。**Hooks 只能注册一份**：插件 manifest 与 workspace `.zcode\u002Fconfig.json` 注册的是同一批事件，装了插件就不要再把 `config.json.patch` 的 hooks 合并进 `.zcode\u002Fconfig.json`（见上算法第 4 步的 hooks 互斥），否则 PreToolUse\u002FPostToolUse 会双触发；插件在场时以插件 manifest 为 hooks 唯一注册源。\n\n### OpenClaw skills-only 部署算法（target_cli 含 openclaw 时）\n\nOpenClaw Phase 1 只部署 skills，不部署 OpenClaw agents\u002Fhooks\u002Fplugin。\n\n1. 读取仓库当前 `skills\u002F` 下所有包含 `SKILL.md` 的 story skill 目录（13 个：`browser-cdp` 与 `story*`）。\n2. 写入目标项目 `skills\u002F{skill-name}\u002F`，仅替换这些 story-setup 管理的已知 skill 目录；保留用户在 `skills\u002F` 下的其他目录。\n3. 每个 `SKILL.md` 必须满足 OpenClaw frontmatter 约束：`name` \u002F `description` 是单行键值，`metadata` 是单行 JSON 对象且含 `metadata.openclaw`。\n4. 复制 `skills\u002Fstory-setup\u002Freferences\u002Fopenclaw\u002FAGENTS.md.tmpl` 到项目 `AGENTS.md`，按「AGENTS.md 合并策略」合并。\n5. `.story-deployed` 的 `target_cli` 写入 `openclaw` 或多端组合；`references_dir` 对 OpenClaw 写 `skills\u002Fstory-setup\u002Freferences\u002Fagent-references`。\n6. 安装报告提示项见 Phase 3 第 10 步。\n\n### Reasonix skills-only 部署算法（target_cli 含 reasonix 时）\n\nReasonix（DeepSeek-Reasonix CLI）当前只部署 skills 与 `AGENTS.md`，不部署 Reasonix hooks\u002Fcustom agents（hook I\u002FO 契约与子代理行为缺少可校验的真实 CLI，留待后续阶段）。\n\n1. 读取仓库当前 `skills\u002F` 下所有包含 `SKILL.md` 的 story skill 目录（13 个：`browser-cdp` 与 `story*`）到目标项目 `skills\u002F{skill-name}\u002F`；仅替换这些 story-setup 管理的已知 skill 目录，保留用户其他目录。\n2. 在项目根创建 `.agents\u002Fskills → ..\u002Fskills` 相对 symlink（与 Codex 共用的 skill root），使 Reasonix 原生扫描 `.agents\u002Fskills` 时发现这些 skill；若已是指向 `skills\u002F` 的 symlink 则保留，若被占用为普通目录则不覆盖并在安装报告提示。Windows 未启用 symlink 时跳过本步，改走根 `reasonix-plugin.json` 的 `reasonix plugin install`。\n3. 复制 `skills\u002Fstory-setup\u002Freferences\u002Freasonix\u002FAGENTS.md.tmpl` 到项目 `AGENTS.md`，按「AGENTS.md 合并策略」合并。\n4. `.story-deployed` 的 `target_cli` 写入 `reasonix` 或多端组合；`references_dir` 对 Reasonix 写 `skills\u002Fstory-setup\u002Freferences\u002Fagent-references`。\n5. 安装报告提示项见 Phase 3 第 12 步。\n\n### 通用 Web AI \u002F 其他 Agent 部署算法（target_cli 含 generic 时）\n\n通用路径面向 NarraFork、Web AI、自定义 Agent 等可读取项目文件的环境，只部署通用文件，不声明平台原生 hooks\u002Fagents 能力。\n\n1. 复制仓库当前 `skills\u002F` 下所有包含 `SKILL.md` 的 story skill 目录（13 个：`browser-cdp` 与 `story*`）到目标项目 `skills\u002F{skill-name}\u002F`；仅替换这些 story-setup 管理的已知 skill 目录，保留用户其他目录。\n2. 复制 `skills\u002Fstory-setup\u002Freferences\u002Fgeneric\u002FAGENTS.md.tmpl` 到项目 `AGENTS.md`，按「AGENTS.md 合并策略」合并。\n3. `.story-deployed` 的 `target_cli` 写入 `generic` 或多端组合；`references_dir` 对 generic 写 `skills\u002Fstory-setup\u002Freferences\u002Fagent-references`。\n4. 安装报告提示项见 Phase 3 第 11 步。\n\n### Step 7：创建部署标记\n\n- 创建 `.story-deployed` 文件（sentinel file）\n- 写入以下字段（YAML `key: value` 格式，hook 用 `references\u002Ftemplates\u002Fhooks\u002Flib\u002Fsentinel.sh` 读取）：\n  ```\n  deployed_at: \u003Cdate -u +\"%Y-%m-%dT%H:%M:%SZ\">\n  agents_version: 30\n  setup_skill_version: 1.2.10\n  target_cli: claude-code（或 opencode、codex、antigravity、zcode、openclaw、reasonix、generic，或其任意组合）\n  resolver_strategy: project-local-skill-reference\n  references_dir: .claude\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references（Codex 写 .codex\u002Fskills\u002F...；Antigravity 写 .agents\u002Fskills\u002F...；ZCode 写 .zcode\u002Fskills\u002F...；OpenClaw \u002F Reasonix \u002F generic 写 skills\u002F...；多端用逗号分隔）\n  ```\n- 此文件供 session-start.sh 和写作 skill 检测部署状态，避免重复提示\n- target_cli 含 claude-code 时，同时创建一次性标记文件 `.claude\u002F.agents-pending-restart`（空文件即可）。session-start.sh 在下一个会话启动时据此确认 agents 已随新会话注册，并自动删除该标记——用来向用户确认「重启已生效」。ZCode 不创建该标记，因为它不部署项目 agents。\n- 如果 `.story-deployed` 已存在但 `agents_version` 缺失、非整数或小于 `30`，按本次流程更新 hooks\u002Fagents\u002Frules\u002Freference bundle（具体变更见 `UPGRADING.md`）；大于 `30` 时已在 Phase 1 停止，不得降级覆盖\n\n## Phase 3：验证安装\n\n按 `.story-deployed.target_cli` 选择对应端的检查：第 1–4 项仅用于 Claude Code，第 5 项是所有端共有的部署标记检查，第 6 项是部署报告，第 7–13 项按目标端各选其一。仅检查模式复用第 1–5 项与对应端的第 7–13 项，跳过第 6 项，且其中要求实际执行 hook 或写入 fixture 的子项改为只做静态校验（文件存在、语法有效、注册项齐全），不运行会写入项目的 hook，也不创建部署标记。\n\n1. 验证 hooks 注册：\n   - 检查 `.claude\u002Fsettings.local.json` 中的 hooks 字段是否正确\n   - 检查 `.claude\u002Fhooks\u002F` 下的脚本是否存在且有执行权限\n   - 检查 `.claude\u002Fhooks\u002Flib\u002Fcommon.sh` 与 `.claude\u002Fhooks\u002Flib\u002Fsentinel.sh` 是否存在\n2. 验证 rules 路径：\n   - 检查 `.claude\u002Frules\u002F` 下的规则文件是否存在且包含 `paths` frontmatter\n3. 验证 agents：\n   - 检查 `.claude\u002Fagents\u002F` 下的 7 个 agent 定义文件是否存在\n4. 验证 agent reference bundle：\n   - 检查 `.claude\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002F` 下 reference 文件完整\n   - 检查所有 `story-setup\u002Freferences\u002Fagent-references\u002F\u003Cfile>.md` 都能解析到 deployed bundle\n5. 验证部署标记：\n   - 检查 `.story-deployed` 是否存在且包含时间戳、`agents_version: 30`、`setup_skill_version: 1.2.10`、`target_cli`、`resolver_strategy`、`references_dir`\n6. 输出安装报告：\n   - 列出所有已部署的文件\n   - 列出需要注意的事项（如已有配置已合并）\n    - **⚠️ 重启提示（必须醒目输出）**：本次部署写入了 `.claude\u002Fagents\u002F`，但这些 custom agent 只在「会话启动」时才会被 Claude Code 注册成 `subagent_type`。**请新开一个 Claude Code 会话再开始写作**，否则当前会话里 story-review \u002F story-long-write 等想 spawn `story-architect`、`narrative-writer` 等时会拿到「subagent_type 不可用」并降级 solo（单视角，失去多 agent 协作）。判断是否生效：新会话里跑 `\u002Fstory-review`，报告头若是 `Effective Mode: full\u002Flean` 即注册成功；若是 `Fallback: ... -> solo` 说明还在旧会话或未注册。\n    - 重启后即可使用 `\u002Fstory-long-write` 或 `\u002Fstory-short-write`\n    - 如果执行了「配置 OpenCode Agent 模型」，输出 Agent 模型配置摘要：\n      ```\n      Agent 模型配置：\n        story-architect          → \u003C高端模型>（provider\u002Fmodel-id）\n        narrative-writer         → \u003C中端模型>（provider\u002Fmodel-id）\n        character-designer       → \u003C中端模型>（provider\u002Fmodel-id）\n        story-researcher         → \u003C中端模型>（provider\u002Fmodel-id）\n        chapter-extractor        → \u003C低端模型>（provider\u002Fmodel-id）\n        consistency-checker      → \u003C低端模型>（provider\u002Fmodel-id）\n        story-explorer           → \u003C低端模型>（provider\u002Fmodel-id）\n      ```\n    - 如果自动检测失败（`opencode models` 不可用），输出手动配置指南：\n      ```\n      无法自动检测模型列表。以下 Agent 未配置模型，将使用主模型，成本可能较高：\n        - chapter-extractor（建议使用低成本模型）\n        - consistency-checker（建议使用低成本模型）\n        - story-explorer（建议使用低成本模型）\n\n      手动配置方法：编辑 .opencode\u002Fagents\u002F{agent名}.md，在 frontmatter 中添加：\n        model: provider\u002Fmodel-id\n\n      可用模型列表与成本可通过 opencode models --verbose 查看（输出含每模型 cost\u002Fcontext）。\n      模型库与定价见 OpenCode 官方模型源 https:\u002F\u002Fmodels.dev\u002F。\n      ```\n7. 验证 opencode 部署（仅当 target_cli 含 opencode 时）：\n    - 检查 `.opencode\u002Fagents\u002F` 下的 7 个 agent 定义文件是否存在，且 frontmatter 包含 `mode: subagent` 和 `permission` 字段\n    - 检查 `.opencode\u002Fplugins\u002Fstory-hooks.ts` 是否存在\n    - 检查 `.opencode\u002Fplugins\u002Flib\u002Fstory_hook_core.js` 存在且 `node --check` 通过（story-hooks.ts import 之，与 `.zcode` 副本字节一致的共享写正文守卫核；置于 `lib\u002F` 子目录以避开 OpenCode 单层 `.opencode\u002Fplugins\u002F*.js` 插件自动发现）\n     - 检查 `.opencode\u002Fcommands\u002F` 下的 13 个 command 文件是否存在\n    - 检查 `skills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002F` 下 reference 文件完整且数量与源目录一致\n    - 检查 `opencode.json` 的 `plugin` 数组是否包含 story-hooks 条目\n    - 检查 `.git\u002Fhooks\u002Fpre-commit` 是否存在且有执行权限（Windows 上跳过执行权限检查）\n    - 检查 `.opencode\u002Fagents\u002F` 下 agent 文件 frontmatter 可被 YAML 解析、`model:`（如有配置）是合法顶层标量，而非仅 grep 到 `model:` 子串\n8. 验证 Codex 部署（仅当 target_cli 含 codex 时）：\n    - 检查 `AGENTS.md` 含 Codex story skill routing sections\n    - 检查 `.codex\u002Fagents\u002F` 下 7 个 `.toml` agent 定义文件存在并可解析\n    - 检查 `.codex\u002Fhooks.json` 存在且 JSON 有效，Unix `command` 仅通过 `run-story-hook.sh` 启动，Windows `commandWindows` 仅通过 `run-story-hook.cmd` 启动；不存在直调 `story_codex_hook.py` 的注册\n   - 检查 `.codex\u002Fhooks\u002Fstory_codex_hook.py`、`run-story-hook.sh`、`run-story-hook.cmd` 存在，Python 语法有效，POSIX\u002FWindows launcher 能从嵌套 cwd 定位项目根\n    - 检查 `.codex\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002F` 下 reference 文件完整且数量与源目录一致\n    - 安装报告必须提示：Codex 需要 trust 项目 `.codex\u002F` 配置层，并在 `\u002Fhooks` review\u002Ftrust 非 managed hooks；部署后新开 Codex 会话让 custom agents 生效；若当前运行时仍返回 `unknown agent_type`，按各 skill 的 fallback 规则降级 solo\u002Fdirect\n9. 验证 Antigravity 部署（仅当 target_cli 含 antigravity 时）：\n    - 检查 `.agents\u002Fskills\u002F` 下 13 个 story skills 为真实目录且 `SKILL.md` 可读；`.agents\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002F` 完整\n    - 检查 `.agents\u002Fagents\u002F` 下 7 个 Markdown agent 可解析，名称、模型档、官方工具白名单、只读边界与 `.agents\u002Fskills\u002F` reference 前缀正确\n    - 检查 `.agents\u002Frules\u002Foh-story.md` 为 `trigger: always_on` 且未超过 12,000 字符\n    - 检查 `.agents\u002Fhooks.json` 有效、顶层 `oh-story` group 恰有 PreToolUse\u002FPostToolUse\u002FPreInvocation\u002FStop，用户 hook groups 保留；检查 `.agents\u002Fhooks\u002Fstory_antigravity_hook.js` 与 `story_hook_core.js` 语法有效\n    - 用 fixture 验证：PreToolUse 缺纲\u002F追踪时 deny、普通写入 allow、commit advisory；PostToolUse stdout 恒为 `{}` 且把正文 findings 写进 session artifact；下一次 PreInvocation 注入 findings；Stop 对未处理 findings 最多 continue 一次；干净正文清除 pending state\n    - 安装报告必须提示：新开 Antigravity conversation 刷新 customization；Hooks 依赖 PATH 中的 `node`；外部 hook API 没有 PreCompact\u002FPostCompact，compact 恢复由 Always-On Rule 读取 `追踪\u002F上下文.md`；IDE 与交互式 `agy` 仍建议分别实机 smoke test；`agy 1.1.22 -p` 每次 headless 启动都可能在静默鉴权前扫描 workspace，鉴权后不重载 custom agents\u002Fhooks，因此当前不在支持面内，可能报 `subagent not found` 或回退写入 `~\u002F.gemini\u002Fantigravity-cli\u002Fscratch\u002F`；命令行写作从项目目录进入交互式 `agy`，确认 `\u002Fskills`、`\u002Fagents`、`\u002Fhooks` 已发现 oh-story 后再发任务，测试后检查 scratch 无意外小说产物\n10. 验证 ZCode 部署（仅当 target_cli 含 zcode 时）：\n    - 检查根 `AGENTS.md` 含 ZCode `$story-*` 路由、大纲守卫和 solo\u002Fdirect fallback\n    - 检查 `.zcode\u002Fskills\u002F` 下 13 个 Skills 与 `.zcode\u002Fcommands\u002F` 下 13 个 Commands，验证 frontmatter 和命名\n    - 检查 `.zcode\u002Fhooks\u002Fstory_zcode_hook.js`、`.zcode\u002Fhooks\u002Fstory_hook_core.js` 存在且 `node --check` 通过\n    - 检查 `.zcode\u002Fconfig.json` JSON 有效，并按「ZCode 部署算法」第 4 步的 hooks 互斥分支校验：未装 oh-story 插件时，`hooks.enabled=true`、仅注册 ZCode 支持事件、所有 `process` args 指向项目 Hook；已装 oh-story 插件（`.zcode-plugin\u002Fplugin.json` 已全局注册这批 hooks）时，改为校验 `.zcode\u002Fconfig.json` 不含（或已移除）这批 oh-story hooks 注册——**不得**为了让校验通过而把 `config.json.patch` 的 hooks 块合并回去，否则同一事件双触发\n    - 检查 `.zcode\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002F` 完整且所有 reference 路径可解析\n    - 用 fixture 调用 SessionStart、PreToolUse deny\u002Fallow、PostToolUse，确认无发现时 stdout 为空、有输出时符合 ZCode 严格 JSON\n    - 安装报告必须提示：ZCode 3.3.4 不执行项目\u002Fplugin custom agents，full\u002Flean 多 Agent 请求会稳定降级 solo\u002Fdirect；Hook 依赖 PATH 中的 `node`；部署后新开 ZCode session 刷新 Skills\u002FCommands\u002FAGENTS.md\n11. 验证 OpenClaw 部署（仅当 target_cli 含 openclaw 时）：\n    - 检查 `AGENTS.md` 含 OpenClaw story skill routing sections\n    - 检查 `skills\u002F` 下 13 个 story skill 目录存在，且每个 `SKILL.md` 包含单行 `name`、单行 `description`、单行 JSON `metadata.openclaw`\n    - 检查 `skills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002F` 下 reference 文件完整且数量与源目录一致\n    - 安装报告必须提示：OpenClaw Phase 1 是 skills-only；未部署 OpenClaw agents\u002Fhooks，运行时硬拦截不可用，写正文前大纲守卫、commit 提醒、session\u002Fcompact 自动注入只作为 skill 内软约束；OpenClaw 在 session 启动时 snapshot eligible skills，部署后如命令\u002Fskills 未出现，需新开 OpenClaw session 或等待 skills watcher 刷新\n12. 验证通用 Web AI \u002F 其他 Agent 部署（仅当 target_cli 含 generic 时）：\n    - 检查 `AGENTS.md` 含通用 story skill routing sections\n    - 检查 `skills\u002F` 下 13 个 story skill 目录存在，且每个 `SKILL.md` 可读\n    - 检查 `skills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002F` 下 reference 文件完整且数量与源目录一致\n    - 安装报告必须提示：generic 不部署平台专属 hooks\u002Fcustom agents；大纲守卫、commit 提醒、session\u002Fcompact 注入等硬拦截与多 agent 协作都按 skill 内软约束或 solo\u002Fdirect fallback 执行\n13. 验证 Reasonix 部署（仅当 target_cli 含 reasonix 时）：\n    - 检查 `AGENTS.md` 含 Reasonix story skill routing sections 与 solo\u002Fdirect fallback 说明\n    - 检查 `skills\u002F` 下 13 个 story skill 目录存在，且每个 `SKILL.md` 可读\n    - 检查项目 `.agents\u002Fskills` 为指向 `skills\u002F` 的 symlink（POSIX；使 Reasonix 原生扫描发现 skill）；Windows 未建 symlink 时改为确认根 `reasonix-plugin.json` 可用于 `reasonix plugin install`\n    - 检查 `skills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002F` 下 reference 文件完整且数量与源目录一致\n    - 安装报告必须提示：Reasonix 当前是 skills-only；未部署 Reasonix hooks\u002Fcustom agents，写正文前大纲守卫、commit 提醒、session\u002Fcompact 自动注入只作为 skill 内软约束，涉及专业 Agent 的 Skill 走 solo\u002Fdirect fallback；可用 `reasonix doctor capabilities` 校验 skill 发现，部署后如未显示新 skills，新开 Reasonix session 或走根 `reasonix-plugin.json` 原生 plugin 安装\n\n---\n\n## 模板占位符\n\n| 占位符 | 替换规则 | 示例 |\n|--------|----------|------|\n| `{项目名}` | 用户项目名称或目录名 | 《剑来》、《暗卫》 |\n| `{书名}` | 书名目录名（与目录一致） | 与 `{项目名}` 相同，或用户自定义 |\n| `{目标平台}` | 目标发布平台 | 起点、番茄、晋江、知乎盐言 |\n| `{作者名}` | 用户笔名或昵称 | 未指定时用「作者」 |\n\n替换时去掉花括号。如果用户未指定项目名，用当前目录名。未指定的占位符保留原样不替换。\n\n## CLAUDE.md 合并策略\n\n用户已有 CLAUDE.md 时，按 marker\u002Fsection 合并：\n1. 优先识别 story-setup 管理块标记（如果旧项目已有标记，只替换标记内内容）\n2. 无标记时，读取用户现有 CLAUDE.md，按 `##` 标题切分为 section map\n3. 读取模板 CLAUDE.md.tmpl，同样切分\n4. 模板中的标准 section（Skill 路由表、文件结构、协作规则、Compact 后恢复上下文）**覆盖**用户同名 section\n5. 用户独有的 section（自定义内容）**保留**不动\n6. 未知冲突用 AskUserQuestion 让用户选择保留哪个版本\n\n## AGENTS.md 合并策略（OpenCode \u002F Codex \u002F ZCode \u002F OpenClaw \u002F Reasonix \u002F generic）\n\n用户已有 AGENTS.md 时，按 marker\u002Fsection 合并：\n1. 优先识别 story-setup 管理块标记（如果旧项目已有标记，只替换标记内内容）\n2. 无标记时，读取用户现有 AGENTS.md，按 `##` 标题切分为 section map\n3. OpenCode 使用 `skills\u002Fstory-setup\u002Freferences\u002Fopencode\u002FAGENTS.md.tmpl`；Codex 使用 `skills\u002Fstory-setup\u002Freferences\u002Fcodex\u002FAGENTS.md.tmpl`；ZCode 使用 `skills\u002Fstory-setup\u002Freferences\u002Fzcode\u002FAGENTS.md.tmpl`；OpenClaw 使用 `skills\u002Fstory-setup\u002Freferences\u002Fopenclaw\u002FAGENTS.md.tmpl`；Reasonix 使用 `skills\u002Fstory-setup\u002Freferences\u002Freasonix\u002FAGENTS.md.tmpl`；通用 Web AI \u002F 其他 Agent 使用 `skills\u002Fstory-setup\u002Freferences\u002Fgeneric\u002FAGENTS.md.tmpl`\n4. 模板中的标准 section（Skill 路由表、文件结构、协作规则、Compact 后恢复上下文）覆盖同名 section；用户独有 section 保留\n5. 多端同时部署时，Codex\u002FOpenCode\u002FZCode\u002FOpenClaw\u002FReasonix\u002Fgeneric 共同可用的通用段落只保留一份；工具特有说明以小节区分，避免互相覆盖\n\n## 重新部署\n\n- `.story-deployed` 不存在 → 全新安装，Phase 2 全部执行\n- `.story-deployed` 存在且 `agents_version: 30` → 提示已部署，AskUserQuestion 确认是否重新部署；提示里写明重新部署只用当前本地 skill 包刷新项目文件，skill 本身的更新走 `npx skills add` 或 marketplace\n- `.story-deployed` 存在但 `agents_version` 缺失、非整数或小于 `30` → 提示需要更新，重新执行 Phase 2 覆盖 agents\u002Fhooks\u002Frules\u002Freference bundle，CLAUDE.md \u002F AGENTS.md \u002F settings.local.json \u002F .codex\u002Fhooks.json \u002F `.agents\u002Fhooks.json` \u002F .zcode\u002Fconfig.json 走合并策略\n- `.story-deployed` 存在且 `agents_version` 大于 `30` → 当前 skill 版本过旧，停止并提示先更新 oh-story-claudecode；不覆盖项目中的更新部署\n\n---\n\n## 参考资料\n\n| 文件 | 用途 |\n|------|------|\n| references\u002Ftemplates\u002Fhooks\u002F | 8 个 hook 脚本模板 + `story_hook_core.js`（正文网\u002F大纲守卫\u002F连续性\u002Fcommit 侦测的共享实现，与 OpenCode\u002FZCode 同一份）+ `story_hook_cli.js`（bash hook 调核的 node 桥）+ `lib\u002Fcommon.sh`\u002F`lib\u002Fsentinel.sh`（正文兜底 `check-prose-after-write.sh` 限 PostToolUse Write\u002FEdit；`cat>`\u002F`tee` 等 Bash 写正文由 Codex Stop 回合末 git 扫描兜，Claude\u002FOpenCode 的 Bash 仅 pre-guard） |\n| references\u002Fantigravity\u002F | Antigravity 2.0 Always-On Rule、named-group hooks 模板与 I\u002FO adapter；正文写后 findings 经 session artifact 桥接到 PreInvocation\u002FStop |\n| references\u002Fzcode\u002F | ZCode AGENTS、13 Commands、workspace config patch 与严格 JSON Hook runner |\n\n---\n\n## 流程衔接\n\n**流水线：** 部署\n**位置：** 初始化（最前置）\n\n| 时机 | 跳转到 | 命令 |\n|---|---|---|\n| 部署完成，开始写作 | story-long-write \u002F story-short-write | `\u002Fstory-long-write` 或 `\u002Fstory-short-write` |\n| 导入已有小说做拆解 | story-import | `\u002Fstory-import` |\n| 需要浏览器登录态（扫榜\u002F拆文取原文） | browser-cdp | `\u002Fbrowser-cdp`；generic 需平台允许本地脚本\u002F浏览器控制 |\n\n各端调用语法：Claude `\u002F名`、Codex\u002FZCode `$名`、Antigravity 通过 `\u002Fskills` 浏览或直接点名、OpenClaw `\u002Fskill 名`、Reasonix \u002F generic 直接点名 skill。\n",{"name":5,"version":24,"metadata":25,"description":7},"1.2.10",{"openclaw":26},{"source":27},"https:\u002F\u002Fgithub.com\u002Fzenstory-ai\u002Foh-story-claudecode","master","ac7e594591f0a87f66930c11b85b293050a972d0","skills\u002Fstory-setup",0,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval","https:\u002F\u002Fgithub.com\u002Frtiy1","2026-09-21 11:50:47",{"source":8,"skillName":5,"commands":36,"prompt":46,"zipAvailable":47},[37,40,43],{"tool":38,"command":39},"npx","npx skills add rtiy1\u002FYeMuAINoval --skill story-setup",{"tool":41,"command":42},"bunx","bunx skills add rtiy1\u002FYeMuAINoval --skill story-setup",{"tool":44,"command":45},"pnpm","pnpm dlx skills add rtiy1\u002FYeMuAINoval --skill story-setup","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002FSKILL.md",true,[49,55,59,63,67,71,75,79,83,87,91,95,99,103,107,111,115,119,123,127,131,135,139,143,147,151,154,158,162,166,170,174,178,182,186,190,194,198,202,206,210,214,218,222,226,230,234,238,242,246,250,254,258,262,266,270,274,278,282,286,290,294,298,302,306,310,314,318,322,326,332,336,340,344,348,352,356,360,364,368,372,376,380,384,388,392,396,400,404,408,412,416,420,424,428,432,436,440,444,448,452,456,460,464,468,472,476,480,484,488,492,496,499,503,506,510,514,518,522,526,530,534,537,541,545,549,553,557,561,565,569,573,577,580,584,588,592,596,600,604,608,612,616,620,623,627,631,635,639,643,646,650,653,656,660,664,667,671,675,679,683,687,691,695],{"path":50,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":53,"sourceHtmlUrl":54},"references\u002Fagent-references\u002Fagent-quality.md","REFERENCE","参考文档",3593,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fagent-quality.md",{"path":56,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":57,"sourceHtmlUrl":58},"references\u002Fagent-references\u002Fagent-reference-profiles.md",4031,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fagent-reference-profiles.md",{"path":60,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":61,"sourceHtmlUrl":62},"references\u002Fagent-references\u002Fanti-ai-writing.md",37154,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fanti-ai-writing.md",{"path":64,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":65,"sourceHtmlUrl":66},"references\u002Fagent-references\u002Fbanned-words.md",10447,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fbanned-words.md",{"path":68,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":69,"sourceHtmlUrl":70},"references\u002Fagent-references\u002Fcharacter-basics.md",16921,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fcharacter-basics.md",{"path":72,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":73,"sourceHtmlUrl":74},"references\u002Fagent-references\u002Fcharacter-design-methods.md",16262,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fcharacter-design-methods.md",{"path":76,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":77,"sourceHtmlUrl":78},"references\u002Fagent-references\u002Fcharacter-relations.md",15470,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fcharacter-relations.md",{"path":80,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":81,"sourceHtmlUrl":82},"references\u002Fagent-references\u002Fdeslop-gates.md",12105,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fdeslop-gates.md",{"path":84,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":85,"sourceHtmlUrl":86},"references\u002Fagent-references\u002Fdialogue-mastery.md",11495,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fdialogue-mastery.md",{"path":88,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":89,"sourceHtmlUrl":90},"references\u002Fagent-references\u002Femotional-arc-design.md",16647,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Femotional-arc-design.md",{"path":92,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":93,"sourceHtmlUrl":94},"references\u002Fagent-references\u002Fformat-and-structure.md",10599,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fformat-and-structure.md",{"path":96,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":97,"sourceHtmlUrl":98},"references\u002Fagent-references\u002Fgenre-prose-cards.md",7146,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fgenre-prose-cards.md",{"path":100,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":101,"sourceHtmlUrl":102},"references\u002Fagent-references\u002Fgenre-prose-cards\u002F东方仙侠.md",2788,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fgenre-prose-cards\u002F东方仙侠.md",{"path":104,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":105,"sourceHtmlUrl":106},"references\u002Fagent-references\u002Fgenre-prose-cards\u002F传统玄幻.md",2801,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fgenre-prose-cards\u002F传统玄幻.md",{"path":108,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":109,"sourceHtmlUrl":110},"references\u002Fagent-references\u002Fgenre-prose-cards\u002F历史古代.md",2635,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fgenre-prose-cards\u002F历史古代.md",{"path":112,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":113,"sourceHtmlUrl":114},"references\u002Fagent-references\u002Fgenre-prose-cards\u002F历史脑洞.md",2934,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fgenre-prose-cards\u002F历史脑洞.md",{"path":116,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":117,"sourceHtmlUrl":118},"references\u002Fagent-references\u002Fgenre-prose-cards\u002F双男主.md",3272,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fgenre-prose-cards\u002F双男主.md",{"path":120,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":121,"sourceHtmlUrl":122},"references\u002Fagent-references\u002Fgenre-prose-cards\u002F古言脑洞.md",2676,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fgenre-prose-cards\u002F古言脑洞.md",{"path":124,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":125,"sourceHtmlUrl":126},"references\u002Fagent-references\u002Fgenre-prose-cards\u002F古风世情.md",2622,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fgenre-prose-cards\u002F古风世情.md",{"path":128,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":129,"sourceHtmlUrl":130},"references\u002Fagent-references\u002Fgenre-prose-cards\u002F女频悬疑.md",2637,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fgenre-prose-cards\u002F女频悬疑.md",{"path":132,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":133,"sourceHtmlUrl":134},"references\u002Fagent-references\u002Fgenre-prose-cards\u002F女频种田.md",2693,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fgenre-prose-cards\u002F女频种田.md",{"path":136,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":137,"sourceHtmlUrl":138},"references\u002Fagent-references\u002Fgenre-prose-cards\u002F宫斗宅斗.md",2522,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fgenre-prose-cards\u002F宫斗宅斗.md",{"path":140,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":141,"sourceHtmlUrl":142},"references\u002Fagent-references\u002Fgenre-prose-cards\u002F年代.md",3069,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fgenre-prose-cards\u002F年代.md",{"path":144,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":145,"sourceHtmlUrl":146},"references\u002Fagent-references\u002Fgenre-prose-cards\u002F快穿.md",2858,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fgenre-prose-cards\u002F快穿.md",{"path":148,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":149,"sourceHtmlUrl":150},"references\u002Fagent-references\u002Fgenre-prose-cards\u002F悬疑灵异.md",2616,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fgenre-prose-cards\u002F悬疑灵异.md",{"path":152,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":101,"sourceHtmlUrl":153},"references\u002Fagent-references\u002Fgenre-prose-cards\u002F悬疑脑洞.md","https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fgenre-prose-cards\u002F悬疑脑洞.md",{"path":155,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":156,"sourceHtmlUrl":157},"references\u002Fagent-references\u002Fgenre-prose-cards\u002F战神赘婿.md",2810,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fgenre-prose-cards\u002F战神赘婿.md",{"path":159,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":160,"sourceHtmlUrl":161},"references\u002Fagent-references\u002Fgenre-prose-cards\u002F抗战谍战.md",2728,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fgenre-prose-cards\u002F抗战谍战.md",{"path":163,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":164,"sourceHtmlUrl":165},"references\u002Fagent-references\u002Fgenre-prose-cards\u002F星光璀璨.md",2800,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fgenre-prose-cards\u002F星光璀璨.md",{"path":167,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":168,"sourceHtmlUrl":169},"references\u002Fagent-references\u002Fgenre-prose-cards\u002F民国言情.md",2817,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fgenre-prose-cards\u002F民国言情.md",{"path":171,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":172,"sourceHtmlUrl":173},"references\u002Fagent-references\u002Fgenre-prose-cards\u002F游戏体育.md",2899,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fgenre-prose-cards\u002F游戏体育.md",{"path":175,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":176,"sourceHtmlUrl":177},"references\u002Fagent-references\u002Fgenre-prose-cards\u002F玄幻脑洞.md",3004,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fgenre-prose-cards\u002F玄幻脑洞.md",{"path":179,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":180,"sourceHtmlUrl":181},"references\u002Fagent-references\u002Fgenre-prose-cards\u002F玄幻言情.md",2596,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fgenre-prose-cards\u002F玄幻言情.md",{"path":183,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":184,"sourceHtmlUrl":185},"references\u002Fagent-references\u002Fgenre-prose-cards\u002F现言脑洞.md",2741,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fgenre-prose-cards\u002F现言脑洞.md",{"path":187,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":188,"sourceHtmlUrl":189},"references\u002Fagent-references\u002Fgenre-prose-cards\u002F科幻末世.md",2653,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fgenre-prose-cards\u002F科幻末世.md",{"path":191,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":192,"sourceHtmlUrl":193},"references\u002Fagent-references\u002Fgenre-prose-cards\u002F职场婚恋.md",2612,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fgenre-prose-cards\u002F职场婚恋.md",{"path":195,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":196,"sourceHtmlUrl":197},"references\u002Fagent-references\u002Fgenre-prose-cards\u002F西方奇幻.md",2834,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fgenre-prose-cards\u002F西方奇幻.md",{"path":199,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":200,"sourceHtmlUrl":201},"references\u002Fagent-references\u002Fgenre-prose-cards\u002F豪门总裁.md",3343,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fgenre-prose-cards\u002F豪门总裁.md",{"path":203,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":204,"sourceHtmlUrl":205},"references\u002Fagent-references\u002Fgenre-prose-cards\u002F都市修真.md",2580,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fgenre-prose-cards\u002F都市修真.md",{"path":207,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":208,"sourceHtmlUrl":209},"references\u002Fagent-references\u002Fgenre-prose-cards\u002F都市日常.md",3766,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fgenre-prose-cards\u002F都市日常.md",{"path":211,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":212,"sourceHtmlUrl":213},"references\u002Fagent-references\u002Fgenre-prose-cards\u002F都市种田.md",2584,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fgenre-prose-cards\u002F都市种田.md",{"path":215,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":216,"sourceHtmlUrl":217},"references\u002Fagent-references\u002Fgenre-prose-cards\u002F都市脑洞.md",3485,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fgenre-prose-cards\u002F都市脑洞.md",{"path":219,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":220,"sourceHtmlUrl":221},"references\u002Fagent-references\u002Fgenre-prose-cards\u002F都市高武.md",3018,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fgenre-prose-cards\u002F都市高武.md",{"path":223,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":224,"sourceHtmlUrl":225},"references\u002Fagent-references\u002Fgenre-prose-cards\u002F青春甜宠.md",2790,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fgenre-prose-cards\u002F青春甜宠.md",{"path":227,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":228,"sourceHtmlUrl":229},"references\u002Fagent-references\u002Fgenre-readers.md",11027,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fgenre-readers.md",{"path":231,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":232,"sourceHtmlUrl":233},"references\u002Fagent-references\u002Flong-chapter-hooks.md",8784,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Flong-chapter-hooks.md",{"path":235,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":236,"sourceHtmlUrl":237},"references\u002Fagent-references\u002Flong-emotional-methods.md",10178,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Flong-emotional-methods.md",{"path":239,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":240,"sourceHtmlUrl":241},"references\u002Fagent-references\u002Flong-genre-catalog.md",17378,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Flong-genre-catalog.md",{"path":243,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":244,"sourceHtmlUrl":245},"references\u002Fagent-references\u002Flong-genre-mechanics.md",17364,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Flong-genre-mechanics.md",{"path":247,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":248,"sourceHtmlUrl":249},"references\u002Fagent-references\u002Flong-quality.md",2891,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Flong-quality.md",{"path":251,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":252,"sourceHtmlUrl":253},"references\u002Fagent-references\u002Flong-reversal.md",15581,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Flong-reversal.md",{"path":255,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":256,"sourceHtmlUrl":257},"references\u002Fagent-references\u002Flong-suspense.md",15524,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Flong-suspense.md",{"path":259,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":260,"sourceHtmlUrl":261},"references\u002Fagent-references\u002Fopening-design.md",12819,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fopening-design.md",{"path":263,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":264,"sourceHtmlUrl":265},"references\u002Fagent-references\u002Foutline-conflict.md",17687,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Foutline-conflict.md",{"path":267,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":268,"sourceHtmlUrl":269},"references\u002Fagent-references\u002Foutline-methods.md",10875,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Foutline-methods.md",{"path":271,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":272,"sourceHtmlUrl":273},"references\u002Fagent-references\u002Foutline-rhythm.md",12878,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Foutline-rhythm.md",{"path":275,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":276,"sourceHtmlUrl":277},"references\u002Fagent-references\u002Fplot-core-methods.md",20291,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fplot-core-methods.md",{"path":279,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":280,"sourceHtmlUrl":281},"references\u002Fagent-references\u002Fshort-chapter-hooks.md",8632,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fshort-chapter-hooks.md",{"path":283,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":284,"sourceHtmlUrl":285},"references\u002Fagent-references\u002Fshort-emotional-methods.md",7888,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fshort-emotional-methods.md",{"path":287,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":288,"sourceHtmlUrl":289},"references\u002Fagent-references\u002Fshort-genre-formulas.md",21439,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fshort-genre-formulas.md",{"path":291,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":292,"sourceHtmlUrl":293},"references\u002Fagent-references\u002Fshort-paragraph-hooks.md",6848,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fshort-paragraph-hooks.md",{"path":295,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":296,"sourceHtmlUrl":297},"references\u002Fagent-references\u002Fshort-quality.md",2789,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fshort-quality.md",{"path":299,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":300,"sourceHtmlUrl":301},"references\u002Fagent-references\u002Fshort-reversal.md",16682,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fshort-reversal.md",{"path":303,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":304,"sourceHtmlUrl":305},"references\u002Fagent-references\u002Fshort-suspense.md",15939,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fshort-suspense.md",{"path":307,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":308,"sourceHtmlUrl":309},"references\u002Fagent-references\u002Fstyle-combat-face.md",20072,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fstyle-combat-face.md",{"path":311,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":312,"sourceHtmlUrl":313},"references\u002Fagent-references\u002Fstyle-genre-modules.md",24808,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fstyle-genre-modules.md",{"path":315,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":316,"sourceHtmlUrl":317},"references\u002Fagent-references\u002Fstyle-resolution.md",4017,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fstyle-resolution.md",{"path":319,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":320,"sourceHtmlUrl":321},"references\u002Fagent-references\u002Fwriting-craft.md",32857,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fagent-references\u002Fwriting-craft.md",{"path":323,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":324,"sourceHtmlUrl":325},"references\u002Fantigravity\u002Fhooks\u002Fhooks.json",994,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fantigravity\u002Fhooks\u002Fhooks.json",{"path":327,"resourceType":328,"resourceTypeDesc":329,"sizeBytes":330,"sourceHtmlUrl":331},"references\u002Fantigravity\u002Fhooks\u002Fstory_antigravity_hook.js","SCRIPT","脚本",8439,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fantigravity\u002Fhooks\u002Fstory_antigravity_hook.js",{"path":333,"resourceType":328,"resourceTypeDesc":329,"sizeBytes":334,"sourceHtmlUrl":335},"references\u002Fantigravity\u002Fhooks\u002Fstory_hook_core.js",51652,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fantigravity\u002Fhooks\u002Fstory_hook_core.js",{"path":337,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":338,"sourceHtmlUrl":339},"references\u002Fantigravity\u002Frules\u002Foh-story.md",2188,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fantigravity\u002Frules\u002Foh-story.md",{"path":341,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":342,"sourceHtmlUrl":343},"references\u002Fcodex\u002FAGENTS.md.tmpl",2883,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fcodex\u002FAGENTS.md.tmpl",{"path":345,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":346,"sourceHtmlUrl":347},"references\u002Fcodex\u002Fagents\u002Fchapter-extractor.toml",20899,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fcodex\u002Fagents\u002Fchapter-extractor.toml",{"path":349,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":350,"sourceHtmlUrl":351},"references\u002Fcodex\u002Fagents\u002Fcharacter-designer.toml",9965,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fcodex\u002Fagents\u002Fcharacter-designer.toml",{"path":353,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":354,"sourceHtmlUrl":355},"references\u002Fcodex\u002Fagents\u002Fconsistency-checker.toml",11990,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fcodex\u002Fagents\u002Fconsistency-checker.toml",{"path":357,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":358,"sourceHtmlUrl":359},"references\u002Fcodex\u002Fagents\u002Fnarrative-writer.toml",16182,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fcodex\u002Fagents\u002Fnarrative-writer.toml",{"path":361,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":362,"sourceHtmlUrl":363},"references\u002Fcodex\u002Fagents\u002Fstory-architect.toml",12690,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fcodex\u002Fagents\u002Fstory-architect.toml",{"path":365,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":366,"sourceHtmlUrl":367},"references\u002Fcodex\u002Fagents\u002Fstory-explorer.toml",22614,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fcodex\u002Fagents\u002Fstory-explorer.toml",{"path":369,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":370,"sourceHtmlUrl":371},"references\u002Fcodex\u002Fagents\u002Fstory-researcher.toml",13022,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fcodex\u002Fagents\u002Fstory-researcher.toml",{"path":373,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":374,"sourceHtmlUrl":375},"references\u002Fcodex\u002Fhooks\u002Fhooks.json",6981,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fcodex\u002Fhooks\u002Fhooks.json",{"path":377,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":378,"sourceHtmlUrl":379},"references\u002Fcodex\u002Fhooks\u002Frun-story-hook.cmd",699,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fcodex\u002Fhooks\u002Frun-story-hook.cmd",{"path":381,"resourceType":328,"resourceTypeDesc":329,"sizeBytes":382,"sourceHtmlUrl":383},"references\u002Fcodex\u002Fhooks\u002Frun-story-hook.sh",769,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fcodex\u002Fhooks\u002Frun-story-hook.sh",{"path":385,"resourceType":328,"resourceTypeDesc":329,"sizeBytes":386,"sourceHtmlUrl":387},"references\u002Fcodex\u002Fhooks\u002Fstory_codex_hook.py",67535,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fcodex\u002Fhooks\u002Fstory_codex_hook.py",{"path":389,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":390,"sourceHtmlUrl":391},"references\u002Fdiagnostics.md",3980,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fdiagnostics.md",{"path":393,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":394,"sourceHtmlUrl":395},"references\u002Fgeneric\u002FAGENTS.md.tmpl",3465,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fgeneric\u002FAGENTS.md.tmpl",{"path":397,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":398,"sourceHtmlUrl":399},"references\u002Fopenclaw\u002FAGENTS.md.tmpl",3943,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fopenclaw\u002FAGENTS.md.tmpl",{"path":401,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":402,"sourceHtmlUrl":403},"references\u002Fopencode\u002FAGENTS.md.tmpl",2225,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fopencode\u002FAGENTS.md.tmpl",{"path":405,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":406,"sourceHtmlUrl":407},"references\u002Fopencode\u002Fagents\u002Fchapter-extractor.md",20145,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fopencode\u002Fagents\u002Fchapter-extractor.md",{"path":409,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":410,"sourceHtmlUrl":411},"references\u002Fopencode\u002Fagents\u002Fcharacter-designer.md",9236,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fopencode\u002Fagents\u002Fcharacter-designer.md",{"path":413,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":414,"sourceHtmlUrl":415},"references\u002Fopencode\u002Fagents\u002Fconsistency-checker.md",11229,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fopencode\u002Fagents\u002Fconsistency-checker.md",{"path":417,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":418,"sourceHtmlUrl":419},"references\u002Fopencode\u002Fagents\u002Fnarrative-writer.md",15459,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fopencode\u002Fagents\u002Fnarrative-writer.md",{"path":421,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":422,"sourceHtmlUrl":423},"references\u002Fopencode\u002Fagents\u002Fstory-architect.md",11971,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fopencode\u002Fagents\u002Fstory-architect.md",{"path":425,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":426,"sourceHtmlUrl":427},"references\u002Fopencode\u002Fagents\u002Fstory-explorer.md",21880,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fopencode\u002Fagents\u002Fstory-explorer.md",{"path":429,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":430,"sourceHtmlUrl":431},"references\u002Fopencode\u002Fagents\u002Fstory-researcher.md",12305,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fopencode\u002Fagents\u002Fstory-researcher.md",{"path":433,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":434,"sourceHtmlUrl":435},"references\u002Fopencode\u002Fcommands\u002Fbrowser-cdp.md",284,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fopencode\u002Fcommands\u002Fbrowser-cdp.md",{"path":437,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":438,"sourceHtmlUrl":439},"references\u002Fopencode\u002Fcommands\u002Fstory-cover.md",189,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fopencode\u002Fcommands\u002Fstory-cover.md",{"path":441,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":442,"sourceHtmlUrl":443},"references\u002Fopencode\u002Fcommands\u002Fstory-deslop.md",222,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fopencode\u002Fcommands\u002Fstory-deslop.md",{"path":445,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":446,"sourceHtmlUrl":447},"references\u002Fopencode\u002Fcommands\u002Fstory-import.md",235,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fopencode\u002Fcommands\u002Fstory-import.md",{"path":449,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":450,"sourceHtmlUrl":451},"references\u002Fopencode\u002Fcommands\u002Fstory-long-analyze.md",214,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fopencode\u002Fcommands\u002Fstory-long-analyze.md",{"path":453,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":454,"sourceHtmlUrl":455},"references\u002Fopencode\u002Fcommands\u002Fstory-long-scan.md",232,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fopencode\u002Fcommands\u002Fstory-long-scan.md",{"path":457,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":458,"sourceHtmlUrl":459},"references\u002Fopencode\u002Fcommands\u002Fstory-long-write.md",200,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fopencode\u002Fcommands\u002Fstory-long-write.md",{"path":461,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":462,"sourceHtmlUrl":463},"references\u002Fopencode\u002Fcommands\u002Fstory-review.md",212,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fopencode\u002Fcommands\u002Fstory-review.md",{"path":465,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":466,"sourceHtmlUrl":467},"references\u002Fopencode\u002Fcommands\u002Fstory-setup.md",322,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fopencode\u002Fcommands\u002Fstory-setup.md",{"path":469,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":470,"sourceHtmlUrl":471},"references\u002Fopencode\u002Fcommands\u002Fstory-short-analyze.md",209,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fopencode\u002Fcommands\u002Fstory-short-analyze.md",{"path":473,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":474,"sourceHtmlUrl":475},"references\u002Fopencode\u002Fcommands\u002Fstory-short-scan.md",215,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fopencode\u002Fcommands\u002Fstory-short-scan.md",{"path":477,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":478,"sourceHtmlUrl":479},"references\u002Fopencode\u002Fcommands\u002Fstory-short-write.md",192,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fopencode\u002Fcommands\u002Fstory-short-write.md",{"path":481,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":482,"sourceHtmlUrl":483},"references\u002Fopencode\u002Fcommands\u002Fstory.md",243,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fopencode\u002Fcommands\u002Fstory.md",{"path":485,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":486,"sourceHtmlUrl":487},"references\u002Fopencode\u002Fopencode.json.patch",111,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fopencode\u002Fopencode.json.patch",{"path":489,"resourceType":328,"resourceTypeDesc":329,"sizeBytes":490,"sourceHtmlUrl":491},"references\u002Fopencode\u002Fplugin.ts",7545,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fopencode\u002Fplugin.ts",{"path":493,"resourceType":328,"resourceTypeDesc":329,"sizeBytes":494,"sourceHtmlUrl":495},"references\u002Fopencode\u002Fpre-commit.sh",4440,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fopencode\u002Fpre-commit.sh",{"path":497,"resourceType":328,"resourceTypeDesc":329,"sizeBytes":334,"sourceHtmlUrl":498},"references\u002Fopencode\u002Fstory_hook_core.js","https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fopencode\u002Fstory_hook_core.js",{"path":500,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":501,"sourceHtmlUrl":502},"references\u002Freasonix\u002FAGENTS.md.tmpl",4274,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Freasonix\u002FAGENTS.md.tmpl",{"path":504,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":31,"sourceHtmlUrl":505},"references\u002Ftemplates\u002F.gitkeep","https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Ftemplates\u002F.gitkeep",{"path":507,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":508,"sourceHtmlUrl":509},"references\u002Ftemplates\u002Fagents\u002Fchapter-extractor.md",20140,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Ftemplates\u002Fagents\u002Fchapter-extractor.md",{"path":511,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":512,"sourceHtmlUrl":513},"references\u002Ftemplates\u002Fagents\u002Fcharacter-designer.md",9343,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Ftemplates\u002Fagents\u002Fcharacter-designer.md",{"path":515,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":516,"sourceHtmlUrl":517},"references\u002Ftemplates\u002Fagents\u002Fconsistency-checker.md",11458,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Ftemplates\u002Fagents\u002Fconsistency-checker.md",{"path":519,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":520,"sourceHtmlUrl":521},"references\u002Ftemplates\u002Fagents\u002Fnarrative-writer.md",15819,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Ftemplates\u002Fagents\u002Fnarrative-writer.md",{"path":523,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":524,"sourceHtmlUrl":525},"references\u002Ftemplates\u002Fagents\u002Fstory-architect.md",12135,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Ftemplates\u002Fagents\u002Fstory-architect.md",{"path":527,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":528,"sourceHtmlUrl":529},"references\u002Ftemplates\u002Fagents\u002Fstory-explorer.md",22086,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Ftemplates\u002Fagents\u002Fstory-explorer.md",{"path":531,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":532,"sourceHtmlUrl":533},"references\u002Ftemplates\u002Fagents\u002Fstory-researcher.md",12381,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Ftemplates\u002Fagents\u002Fstory-researcher.md",{"path":535,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":402,"sourceHtmlUrl":536},"references\u002Ftemplates\u002FCLAUDE.md.tmpl","https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Ftemplates\u002FCLAUDE.md.tmpl",{"path":538,"resourceType":328,"resourceTypeDesc":329,"sizeBytes":539,"sourceHtmlUrl":540},"references\u002Ftemplates\u002Fhooks\u002Fcheck-prose-after-write.sh",6103,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Ftemplates\u002Fhooks\u002Fcheck-prose-after-write.sh",{"path":542,"resourceType":328,"resourceTypeDesc":329,"sizeBytes":543,"sourceHtmlUrl":544},"references\u002Ftemplates\u002Fhooks\u002Fdetect-story-gaps.sh",7213,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Ftemplates\u002Fhooks\u002Fdetect-story-gaps.sh",{"path":546,"resourceType":328,"resourceTypeDesc":329,"sizeBytes":547,"sourceHtmlUrl":548},"references\u002Ftemplates\u002Fhooks\u002Fguard-outline-before-prose.sh",12112,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Ftemplates\u002Fhooks\u002Fguard-outline-before-prose.sh",{"path":550,"resourceType":328,"resourceTypeDesc":329,"sizeBytes":551,"sourceHtmlUrl":552},"references\u002Ftemplates\u002Fhooks\u002Flib\u002Fcommon.sh",7878,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Ftemplates\u002Fhooks\u002Flib\u002Fcommon.sh",{"path":554,"resourceType":328,"resourceTypeDesc":329,"sizeBytes":555,"sourceHtmlUrl":556},"references\u002Ftemplates\u002Fhooks\u002Flib\u002Fsentinel.sh",1510,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Ftemplates\u002Fhooks\u002Flib\u002Fsentinel.sh",{"path":558,"resourceType":328,"resourceTypeDesc":329,"sizeBytes":559,"sourceHtmlUrl":560},"references\u002Ftemplates\u002Fhooks\u002Fpost-compact.sh",698,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Ftemplates\u002Fhooks\u002Fpost-compact.sh",{"path":562,"resourceType":328,"resourceTypeDesc":329,"sizeBytes":563,"sourceHtmlUrl":564},"references\u002Ftemplates\u002Fhooks\u002Fpre-compact.sh",1040,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Ftemplates\u002Fhooks\u002Fpre-compact.sh",{"path":566,"resourceType":328,"resourceTypeDesc":329,"sizeBytes":567,"sourceHtmlUrl":568},"references\u002Ftemplates\u002Fhooks\u002Fsession-end.sh",946,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Ftemplates\u002Fhooks\u002Fsession-end.sh",{"path":570,"resourceType":328,"resourceTypeDesc":329,"sizeBytes":571,"sourceHtmlUrl":572},"references\u002Ftemplates\u002Fhooks\u002Fsession-start.sh",11001,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Ftemplates\u002Fhooks\u002Fsession-start.sh",{"path":574,"resourceType":328,"resourceTypeDesc":329,"sizeBytes":575,"sourceHtmlUrl":576},"references\u002Ftemplates\u002Fhooks\u002Fstory_hook_cli.js",8562,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Ftemplates\u002Fhooks\u002Fstory_hook_cli.js",{"path":578,"resourceType":328,"resourceTypeDesc":329,"sizeBytes":334,"sourceHtmlUrl":579},"references\u002Ftemplates\u002Fhooks\u002Fstory_hook_core.js","https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Ftemplates\u002Fhooks\u002Fstory_hook_core.js",{"path":581,"resourceType":328,"resourceTypeDesc":329,"sizeBytes":582,"sourceHtmlUrl":583},"references\u002Ftemplates\u002Fhooks\u002Fvalidate-story-commit.sh",6508,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Ftemplates\u002Fhooks\u002Fvalidate-story-commit.sh",{"path":585,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":586,"sourceHtmlUrl":587},"references\u002Ftemplates\u002Frules\u002Fstory-consistency.md",2761,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Ftemplates\u002Frules\u002Fstory-consistency.md",{"path":589,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":590,"sourceHtmlUrl":591},"references\u002Ftemplates\u002Frules\u002Fstory-format.md",3248,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Ftemplates\u002Frules\u002Fstory-format.md",{"path":593,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":594,"sourceHtmlUrl":595},"references\u002Ftemplates\u002Frules\u002Fstory-narrative.md",2974,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Ftemplates\u002Frules\u002Fstory-narrative.md",{"path":597,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":598,"sourceHtmlUrl":599},"references\u002Ftemplates\u002Frules\u002Fstory-outline.md",6374,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Ftemplates\u002Frules\u002Fstory-outline.md",{"path":601,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":602,"sourceHtmlUrl":603},"references\u002Ftemplates\u002Fsettings-hooks.json",2025,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Ftemplates\u002Fsettings-hooks.json",{"path":605,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":606,"sourceHtmlUrl":607},"references\u002Fzcode\u002FAGENTS.md.tmpl",3220,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fzcode\u002FAGENTS.md.tmpl",{"path":609,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":610,"sourceHtmlUrl":611},"references\u002Fzcode\u002Fcommands\u002Fbrowser-cdp.md",221,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fzcode\u002Fcommands\u002Fbrowser-cdp.md",{"path":613,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":614,"sourceHtmlUrl":615},"references\u002Fzcode\u002Fcommands\u002Fstory-cover.md",204,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fzcode\u002Fcommands\u002Fstory-cover.md",{"path":617,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":618,"sourceHtmlUrl":619},"references\u002Fzcode\u002Fcommands\u002Fstory-deslop.md",234,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fzcode\u002Fcommands\u002Fstory-deslop.md",{"path":621,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":458,"sourceHtmlUrl":622},"references\u002Fzcode\u002Fcommands\u002Fstory-import.md","https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fzcode\u002Fcommands\u002Fstory-import.md",{"path":624,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":625,"sourceHtmlUrl":626},"references\u002Fzcode\u002Fcommands\u002Fstory-long-analyze.md",218,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fzcode\u002Fcommands\u002Fstory-long-analyze.md",{"path":628,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":629,"sourceHtmlUrl":630},"references\u002Fzcode\u002Fcommands\u002Fstory-long-scan.md",206,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fzcode\u002Fcommands\u002Fstory-long-scan.md",{"path":632,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":633,"sourceHtmlUrl":634},"references\u002Fzcode\u002Fcommands\u002Fstory-long-write.md",202,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fzcode\u002Fcommands\u002Fstory-long-write.md",{"path":636,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":637,"sourceHtmlUrl":638},"references\u002Fzcode\u002Fcommands\u002Fstory-review.md",216,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fzcode\u002Fcommands\u002Fstory-review.md",{"path":640,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":641,"sourceHtmlUrl":642},"references\u002Fzcode\u002Fcommands\u002Fstory-setup.md",363,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fzcode\u002Fcommands\u002Fstory-setup.md",{"path":644,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":450,"sourceHtmlUrl":645},"references\u002Fzcode\u002Fcommands\u002Fstory-short-analyze.md","https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fzcode\u002Fcommands\u002Fstory-short-analyze.md",{"path":647,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":648,"sourceHtmlUrl":649},"references\u002Fzcode\u002Fcommands\u002Fstory-short-scan.md",217,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fzcode\u002Fcommands\u002Fstory-short-scan.md",{"path":651,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":614,"sourceHtmlUrl":652},"references\u002Fzcode\u002Fcommands\u002Fstory-short-write.md","https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fzcode\u002Fcommands\u002Fstory-short-write.md",{"path":654,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":610,"sourceHtmlUrl":655},"references\u002Fzcode\u002Fcommands\u002Fstory.md","https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fzcode\u002Fcommands\u002Fstory.md",{"path":657,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":658,"sourceHtmlUrl":659},"references\u002Fzcode\u002Fconfig.json.patch",1698,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fzcode\u002Fconfig.json.patch",{"path":661,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":662,"sourceHtmlUrl":663},"references\u002Fzcode\u002Fhooks\u002Fhooks.json",1623,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fzcode\u002Fhooks\u002Fhooks.json",{"path":665,"resourceType":328,"resourceTypeDesc":329,"sizeBytes":334,"sourceHtmlUrl":666},"references\u002Fzcode\u002Fhooks\u002Fstory_hook_core.js","https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fzcode\u002Fhooks\u002Fstory_hook_core.js",{"path":668,"resourceType":328,"resourceTypeDesc":329,"sizeBytes":669,"sourceHtmlUrl":670},"references\u002Fzcode\u002Fhooks\u002Fstory_zcode_hook.js",6895,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Freferences\u002Fzcode\u002Fhooks\u002Fstory_zcode_hook.js",{"path":672,"resourceType":328,"resourceTypeDesc":329,"sizeBytes":673,"sourceHtmlUrl":674},"scripts\u002Fcopy-path-safety.py",3155,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Fscripts\u002Fcopy-path-safety.py",{"path":676,"resourceType":328,"resourceTypeDesc":329,"sizeBytes":677,"sourceHtmlUrl":678},"scripts\u002Fdeploy-antigravity-skills.py",4633,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Fscripts\u002Fdeploy-antigravity-skills.py",{"path":680,"resourceType":328,"resourceTypeDesc":329,"sizeBytes":681,"sourceHtmlUrl":682},"scripts\u002Fgenerate-antigravity-agents.mjs",12336,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Fscripts\u002Fgenerate-antigravity-agents.mjs",{"path":684,"resourceType":328,"resourceTypeDesc":329,"sizeBytes":685,"sourceHtmlUrl":686},"scripts\u002Fmerge-antigravity-hooks.py",2360,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Fscripts\u002Fmerge-antigravity-hooks.py",{"path":688,"resourceType":328,"resourceTypeDesc":329,"sizeBytes":689,"sourceHtmlUrl":690},"scripts\u002Fmerge-claude-settings.py",4743,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Fscripts\u002Fmerge-claude-settings.py",{"path":692,"resourceType":328,"resourceTypeDesc":329,"sizeBytes":693,"sourceHtmlUrl":694},"scripts\u002Fmerge-codex-hooks.py",5316,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002Fscripts\u002Fmerge-codex-hooks.py",{"path":696,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":697,"sourceHtmlUrl":698},"UPGRADING.md",23766,"https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-setup\u002FUPGRADING.md",[700,707,714,721,728,735],{"skillNo":701,"name":702,"nameZh":6,"description":703,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":704,"categories":705,"keywords":706,"publishedAt":19},"01M79HBH6R2ZBZ4QR6HYVTHKW1","story","网络小说工具箱主入口。根据用户需求自动路由到对应 skill，并可管理作者习惯、启动本地 Dashboard。触发方式：\u002Fstory、$story、\u002Fstory dashboard、\u002F网文、「我想写小说」「记住我的写作习惯」「打开工作台」「检查更新」。","https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory\u002FSKILL.md",[],[],{"skillNo":708,"name":709,"nameZh":6,"description":710,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":711,"categories":712,"keywords":713,"publishedAt":19},"01M79HBE0HBW1NRTRZYYNAASHJ","story-short-write","短篇网文写作。辅助短篇小说创作，从构思到成稿，聚焦情绪拉扯与节奏把控。触发方式：\u002Fstory-short-write、\u002F写短篇、「帮我写一篇短篇」「写个盐言故事」。","https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-short-write\u002FSKILL.md",[],[],{"skillNo":715,"name":716,"nameZh":6,"description":717,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":718,"categories":719,"keywords":720,"publishedAt":19},"01M79HBB199M9X0GG3CYDMCFJW","story-short-scan","短篇网文扫榜。分析知乎盐言、七猫、黑岩、点众等平台热门短篇数据，捕捉风口题材。触发方式：\u002Fstory-short-scan、\u002F短篇扫榜、「短篇什么火」「知乎故事排行」。","https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-short-scan\u002FSKILL.md",[],[],{"skillNo":722,"name":723,"nameZh":6,"description":724,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":725,"categories":726,"keywords":727,"publishedAt":19},"01M79HB5TJ581H9R59S9D60CGQ","story-short-analyze","短篇网文拆文。拆解爆款短篇小说（番茄短篇 \u002F 故事会 \u002F 知乎盐选 \u002F 追妻 \u002F 世情 \u002F 重生 \u002F 虐渣等通俗题材）的故事核、结构、情感线、反转设计、写作手法、共鸣层次。单一全量拆解管道：跑完 Stage 2-6 产出完整拆文报告，落盘到 拆文库\u002F{书名}\u002F，下游 story-short-write 同时读拆文报告 + 情节节点 + 写作手法 + 原文 + _meta.json 写下一篇。触发方式：\u002Fstory-short-analyze、\u002F短篇拆文、「拆短篇」「拆这篇短文」「短篇拆文」「精细拆解短篇」「8000 字短篇拆解」「番茄短篇拆文」「故事会拆解」「盐言故事拆解」「分析这篇短篇」——均进入同一管道。","https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-short-analyze\u002FSKILL.md",[],[],{"skillNo":729,"name":730,"nameZh":6,"description":731,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":732,"categories":733,"keywords":734,"publishedAt":19},"01M79HATE01XBQ2VXY7C22DYQM","story-review","多视角对抗式审查。full\u002Flean 模式在已部署 reviewer agents 时并行 spawn；缺失\u002F异常 agents 或 spawn 失败时自动降级 solo，参考文件不可读时使用内置 rubric fallback。触发方式：\u002Fstory-review、\u002F审查、「审查一下」「帮我审一下」。","https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-review\u002FSKILL.md",[],[],{"skillNo":736,"name":737,"nameZh":6,"description":738,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":739,"categories":740,"keywords":741,"publishedAt":19},"01M79HAP6939AMG1PA8PAZ9555","story-relationship","生成或更新当前作品的人物关系蛛网图。分析人物卡、章节正文、作品记忆和当前关系图，输出结构化的 relationship_graph 数据。触发方式：\u002Fstory-relationship、\u002F人物关系图、「更新人物关系图」「生成人物关系图」「角色关系」。","https:\u002F\u002Fgithub.com\u002Frtiy1\u002FYeMuAINoval\u002Fblob\u002Fmaster\u002Fskills\u002Fstory-relationship\u002FSKILL.md",[],[]]