用途
Compiler Orchestrator 用于自动推进 React 编译器从 TypeScript 到 Rust 的移植进程。它按照固定的 pass 顺序,循环执行“发现当前前沿 → 修复失败 → 移植新 pass → 审查并提交”的流程,使移植工作可以持续向前推进。
主要能力
- 运行
compiler/scripts/test-rust-port.sh --json获取机器可读的测试结果,包括通过数、失败数、总用例数、当前 frontier(最早出现失败的 pass)以及各 pass 的通过/失败明细。 - 根据 frontier 判断模式:若 frontier 为空,则定位 Pipeline.ts 中最后一个已移植 pass 的下一个 pass,进入 PORT 模式;若 frontier 是某个 pass 名称,则进入 FIX 模式。
- 维护
compiler/docs/rust-port/rust-port-orchestrator-log.md日志,包含 Status 段(逐 pass 标记 complete、partial、todo)与 Logs 段(按时间戳记录每次移植、修复和提交)。 - 在 FIX 模式下并行启动审查子代理与分析子代理诊断失败,再启动修复子代理实施修复,最多循环 3 轮。
- 在 PORT 模式下启动通用子代理完成指定 pass 的移植、接入 pipeline.rs 并循环测试至 0 失败。
- 调用
/compiler-commit完成验证、审查与提交,提交信息带[rust-compiler]前缀。 - 支持可选参数
$ARGUMENTS:传入 pass 名称可从该 pass 开始;传入status则仅报告当前状态而不执行操作。
使用方式
该技能以 pass 顺序表(共 49 个 pass,含条件执行项)为参照,主上下文仅承担编排职责:解析子代理结果、更新日志、打印状态、启动下一个子代理,不直接阅读源码或修改代码。每轮执行流程为:Step 1 发现 frontier;Step 2 打印状态报告;Step 3 按模式委派子代理;Step 4 审查并提交;Step 5 回到 Step 1 循环。
适用场景
适用于 React 编译器 Rust 移植项目中需要持续、增量推进多个编译 pass 移植与修复的场景。遵循“最早失败优先”和“累积测试”原则:即使早期 pass 只有一个测试失败,也需先修复;测试某个 pass 时会覆盖其之前的所有 pass。
限制
- 依赖项目内特定路径的脚本、架构指南、Pipeline.ts 与 pipeline.rs,未提供这些文件时无法运行。
- 日志时间戳通过
date '+%Y%m%d-%H%M%S'获取。 - 主上下文不得直接阅读源码、调查失败或进行编辑,所有实现工作必须由子代理完成。
- 循环在全部 pass 移植完成且测试干净,或出现不可恢复错误时停止。