用途
legacy-modernizer 用于处理遗留代码库的现代化改造。它不主张一次性重写,而是通过绞杀者无花果(strangler fig)模式,设计增量式迁移策略,在保持生产环境零中断的前提下逐步替换旧系统。
主要能力
- 评估系统:分析代码库、依赖、风险与业务约束,产出依赖关系图和风险登记表。
- 规划迁移:设计带明确回滚策略的增量路线图,每个阶段都有回滚触发条件和负责人。
- 构建安全网:在改动生产代码前创建特征化测试与监控,目标覆盖现有行为 80% 以上。
- 增量迁移:应用绞杀者模式配合功能开关,通过门面层路由流量并逐步切换负载。
- 验证与迭代:运行完整测试套件、查看监控面板,确认业务行为保持不变后再下线旧代码。
使用方式
该技能按核心工作流推进,每一步都设有验证检查点:
- 评估系统——确认所有外部集成与数据契约已记录后再进入下一步。
- 规划迁移——确认每个阶段都有回滚触发条件和负责人。
- 构建安全网——在未修改的遗留系统上运行特征化测试套件并确认全部通过。
- 增量迁移——每次流量递增(如 5% → 25% → 50% → 100%)后验证错误率和延迟指标仍在基线阈值内。
- 验证与迭代——新代码需在 100% 流量下稳定运行至少一个发布周期,才能移除旧路径。
技能提供按上下文加载的参考文档:绞杀者模式、重构模式、迁移策略、遗留测试、系统评估。
代码示例
绞杀者门面(Python):根据功能开关将请求路由到旧服务或新服务。
# facade.py — routes requests to legacy or new service based on a feature flag
import os
from legacy_service import LegacyOrderService
from new_service import NewOrderService
class OrderServiceFacade:
def __init__(self):
self._legacy = LegacyOrderService()
self._new = NewOrderService()
def get_order(self, order_id: str):
if os.getenv("USE_NEW_ORDER_SERVICE", "false").lower() == "true":
return self._new.fetch(order_id)
return self._legacy.get(order_id)
功能开关包装器:
# feature_flags.py — thin wrapper around an environment or config-based flag store
import os
def flag_enabled(flag_name: str, default: bool = False) -> bool:
"""Check whether a migration feature flag is active."""
return os.getenv(flag_name, str(default)).lower() == "true"
# Usage
if flag_enabled("USE_NEW_PAYMENT_GATEWAY"):
result = new_gateway.charge(order)
else:
result = legacy_gateway.charge(order)
特征化测试模板(pytest):
# test_characterization_orders.py
# Captures existing legacy behavior as a golden-master safety net.
import pytest
from legacy_service import LegacyOrderService
service = LegacyOrderService()
@pytest.mark.parametrize("order_id,expected_status", [
("ORD-001", "SHIPPED"),
("ORD-002", "PENDING"),
("ORD-003", "CANCELLED"),
])
def test_order_status_golden_master(order_id, expected_status):
"""Fail loudly if legacy behavior changes unexpectedly."""
result = service.get(order_id)
assert result["status"] == expected_status, (
f"Characterization broken for {order_id}: "
f"expected {expected_status}, got {result['status']}"
)
适用场景
- 需要将单体遗留系统逐步拆分为服务。
- 数据库、UI、API 或框架的迁移。
- 通过分支抽象、适配器等方式抽取服务。
- 在降低技术债务的同时保持业务逻辑与行为不变。
限制与约束
必须做到:迁移全程保持生产零中断;重构前建立全面测试覆盖(目标 80% 以上);所有增量发布使用功能开关;实现监控与回滚流程;记录所有迁移决策与理由;保留现有业务逻辑与行为;透明沟通进度与风险。
禁止事项:大爆炸式重写或替换;改动前跳过遗留行为测试;无回滚能力就部署;破坏现有集成或 API;在新代码中忽视技术债务;未经充分验证就仓促迁移;新代码未经验证就移除旧代码。
输出模板
实施现代化时需提供:评估摘要(风险、依赖、方法)、迁移计划(阶段、回滚策略、指标)、实现代码(门面、适配器、新服务)、测试覆盖(特征化、集成、端到端)、监控设置(指标、告警、面板)。
知识参考
绞杀者无花果模式、分支抽象、特征化测试、增量迁移、功能开关、金丝雀部署、API 版本管理、数据库重构、微服务抽取、技术债务削减、零停机部署。
引用文档
以下为作者声明的引用来源,保留指定版本、署名和许可。
- jeffallan/claude-skills/skills/legacy-modernizer/SKILL.md — 署名:Jeffallan;许可:MIT;版本:
3bf9a24b76a7c122f1fc05e83929fbc84e1c207a。