Novel Characters Skill：把小说拆成角色卡、三视图与可交互报告

小说作者、短剧编剧、编辑和角色设计师可以把 Novel Characters Skill 接入 Codex 或 Claude Code，用一份小说或短故事生成角色表、带逐字证据的人物画像、关系网、形象与音色提示词，以及可验证的 JSON、Markdown、离线交互报告和可选角色设定图；这页说明如何安装、输入、验收，并判断它适合哪种创作交接。

技能概览

这项 skill 不是一段孤立的角色提示词，而是一条有确定性脚本和校验门槛的生产管线。它先把长文本分块扫描，再按名字与别名归并角色，针对主要人物生成完整卡片，最后检查引文、字段语言、图像提示词和风格预设是否守约。图像生成是可选步骤；即使没有可用的 Codex 图像能力，文本分析、提示词、数据文件与报告仍可交付。

能力定位

它位于“原始小说”和“可交给编剧、美术、配音或游戏团队的角色圣经”之间。写作团队可以用它整理人物关系与弧光，视觉团队可以复用英文形象提示词和角色设定图，音频团队可以接收音高、语速、口音与情绪等 voice-design 字段。下一步不是继续泛聊人物，而是安装 skill、给出原文路径、指定报告语言与画风，再用原文和校验器审核结果。

适合谁

• 小说作者与编辑：为长篇修订建立统一角色表，识别别名、关系冲突、人物动机和缺失证据。
• 短剧与影视开发团队：把原作人物转换成便于选角、服化道、分镜和配音沟通的结构化角色档案。
• 游戏叙事与美术团队：从故事文本生成角色关系、外观约束、三视图需求和可继续修改的数据文件。
• 有声书与语音设计人员：获取英文 voice-design prompt，同时保留原文引文与目标语言的人类可读说明。

获取与安装链接

Skill 页面：novel-characters GitHub 子目录。仓库采用 Apache-2.0 许可，skill 自身零 npm 依赖；Node 18 或更高版本是必需条件，Codex 只在生成角色设定图时需要。

git clone https://github.com/eternityspring/shuohao-skills.git
cd shuohao-skills
./scripts/install.sh novel-characters

安装脚本会检测 Claude Code 或 Codex，并把对应 skill 软链接到本地 skills 目录。只想安装到 Codex 时，可执行 ./scripts/install.sh --codex；手动安装也可以把 skills/novel-characters 链接到 ~/.codex/skills/novel-characters。

安装与配置步骤

1. 确认运行环境：准备 Node 18+、可读的小说文本文件和具备文件读写能力的 Agent；若需要设定图，再确认 Codex 图像能力可用。
2. 安装并验证：克隆仓库，运行单 skill 安装命令，再检查 SKILL.md、scripts/、references/、examples/ 与 assets/ 是否完整。
3. 锁定语言与画风：默认报告语言为中文、画风为 realistic；可用 --lang en、--lang ja 或其他语言，并用 --style ghibli 切换整套风格预设。
4. 运行并验收：让 skill 读取原文、分块、归并、出卡，然后执行 validate。只有校验通过后，才渲染 Markdown、HTML 和可选角色设定图。

示例输入

把方括号变量替换成你有权读取的本地文件路径。下面三种输入覆盖默认中文报告、多语言交付和动画画风三类常见任务。

/novel-characters [novel file]

/novel-characters [novel file] --lang en

/novel-characters [novel file] --style ghibli

预期输出

• 结构化角色数据：[book name]-cast.json 保存故事摘要、报告语言、画风和完整角色数组，可供后续工具修改后重新渲染。
• 可读报告：Markdown 适合审阅和版本控制，report.html 提供搜索、角色导航、关系图谱、详情切换与 JSON 导出。
• 人物证据与提示词：每个角色包含身份、外貌、性情、动机、人物弧光、关系、原文逐字引文、英文形象提示词和英文音色提示词。
• 可选视觉资产：每位入选角色可生成一张 16:9 角色设定图，包含半身像、正视/侧视/背视全身像和细节条。

使用场景

• 长篇小说修订：编辑用角色表和关系图检查跨章节别名、人物戏份、动机变化与证据缺口。
• 短剧改编前期：制片与编剧把原作转换成角色圣经，供选角、服化道、海报、分镜和剧本会议使用。
• 游戏叙事交接：叙事设计师把角色档案、关系和视觉约束交给概念美术、关卡编剧与配音团队。
• 有声书声音设计：制作人把音色、音高、语速、口音和情绪提示词交给 Qwen3-TTS 或 ElevenLabs Voice Design 等语音工具。

