用途:按 GRACE 开发计划以控制器管理的并行波次执行模块实现,同时保持规划产物与共享上下文一致。核心原则是并行化模块实现而非架构决策:控制器独占 docs/development-plan.xml、docs/knowledge-graph.xml、docs/verification-plan.xml、阶段状态与执行队列;worker 只负责被分配模块的文件与模块内测试;reviewer 在合并前校验模块输出。
前置条件:需存在 docs/development-plan.xml(含模块契约与实现顺序)和 docs/knowledge-graph.xml;docs/verification-plan.xml 应存在并含模块内验证命令与门禁预期;若存在 docs/operational-packets.xml 则作为规范包与增量参考。计划或图谱缺失、验证计划缺失或仍为骨架时应立即停止,让用户先自行运行 $grace-plan 或 $grace-verification。
执行档位:默认 balanced。safe 在每次派发前请求批准,对每个模块输出做契约与验证审查,每波后做定向图谱同步、阶段边界做全量刷新;balanced 开始时解析一次计划与图谱,一次性批准执行排期,给 worker 紧凑执行包,按模块做本地验证与范围门禁审查,每波或每阶段做批量完整性检查;fast 仅用于验证强、架构稳定的成熟代码库,整轮一次批准,波内只阻塞关键范围审查问题。每个模块仍使用全新 worker,不跨模块复用会话。
流程:构建并行安全波次(依赖已完成、写范围不相交、无共享集成面编辑);明确控制器、worker、reviewer 的所有权;每波派发全新 worker,要求保留 MODULE_CONTRACT、MODULE_MAP、CHANGE_SUMMARY、函数契约与语义块,仅改模块内测试,运行模块内验证,并按 grace(MODULE_ID): 格式提交;随后做最小安全范围审查,默认每 worker 最多 2 轮修复;控制器集中应用图谱与验证增量、更新计划状态、运行定向 $grace-refresh;按 worker、波次、阶段三级验证;控制器仅提交共享产物,格式为 grace(meta): sync <artifacts updated> after wave N,并输出 WAVE COMPLETE 报告。
限制:仅剩一个模块、步骤紧耦合共享文件、计划频繁变动或尚无可靠模块内验证时不应使用,此时改用 $grace-execute 顺序执行。若 worker 发现缺失模块或新依赖,应停止并请用户修订计划,禁止静默架构漂移。具体命令参数、价格与平台支持暂未提供。