尽快推进:提高align-linuxcnc迭代效率

This commit is contained in:
cnc
2026-06-05 09:41:40 +08:00
parent 14fba4564a
commit 681d1976e9
2 changed files with 83 additions and 0 deletions

View File

@@ -61,6 +61,47 @@ For switchkins/remap table changes, also run:
5. Run required tests. 5. Run required tests.
6. Report percent complete, source basis, changed files, and 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 ## Source Pointers
- RS274: `../linuxcnc/src/emc/rs274ngc/` - RS274: `../linuxcnc/src/emc/rs274ngc/`

View File

@@ -1,3 +1,9 @@
继续按 align-linuxcnc 约束,先确认干净基线,尽量完成多部分功能。
如果提交满足,及时提交。禁止顺手扩功能 smoke
每次完善提交结束后立即上传到云仓库使用中文git上传的标题使用提示词说明使用结论。
双向同步
# CNC Project Agent Guide # CNC Project Agent Guide
工作树已经有一批未提交修改,太大了。我把这批改动按 6 个上下文拆更合适 工作树已经有一批未提交修改,太大了。我把这批改动按 6 个上下文拆更合适
switchkins/remap 生成器和表 switchkins/remap 生成器和表
@@ -120,6 +126,42 @@ Main remaining risks:
source files. source files.
- Add browser checks that prove WASM file reads/writes persist through OPFS. - 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 Conditions
Stop and report if: Stop and report if: