6.4 KiB
name, description
| name | description |
|---|---|
| historical-battle-assets | 为 Digital Me 生成纯素材型历史战役包：史实上下文、中文旁白、分幕图片、人物标签和项目自生成音乐选曲，并在校验后自动创建本地 Git 提交。用户说“某战役生成”“玄武门事变生成”，或要求战役图片配文字与 BGM 素材时使用；不负责前端页面或交互实现，不执行 Git push。 |
历史战役素材生成
交付“食材”，不替用户“炒菜”：产出可直接交给前端、剪辑或策划使用的图片、文字和音乐选择，不写页面组件、样式或交互代码，除非用户另行明确要求。
先定史实边界
- 规范战役名称和时代；遇到俗称、错别字或多个同名事件时，依据史料确定规范名，并在交付中列出用户原称和规范名。
- 优先读取目标项目已有的事件资料、人物表、史料引文、
gaps与blacklist。在 Digital Me 中重点查找digital-me-backend/src/mingchangmianData.js、digital-me-backend/src/rujuDashi/及相关朝代数据。 - 本地资料不足时，再查权威史料或正式学术来源。事实、合理视觉补全与纯气氛描写必须分开标注；史料空白不得写成确定事实。
- 战役胜负、生死、时间、地点、身份、器物和服饰不得为戏剧性而改写。演义、影视桥段或后世传说若无可靠依据，放进“禁用元素”，不要画进图片。
组成素材包
默认按事件复杂度设计 3–5 幕，而不是强行把所有战役切成同样长度。每幕必须含：
- 时间与地点；
- 这一幕在整场战役中的作用；
- 适合配音的连续旁白；
- 适合画面叠加的短标题与一句短文案；
- 在场人物的“姓名／当时身份／本幕动作或结局”；
- 图片文件名、画面说明、无障碍替代文本和最终生成提示词；
- 史实依据，以及哪些画面细节属于不改变事件走向的视觉补全。
另写一段可从头顺读的主旁白。用户未指定时，以约 60–90 秒为目标，句子短、可口播，用具体动作连接上下文，不写教科书式人物履历堆砌。
完整目录与 manifest.json 字段遵循 交付结构。
生成图片
需要成图时，先加载并遵循 imagegen skill，再使用图像生成工具。保持同一战役的建筑时代、服饰、盔甲、人物外观、色调和镜头语言一致。
- 默认横版 16:9，适配网页大画幅与视频分镜。
- 图片本身不烘焙姓名、字幕、书法、Logo 或水印；为后续叠字保留可用负空间。
- 人物关系通过站位、视线、明暗和景深表达；人物姓名与身份写在伴随文案中。
- 暴力场面以动作、兵器和后果暗示为主，不依赖血腥特写。
- 每幕生成不同构图，不能只换同一画面的滤镜。
- 保存原始生成图，并为交付另备体积合理的 WebP；文件名使用稳定的幕次和英文 slug。
从项目音乐里选 BGM
只从用户指定项目的自生成音乐或自有曲库选曲，不拿外部商业歌曲凑数。Digital Me 默认先查：
digital-me-backend/src/data/music-library.json；digital-me-backend/src/storyScores.js；/api/tianxia/yue/library?q=<战役名>返回的音频绑定状态。
优先级依次为：同一事件且已有可播放音频、同一人物或时代且已有音频、最贴合叙事曲线的自生成音乐方案。判断维度是情绪弧、节奏、是否压住旁白、时代音色、开头和收尾是否易剪。
如果曲库只有作曲方案而没有实际音频：仍可选出最佳曲目 ID 和版本，但必须写明“待生成／待导出”，不得声称已附 MP3；同时给出 3–5 段 cue sheet。若选中含人声版本作为 BGM 来源，明确要求使用伴奏或去人声 stem。
写入与交付
若用户给了项目，默认在项目内创建 战役素材/<规范战役名>/；没有目标目录时，在当前工作区创建同名素材包。不要把素材自动接进页面。
自动创建本地 Git 提交
素材包写入并通过检查后，只要交付目录位于 Git 工作树内，默认自动创建本地 commit，不再另行询问；这项默认授权只覆盖本次新生成或更新的战役素材包，以及用户明确要求同步更新的本技能文件。
- 先读取目标仓库的
AGENTS.md、Git 发布约束和适用架构文档，并用git rev-parse --show-toplevel、当前分支、远端和git status --short --branch确认提交位置。 - Digital Me 的源码目录与历史归档仓库分离时，以用户指定的交付仓库为准。若用户已指定
SPianPianShaoNian/digital-me-history，应把最终素材包同步到该远端对应的本地工作树，再在那里提交；不要把源码仓库的其他改动带入归档提交。 - 工作树存在无关改动时，保留且不触碰它们。只按明确路径暂存本次素材目录和本技能文件，禁止使用
git add .或git add -A。 - 提交前至少验证：
manifest.json可解析、所有清单引用的 PNG/WebP 都存在、图片格式与尺寸可读、git diff --cached --check通过。纯图片/文案素材不触发前后端构建；若同时修改代码，则按仓库门禁运行相应测试。 - 默认提交信息使用
feat: add <规范战役名> battle asset bundle；若只是修订已有素材，则使用docs: update <规范战役名> battle asset bundle。 - 创建 commit 后报告提交号、暂存范围、验证结果和相对上游的领先状态。
- 只创建本地提交。禁止执行
git push、git publish、强推或其他远端写操作；远端上传仍由用户手动完成。
如果交付目录不在 Git 工作树内、找不到用户指定的交付仓库、提交身份缺失，或本次文件与用户未提交改动发生重叠，先完成素材交付并说明未自动提交的具体原因，不得猜测远端、覆盖改动或扩大提交范围。
完成前检查：
- 每张图都能对应一段旁白，而不是装饰图；
- 人名、官职和动作在各文件中一致；
- 主旁白能按幕次顺读；
- 图片提示词不含违背本战史实的元素；
- BGM 有明确选曲理由、状态和剪辑点；
- 所有来源、生成提示词和文件路径可追溯。
交付时列出素材目录、图片数量、旁白时长、选中 BGM 及其是否已有音频。若调用图像生成，附上最终提示词摘要。