用途:规划并执行一次有意识、有文档、风险可控的代码库或包整体重写。重写带有主见,可能破坏 API、仓库布局或部署期契约,适用于技术债、架构约束或产品方向使增量重构不切实际的情况。
主要能力:产出含里程碑、风险与回滚策略的具体重写计划;提交实现新架构的补丁仓库;编写迁移指南与兼容性矩阵;更新测试与 CI 及发布清单。流程包括:确认范围与目标、制定高层迁移计划与回滚标准、识别需保留的不变量与关键行为、建立测试与 CI 基线、以小型可审查 PR 实施、提供迁移/升级路径(兼容垫片、特性开关或升级脚本)、与干系人协调时间线并记录破坏性变更、隔离环境跑集成与冒烟测试并验证回滚、按清单合并发布、发布后监控与跟进。
使用方式:可提供 scope、goals、migration、timeline、tests_ci、stakeholders 等输入;若范围或目标缺失,最多提出一个澄清问题;建议先写简短设计文档(README 或 PR 描述)再大量改代码。提交标题格式示例:rewrite(<scope>): Short summary。PR 描述应含动机、迁移计划、破坏性变更列表、发布步骤、回滚说明与测试矩阵。参考 AGENTS.md 中的仓库约定。
限制:不适用于小型改进或重命名(应优先使用 refactor 技能);不适用于必须保持 API 兼容且无迁移窗口的情况;在缺少测试或部署流水线、风险不可接受时不应使用。需避免在一次重写中混杂无关的大改动;缺乏干系人签字的重写常在发布时失败;未经明确批准的推测性架构变更应避免。
适用场景举例:将认证服务从 Express 迁移到 Fastify 并把处理器拆为类型化模块并提供中间件迁移垫片;将单体 CLI 从同步 I/O 迁移到异步插件架构并记录插件 API 变更;用更小的数据访问层替换内部 ORM,并提供数据迁移脚本与旧查询兼容层。
分类:编程与开发。