diff --git a/.agents/skills/align-linuxcnc/SKILL.md b/.agents/skills/align-linuxcnc/SKILL.md index 89041af..94bebbf 100644 --- a/.agents/skills/align-linuxcnc/SKILL.md +++ b/.agents/skills/align-linuxcnc/SKILL.md @@ -61,6 +61,47 @@ For switchkins/remap table changes, also run: 5. Run required tests. 6. Report percent complete, source basis, changed files, and tests. +## Acceleration Rules + +When the user says "尽快推进", optimize for completion progress, not just +more source-map anchoring. + +- Prefer work that changes runnable coverage or removes a real blocker: + source-linked RS274 behavior, WASM-safe LinuxCNC dependency wrapping, + generated LinuxCNC config/remap fixtures, OPFS browser persistence checks, or + source-backed bridge/API paths. +- Do not spend consecutive turns on documentation/source-map-only tightening + unless it unblocks a build/test, covers a newly added source path, or the user + explicitly asks for documentation. After two source-map-only commits, the next + iteration must attempt code, generated fixture, manifest, or executable test + progress. +- Batch one coherent mini-slice instead of one-line guard churn: update the + LinuxCNC source basis, the relevant manifest/generator/test, and the minimal + shim/bridge in the same commit when they belong to one workstream. +- Time-box source discovery. If the LinuxCNC source basis cannot be located + quickly, switch to another listed target and report the blocked symbol/path + instead of inventing behavior. +- Keep smoke behavior shrinking. Never add project-authored smoke parser + semantics; prefer routing tests to LinuxCNC source-linked paths or proving why + a fallback remains a tracked blocker. + +Impact priority for "尽快推进": + +1. Replace or bypass temporary smoke/fallback behavior with LinuxCNC + source-linked execution. +2. Make browser-hostile LinuxCNC dependencies wasm-safe without changing CNC + semantics: Python/remap, Boost.Python, dlopen, HAL/filesystem, tooldata. +3. Add real browser OPFS persistence coverage for WASM reads/writes. +4. Expand generated LinuxCNC config/remap/kinematics fixtures from source INI, + HAL, and remap files. +5. Strengthen source maps only when they protect one of the above changes. + +Commit discipline: + +- Commit each coherent slice once required checks pass. +- Push once after each commit. If HTTP credentials are missing, record the + failure and do not waste additional retries in the same turn. + ## Source Pointers - RS274: `../linuxcnc/src/emc/rs274ngc/` diff --git a/AGENTS.md b/AGENTS.md index d57ce50..ab72c4e 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,3 +1,9 @@ +继续按 align-linuxcnc 约束,先确认干净基线,尽量完成多部分功能。 +如果提交满足,及时提交。禁止顺手扩功能 smoke +每次完善提交结束后,立即上传到云仓库,使用中文;git上传的标题使用提示词,说明使用结论。 +双向同步 + + # CNC Project Agent Guide 工作树已经有一批未提交修改,太大了。我把这批改动按 6 个上下文拆更合适 switchkins/remap 生成器和表 @@ -120,6 +126,42 @@ Main remaining risks: source files. - Add browser checks that prove WASM file reads/writes persist through OPFS. +## Faster Iteration Policy + +When the prompt is "尽快推进", optimize for measurable completion progress +instead of low-yield source-map churn. + +- Prefer changes that add runnable source-backed coverage or remove a real + blocker: LinuxCNC source-linked RS274 paths, WASM-safe dependency wrappers, + generated LinuxCNC config/remap fixtures, OPFS browser persistence checks, or + thin bridge/API paths. +- Avoid repeated documentation/source-map-only commits. Source-map tightening is + useful only when it protects a newly added source path, unblocks a build/test, + or documents a real bridge/shim change. After two source-map-only commits, + the next iteration should attempt code, generator, manifest, fixture, or + executable test progress. +- Batch one coherent mini-slice per commit: source lookup, manifest or fixture, + minimal shim/bridge/generator change, and required check should travel + together when they are part of the same workstream. +- Time-box LinuxCNC source discovery. If the source basis cannot be located + quickly, switch to another target and report the blocked symbol/path rather + than inventing CNC behavior. +- Do not expand temporary smoke parser semantics. Prefer deleting, shrinking, + or routing smoke-only paths toward LinuxCNC source-linked execution. + +Impact priority: + +1. Replace smoke/fallback behavior with LinuxCNC source-linked execution. +2. Wrap browser-hostile LinuxCNC dependencies without changing CNC semantics: + Python/remap, Boost.Python, dlopen, HAL/filesystem, and tooldata. +3. Add real browser OPFS persistence verification for WASM reads/writes. +4. Expand generated source-backed LinuxCNC INI/HAL/remap/kinematics coverage. +5. Strengthen source maps only when guarding one of the above. + +After a successful commit, push once. If the cloud repository still lacks HTTP +credentials, report the failure and continue local progress instead of retrying +the same push repeatedly. + ## Stop Conditions Stop and report if: