Codex Mekara 重构计划|用小提交拆分工作并保留行为
EnglishCodex 安装步骤
- 打开 GitHub 固定提交的 `.agents/skills/plan-refactor/SKILL.md`,核对内容与使用条件。
- 在自己的项目中创建 `.agents/skills/plan-refactor/`,把核对后的文件保存为 `.agents/skills/plan-refactor/SKILL.md`。
- 在该项目根目录启动 Codex,输入 `$plan-refactor` 并选择同名技能。
中文摘要
为 Mekara 项目编写行为保持型重构计划,说明现状、目标、职责划分与可独立合并的阶段。
SKILL.md 中文导读
可复现示例
为拆分报告渲染函数拟一份两阶段计划。
{"module":"report renderer","pain":"formatting mixed with output","invariant":"same output bytes","steps":2}工作步骤
- 查找真实调用链和依赖,记录需要维持的数据和行为。
- 按项目设计模板写架构现状、目标和职责边界。
- 按可独立合并的阶段拆分改动,列出每阶段验证并提交评审。
验收方法
第 1 阶段抽出并验证格式处理,第 2 阶段迁移调用点并清理被替换的实现。每一步都检查 `same output bytes`,先交付评审用计划。
GitHub 原文 · 更新日期
适用环境
在 Codex 中打开 Mekara,准备目标代码与现有测试,并阅读项目的设计文档规范。
常见问题
阶段一留下一个临时包装器可以吗?
项目约定在替换代码的同一提交清理旧实现。可以调整阶段边界,让替换与清理一起完成。