SuperAPI AI 工具集

skyrim-fomod-packaging

编程与开发

查看项目

更新于 10-30 16:18

技能介绍

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。

工作流:

  1. 用表格起草选项矩阵。
  2. 生成 fomod/info.xml 和 fomod/ModuleConfig.xml。
  3. 解析两个 XML 文件。
  4. 对安装器根目录运行 scripts/validate_fomod.py。
  5. 模拟每个有效选项组合,或至少覆盖每个依赖分支。
  6. 检查最终归档是否意外多出根文件夹、嵌套 Data、陈旧文件或缺失源文件。
  7. 将结果交给 skyrim-ship-gate。

证据标准(用于版本敏感事实的优先级):

  1. 活动项目的 ENVIRONMENT.md、TASK.md、已安装框架版本和构建文件。
  2. 该精确版本的官方上游文档或源码。
  3. 用户已安装模组库中的已知可用文件(只读)。
  4. 直接检查相关 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 等组件的具体获取方式暂未提供。