MiniMax Agent Coding Plan 能直接输出可执行的重构路径：①检查依赖文件和Git仓库；②构造含目标语言、路径、痛点、结果的结构化提示词；③生成编号执行序列并逐步验证；④应用diff补丁与测试桩，确保类型注解生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要把一段跑得慢、改起来疼、交接时没人敢碰的旧代码，变成结构清晰、有单元测试、能被新人快速上手的新版本，但又不想花三天重写——MiniMax Agent Coding Plan 能直接输出可执行的重构路径，而不是只给你几行建议。
确认当前代码是否具备重构前提
打开你的项目根目录，检查是否存在 【requirements.txt 或 pyproject.toml】，且其中至少包含 pandas、requests、pytest 三者之一。没有依赖声明的代码仓，Coding Plan 会拒绝生成重构方案——它不猜你用什么库，也不假设你装了什么环境。
用终端进入代码所在目录，运行：git status。如果提示“not a git repository”，请先执行 git init && git add . && git commit -m "init"。Coding Plan 默认以 Git 提交历史为上下文锚点，未初始化仓库将导致模块识别失败。
构造结构化重构提示词
不要写“帮我优化这段代码”，这会让模型退回模糊补全模式。必须明确写出：目标语言、待重构文件路径、当前痛点、期望结果四项。
方法一：单文件精准重构（推荐新手）
在 Coding Plan 输入框中粘贴如下格式（标点、换行、缩进全部保留）：
重构 Python 文件 ./src/etl/fetcher.py
现状：HTTP 请求硬编码超时值，无重试机制，JSON 解析失败直接抛异常
目标：引入 requests.Session + backoff 重试 + 结构化错误日志 + 返回 TypedDict
方法二：跨模块接口级重构
当你要动的是 API 层或服务契约时，必须附带接口契约快照。例如：
重构 ./api/v1/order.py 及其调用方 ./service/billing.py
现状：order.create() 返回 dict，billing.process() 直接取 ['id'] 字段
目标：定义 OrderCreateResult Pydantic 模型，强制类型校验，所有调用方需适配新返回类型
附：当前 order.create() 输出示例 {"id": "ord_abc123", "status": "pending"}
您的智能体声称“已完成”——但它真的验证过了吗？Superpowers 可将任意 OpenClaw 智能体转变为一名严谨的工程师。其核心机制包括： - **验证铁律**（主张须有证据支撑） - **三智能体代码评审流程**（构建 → 验证规格符合性 → 验证质量） - **系统化调试机制**（四阶段根因分析 + 三击规则） - **头脑风暴关卡**（先完成设计，再编写代码） - **反过度工程规则** 适用场景： (1) 任意复杂度的编码任务 (2) 调试失败问题 (
【注意：示例 JSON 必须真实存在，不能虚构字段名。模型会校验字段是否在你提供的样本中出现过】
执行重构计划并验证第一步
点击「生成 Plan」后，页面将显示一个带编号的执行序列，形如：
① 分析 ./src/etl/fetcher.py 的 import 链与函数边界
② 提取所有 requests.get() 调用点，定位超时参数位置
③ 生成 requests.Session 初始化模板与 backoff 装饰器 stub
④ 注入 logging.getLogger(__name__) 实例并替换 print()
⑤ 输出 diff 补丁包（含 pytest 测试桩）
不要跳过第①步。如果模型标注“无法解析 AST”，说明你粘贴的代码含语法错误或使用了未声明的动态特性（如 exec()、getattr(module, name)）。此时需先修复原始代码再重试。
点击第①步右侧的「执行」按钮，系统会自动高亮该文件中被识别为入口函数的 def fetch_data(): 块，并在右侧预览 AST 解析树。确认函数签名与你预期一致后，再点击第②步「执行」。
应用补丁并运行测试桩
第⑤步执行完成后，页面弹出「下载 patch.zip」按钮。解压后你会看到：
— patch.diff（标准 Unix diff 格式）
— test_fetcher_stub.py（仅含 assert True 的空桩）
— migration_notes.md（含 breaking change 清单）
在终端中执行：patch -p1 。如果提示 “Hunk #1 FAILED”，说明你本地代码与 Plan 读取的版本不一致——<strong>【必须用 git checkout HEAD -- ./src/etl/fetcher.py 回滚到 Plan 读取的快照】</strong>
运行：python -m pytest test_fetcher_stub.py -v。看到 PASSED 后，立即执行：python -c "import sys; sys.path.insert(0, '.'); from src.etl.fetcher import fetch_data; print(fetch_data.__annotations__)"。输出应包含 -> FetchResult 类型注解。
