ai-tooling-stack

用途

本技能是《上古卷轴5：天际》模组开发场景下的跨工具索引。它不承载具体命令语法（那些位于各专门技能中），而是帮助使用者判断：面对某个任务时应该选用哪个工具、如何连接 MCP、以及各工具之间的职责边界。路径一律通过 tool-discovery 发现，绝不假设。

常驻基线

在天际相关工作中，以下技能始终启用：skyrim-memory、skyrim-tool-router；当可能需要任何外部二进制或 MCP 时使用 tool-discovery；首次写入前使用 skyrim-versioned-workspace。

工具角色（不可合并）

Skyrim Forge：类型化自动化代理，负责 doctor、capabilities、Papyrus 编译流水线、FOMOD、发布/Nexus 门禁、tool-resolve。对应技能 skyrim-forge。由捆绑包管理，AIO 会安装它；若缺失，可继续使用更窄的工具。
houseCARL：实时 MO2 加载顺序 MCP，提供真实胜出记录、冲突树、可审查的补丁 ESP、Nexus 免密钥查询、VFS 资源。对应技能 housecarl 及 mutagen/spid/kid/skypatcher 编写辅助。若缺失，建议安装 houseCARL-Setup + .NET 9 配对 + MCP 注册。
Spooky's AutoMod Toolkit：用于 ESP/Papyrus/MCM/NIF/BSA/音频/SKSE 项目工作流的 CLI，支持 --json。对应技能 spookys-automod-toolkit + skyrim-plugin-authoring。若缺失，建议安装 toolkit 发行版 + .NET 8 SDK。
codebase-memory-mcp：知识图谱式代码导航（调用图、影响分析）。对应技能 codebase-memory。若缺失，建议 DeusData 安装 + MCP 连接。
Headroom：上下文压缩/检索/会话统计 MCP。对应技能 headroom。可选；当上下文抖动确实严重时建议 pip install。
Superpowers：流程纪律（调试、TDD、计划、验证）。对应技能 using-superpowers 及同族。捆绑技能文本即可用；插件可选。
Ponytail：最小差异/反过度工程模式。对应技能 ponytail 及同族。捆绑技能文本即可用；插件可选。
CodeBurn：本地 AI token/成本分析。对应技能 codeburn。可选；npx codeburn。

能力与 schema 开销

当现有 CLI 能完整回答任务时，优先使用 CLI。休眠的 CLI 不增加 MCP schema 的 token 开销；但命令、指令和输出在使用时仍会消耗上下文。houseCARL 仅提供 MCP，没有 CLI，它提供的实时 MO2 加载顺序证据是离线插件读取器无法替代的。

历史 schema 估算（非每轮账单）：Forge MCP 52 个工具 / 17,488 字节 / 约 4,372 token（字节/4）；houseCARL Full 45 个工具 / 167,072 字节 / 约 41,768；Lean 125,476 字节 / 约 31,369；ReadOnly 70,418 字节 / 约 17,604。仅凭工具数量判断体积并不可靠。

优先选择已连接的更便宜服务器并不保证更低用量。范围、原生过滤、延迟发现、缓存和实际调用才决定什么进入上下文。首先不要注册无关服务器。Codex 支持 enabled_tools / disabled_tools；Hermes 支持 tools.include / tools.exclude；Claude Code 支持延迟 Tool Search。不要为提供方已原生具备的能力再购买新路由器。

类型化工程使用 Forge CLI，专门工作流使用 Spooky CLI，实时加载顺序真相、冲突树、VFS 和免密钥 Nexus 使用 houseCARL。设置与测量边界见 capability-profiles。

决策速查表

“在我的列表中这个 FormID 由谁胜出？”→ houseCARL，其他工具无法回答。
“类型化发布 / FOMOD / nexus 策略 / doctor”→ Forge CLI（forge release-build、forge doctor）。
“从 CLI 创建 ESL + 任务 + 编译 papyrus”→ Spooky 或 Forge CLI，两者均免费。
“从磁盘读取记录 / 查询插件”→ 先用 Forge CLI record-query / plugin-info，再用 houseCARL。
“从计划构建或验证补丁插件”→ Forge CLI plugin-build / plugin-plan-validate。
“编辑实时加载顺序解析出的内容”→ houseCARL，Forge 无法查看 MO2。
“SPID/KID/SkyPatcher 行语法”→ *-authoring / 专门的 V4 语法技能，绝不臆造。
“仓库中谁调用了这个函数？”→ codebase-memory。
“上下文太大 / 压缩此日志”→ headroom。
“停止过度工程”→ ponytail。
“这次 AI 会话花了多少钱？”→ codeburn。
“完成前的 bug / 计划 / 验证”→ superpowers 流程技能。

提供方适配

Claude Code：houseCARL 以 Claude 插件形式发布；Superpowers/Ponytail/Headroom 常以插件安装。本包中的技能仍可作为普通 SKILL.md 使用。
Grok Build：在 %USERPROFILE%.grok\config.toml 中注册 MCP 服务器。仅在编辑 exe 路径后使用包脚本 TOOLS\Fix-Grok-Codebase-Memory-Direct.ps1。技能放入 %USERPROFILE%.grok\skills。
Codex：用户技能位于 %USERPROFILE%.agents\skills；%CODEX_HOME%\skills 仅为遗留。MCP 按 Codex 文档。houseCARL 可能附带 codex\ 技能存根，但仍需要 MCP 二进制。
Kimi / Hermes / 其他：复制提供方原生技能；若 harness 支持则连接 MCP；否则说明 MCP 不可用并使用 CLI 回退。

硬性规则

工具缺失 → 建议安装并给出验证命令；安全时继续使用回退方案。
绝不在工具实际响应前声称 houseCARL/Forge 的结果。
绝不启动 xEdit/CK GUI。
游戏 Data / MO2 staging / 存档保持只读，除非通过明确拥有的项目输出。
houseCARL 补丁是新的 MO2 模组，供审查；原始文件不动（默认通道）。
工具输出（DynDOLOD、ParallaxGen、Reqtificator 等）不得冻结为手工补丁，见 tool-output-awareness。

会话工具报告（可选，每会话一次）

houseCARL 首次安装 / Vortex

绝不要让 houseCARL 处于“几乎安装”状态。运行包自动化：

TOOLS\Setup-HouseCarl.ps1

MO2 用户 → 自动检测实例或使用 -Mo2Instance

Vortex 用户 → 在 %LOCALAPPDATA%\houseCARL-Shim 自动构建 shim

然后完全重启 AI。

AIO 安装器（包）

新用户和缺失工具恢复：

Pack root

.\INSTALL-AIO.ps1 .\INSTALL-AIO.ps1 -Mode OnlineLatest .\TOOLS\Ensure-Tools.ps1 .\TOOLS\Update-From-GitHub.ps1

离线快照位于 BUNDLED-TOOLS\offline\。组件注册表：BUNDLED-TOOLS\CATALOG.json。 MCP 变更后，用户必须完全重启 AI 应用。