质量检查

这项 skill 的价值很大一部分来自硬校验。validate 会检查 JSON 结构与枚举、证据是否为原文连续片段、图像提示词是否错误包含人名、报告字段与提示词的语言分工，以及画风与反向提示词是否匹配。修改脚本后，还可以运行 node scripts/selftest.mjs 执行 274 项不调用模型的确定性断言。

node scripts/novel-characters.mjs validate [cast json] [novel file] --lang [language code]
node scripts/selftest.mjs

常见错误与修复

• 把转述当逐字证据：按校验报错回到原文，改成连续、未经拼接或翻译的真实片段。
• 只换画风名称：不要混用 realistic 与 ghibli 的渲染、光照和 negative prompt；应整套切换预设。
• 角色太多导致出图成本失控：在开始前限定人数，或明确只处理 protagonist 与 major 角色。

限制与注意事项

• 单次最多处理 24 个约 14k 字符的文本块，总量约 33 万字符；超过上限会明确标记 truncated，不会静默丢弃。
• 默认选择戏份最重的 30 位角色，而且每位角色单独生成设定图；角色多时，图像阶段是最慢、额度消耗最大的部分。
• 不同角色分别出图，同批画风仍可能轻微漂移。对一致性要求高时，应把第一张合格设定图作为后续参考图。
• 非中文、英文、日文的报告需要额外提供翻译后的 ui 字段；缺失时校验会阻止生成混杂语言的界面。
• 仓库说明目前只在 macOS 与 Node 24 上实测；Linux 和更低 Node 版本理论可用，但尚未验证。

相关工具与 Prompt

形象提示词可以继续交给 Midjourney、Stable Diffusion 或 GPT Image 做视觉探索，音色提示词可以进入 Qwen3-TTS 或 ElevenLabs Voice Design。更稳的做法是把这里的 JSON 作为共享真源：写作团队校正人物事实，美术团队维护外观与服饰，音频团队维护声音字段，再从同一数据重新渲染报告，而不是在多个聊天记录里复制不一致的描述。

常见问题

• Q: Novel Characters Skill 是什么，适合分析哪类文本？
  A:它是一项可安装的 Agent skill，适合小说、短故事和可完整读取的叙事文本，重点产出角色表、人物证据、提示词、数据文件与报告。
• Q: 如何让报告使用英文或日文？
  A:在任务中加入 --lang en 或 --lang ja。人类可读字段随语言切换，原文引文保持不变，图像与 TTS 提示词继续使用英文。
• Q: 没有 Codex 图像能力是否还能完成角色分析？
  A:可以。图像生成是可选步骤；角色扫描、归并、画像、提示词、校验、JSON、Markdown 与 HTML 报告都可以继续完成。
• Q: 为什么校验器要求引文必须逐字连续？
  A:因为角色结论需要可回溯证据。连续原文能阻止模型拼接对白、翻译证据或编造细节，也方便编辑快速回到小说核验。

如果你要把小说角色分析稳定接入编剧、美术、配音或游戏叙事流程，可以先用仓库自带的《渡口》样例跑通安装、校验和渲染，再换成自己的完整文本。

更多可安装能力可以浏览 AI Skills；需要继续完善文字资产时可查看 Writing & Content Creation，需要角色视觉与设定图工作流时可查看 Image & Design。

欢迎在评论区分享你的角色设定工作流，也可以关注 @bigprompt 获取更多可安装 skills、prompt systems 和 workflow assets。

Big Prompt Hub 相关文章：

Web Design Prompt: A Premium Editorial Landing-Page System

Commercial Campaign Poster Prompt for Product Hero Ads

Watercolor City Poster Prompt for Warm Summer Postcards

Paper Cut Travel Diorama Prompt for Suitcase City Posters

Skincare Advertisement Prompt for Luxury Face Cream Campaigns

Big Prompt Hub Review

Novel Characters Skill 最值得复用的部分不是“自动画一个角色”，而是把人物提取、别名归并、证据保留、跨团队提示词、结构化数据和离线报告串成一条可审计的交接链。它适合先用于有完整原文、需要角色圣经或改编前期材料的项目；若团队只要一张概念图，整条管线会显得偏重。人工判断仍应放在角色取舍、证据解释、画风一致性和最终可用性上。