用途
skyrim-versioned-workspace 是一个面向《上古卷轴5:天际》模组创建或编辑的强制性工作区归属与版本快照工作流技能。其核心目标是:在 Agent 首次写入之前确立权威工作区与项目根目录,通过语义化版本快照隔离修改,防止代理覆盖已部署、暂存或安装目录中的文件,并保留上一版本用于回滚与二进制比对。
主要能力
- 工作区选择约定:工作区根目录是用户打开、提供或明确选择的目录,不假设盘符、用户名、文件夹名,也不假设存在独立的提供商工作区。多个 AI 应用共享同一权威项目根与同一活动版本,切换应用不构成克隆或迁移项目的理由。
- 项目布局规范:根目录下按
<WORKSPACE_ROOT>\<Mod Display Name>\组织,包含 WORKSPACE_OWNERSHIP.md、CHANGELOG.txt、CURRENT.txt、PLAN.md、STATE.md、VALIDATION.md、MEMORY\ 以及带版本号的快照文件夹(如<Mod Display Name> 1.0.0\VERSION.txt、1.0.1\VERSION.txt)。 - 编辑前流程:从 CURRENT.txt、归属记录、提供的归档与只读安装证据中确定权威项目;拒绝将已部署、暂存、存档、配置文件和已安装工具路径作为可写根;读取 CURRENT.txt、CHANGELOG.txt、STATE.md 与已知良好记录;选择语义化版本增量;将当前快照完整复制到新版本文件夹;更新 CURRENT.txt;创建或更新新快照的 VERSION.txt;在修改新快照前先开始写变更日志;只编辑新快照。
- 预检守卫 guard.py:脚本随技能打包提供,在写入之前而非之后运行,拒绝三类失败:写入只读区域、启动 GUI 工具、通过 PowerShell 往返破坏 UTF-8。用法:
python scripts/guard.py path "<intended write target>"python scripts/guard.py cmd "<intended shell command>"- 退出码 0 允许操作;退出码 2 阻止并打印原因与受支持的替代方案;
python scripts/guard.py --selftest验证规则。 守卫依据文件系统证据(祖先目录中的 SkyrimSE.exe、ModOrganizer.ini、Vortex.exe)识别已部署与受管理领域,因此不假设盘符、用户名或文件夹名。仅在用户明确要求绕过时设置SKYRIM_GUARD=off,并需报告已绕过。Claude Code 将同一脚本安装为 PreToolUse 钩子并自动阻止;其他应用必须在操作前显式调用。
- 版本与记录规则:绝不覆盖上一版本;绝不将不完整副本标记为当前;记录 AI 应用、模型、推理模式、父版本、预期变更、变更文件、命令、验证、运行时状态与未解决风险;移动或复制项目后重新生成一次性构建缓存;扫描生成项目中的过期绝对路径;保留上一版本用于回滚与二进制比对;显式记录归属转移(转移改变归属记录,不因使用另一 AI 而改变物理工作区)。
- 完成报告:报告工作区根、项目根、父版本、活动版本、复制文件数、变更日志状态、构建状态、最终包哈希与剩余风险。
- Claude Code 执行适配:保持 CLAUDE.md 简洁,将过程细节交由本技能;仅加载当前里程碑所需的技能,因为已调用技能内容会留在上下文中;对高风险架构、插件、DLL 与对抗性审查使用 high 或 xhigh 努力级别;在压缩或使用边界前持久化精确状态、命令、未提交变更与剩余验证;在通过记忆提升协议之前,将自动记忆视为候选学习而非已验证事实。
使用方式
在《上古卷轴5:天际》模组创建或编辑的首次写入前加载本技能,按“编辑前流程”逐步执行,并在每次写入与执行 shell 命令前调用 guard.py 预检。多应用交接时记录精确路径、哈希、活动版本、上次成功构建与下一必需命令。
适用场景
适用于 Skyrim 模组开发与编辑,尤其是多个 AI 应用共享同一项目根、需要版本隔离与回滚能力、需要防止误写入游戏部署目录或模组管理器目录的场景。
限制
本技能面向 Skyrim 模组工作流,未提供其他游戏的适配说明;guard.py 的自动阻止仅在 Claude Code 中作为钩子生效,其他应用需显式调用;绕过守卫需用户明确要求并报告;资料未提供除指定脚本外的其他工具或平台支持信息。