更新数控仿真工作区快照

.agents/skills/align-linuxcnc/SKILL.md

@@ -0,0 +1,44 @@
+# 技能：对齐 LinuxCNC G 代码 (align-linuxcnc)
+
+## 触发条件
+目标：对标 LinuxCNC，分阶段完善 Web 版数控系统仿真的 WASM 程序，逐步补齐完整功能并严格测试。
+
+近期重点：
+- 刀补
+- 坐标系
+- 固定循环
+- 五轴 / RTCP
+- M428、M429、M430
+- 子程序调用
+
+实现约束：若 WASM 编译后涉及文件读写，可考虑使用 OPFS 满足文件处理需求。
+继续进一步完善程序，步步为营。G代码语法，与linuxcnc一致。程序主要来源于linuxcnc项目中的源程序。功能和G代码与linuxcnc对标。
+
+## 标准作业程序（S.O.P.）
+严格遵循以下“分析-计划-实现-验证”循环，每一步都要遵循“最小变更原则”。
+
+### 阶段 1：差异分析与目标选择
+1.  **扫描当前代码**：使用 `grep` 或代码导航工具，在 `src/` 目录下寻找已实现的 G/M 代码处理逻辑。
+2.  **对比 LinuxCNC 源码**：查阅 LinuxCNC 官方仓库中对应的源码文件（如 `src/emc/rs274ngc/rs274ngc_return.hh` 和 `interp_execute.cc` 等）。
+3.  **找出一个差异点**：从以下角度寻找**一个**最微小的差异：
+    - **数值解析**：如科学计数法、前导零、特殊字符处理。
+    - **参数范围与处理**：字参数（如 F、S、P 的值域）和表达式参数。
+    - **错误检查**：缺少某个 LinuxCNC 已实现但本项目尚未实现的 `CHK` 或 `CHKS` 校验逻辑。
+    - **模态状态**：某个 G 代码组内部的状态切换不完全一致。
+4.  **以书面形式明确目标**：在回复的开始，用一句话清晰说明本次要修复的具体差异点。例如：“**目标：对齐科学计数法解析行为。LinuxCNC 不允许 `1e3`，本项目当前会将其解析为 `1000`，需修复为解析失败。**”
+
+### 阶段 2：编写测试（先写测试）
+1.  **创建失败的测试**：在 `tests/` 或相应目录下，先编写一个能够清晰验证此行为的、**预期会失败**的测试用例。
+2.  **运行测试以确认失败**：执行 `./test-native.sh`，确保因为新测试而导致整体测试失败，这验证了测试的有效性。
+
+### 阶段 3：实施代码修改（小步快跑）
+1.  **定位源码**：找到项目中对应该行为的实现位置。
+2.  **参考 LinuxCNC 源码实现**：严格模仿 LinuxCNC 源码中的数据结构、算法和函数调用方式来进行修改。
+3.  **最小化修改**：只改动实现该功能的**最小必要代码行**。严禁“顺便”重构无关代码。
+4.  **保留接口一致性**：确保修改后的函数签名、返回值和副作用与 LinuxCNC 源码中的对应实现完全一致。
+
+### 阶段 4：验证与循环
+1.  **运行本地测试**：执行 `./test-native.sh`。如果失败，分析错误并修复，直到通过。
+2.  **运行完整回归测试**：执行 `./test-linuxcnc-source-link.sh`。如果失败，修复到通过为止。
+3.  **记录与完成**：在回复中简要报告：“差异点 `[目标]` 已修复，测试全部通过。准备进行下一轮分析。”
+4.  **无条件循环**：报告完成后，**必须立即、自动地**将思维跳转回**阶段 1**，并开始寻找下一个差异点。**严禁在报告完成后停止，除非已达到 AGENTS.md 中定义的中断条件。**