SuperAPI AI 工具集

compiler-orchestrator

编程与开发

查看项目

更新于 11-17 14:18

技能介绍

用途

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 移植完成且测试干净,或出现不可恢复错误时停止。