SuperAPI AI 工具集

rewrite-with

编程与开发

查看项目

更新于 11-05 19:20

技能介绍

用途

rewrite-with 用于把现有代码库重写为目标语言或架构(也支持同语言重写)。它强调“从经过验证的行为契约出发重写”:先确定系统应当做什么、解决语义歧义、对设计做形式化分析,再依据证据实现并优化。旧实现被视为关于现有行为的证据,而不是预期行为的权威。

主要能力

  • 接受本地项目或仓库 URL、重写范围、可选目标语言/框架、约束和决策模式;日常细节从项目中推断。
  • 未指定目标时默认使用 Safe Rust,也支持其他目标(含源语言)。同语言重写同样要经过全部门禁。
  • 默认咨询模式:对重要歧义给出解决建议,等用户选择后再做依赖工作。若用户明确要求不再提问,则进入自主模式,按建议执行并记录。
  • 不默认要求向后兼容,保留约定的领域行为,显式标注有意变更;无需求与验证时不保留旧适配器、重复实现或回退路径。
  • 实现生产代码前先做形式化分析;基线运行器、实验、模型代码与验证装置可提前搭建。
  • 不把模型检查结果等同于生产代码正确性的证明,需说明检查范围、假设、边界与剩余实现义务。
  • 不以普通测试静默替代不可用的形式化验证:记录阻碍并继续独立工作,依赖部分保持门禁。

使用方式与工作产物

使用既有项目约定(否则用 .rewrite-with/)保存精简证据包:

  • baseline.md:源版本、范围、可复现构建/运行/测试命令、夹具、环境、测量与观察到的失败。
  • decisions.md:稳定决策 ID、证据、备选方案、建议、选定结果、决策权限与未决事项。
  • design.md:目标架构、行为契约、排除项,以及属性到实现的可追溯表。
  • formal/:规格、检查器配置、适用的证明产物、可复现验证命令。
  • evidence/:检查器/测试/基准日志与反例,含工具版本与输入标识。
  • report.md:最终结果、行为变更、验证覆盖与局限、测量与剩余阻碍。

流程分五步:

  1. 发现、基线与设计:检查仓库指令、入口、依赖、测试、数据格式、外部效应、部署假设与现有规格;界定重写边界;尽量复现旧构建与代表性负载,失败记为基线事实;刻画可观察行为(输入输出、错误、状态迁移、持久化、顺序、取消、重试、并发、资源边界、数值语义等);区分观察行为、文档意图、用户需求与建议行为,登记矛盾与缺失需求;草拟目标架构与契约。
  2. 解决歧义:对每个重要歧义记录 ID 与证据、问题、可选方案、建议、最终解决(语义、决策权限、受影响属性与测试)。咨询模式批量提问;自主模式按“明确用户需求→领域不变量→文档意图→一致的观察行为”顺序选择,并记录不确定性与残余风险。契约成为基准;仅对选择保留的行为沿用旧输出。
  3. 实现前形式化与验证:把契约转为具名属性(前置/后置条件、安全不变量、进展要求、精化义务等)并分配稳定 ID;选择最小忠实形式化(有状态/并发用 TLA+/PlusCal,其他义务用合适求解器、关系模型或证明工具),显式建模环境假设与失败行为,执行检查器并检查非空性与可达性,保存命令、版本、配置、输出与反例;建立属性到决策、模型元素、检查证据、计划代码边界与实现检查的可追溯表。
  4. 实现与对应性验证:按依赖顺序实现;Rust 中在每个受维护 crate 根加 #![forbid(unsafe_code)],并评估依赖假设;按属性表构建契约测试、基于模型的轨迹、属性测试、集成测试、并发测试或经工具检查的代码证明;对保留行为做差分对比,对有意变更按契约验证;运行构建、静态检查与有意义测试,完成可追溯表并区分“已测试对应”“已评审对应”“机器证明精化”。
  5. 优化与报告:剖析代表性负载并优化测得的瓶颈,只保留有支撑、可测量的改进;改动态表示、同步、顺序、失败处理或数值语义需复审模型并重跑受影响的正式检查;交付实现与证据包及简明总结。

适用场景

适用于需要按明确行为契约重写代码库的项目:跨语言或同语言架构重写、需要处理行为歧义并保留可追溯证据的场景,以及希望以形式化分析和属性验证支撑重写的团队。

限制

资料未提供具体支持的检查器/求解器清单、安装命令、性能数据、价格与平台信息;无法执行旧构建或使用形式化工具时,只能文档化局限、记录阻碍并在不依赖该证据的范围内继续,依赖实现保持门禁。重写完成需约定范围通过各门禁,受阻或部分完成须明确标注。