FOMOD 打包技能
用途:为《上古卷轴5:天际》模组创建和验证 FOMOD 安装器,包括 ModuleConfig.xml、info.xml、选项组、依赖标记,以及可供 Vortex/MO2 使用的确定性归档布局。
输入:
- 已完成并验证的核心文件与补丁。
- 选项矩阵,区分互斥、可选和必选选项。
- 精确的插件与文件依赖。
- 安装目标位置与冲突策略。
主要规则:
- 安装器源文件夹与部署后的 Data 布局保持分离。
- 选项名称和描述需明确说明依赖与冲突。
- 当 schema 支持正确的依赖类型时,不要用文件存在条件替代插件依赖检查。
- 避免多个被选选项重复安装同一目标,除非是有意且有序的。
- 只保留一份规范的核心副本;补丁只包含其差异内容。
- XML 元素顺序和 schema 行为需与已知可用的 FOMOD 或 Vortex/MO2 当前规范一致。
- 输出 UTF-8 XML,并使用显式双引号声明 <?xml version="1.0" encoding="utf-8"?>。程序化写入后需复查字节。通用 XML 合法性不能证明特定安装器版本接受该文件;应在该版本自身的解析路径中复现编码/引号问题后再归因。
- 记录最终归档的 SHA-256 用于构建到下载的校验,并验证其成员集合与载荷文件哈希。ZIP 时间戳可能改变不可复现重建的归档字节而不改变载荷;这不应成为放弃归档完整性检查或复用旧构建哈希的理由。
- 将安装器测试夹具、所需 schema 和安全的已知坏回归夹具保留在项目中。schema 应相对于夹具解析,而非临时绝对路径。断言精确的成功/退出状态:搜索 VALID 也会匹配 INVALID。
工作流:
- 用表格起草选项矩阵。
- 生成 fomod/info.xml 和 fomod/ModuleConfig.xml。
- 解析两个 XML 文件。
- 对安装器根目录运行 scripts/validate_fomod.py。
- 模拟每个有效选项组合,或至少覆盖每个依赖分支。
- 检查最终归档是否意外多出根文件夹、嵌套 Data、陈旧文件或缺失源文件。
- 将结果交给 skyrim-ship-gate。
证据标准(用于版本敏感事实的优先级):
- 活动项目的 ENVIRONMENT.md、TASK.md、已安装框架版本和构建文件。
- 该精确版本的官方上游文档或源码。
- 用户已安装模组库中的已知可用文件(只读)。
- 直接检查相关 ESM、ESP、DLL、脚本、日志或归档。 不要用记忆、旧示例或看似合理的 token 替代。在 VALIDATION.md 中记录证据路径或 URL。
Claude Code 执行适配:
- 保持 CLAUDE.md 简洁,过程细节使用本技能。
- 只加载当前里程碑所需的技能,因为已调用技能内容会留在上下文中。
- 对高风险架构、插件、DLL 和对抗性审查使用 high 或 xhigh 努力级别。
- 在压缩或用量边界前,持久化精确状态、命令、未提交更改和剩余验证。
- 将自动记忆视为候选学习内容,而非已验证事实,直到通过记忆提升协议。
技能特定提供方控制:
- 对照最终归档(而非仅暂存文件夹)验证 schema 顺序和每个分支。
基于证据的发布清单控制:
- 审计所有公开版本字符串,包括 DLL 元数据、清单、MCM、README、变更日志、安装器、归档名称和日志。验证显式发布允许列表,并将 PDB、缓存、中间产物和调试日志排除在用户归档之外,除非有意作为单独的开发者/符号包发布。
适用场景:需要为 Skyrim 模组制作可重复、可验证的 FOMOD 安装器,并确保 Vortex/MO2 安装行为正确时使用。
限制:资料未提供具体安装命令、脚本实现细节、支持的 FOMOD schema 版本范围或价格信息;scripts/validate_fomod.py、skyrim-ship-gate 等组件的具体获取方式暂未提供。