小说人物档案创建工具
概述
本skill帮助小说作者创建结构化的人物角色档案，以markdown格式输出。适用于小说创作前期的人物设定阶段，确保角色设定完整、一致，为故事创作奠定基础。
快速开始
当用户需要创建人物档案时：
- 设置工作目录：访问用户工作目录，并切换到该目录
- 收集角色信息：询问用户角色的核心信息
- 选择模板类型：根据角色类型选择合适的模板
- 填充详细信息：逐步引导用户完善各个字段
- 生成markdown档案：输出格式化的markdown文档
核心工作流程
1. 确定角色类型
首先识别角色在故事中的定位：
- 主角：故事核心，需要最详细的档案
- 重要配角：关键支持角色，需要较详细档案
- 次要角色：功能性角色，需要基本档案
- 反派：对立角色，需要动机和背景深度分析
2. 信息收集顺序
按照以下逻辑顺序收集信息：
- 基础身份：姓名、年龄、性别、职业等
- 外在特征：外貌、着装、举止
- 内在特质：性格、价值观、信仰
- 背景故事：过去经历、关键事件
- 关系网络：与其他角色的联系
- 故事功能：角色弧线、目标、冲突
3. 档案结构
所有档案都包含以下核心部分：
# [角色姓名] - 角色档案
## 基本信息
- **姓名**：
- **年龄**：
- **性别**：
- **职业/身份**：
- **故事中的角色**：
## 外貌特征
- **整体印象**：
- **面部特征**：
- **身材体型**：
- **着装风格**：
- **标志性特征**：
## 性格特点
- **核心性格**：
- **优点**：
- **缺点**：
- **价值观**：
- **恐惧**：
- **渴望**：
## 背景故事
- **出身背景**：
- **关键经历**：
- **转折点**：
- **未解之谜**：
## 人物关系
- **与主角关系**：
- **重要关系人**：
- **敌对关系**：
- **情感羁绊**：
## 故事发展
- **角色目标**：
- **内在冲突**：
- **外在冲突**：
- **发展弧线**：
- **可能的结局**：
## 创作笔记
- **灵感来源**：
- **象征意义**：
- **潜在发展**：详细指南
针对不同角色类型的调整
主角模板
- 需要最完整的背景故事和内心冲突
- 详细的发展弧线规划
- 复杂的动机层次
- 参考：主角详细指南
反派模板
- 重点刻画动机的合理性
- 详细的对立逻辑
- 潜在的救赎可能性
- 参考：反派塑造指南
配角模板
- 突出功能性特点
- 简化的背景故事
- 明确的故事作用
- 参考：配角设计指南
高级技巧
角色一致性检查
创建档案后，进行以下检查：
- 动机一致性：行为是否与动机匹配
- 发展合理性：变化是否有合理铺垫
- 关系逻辑性：人物关系是否自然
- 冲突有效性：冲突是否推动故事
角色关系矩阵
对于多个角色，创建关系矩阵：
- 情感强度
- 冲突程度
- 信任等级
- 依赖关系
使用示例
示例1：创建奇幻小说主角
用户：我需要创建一个奇幻小说的主角，年轻法师，出身平凡但有特殊血统
步骤：
1. 识别为"主角"类型
2. 使用主角模板
3. 重点询问：特殊血统的设定、法师能力的限制、成长路径
4. 生成完整档案，强调魔法系统和成长弧线示例2：创建都市情感故事配角
用户：需要一个都市故事的女主角闺蜜，性格开朗但有自己的秘密
步骤：
1. 识别为"重要配角"类型
2. 使用配角模板，调整情感深度
3. 重点询问：秘密的内容、与女主的关系、独立故事线
4. 生成档案，平衡功能性和深度输出文件处理
生成的markdown档案可以：
- 直接保存为
.md文件 - 集成到小说写作软件
- 作为角色卡片打印使用
- 后续更新和迭代
常见问题
Q: 如何避免角色模板化？
A: 在每个部分加入独特细节，寻找角色的矛盾点和非常规特征。
Q: 档案应该多详细？
A: 根据角色重要性调整，主角可能需要5000+字，配角500-1000字。
Q: 如何处理角色发展？
A: 在"故事发展"部分规划多个阶段的状态变化。
参考文件
最佳实践
- 从核心概念开始：先确定角色的核心理念
- 逐步丰富细节：层层添加具体特征
- 检查逻辑一致性：确保所有元素协调
- 预留发展空间：为故事发展留有余地
- 迭代更新：随着写作进展更新档案
增强功能 (v1.1+)
概述
从v1.1版本开始，工具增加了LoreBible管理和冲突检测功能，帮助作者维护统一的故事设定宇宙。
核心功能
1. LoreBible目录管理
- 工作目录支持：使用
--workspace参数指定LoreBible工作目录 - 自动目录创建：自动创建
00_Prepare、02_LoreBible/Characters等标准目录结构 - 现有角色扫描：自动扫描和解析现有角色档案，构建角色索引
2. 冲突检测
- 重复角色检测：检测姓名重复或高度相似的角色
- 常识校验：检查年龄合理性、时间线一致性等常识错误
- 关系冲突检测：检测角色关系中的矛盾和不一致
- 冲突报告：生成详细的冲突报告和建议解决方案
3. 会话管理
- 临时文件系统：用户确认前在
00_Prepare目录保存临时档案 - 用户确认流程：交互式展示冲突，用户确认后移动到最终目录
- 会话状态持久化：支持断点续传，自动清理过期会话
4. 子代理工作流
- 任务分解：将角色创建过程分解为原子任务
- 依赖管理：自动处理任务依赖关系
- 错误恢复：任务失败时自动重试，提供详细错误报告
使用方法
命令行增强模式
# 基本用法（传统模式）
python scripts/generate_profile.py --name "张三" --age "25" --gender "男"
# 增强模式（推荐）
python scripts/generate_profile.py --name "李四" --age "30" --workspace "/path/to/lorebible"
# 跳过用户确认
python scripts/generate_profile.py --name "王五" --workspace "/path/to/lorebible" --no-confirm
# 指定模板类型
python scripts/generate_profile.py --name "赵六" --type "protagonist" --workspace "/path/to/lorebible"目录结构
工作目录/
├── 00_Prepare/ # 临时档案目录
├── 01_Research/ # 研究资料目录（可选）
└── 02_LoreBible/
├── Characters/ # 最终角色档案目录
├── Locations/ # 地点设定目录（可选）
├── Organizations/ # 组织设定目录（可选）
└── Timeline/ # 时间线目录（可选）子代理工作流
# 运行完整工作流
python scripts/subagent_orchestrator.py "/path/to/lorebible" "character_creation"
# 运行快速创建模式
python scripts/subagent_orchestrator.py "/path/to/lorebible" "quick_creation"配置文件
校验规则配置 (config/validation_rules.json)
{
"rules": [
{
"id": "age_realistic",
"name": "年龄合理性",
"description": "检查年龄是否在合理范围内",
"condition": "age.isdigit() and not (0 <= int(age) <= 150)",
"severity": "warning"
}
]
}工作流配置 (config/workflow_tasks.json)
{
"workflows": {
"character_creation": {
"name": "角色创建工作流",
"tasks": [
{
"id": "init_workspace",
"name": "初始化工作空间",
"agent_type": "lore_bible_manager"
}
]
}
}
}新脚本模块
lore_bible_manager.py- LoreBible目录管理和角色扫描conflict_detector.py- 冲突检测和常识校验profile_session.py- 会话管理和用户确认流程subagent_orchestrator.py- 子代理工作流协调
向后兼容性
- 传统模式：不指定
--workspace参数时，使用传统生成模式 - 交互模式：增强模式也支持交互式创建
- 输出文件：传统模式输出到当前目录，增强模式输出到LoreBible目录
故障排除
常见问题
- 导入错误：确保所有新脚本文件在
scripts/目录中 - 目录权限：确保工作目录有读写权限
- 配置文件缺失：
config/目录需要包含validation_rules.json和workflow_tasks.json
日志查看
启用详细日志：
import logging
logging.basicConfig(level=logging.DEBUG)未来计划
- 图形用户界面支持
- 云同步功能
- AI辅助角色生成
- 跨作品角色库管理
版本历史:
- v1.0 (初始版本): 基础角色档案生成功能
- v1.1 (当前版本): LoreBible管理、冲突检测、会话管理、子代理工作流