用途:改善 Roblox Luau 代码健康度,同时避免意外改变玩家可见行为。适用于技术债处理、死代码移除、模块边界整理、命名清理、重复逻辑消除和依赖梳理。
主要能力与目标:处理重复常量与奖励公式、职责混杂的大型脚本、客户端/服务端边界混乱、失效的 remote、过时 UI 路径、未使用模块、重复的事件连接模式、围绕重要状态的不清晰命名,以及应改为平衡表的魔法数字。
重构规则:编辑前先阅读;保持改动范围收敛;除非有意迁移,否则保留 remote 契约;避免把行为变更与清理混在一起;有意义的重构后进行 playtest;检查控制台输出。
深化机会:除明显清理外,寻找可深化的浅模块——接口复杂度接近实现、调用方承担了本应隐藏的复杂度之处。对疑似浅模块应用删除测试:若删除只是转移复杂度,则内联;若删除会把同一复杂度分散到多个调用点,则保留并赋予小而稳定的接口,用游戏词汇命名。每个机会按“涉及文件·当前摩擦·建议改动·收益(局部性+可测试性)”呈现。不要为单一实现引入新间接层。
MCP 工作流:用 script_grep 查找重复、旧名称或调用点;用 script_read 阅读所有受影响脚本;用 multi_edit 做小改动;用 start_stop_play 验证相关循环;检查 get_console_output。
输出:重构目标、保持的行为、改动的脚本、执行的验证、后续债务项。
后续:用 roblox-playtest-qa 验证行为未变;较大结构变更先在 roblox-luau-architecture 中设计,再用 roblox-to-issues 切片,逐步安全落地。
限制:资料未提供具体收费、价格、平台支持范围或效果保证。