메뉴
Codex 网文写作项目初始化。将 AGENTS.md、story rules、角色提示词参考、Codex custom agents、Codex hooks 和 agent reference bundle 部署到用户写作项目目录。 触发方式：/story-setup、$story-setup、「准备写书」「帮我搭一下环境」「配置写作项目」「初始化写作项目」
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
小说封面生成。根据书名、作者名自动分析题材风格，调用 GPT-Image-2 直接生成含标题和署名的专业级网文封面。触发方式：/story-cover、/封面、「帮我做个封面」「生成封面图」「做个小说封面」「封面设计」。
网文去AI味。检测并清除文本中的AI写作痕迹，让文字回归自然、非模板化。触发方式：/story-deslop、/去AI味、「去AI味」「这篇太AI了」「网文去AI味」。
逆向导入已有小说。将已写好的小说（半成品或完本）反向解析为标准项目目录结构，兼容 story-long-write / story-short-write 后续写作流程；内部复用 story-long-analyze / story-short-analyze 的拆解管道，按篇幅自动分流。触发方式：/story-import、「导入小说」「反向解析」「导入」「把我的书导进来」。
长篇网文拆文。深度拆解爆款长篇小说的黄金三章、人设架构、爽点设计、节奏控制。单一深度拆解管道：跑完黄金三章（Stage 1）后产出快速预览报告并询问是否继续全量拆解，确认后从 Stage 2 续跑逐章摘要、聚合分析、设定关系、汇总报告，全程产物落盘 拆文库/{书名}/。触发方式：/story-long-analyze、/长篇拆文、「帮我拆这本书」「拆这本书」「分析黄金三章」「深度拆解」「完整拆解」「系统拆解」或提供小说文本文件路径——全部进入同一管道。
长篇网文扫榜。分析起点、番茄、晋江等平台排行榜数据，提炼市场趋势与热门题材。触发方式：/story-long-scan、/长篇扫榜、「长篇什么火」「起点排行」。
长篇网文写作。从大纲到正文，辅助长篇网络小说的创作，包括世界观、人物、情节线管理。触发方式：/story-long-write、/写长篇、「帮我开书」「写大纲」「日更」「续写」「继续写」「修改第X章」「回炉」「重写第X章」。
| name | story-setup |
| description | Codex 网文写作项目初始化。将 AGENTS.md、story rules、角色提示词参考、Codex custom agents、Codex hooks 和 agent reference bundle 部署到用户写作项目目录。 触发方式：/story-setup、$story-setup、「准备写书」「帮我搭一下环境」「配置写作项目」「初始化写作项目」 |
你是写作基础设施部署器。把网文写作项目需要的项目规则、角色提示词、Codex custom agents、Codex hooks、agent 参考资料副本和上下文模板部署到用户项目目录。
执行铁律：不覆盖用户已有配置，合并而非替换。
.story-deployed）。
追踪/ 子目录的目录，或用户自定义结构）。
AGENTS.md。
.active-book 文件是否存在。
.codex/、.codex/agents/、.codex/hooks.json 是否存在。
.codex/ 目录树。向用户确认部署位置后，依次执行。
| Source path | Target path | Owner class | Merge mode | Validation check |
|---|---|---|---|---|
references/codex/AGENTS.md.tmpl | AGENTS.md | user+managed | section/marker merge | 包含 Codex skill 路由、文件结构、上下文恢复规则 |
references/templates/rules/*.md | .codex/story-rules/*.md | story-setup managed | replace | 规则文件完整，且包含 paths frontmatter |
references/templates/agents/*.md | .codex/story-agents/*.md | story-setup managed | replace | 7 个角色提示词完整，frontmatter 只保留 Codex 可读字段 |
references/codex/agents/*.toml | .codex/agents/*.toml | story-setup managed | replace | 7 个 TOML custom agents 可解析，包含 name、description、developer_instructions |
references/codex/hooks/hooks.json | .codex/hooks.json | user+managed | merge by hook command | JSON 有效，hook command 去重合并 |
references/codex/hooks/story_codex_hook.py | .codex/hooks/story_codex_hook.py | story-setup managed | replace | Python 语法有效，UTF-8 stdin/stdout |
references/agent-references/*.md | .codex/story-agent-references/*.md | story-setup managed | replace | legacy 参考提示词可读 |
references/agent-references/*.md | .codex/skills/story-setup/references/agent-references/*.md | story-setup managed | replace | Codex custom agents 的项目内主参考路径完整 |
references/templates/上下文.md.tmpl | {书名}/追踪/上下文.md | user state | create only if absent | 不覆盖用户已有写作上下文 |
| generated sentinel | .story-deployed | story-setup managed | replace | 包含 runtime: codex、agents_version: 17、setup_skill_version: 1.2.6 |
references/codex/AGENTS.md.tmpl。AGENTS.md；如已存在，按「AGENTS.md 合并策略」处理。references/templates/rules/ 下所有 .md 文件。.codex/story-rules/ 目录。references/templates/agents/ 下所有 .md 文件。.codex/story-agents/ 目录。story-setup/references/agent-references/*.md，这是本 skill 自带的参考资料副本；不要跨 skill 读取其他 skill 的 references，也不要只写裸文件名。references/codex/agents/ 下所有 .toml 文件。.codex/agents/ 目录。name、description、developer_instructions。chapter-extractor、consistency-checker、story-explorer）必须保留 sandbox_mode = "read-only"。.codex/ 配置层需要被 trust；部署后需要新会话/刷新后才可能稳定暴露给 spawn。若运行时返回 unknown agent_type，调用方必须降级 solo/direct 并报告 fallback。references/codex/hooks/hooks.json。.codex/hooks.json（如存在），保留未知字段。command 去重追加；每个 hook 同时携带 command（POSIX sh）与 commandWindows（Windows cmd）两个字段，整体保留不要拆开。references/codex/hooks/story_codex_hook.py 到 .codex/hooks/story_codex_hook.py。.codex/ 层需要被 Codex trust，非 managed command hooks 还需要在 /hooks 中 review/trust 后才会运行。references/agent-references/ 下所有 .md 复制到 .codex/story-agent-references/，作为 legacy 参考提示词可读副本。.codex/skills/story-setup/references/agent-references/，作为 Codex custom agents 的项目内主路径。.codex/story-agents/*.md、.codex/agents/*.toml 或 reference 中出现 story-setup/references/agent-references/<file>.md，源包与目标包都必须存在 <file>.md。output-templates.md 不复制；chapter-extractor 已内置输出格式，遵循本文件「输出格式」章节即可。references/templates/上下文.md.tmpl。{书名}/追踪/ 已存在，复制到 {书名}/追踪/上下文.md。追踪/ 目录。创建 .story-deployed，写入：
deployed_at: <date -u +"%Y-%m-%dT%H:%M:%SZ">
runtime: codex
agents_version: 17
setup_skill_version: 1.2.6
resolver_strategy: codex-project-reference
references_dir: .codex/skills/story-setup/references/agent-references
如果 .story-deployed 已存在但无 agents_version 或版本小于 17，提示用户重新运行 /story-setup 以更新 story agents、Codex custom agents、hooks、rules 和 reference bundle（具体变更见 UPGRADING.md）。
AGENTS.md 是否存在，且包含 Codex skill 路由、文件结构、上下文恢复规则。.codex/story-rules/ 是否存在并包含规则文件。.codex/story-agents/ 是否存在并包含 7 个角色提示词。.codex/agents/ 是否存在并包含 7 个 TOML custom agents，且 TOML 可解析。.codex/hooks.json 和 .codex/hooks/story_codex_hook.py 是否存在，JSON/Python 语法有效。.codex/story-agent-references/ 和 .codex/skills/story-setup/references/agent-references/ 是否存在，且包含所有 agent 模板引用的参考文件。.story-deployed 是否存在且 runtime: codex、agents_version: 17、setup_skill_version: 1.2.6。.codex/ 配置，以及“新开 Codex 会话后 custom agents 才稳定可用”的提示。| 占位符 | 替换规则 | 示例 |
|---|---|---|
{项目名} | 用户项目名称或目录名 | 《剑来》、《暗卫》 |
{书名} | 书名目录名 | 与 {项目名} 相同，或用户自定义 |
{目标平台} | 目标发布平台 | 起点、番茄、晋江、知乎盐言 |
{作者名} | 用户笔名或昵称 | 未指定时用「作者」 |
替换时去掉花括号。如果用户未指定项目名，用当前目录名。未指定占位符保留原样。
用户已有 AGENTS.md 时，按 marker/section 合并：
AGENTS.md，按 ## 标题切分为 section map。references/codex/AGENTS.md.tmpl，同样切分。.story-deployed 不存在：全新安装，Phase 2 全部执行。.story-deployed 存在且 runtime: codex、agents_version: 17：提示已部署，确认后重跑。.story-deployed 存在且 runtime: codex、agents_version 小于 17：提示需要重新部署以更新 Codex custom agents、hooks、rules 和 reference bundle。.story-deployed 存在但 runtime 不是 codex：按迁移处理，部署 Codex 目录，不删除用户原有目录。本仓作为 Codex 插件安装时，还会通过 .codex-plugin/plugin.json 加载仓库根 hooks/story-lifecycle-hook.cjs。该插件 hook 用于全局写作项目上下文注入、正文前置检查和提交提醒；/story-setup 部署的 .codex/hooks/story_codex_hook.py 是项目级 hook，适用于希望把 hook 配置随写作项目一并落盘的场景。
| 文件 | 用途 |
|---|---|
references/codex/AGENTS.md.tmpl | Codex 项目根 AGENTS.md 模板 |
references/codex/agents/ | Codex custom agent TOML 模板 |
references/codex/hooks/hooks.json | Codex hooks 注册模板 |
references/codex/hooks/story_codex_hook.py | Codex hook adapter |
references/templates/rules/ | 写作规则参考 |
references/templates/agents/ | 7 个角色提示词参考 |
references/agent-references/ | agent 模板自带的参考资料副本，避免跨 skill references |
references/templates/上下文.md.tmpl | 写作上下文模板 |
UPGRADING.md | 已部署项目重新运行 /story-setup 时的升级策略和版本说明 |
流水线： 部署 位置： 初始化（最前置）
| 时机 | 跳转到 | 命令 |
|---|---|---|
| 部署完成，开始长篇写作 | story-long-write | /story-long-write 或 $story-long-write |
| 部署完成，开始短篇写作 | story-short-write | /story-short-write 或 $story-short-write |
| 导入已有小说做拆解 | story-import | /story-import 或 $story-import |
| 需要浏览器登录态（扫榜/拆文取原文） | browser-cdp | /browser-cdp 或 $browser-cdp |