---
将剧本文件批量转换为游戏配置文件,通过分块处理和子代理协作确保转换质量。适用于大型剧本项目的结构化处理,支持自定义规则和验证流程。
/plugin marketplace add stallboy/claude-code-marketplace/plugin install game-dev-script-processor@thy当此命令被调用时:
设置工作目录:
参数验证:
如果没有提供参数,响应:
我将帮您将剧本文件转换为游戏配置文件。
请提供:
1. 剧本目录路径(必需)
2. 工作目录路径(可选,默认为.work)
3. 规则目录路径(可选,默认为在剧本目录下自动查找rule_*.md)
或者使用参数:
/script-to-config --script-dir Doc/剧本_md_dir --rule-dir Main/AIWork --work-dir .work
--script-dir: 剧本目录路径(必需)--rule-dir: 规则目录路径(可选)--work-dir: 工作目录路径(可选,默认为.work)--analysis: 开始处理签是否需要解析剧本格式(可选)--chunk-size: 分块大小配置(可选,默认10000)实施说明:完成此阶段后,显示剧本分析结果、找到的转换规则文件和计划处理的分块数量。
该阶段仅当用户指定了--analysis参数时才执行,否则直接跳过
script-format-analyzer代理分析剧本目录输入参数:
- 剧本目录路径
- 工作目录路径
- 输出目录路径(默认为剧本目录)
输出:
- format-specification.md(格式说明文档)
- 分析报告和统计信息
实施说明:完成此阶段后,显示格式分析结果、识别的元素类型和生成的格式说明文档位置。如果已存在有效的格式说明文档且剧本未修改,可跳过此阶段。
script-chunk-processor代理, 只传递必要参数,子代理会自行决断如何处理,如果有规则文件就不要提任何额外要求输入参数:
- 剧本文件路径
- 工作目录路径
- 分块大小配置(可选但不建议)
- 输出子目录规则
- 剧本结构分析结果(如果执行了分析阶段提供,否则不提供)
输出:
- 每个剧本文件对应的子目录
- 分块后的文件列表
实施说明:完成此阶段后,显示分块处理结果、生成的子目录结构和分块文件统计。你可以根据子代理的回报将分块文件生成列表文件存储于工作目录中,并在后续的转换过程中在该文件中标记完成情况。
输入参数:
- 分块文件路径
- 转换规则文件路径(设置转换规则根目录为Main/AIWork目录)
- 附加规则(如有)
输出:
- 处理报告
实施说明:完成此阶段后,显示文件转换结果、生成的配置文件统计。
config-validator代理输入参数:
- 转换后的配置文件目录
- 编码偏移信息
- 验证规则文件(如有)
输出:
- 验证报告
- 发现的问题列表
- 修复建议
- 最大编码号
实施说明:完成此阶段后,显示验证结果、发现的问题和最终的编码状态。
实施说明:完成此阶段后,显示最终交付结果和文件位置。
/script-to-config --script-dir Doc/剧本_md_dir --work-dir Main/AIWork
/script-to-config --script-dir Doc/剧本_md_dir --work-dir Main/AIWork --output-dir Main/AIWork/output --rule-dir Config/rules
/script-to-config --script-dir Doc/剧本_md_dir --work-dir Main/AIWork --resume
/script-to-config --script-dir Doc/剧本_md_dir --work-dir Main/AIWork --chunk-size 150
script-format-analyzer - 剧本格式分析专家script-chunk-processor - 剧本分块处理专家file-transformer - 文件转换专家config-validator - 配置验证专家用户: /script-to-config --script-dir Doc/剧本_md_dir --work-dir Main/AIWork
助理: 开始处理剧本到配置转换流程
[阶段1] 设置工作目录: .work
查找转换规则文件: rule_trans_*.md
找到2个转换规则文件: rule_trans_1.md, rule_trans_item.md
发现7个剧本文件,总计6573行。
[阶段2] 启动剧本格式分析器...
分析剧本文件格式和结构
识别元素类型: 章节、场景、对话、选项、QTE、道具、角色
生成格式说明文档: format-specification.md
格式分析完成,识别的结构模式: 线性叙事、分支选择
[阶段3] 启动剧本分块处理器...
基于格式分析结果进行智能分块
创建子目录结构:
- .work/剧本第一章_001.md.chunk/
- .work/剧本第二章_002.md.chunk/
- .work/剧本第三章_003.md.chunk/
- ...
分块处理完成,生成35个分块文件
[阶段4] 开始文件转换处理...
根据格式说明映射元素到配置文件
处理 .work/剧本第一章_001.md.chunk/chunk_01.md
调用 file-transformer 子代理
转换成功, 最大编码15
处理 .work/剧本第一章_001.md.chunk/chunk_02.md
调用 file-transformer 子代理
转换成功,最大编码: 23
[处理中] 正在处理分块 20/35 (57%完成)
累计生成: video.cfg(8), story.cfg(12), prop.cfg(5)
[阶段5] 配置验证...
收集所有转换后的回报
调用 config_validator 子代理
验证结果: 语法正确,逻辑完整,编码一致
[阶段6完成] 处理完成!
输出目录: Main/AIWork/_video_video
生成文件: 25个配置文件
最终编码状态: 1356
注意:此命令专门设计用于处理大型剧本文件,通过分块处理和子代理协调,确保在有限的上下文内高效完成复杂的配置生成任务。
注意:请假设用户的运行环境中没有任何编程语言的编译器和解释器,你只能使用系统默认工具和子代理和ClaudeCode提供的工具来工作,不允许自己编码执行脚本(如python和js)