v0.5.0 · 项目环境感知的通用 Minecraft 模组开发 Skill（0.x：覆盖补齐中）

v0.5.0 · 项目环境感知的通用 Minecraft 模组开发 Skill（0.x：覆盖补齐中）

从「固定 1.21.1/1.21.11 × Fabric/NeoForge 知识包」到项目环境感知通用 Skill 的断代升级。

核心变化

• Phase 0 强制项目侦察：任何实现之前读构建配置 / loader metadata / 映射配置 / 已有代码，产出环境卡（版本 / Loader / 映射 / Java / 构建系统 / 架构 / 项目约定）；版本和 Loader 是运行时识别的项目事实，不是 Skill 前提
• 不凭记忆猜 API：六级核实优先级（项目代码 → 依赖 → 映射源码 → 原版/Loader 源码 → 文档 → 编译探针），新增 mappings.tiny 直查手法
• 按版本分文件夹的知识结构：21 个版本（1.7.10 → 26.3），条目级可信标签（无标签 = 公开常识 / [公开文档] / [实测] / [未核实]）
• 两层知识模型：通用规程（环境无关）+ environments/ 环境知识（按需加载，覆盖 ≠ 支持边界）

实测覆盖（全部编译探针 / 服务器行为验证，带证据）

• 已验证差异经验：1.21.1 ↔ 1.21.11 四构建实测（含适用边界标注：SUCCESS_SERVER=1.21.2、ContainerUser=1.21.9、Identifier 改名=1.21.11、SavedDataType=1.21.5、出生点 API 与 noise 字段=1.21.9）
• 编译探针闭环：1.16.4 / 1.16.5 / 1.18.2 / 1.19.2 / 1.20.1 / 1.21.4 / 1.21.8 / 1.21.9 / 1.21.11（正反探针 + 报错原文）
• 老线考古闭环：1.12.2（FG2 必须用 14.23.5.2847——2859 无 userdev）与 1.7.10（原版 FG 1.2-SNAPSHOT S3 死链 → anatawa12 fork + 本地 file 仓库收割 libraries.minecraft.net；twitch-external-platform 的 win64 natives 官方从未发布）
• 移植批次经验归并：1.21.4–1.21.10 服务器级实测（SavedDataType 边界、spawn chunk 移除、RCON 斜杠假 FAIL、虚空维度 forceload 死锁等）
• 26.x 去混淆时代知识：新工具链断层与 API 改名（26.1/26.2/26.3）

结构

SKILL.md                       Agent 操作手册（13 节，环境无关）
references/environment-discovery.md   Phase 0 侦察手册
references/api-verification.md        API 核实规程
references/pitfalls.md                踩坑手册（A/B/C/D 组 + 案例研究）
references/e2e-testing.md             专用服务器 + 服务端权威断言
references/environments/versions/     21 个版本文件夹 + 版本对差异
references/environments/loaders/      Loader 对照（含全线坐标表）

许可证：GPL-3.0。完整变更见 commit 历史。

版本语义

• 0.x：架构定型，版本谱系与实测覆盖仍在补齐中（当前 21 个版本，1.7.10 → 26.3）
• 1.0：版本谱系与各线实测补齐后的首个正式版