SaaS 迁移预算与 Agent 幻觉管理方法

将模块拆解得足够细小

一次性更换大规模代码库会带来风险。Bun 项目之所以在 11 天内将 53 万行代码迁移至 Rust 并产生 27,000 行 unsafe 代码，就是因为盲目采用了“大爆炸”式（Big Bang）的重构方案。请不要将整个项目完全交给 AI，而是将其拆解为 500 行以内独立的函数单元。

首先，使用 dependency-cruiser 分析代码依赖关系，找出循环引用。接着，利用 repowise 对 AST（抽象语法树）和提交历史进行可视化，从而挑选出耦合度较低的组件。通过这种方式划分边界，可以使 Agent 编写错误代码并导致重复修改的频率降低 40%。

Agent 之所以会将最新的 API 规范与旧代码模式混淆，是因为上下文不够严谨。在迁移每个模块时，请将包含功能说明和测试要求的 YAML 文件作为上下文传递给它。

编写示例非常简单。在 auth-migration.yaml 文件中，写入功能说明、类型签名以及禁止使用 unsafe 代码块等技术约束。在调用 Agent 时将其作为参考文件一并发送，幻觉现象会显著减少。从这一步开始，也可以实现验证工作的自动化。

人类哪里有时间去逐一审查 AI 编写的代码。请使用 promptfoo 创建一个能够自动执行现有测试场景的循环。编写一个 gatekeeper（把关）脚本，要求代码只有在通过测试后，才允许合并到主分支。

如果构建失败，请将错误日志重新丢回给 Agent，让它自行修复。引入这种自我修复循环，可以节省 60% 以上的手动调试时间。

盲目的迁移会直接导致预算爆表。请参考 Branch8 的案例，积极利用提示词缓存（Prompt Caching）并设置令牌（Token）限制。请记住，以 Claude 4.6 Sonnet 为例，每百万（1M）Token 的价格为 3 美元。

在 ~/.claude/settings.json 中设置每日使用量，并在执行 API 时通过 --token-budget 标志指定各模块的限额。最稳妥的做法是通过 Python 脚本设置一个强制拦截程序，一旦单次会话超过 2 美元，立即终止任务。

如果迁移后的代码在生产环境中崩溃，整个 Web 服务器都会瘫痪。在将 Rust 代码绑定到 Node.js 时，请设置 catch_unwind 隔板。即使发生原生恐慌（Native Panic），也能将其优雅地转换为 JavaScript 错误对象，从而避免服务器崩溃。

使用 Unleash 或 PostHog 等工具，将基于 Rust 的模块暴露比例从 0% 缓慢提升至 100%。如果构建能自动切换回旧代码的中间件，在发生错误时立即回滚到遗留代码，就能保证 99.9% 以上的可用性。

将模块拆解得足够细小

使用 YAML 进行约束

仅在测试通过时进行合并

如果构建失败，请将错误日志重新丢回给 Agent，让它自行修复。引入这种自我修复循环，可以节省 60% 以上的手动调试时间。

控制 API 成本

防止部署期间停机