对齐 gmoccapy XYZAB 模式互锁

work/working5/02-项目程序开发详细步骤.md

@@ -0,0 +1,48 @@
+# 02-项目程序开发详细步骤
+
+## 步骤 1：建立工作控制文件
+
+- 创建 README、功能内容、开发步骤、推进台账、任务矩阵、验收证据、决策记录。
+- 把任务按 LinuxCNC 执行流程拆分为可验收条目。
+
+## 步骤 2：读取基准与现有实现
+
+- 读取 `work/working3/gmoccapy_XYZAB_execution_analysis.md`。
+- 读取 Web 项目 runtime、state、profile、ui 和测试文件。
+- 将 LinuxCNC 执行链路映射到 Web 项目模块。
+
+## 步骤 3：执行现有测试
+
+- 在 `app` 下运行 `npm run smoke:node`。
+- 运行构建：`npm run build`。
+- 运行浏览器冒烟：`npm run smoke`。
+- 如有失败，先定位是否为环境、测试夹具或功能差异。
+
+## 步骤 4：差异分析
+
+按任务矩阵逐项检查：
+
+- INI/HAL/profile 是否覆盖 `gmoccapy_XYZAB.ini` 的五轴语义。
+- task/HAL runtime 是否覆盖状态机、互锁、回零、运行、暂停、停止、换刀、主轴、冷却、倍率。
+- interpreter/kinematics/session 是否覆盖 LinuxCNC 解释和五轴运行边界。
+- UI 是否按 gmoccapy 规则启停按钮并显示状态。
+
+## 步骤 5：修改实现
+
+- 优先修复已有测试暴露的问题。
+- 对未覆盖但属于 LinuxCNC 基准行为的差异，补测试后修实现。
+- 修改范围保持在对应 runtime/state/ui/profile/tests 文件内，避免无关重构。
+
+## 步骤 6：回归验收
+
+- 重新运行相关最小测试。
+- 运行完整 Node 冒烟测试。
+- 对 UI/浏览器改动运行构建与浏览器冒烟。
+- 把命令、结果、证据路径写入 `05-验收证据.md`。
+
+## 步骤 7：更新台账和任务矩阵
+
+- 更新已完成任务状态。
+- 写清本轮修改文件、验证命令和下一步。
+- 对重要取舍写入 `06-决策记录.md`。
+