SuperAPI AI 工具集

skyrim-esp-vmad-renaming

编程与开发

查看项目

更新于 10-30 16:21

技能介绍

用途

该技能面向《上古卷轴5:天际》插件的 VMAD(虚拟机器附加数据)编辑,目标是在 ESP/ESM 插件内对脚本名、属性名或字符串数据进行范围严格限定的重命名,同时保持文件的二进制结构不被破坏。原文明确限定:仅在需要重命名类型化记录内的数据时使用。

主要能力

  • 对目标 VMAD 记录族执行脚本、属性或字符串的重命名。
  • 优先采用类型化插件库路径:使用理解目标 VMAD 记录族的插件库,修改后重新加载并比对结果。
  • 在满足全部前置条件时允许原始字节替换作为后备方案。

使用方式(按原文流程整理)

二进制后备方案仅在以下条件全部成立时允许:

  1. 已确定精确的目标字符串及其所属记录;
  2. 已理解编码与长度前缀;
  3. 已对每一处出现进行分类;
  4. 变换正确更新了长度和外层记录大小,或替换前后字节长度完全相同;
  5. 解析器能在修改前后走查完整文件;
  6. 字节差异显示无无关改动;
  7. 原始文件保持未动。

原文明确禁止:对插件使用全局 bytes.replace;在未同时提供对应 PSC/PEX 并保持属性契约的情况下重命名脚本。

验证流程:

  1. 修改前审计插件结构;
  2. 提取目标记录与 VMAD 树;
  3. 在工作区副本上应用变换;
  4. 重新解析完整插件;
  5. 比对 masters、FormID、记录大小、VMAD 脚本、属性以及无关字节;
  6. 编译重命名后的脚本并运行 ship gate。

证据标准

原文给出的版本敏感事实证据优先级:

  1. 当前项目的 ENVIRONMENT.md、TASK.md、已安装框架版本与构建文件;
  2. 该确切版本的官方上游文档或源码;
  3. 用户已安装模组库中的已知良好文件(只读);
  4. 直接检查相关 ESM、ESP、DLL、脚本、日志或归档。 原文要求不得以记忆、旧示例或看似合理的 token 替代证据,并在 VALIDATION.md 中记录证据路径或 URL。

Claude Code 执行适配

  • 保持 CLAUDE.md 简洁,将过程细节交给本技能。
  • 仅加载当前里程碑所需的技能,因为已调用的技能内容会保留在上下文中。
  • 对高风险架构、插件、DLL 与对抗性审查使用 high 或 xhigh 推理强度。
  • 在压缩或使用边界前,持久化精确状态、命令、未提交改动与剩余验证。
  • 自动记忆在通过记忆提升协议前仅视为候选知识,而非已验证事实。
  • 要求字节长度不变或使用类型化写入器,绝不臆造 VMAD 偏移。

适用场景与限制

适用于熟悉天际插件二进制结构与 VMAD 记录、需要进行受控重命名的模组开发或维护工作。限制包括:仅在窄范围重命名场景使用;必须维持二进制结构;必须遵循上述证据与验证标准;资料未提供具体工具名称、代码示例或安装命令。