中文 · English

面向智能体（以 Codex 为例）的中文小说项目一键搭建 Skill
把一句灵感或已有简介扩展成字段齐全、前后一致、可直接建书的小说资料包。

create-novel-package 是一个可供支持 Skills 的智能体使用的中文小说立项 Skill。它可以接收一句话灵感、故事梗概、人物设定或更完整的创作要求，一次生成封面方案、视角、标题、简介、主角、核心设计、开篇、大纲和标签。

安装后，你可以直接提出：

使用 $create-novel-package，搭建一个“落魄配音演员通过声音修复旧城记忆”的
完整小说项目。保留现实题材，不要系统和爱情线。

• 从一句话自动补足人物目标、核心阻力、世界规则和长篇推进机制。
• 沿着用户已有简介继续扩展，不偷换人物、关系、题材或结局方向。
• 按固定顺序生成可直接复制到建书表单的完整字段。
• 让标题、简介、人物设定、开篇和大纲共同兑现同一个故事承诺。
• 设计“事件—选择—后果”相连的大纲，而不是只罗列剧情名词。
• 为现实、悬疑、历史、职业、科幻和角色扮演等题材选择合适视角与节奏。
• 生成竖版封面的视觉方案、构图、色彩、生图提示词和负面提示词。
• 检查篇幅、字段完整性、硬约束、人物弧、伏笔和因果一致性。

• 第一次使用：阅读安装与在智能体中调用。
• 想了解 Skill 如何工作：阅读项目结构。
• 想复核实际输出：阅读能力验证。
• 准备发布到 GitHub：阅读 GitHub 发布资料清单。
• 想参与改进：阅读贡献指南。
• 发现问题：提交 GitHub Issue。

在支持 Skills 的智能体中提出：

请把 https://github.com/muxia0396/create-novel-package-skill
里的 create-novel-package Skill 安装到我当前使用的智能体。

智能体会按自身的 Skill 机制完成安装。不同智能体的目录位置和重新加载方式可能不同。

Windows PowerShell：

New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex\skills" | Out-Null
Copy-Item -Recurse -Force ".\create-novel-package" "$env:USERPROFILE\.codex\skills\"

macOS 或 Linux：

mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
cp -R ./create-novel-package "${CODEX_HOME:-$HOME/.codex}/skills/"

以 Codex 为例，安装后新建一个任务，使 Skill 列表重新载入。

用户只需复制 create-novel-package/。评测、贡献说明和发布文档不属于运行时安装内容。

可以显式调用：

使用 $create-novel-package：一个月球维修工发现，每修好一次基地故障，
地球上关于她的一段记忆就会消失。

也可以直接描述任务：

保留下面简介的原意，继续补齐封面、人物设定、核心内容、开篇和十二章大纲：
……

更多可尝试的请求：

• “把‘县城修鞋匠参加国际设计大赛’搭建成现实成长小说项目。”
• “第二人称，十二章完结，无爱情线，结局不能洗白对手。”
• “标题必须保留，开篇控制在 800 字，大纲按三卷组织。”
• “这是我已经写好的简介，请只补充缺失因果，不要改变人物关系。”

默认依次生成：

1. 封面方案
2. 视角
3. 故事标题
4. 简介
5. 主角姓名
6. 主角设定
7. 故事核心内容设计
8. 开篇
9. 大纲
10. 标签

用户只要求其中一个字段时，Skill 会只交付对应字段；用户只给灵感或要求“一键搭建”时，生成完整资料包。

.
├── create-novel-package/           # 可直接安装的 Skill
│   ├── SKILL.md                    # 触发描述与核心工作流
│   ├── agents/
│   │   └── openai.yaml             # 智能体界面元数据
│   └── references/
│       ├── field-contract.md       # 字段顺序、篇幅与输出契约
│       ├── story-design.md         # 人物、冲突、世界、开篇与大纲方法
│       ├── quality-checklist.md    # 交付前一致性检查
│       └── examples.md             # 稀疏与丰富输入的处理示例
├── comparison-test/
│   ├── prompts.md                  # 六条固定测试问题
│   └── rubric.md                   # 公开复核维度
├── create-novel-package-test-report.md  # 问题与完整调用结果
├── docs/
│   ├── EVALUATION.md               # 评测范围、方法与局限
│   └── GITHUB_PUBLISHING.md        # GitHub 发布资料清单
├── tests/
│   └── test_repository.py          # 结构、字段和敏感内容检查
├── .github/                        # Issue、PR 与 CI 配置
├── CONTRIBUTING.md
├── SECURITY.md
├── NOTICE
└── LICENSE

Skill 采用渐进式加载：智能体先看到名称和触发描述，触发后读取 SKILL.md，再按任务需要读取具体参考文件。这样既控制上下文长度，也保留完整的小说立项方法。

运行仓库测试：

python -m unittest discover -s tests -v

如果本机可用 Codex 官方 skill-creator，还可以运行其 quick_validate.py 校验 create-novel-package/。

当前固定题集包含 6 条任务，覆盖一句话扩展、已有简介延展、第二人称与十二章硬约束、职业科幻、历史现实题材，以及指定标题、身份、禁区和结局方向。

公开材料采用“问题—调用 Skill 给出的答案”的纵向结构。请阅读固定题集调用结果，并结合评测说明自行复核。当前材料展示真实运行结果，不宣称能代表所有模型、智能体或题材。

欢迎提交问题、测试题、参考规则和文档改进。涉及 Skill 行为的修改，请说明目标失败模式，并尽量补充可复现问题。

提交 Pull Request 前请阅读 CONTRIBUTING.md。

本项目原创的 Skill 指令、参考文件、测试和项目文档采用 Apache License 2.0。

用户稿件、生成结果、私有研究材料、个人数据和其他第三方内容不因进入本项目工作流而自动获得本许可证授权。公开贡献前请确认拥有相应权利，并移除隐私信息。具体说明见 NOTICE。

感谢所有参与测试、报告失败模式和改进小说创作工作流的人。