Claude Code辅助遗留系统重构：可行性评估、小步落地与多仓WMS整合建议
摘要：遗留系统"不敢动、看不懂、改得慢"的根因不是"代码老"，而是规则不可追溯、测试缺失、接口债务深。Claude Code 在这类场景中真正解决的是"读代码、抽规则、补测试、出适配器、做局部重构"的工程成本，不替代架构决策与业务签核。本文按实操文标准组织：给出可行性五维评分卡、可直接复制的 CLAUDE.md 与特征测试、2--4周试点甘特图、多仓WMS异构整合方案、风险与成本口径、FAQs。文中示例数据明确标注"演示口径"，请勿作为真实业务承诺。
一、先解决最大疑问：Claude Code 真能"救"几十年老系统吗
不能把"救"理解为"整库翻译一遍就上线"。真正的遗留系统难点往往不是语法老，而是下面三座大山：
- 规则不可追溯：折扣、税额、批次、库位分配、波次策略、历史回退散在存储过程、定时任务、配置文件和线下Excel里。
- 没有安全网：测试覆盖率极低，改一行不知道炸断哪条链路。
- 接口与数据债深：主数据重复、库存口径不一、系统间用FTP/SOAP/直连库点对点连接。
Claude Code 的价值，业界实践和官方资料都集中在"代码理解与增量现代化"：依赖图、死代码识别、补测试、生成文档、小步重构、老接口包适配器。大规模语言/框架迁移还会先建"规则书 → 依赖顺序 → 差异清单"，再用"实现→评审→修复"循环做行为对拍，而不是单独模型逐文件盲翻。
因此，更严谨的定位是：
| 能力 | 能解决 | 注意/不解决 |
|---|---|---|
| 代码理解 | 依赖图、模块职责、调用链、死代码 | 不理解业务上下文"潜规则" |
| 规则提取 | 从源码/存储过程定位规则位置并溯源到行号 | 未写进代码的规则会"自信补全"，必须标 UNVERIFIED |
| 测试 | 补单测、特征测试、对拍脚本、契约测试 | 测试边界要人定义，预期值要人签核 |
| 重构 | 局部坏味道重构、DTO/适配器/翻译草稿 | 核心记账/税务/清算不建议自动改 |
| 业务知识 | 不能 | 业务规则必须由老员工和架构师签字 |
一句话结论 ：
Claude Code 解决老系统的"看不懂、不敢动、改得慢"；不解决"业务说不清、数据对不上、组织不配合"。
二、可行性评估：五维评分卡，拒绝拍脑袋
不要问"整个系统能不能改"，要问"哪个域适合先用 Claude Code 改"。
2.1 五维评分表
| 维度 | 分值 | 3分（强） | 2分（中） | 1分（弱） |
|---|---|---|---|---|
| 代码可获取性 | 1--3 | 全量镜像/可构建/可跑测试 | 只有源码，无构建或测试 | 只有生产环境，无源码副本 |
| 规则可追溯性 | 1--3 | 规则集中在代码/存储过程，可定位到行号 | 部分规则在配置或文档，另一部分靠人 | 规则全在老员工脑子/线下表格 |
| 业务关键度 | 1--3 | 报表、文件对接、校验、接口层等外围 | 有业务影响但可灰度 | 核心记账、税务、清算主链路 |
| 测试基础 | 1--3 | 已有单测/集成测试/可重放场景 | 能补特征测试，但无现成CI | 无测试、无样例数据、无法自动对拍 |
| 合规与数据 | 1--3 | 可脱敏、可私有化/企业代理、可留审计 | 可脱敏，但流程需申请 | 敏感PII/财务/医疗直连公网 |
2.2 评分法
总分15分。≥11分 可启动2--4周试点；8--10分 先做规则抽取和业务访谈；≤7分暂停，先补数据治理或测试基线。
示例评估一个入库模块：
| 维度 | 得分 | 理由 |
|---|---|---|
| 代码可获取性 | 3 | VB6源码完整，SQL Server可还原到沙箱 |
| 规则可追溯性 | 3 | sp_inbound_validate 等存储过程包含大部分校验逻辑 |
| 业务关键度 | 2 | 影响收货和上架，但可单仓灰度 |
| 测试基础 | 2 | 无自动化，但可用老库真实订单做对拍 |
| 合规与数据 | 3 | 脱敏后可分析 |
| 总分 | 13 | 适合试点 |
三、小步落地流水线：只读→规则→测试→重构→对拍→灰度
3.1 实验环境与版本
为避免读者"版本对不上"，这里给一个实际可执行的口径：
text
操作系统：Ubuntu 22.04 LTS / macOS 14
Claude Code：v2.x 命令行版（以官方最新发布为准）
模型：Claude Opus 4.5 用于跨模块架构分析；Claude Sonnet 4.5 用于子域规则抽取与代码生成
被测老系统：
- WMS-A：VB6 + SQL Server 2014，可沙箱还原
- WMS-B：Java 8 + Oracle 11g，Maven 构建
安全模式：私有API代理，所有文件路径和业务规则输出保留，PII字段脱敏3.2 环境隔离与 CLAUDE.md
- 全量源码、库结构、DTS/ETL、定时任务拉入隔离环境。
- 禁止连接生产库；生产数据导出后脱敏。
- 创建
.claudeignore，排除依赖目录、构建产物、日志、大二进制。
根级 CLAUDE.md 示例（可直接复制使用）：
markdown
# CLAUDE.md（遗留WMS重构试点）
## 技术栈
- 老系统A：VB6 + SQL Server 2014，构建与本地运行见 docs/build-a.md
- 老系统B：Java 8 + Oracle 11g，mvn test -pl inbound 跑入库域
- 老系统C：SaaS导出Excel，原始样本在 data/c-sample/，仅用于规则对照
## 红线
- 不修改生产配置、不直连生产库、不自动执行库存写操作
- 所有业务规则输出必须带 file:line；无源码出处的写 UNVERIFIED
- 核心库存扣减、财务对账、税规则仅做分析，不自动重构
## 子域契约
- 入库域：收货/质检/上架/库位分配；规则源在 src/inbound 与 sp_inbound_* 存储过程
- 库存域：可用量=在库-锁定-质检占用-残损；各老系统口径映射见 docs/stock-mapping.md
- 接口域：优先生成只读适配器与DTO，不直接改老系统业务表
## 测试要求
- 先写特征测试锁定当前行为；行为差异超阈值人工复核
- 任何重构PR必须附：依赖影响范围、规则溯源表、测试结果3.3 只读分析与运行实录
建议按子域启动，不要一个会话分析全库。提示词示例：
text
只读取 src/inbound 与数据库存储过程 sp_inbound_*，输出：
1. 模块职责与对外调用关系；
2. 入库校验、质检判定、库位分配的业务规则，每条标注 file:line；
3. 死代码、重复逻辑、超高复杂度函数；
4. 无测试覆盖且被多处调用的高风险函数清单。
不要修改任何文件。执行命令与输出（脱敏示意）：
bash
$ claude -p "分析 src/inbound 下所有存储过程，输出规则溯源表" --output-format json > rules_inbound.json
$ head -20 rules_inbound.json
json
{
"rule_id": "R-001",
"rule": "到货数量小于0时置为0并标记异常",
"source": "src/inbound/sp_inbound_validate.sql:42",
"confidence": "confirmed",
"verification_status": "TO_BE_REVIEWED"
},
{
"rule_id": "R-002",
"rule": "当仓类型为冷库时，质检等待时间=30分钟",
"source": "src/inbound/sp_inbound_quality.sql:88",
"confidence": "unverified",
"verification_status": "UNVERIFIED"
}3.4 特征测试：先锁行为，再谈正确
推荐 characterization test，只记录"当前行为"，不急着断言"应该怎样"。哪怕老逻辑存在已知bug，也先锁住，避免重构后"悄悄变正确"反而引发业务事故。
Python 示例：
python
# test_inbound_allocation_char.py
# CHARACTERIZATION: 锁定老系统当前库位分配行为，日期 2026-09-18
def test_allocation_by_zone_current(old_alloc_service, sample_order):
result = old_alloc_service.allocate(sample_order)
# 预期值来自老库存储过程 sp_allocate 实测，不按新规则改
assert result.zone == "A"
assert result.priority == 1
assert len(result.line_items) == 3
def test_allocation_when_quantity_zero(old_alloc_service):
order = make_order(qty=0)
result = old_alloc_service.allocate(order)
# 老系统历史行为：返回默认区但不生成上架任务
assert result.zone == "DEFAULT"
assert result.tasks == []Java 版可用 JUnit 锁存储过程结果；无自动化测试的老项目，可让 Claude 生成对拍脚本：同一输入分别调老函数与新实现，diff 输出。
3.5 局部重构与翻译草稿
只选低危、边界清晰、可回滚模块，例如：
- 文件/报文格式转换；
- 入库参数校验，波次过滤条件；
- 老接口 DTO 转标准事件；
- 报表 SQL 重构；
- 单个 God class 拆分为多个有明确职责的类。
Claude 出 diff → 人工 review → 单测 → 集成测试 → 行为对拍。跨语言端口时先建"规则书"：
text
命名：类名PascalCase，方法camelCase，常量UPPER_SNAKE
金额：统一用decimal，精度4位，禁止double
时间：统一UTC存储，展示用+08:00
null：Optional显式处理，不隐式吞null
异常：老系统错误码映射为新的BusinessException码关键提醒："编译通过"不等于"行为正确"。每种行为差异必须有测试或对拍脚本覆盖，不允许仅靠"转译后看起来没问题"上线。
3.6 绞杀者迁移，不大爆炸
老系统继续跑核心，外围用适配器包一层标准API/消息；新服务经适配器调用，逐步把能力外移。
#mermaid-svg-tXMFTmHVapOtwP7g{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-tXMFTmHVapOtwP7g .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-tXMFTmHVapOtwP7g .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-tXMFTmHVapOtwP7g .error-icon{fill:#552222;}#mermaid-svg-tXMFTmHVapOtwP7g .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-tXMFTmHVapOtwP7g .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-tXMFTmHVapOtwP7g .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-tXMFTmHVapOtwP7g .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-tXMFTmHVapOtwP7g .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-tXMFTmHVapOtwP7g .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-tXMFTmHVapOtwP7g .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-tXMFTmHVapOtwP7g .marker{fill:#333333;stroke:#333333;}#mermaid-svg-tXMFTmHVapOtwP7g .marker.cross{stroke:#333333;}#mermaid-svg-tXMFTmHVapOtwP7g svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-tXMFTmHVapOtwP7g p{margin:0;}#mermaid-svg-tXMFTmHVapOtwP7g .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-svg-tXMFTmHVapOtwP7g .cluster-label text{fill:#333;}#mermaid-svg-tXMFTmHVapOtwP7g .cluster-label span{color:#333;}#mermaid-svg-tXMFTmHVapOtwP7g .cluster-label span p{background-color:transparent;}#mermaid-svg-tXMFTmHVapOtwP7g .label text,#mermaid-svg-tXMFTmHVapOtwP7g span{fill:#333;color:#333;}#mermaid-svg-tXMFTmHVapOtwP7g .node rect,#mermaid-svg-tXMFTmHVapOtwP7g .node circle,#mermaid-svg-tXMFTmHVapOtwP7g .node ellipse,#mermaid-svg-tXMFTmHVapOtwP7g .node polygon,#mermaid-svg-tXMFTmHVapOtwP7g .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-tXMFTmHVapOtwP7g .rough-node .label text,#mermaid-svg-tXMFTmHVapOtwP7g .node .label text,#mermaid-svg-tXMFTmHVapOtwP7g .image-shape .label,#mermaid-svg-tXMFTmHVapOtwP7g .icon-shape .label{text-anchor:middle;}#mermaid-svg-tXMFTmHVapOtwP7g .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-tXMFTmHVapOtwP7g .rough-node .label,#mermaid-svg-tXMFTmHVapOtwP7g .node .label,#mermaid-svg-tXMFTmHVapOtwP7g .image-shape .label,#mermaid-svg-tXMFTmHVapOtwP7g .icon-shape .label{text-align:center;}#mermaid-svg-tXMFTmHVapOtwP7g .node.clickable{cursor:pointer;}#mermaid-svg-tXMFTmHVapOtwP7g .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-tXMFTmHVapOtwP7g .arrowheadPath{fill:#333333;}#mermaid-svg-tXMFTmHVapOtwP7g .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-tXMFTmHVapOtwP7g .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-tXMFTmHVapOtwP7g .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-tXMFTmHVapOtwP7g .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-tXMFTmHVapOtwP7g .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-tXMFTmHVapOtwP7g .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-tXMFTmHVapOtwP7g .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-tXMFTmHVapOtwP7g .cluster text{fill:#333;}#mermaid-svg-tXMFTmHVapOtwP7g .cluster span{color:#333;}#mermaid-svg-tXMFTmHVapOtwP7g div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-tXMFTmHVapOtwP7g .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-tXMFTmHVapOtwP7g rect.text{fill:none;stroke-width:0;}#mermaid-svg-tXMFTmHVapOtwP7g .icon-shape,#mermaid-svg-tXMFTmHVapOtwP7g .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-tXMFTmHVapOtwP7g .icon-shape p,#mermaid-svg-tXMFTmHVapOtwP7g .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-tXMFTmHVapOtwP7g .icon-shape .label rect,#mermaid-svg-tXMFTmHVapOtwP7g .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-tXMFTmHVapOtwP7g .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-tXMFTmHVapOtwP7g .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-tXMFTmHVapOtwP7g :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} 老WMS A VB6/SQL
适配器/API网关
老WMS B Java/Oracle
老仓Excel/RF/SP
标准库存事件层 Kafka
新入库/上架/波次服务
全局库存视图/对账
业务看板/OMS/ERP
原则：先接口后内核，先只读后写回，先单域后全量。
3.7 对拍、影子、灰度
- 影子：新老系统同时收同一批订单/库存事件，只比差异，不切业务。
- 双写：低动销区或单仓单客户并行，老系统主账，新系统验证。
- 切流阈值必须明确：如库存对账差异率≤0.01%、接口失败率≤0.05%、特征测试通过率100%、人工复核工时低于预设。
- 回滚：适配器层保留开关，单域异常可随时切回老实现。
四、多仓WMS整合建议：先治理数据和接口，不先统一内核
以下为中性假设场景，不涉及具体企业名称和"全省数百仓"等无来源数据。
假设某省级流通/国资仓储体系，多个地市仓过去分别建设WMS：
| 仓库 | 技术栈 | 对外接口 |
|---|---|---|
| A仓 | VB6 + SQL Server 2014 | FTP + 直连库视图 |
| B仓 | Java 8 + Oracle 11g | SOAP WebService |
| C仓 | SaaS WMS | Excel导出 + 人工表 |
| D仓 | RF枪 + 存储过程 | 文件监听 + 人工补录 |
4.1 主数据先行，接口其次
多仓整合最容易翻车的地方不是接口，而是主数据不一致。建议：
- 建立全局 MDM/主数据层：
master_sku、仓库ID、包装层级、单位、批次规则、库存状态枚举。 - 各老WMS保留本地SKU，中台维护"本地SKU → master_sku"映射表。
- 权威来源原则：商品档案以ERP/PIM为主；库位/库区以本地WMS为主；承运商以OMS/TMS为主。
4.2 统一库存口径，而不是强制覆盖
不同老系统"可用量"定义可能不同。先定义标准库存事件：
json
{
"event_id": "evt_20260918_001",
"event_type": "inbound.received",
"warehouse_id": "WH001",
"master_sku": "SKU-10001",
"qty": 120,
"uom": "PCS",
"batch_no": "B20260918-01",
"location": "A-01-02",
"source_system": "WMS-A",
"occurred_at": "2026-09-18T09:30:00+08:00",
"trace_id": "trace-8f7d"
}库存状态公式由业务统一约定，例如：
text
available = on_hand - locked - quality_hold - damaged - other_reserved是否计入在途按业务域分开，不要一刀切。
4.3 异构接入：按实时性选型
| 需求 | 推荐方案 |
|---|---|
| 高频订单/库存查询 | REST/gRPC API |
| 异步解耦事件 | Kafka/RabbitMQ，幂等+重试+死信 |
| 多协议复杂路由 | ESB/Camel：SOAP转REST、报文转换 |
| 老系统无API | 受控读视图+CDC+文件监听，人工补录走旁路 |
| 日结/对账大批量 | SFTP CSV/XML，自动校验+对账作业 |
4.4 Claude Code 在多仓整合中的限定用法
不要让它直接改生产库存。用它做：
- 读各仓老代码/存储过程，抽"入库校验、库位分配、波次过滤"规则并输出
file:line溯源表； - 为无API老系统生成适配器骨架、DTO、校验脚本、标准事件映射；
- 生成历史数据清洗草稿：单位换算、批次号补位、库位编码规范化；
- 根据老系统逻辑生成对拍用例；
- 输出接口文档、字段映射表、未覆盖规则清单供业务签核。
提示词模板：
text
读取 WMS-A 的 sp_inbound_validate、sp_allocate 与 WMS-B 的 InboundService.java，
抽取收货校验和库位分配规则。输出：
1. 两仓规则差异表；
2. 每条规则标注源系统、对象、file:line；
3. 生成标准事件 inbound.received / inbound.putaway 的字段映射；
4. 对无法从代码确认的规则标注 UNVERIFIED，并列出需业务确认的问题。
不修改生产代码，不假设默认业务规则。4.5 切流顺序与KPI
#mermaid-svg-nltn7FJr10VaoDmh{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-nltn7FJr10VaoDmh .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-nltn7FJr10VaoDmh .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-nltn7FJr10VaoDmh .error-icon{fill:#552222;}#mermaid-svg-nltn7FJr10VaoDmh .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-nltn7FJr10VaoDmh .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-nltn7FJr10VaoDmh .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-nltn7FJr10VaoDmh .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-nltn7FJr10VaoDmh .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-nltn7FJr10VaoDmh .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-nltn7FJr10VaoDmh .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-nltn7FJr10VaoDmh .marker{fill:#333333;stroke:#333333;}#mermaid-svg-nltn7FJr10VaoDmh .marker.cross{stroke:#333333;}#mermaid-svg-nltn7FJr10VaoDmh svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-nltn7FJr10VaoDmh p{margin:0;}#mermaid-svg-nltn7FJr10VaoDmh .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-svg-nltn7FJr10VaoDmh .cluster-label text{fill:#333;}#mermaid-svg-nltn7FJr10VaoDmh .cluster-label span{color:#333;}#mermaid-svg-nltn7FJr10VaoDmh .cluster-label span p{background-color:transparent;}#mermaid-svg-nltn7FJr10VaoDmh .label text,#mermaid-svg-nltn7FJr10VaoDmh span{fill:#333;color:#333;}#mermaid-svg-nltn7FJr10VaoDmh .node rect,#mermaid-svg-nltn7FJr10VaoDmh .node circle,#mermaid-svg-nltn7FJr10VaoDmh .node ellipse,#mermaid-svg-nltn7FJr10VaoDmh .node polygon,#mermaid-svg-nltn7FJr10VaoDmh .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-nltn7FJr10VaoDmh .rough-node .label text,#mermaid-svg-nltn7FJr10VaoDmh .node .label text,#mermaid-svg-nltn7FJr10VaoDmh .image-shape .label,#mermaid-svg-nltn7FJr10VaoDmh .icon-shape .label{text-anchor:middle;}#mermaid-svg-nltn7FJr10VaoDmh .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-nltn7FJr10VaoDmh .rough-node .label,#mermaid-svg-nltn7FJr10VaoDmh .node .label,#mermaid-svg-nltn7FJr10VaoDmh .image-shape .label,#mermaid-svg-nltn7FJr10VaoDmh .icon-shape .label{text-align:center;}#mermaid-svg-nltn7FJr10VaoDmh .node.clickable{cursor:pointer;}#mermaid-svg-nltn7FJr10VaoDmh .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-nltn7FJr10VaoDmh .arrowheadPath{fill:#333333;}#mermaid-svg-nltn7FJr10VaoDmh .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-nltn7FJr10VaoDmh .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-nltn7FJr10VaoDmh .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-nltn7FJr10VaoDmh .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-nltn7FJr10VaoDmh .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-nltn7FJr10VaoDmh .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-nltn7FJr10VaoDmh .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-nltn7FJr10VaoDmh .cluster text{fill:#333;}#mermaid-svg-nltn7FJr10VaoDmh .cluster span{color:#333;}#mermaid-svg-nltn7FJr10VaoDmh div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-nltn7FJr10VaoDmh .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-nltn7FJr10VaoDmh rect.text{fill:none;stroke-width:0;}#mermaid-svg-nltn7FJr10VaoDmh .icon-shape,#mermaid-svg-nltn7FJr10VaoDmh .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-nltn7FJr10VaoDmh .icon-shape p,#mermaid-svg-nltn7FJr10VaoDmh .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-nltn7FJr10VaoDmh .icon-shape .label rect,#mermaid-svg-nltn7FJr10VaoDmh .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-nltn7FJr10VaoDmh .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-nltn7FJr10VaoDmh .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-nltn7FJr10VaoDmh :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} 单仓影子同步
单仓低动销客户双写
差异率稳定后切外围
高动销大仓最后切
核心财务/税务对账始终并行
KPI建议：
- 主数据匹配率、重复SKU清理数；
- 库存对账差异率、接口失败率、消息重放成功率；
- 规则溯源覆盖率、特征测试通过率；
- 单域回滚时长、人工复核工时下降比例。
五、风险与合规：把幻觉拦在合并之前
| 风险 | 表现 | 缓解措施 |
|---|---|---|
| 规则幻觉 | AI按通用习惯补折扣/税/批次规则，忽略本企特殊政策 | 所有规则必须带 file:line；无出处标 UNVERIFIED；业务签核；特征测试对拍 |
| 上下文丢失 | 全库投喂超大单体，依赖断片 | 按子域启动；根/子CLAUDE.md；子代理隔离任务；一个会话只改一个域 |
| 数据质量 | 重复SKU、历史废单、错位批次泄露到新系统 | 主数据治理独立工作流；先映射后对账再切流 |
| 合规审计 | PII/财务/医疗数据外泄 | 私有部署/企业代理、脱敏、最小权限、AI改动作留审计 |
| 评审瓶颈 | AI出大量diff，资深人审不过来 | 低危模块自动建议；高险域人工逐条；用编译器/测试/diff做机械初筛 |
| 组织阻力 | 业务不定规则，仓管拒用新界面 | 并行运行、老界面兼容层、变更管理单独排期 |
六、成本测算：预算模板与止损线
| 成本项 | 测算口径 | 参考范围 |
|---|---|---|
| 模型/工具 | Claude Code订阅、令牌、CI、沙箱；并行子代理会放大令牌成本 | 数千至数万/月 |
| 人力 | 架构师、业务专家、测试、数据治理、DBA | 视团队规模，通常是大头 |
| 测试/对拍 | 特征测试、跨系统对拍、性能回归 | 占整体30%--40%，不可省 |
| 数据治理 | 主数据映射、历史单据清洗、编码对照 | 多仓场景可能超过代码改造 |
| 并行运行 | 老新双跑、双写、日对账、培训、支持 | 数月级持续成本 |
止损线示例：
- 某域对拍差异率 > 1%，暂停并回溯；
- 特征测试覆盖率提升不足，说明测试基建优先级应高于重构；
- 人工复核工时超过AI节省工时的2倍，重新评估该域ROI。
七、2--4周试点计划与效果评估
7.1 试点甘特图
#mermaid-svg-dIYkfmZVkl9GLNpa{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-dIYkfmZVkl9GLNpa .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-dIYkfmZVkl9GLNpa .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-dIYkfmZVkl9GLNpa .error-icon{fill:#552222;}#mermaid-svg-dIYkfmZVkl9GLNpa .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-dIYkfmZVkl9GLNpa .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-dIYkfmZVkl9GLNpa .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-dIYkfmZVkl9GLNpa .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-dIYkfmZVkl9GLNpa .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-dIYkfmZVkl9GLNpa .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-dIYkfmZVkl9GLNpa .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-dIYkfmZVkl9GLNpa .marker{fill:#333333;stroke:#333333;}#mermaid-svg-dIYkfmZVkl9GLNpa .marker.cross{stroke:#333333;}#mermaid-svg-dIYkfmZVkl9GLNpa svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-dIYkfmZVkl9GLNpa p{margin:0;}#mermaid-svg-dIYkfmZVkl9GLNpa .mermaid-main-font{font-family:"trebuchet ms",verdana,arial,sans-serif;}#mermaid-svg-dIYkfmZVkl9GLNpa .exclude-range{fill:#eeeeee;}#mermaid-svg-dIYkfmZVkl9GLNpa .section{stroke:none;opacity:0.2;}#mermaid-svg-dIYkfmZVkl9GLNpa .section0{fill:rgba(102, 102, 255, 0.49);}#mermaid-svg-dIYkfmZVkl9GLNpa .section2{fill:#fff400;}#mermaid-svg-dIYkfmZVkl9GLNpa .section1,#mermaid-svg-dIYkfmZVkl9GLNpa .section3{fill:white;opacity:0.2;}#mermaid-svg-dIYkfmZVkl9GLNpa .sectionTitle0{fill:#333;}#mermaid-svg-dIYkfmZVkl9GLNpa .sectionTitle1{fill:#333;}#mermaid-svg-dIYkfmZVkl9GLNpa .sectionTitle2{fill:#333;}#mermaid-svg-dIYkfmZVkl9GLNpa .sectionTitle3{fill:#333;}#mermaid-svg-dIYkfmZVkl9GLNpa .sectionTitle{text-anchor:start;font-family:"trebuchet ms",verdana,arial,sans-serif;}#mermaid-svg-dIYkfmZVkl9GLNpa .grid .tick{stroke:lightgrey;opacity:0.8;shape-rendering:crispEdges;}#mermaid-svg-dIYkfmZVkl9GLNpa .grid .tick text{font-family:"trebuchet ms",verdana,arial,sans-serif;fill:#333;}#mermaid-svg-dIYkfmZVkl9GLNpa .grid path{stroke-width:0;}#mermaid-svg-dIYkfmZVkl9GLNpa .today{fill:none;stroke:red;stroke-width:2px;}#mermaid-svg-dIYkfmZVkl9GLNpa .task{stroke-width:2;}#mermaid-svg-dIYkfmZVkl9GLNpa .taskText{text-anchor:middle;font-family:"trebuchet ms",verdana,arial,sans-serif;}#mermaid-svg-dIYkfmZVkl9GLNpa .taskTextOutsideRight{fill:black;text-anchor:start;font-family:"trebuchet ms",verdana,arial,sans-serif;}#mermaid-svg-dIYkfmZVkl9GLNpa .taskTextOutsideLeft{fill:black;text-anchor:end;}#mermaid-svg-dIYkfmZVkl9GLNpa .task.clickable{cursor:pointer;}#mermaid-svg-dIYkfmZVkl9GLNpa .taskText.clickable{cursor:pointer;fill:#003163!important;font-weight:bold;}#mermaid-svg-dIYkfmZVkl9GLNpa .taskTextOutsideLeft.clickable{cursor:pointer;fill:#003163!important;font-weight:bold;}#mermaid-svg-dIYkfmZVkl9GLNpa .taskTextOutsideRight.clickable{cursor:pointer;fill:#003163!important;font-weight:bold;}#mermaid-svg-dIYkfmZVkl9GLNpa .taskText0,#mermaid-svg-dIYkfmZVkl9GLNpa .taskText1,#mermaid-svg-dIYkfmZVkl9GLNpa .taskText2,#mermaid-svg-dIYkfmZVkl9GLNpa .taskText3{fill:white;}#mermaid-svg-dIYkfmZVkl9GLNpa .task0,#mermaid-svg-dIYkfmZVkl9GLNpa .task1,#mermaid-svg-dIYkfmZVkl9GLNpa .task2,#mermaid-svg-dIYkfmZVkl9GLNpa .task3{fill:#8a90dd;stroke:#534fbc;}#mermaid-svg-dIYkfmZVkl9GLNpa .taskTextOutside0,#mermaid-svg-dIYkfmZVkl9GLNpa .taskTextOutside2{fill:black;}#mermaid-svg-dIYkfmZVkl9GLNpa .taskTextOutside1,#mermaid-svg-dIYkfmZVkl9GLNpa .taskTextOutside3{fill:black;}#mermaid-svg-dIYkfmZVkl9GLNpa .active0,#mermaid-svg-dIYkfmZVkl9GLNpa .active1,#mermaid-svg-dIYkfmZVkl9GLNpa .active2,#mermaid-svg-dIYkfmZVkl9GLNpa .active3{fill:#bfc7ff;stroke:#534fbc;}#mermaid-svg-dIYkfmZVkl9GLNpa .activeText0,#mermaid-svg-dIYkfmZVkl9GLNpa .activeText1,#mermaid-svg-dIYkfmZVkl9GLNpa .activeText2,#mermaid-svg-dIYkfmZVkl9GLNpa .activeText3{fill:black!important;}#mermaid-svg-dIYkfmZVkl9GLNpa .done0,#mermaid-svg-dIYkfmZVkl9GLNpa .done1,#mermaid-svg-dIYkfmZVkl9GLNpa .done2,#mermaid-svg-dIYkfmZVkl9GLNpa .done3{stroke:grey;fill:lightgrey;stroke-width:2;}#mermaid-svg-dIYkfmZVkl9GLNpa .doneText0,#mermaid-svg-dIYkfmZVkl9GLNpa .doneText1,#mermaid-svg-dIYkfmZVkl9GLNpa .doneText2,#mermaid-svg-dIYkfmZVkl9GLNpa .doneText3{fill:black!important;}#mermaid-svg-dIYkfmZVkl9GLNpa .doneText0.taskTextOutsideLeft,#mermaid-svg-dIYkfmZVkl9GLNpa .doneText0.taskTextOutsideRight,#mermaid-svg-dIYkfmZVkl9GLNpa .doneText1.taskTextOutsideLeft,#mermaid-svg-dIYkfmZVkl9GLNpa .doneText1.taskTextOutsideRight,#mermaid-svg-dIYkfmZVkl9GLNpa .doneText2.taskTextOutsideLeft,#mermaid-svg-dIYkfmZVkl9GLNpa .doneText2.taskTextOutsideRight,#mermaid-svg-dIYkfmZVkl9GLNpa .doneText3.taskTextOutsideLeft,#mermaid-svg-dIYkfmZVkl9GLNpa .doneText3.taskTextOutsideRight{fill:black!important;}#mermaid-svg-dIYkfmZVkl9GLNpa .crit0,#mermaid-svg-dIYkfmZVkl9GLNpa .crit1,#mermaid-svg-dIYkfmZVkl9GLNpa .crit2,#mermaid-svg-dIYkfmZVkl9GLNpa .crit3{stroke:#ff8888;fill:red;stroke-width:2;}#mermaid-svg-dIYkfmZVkl9GLNpa .activeCrit0,#mermaid-svg-dIYkfmZVkl9GLNpa .activeCrit1,#mermaid-svg-dIYkfmZVkl9GLNpa .activeCrit2,#mermaid-svg-dIYkfmZVkl9GLNpa .activeCrit3{stroke:#ff8888;fill:#bfc7ff;stroke-width:2;}#mermaid-svg-dIYkfmZVkl9GLNpa .doneCrit0,#mermaid-svg-dIYkfmZVkl9GLNpa .doneCrit1,#mermaid-svg-dIYkfmZVkl9GLNpa .doneCrit2,#mermaid-svg-dIYkfmZVkl9GLNpa .doneCrit3{stroke:#ff8888;fill:lightgrey;stroke-width:2;cursor:pointer;shape-rendering:crispEdges;}#mermaid-svg-dIYkfmZVkl9GLNpa .milestone{transform:rotate(45deg) scale(0.8,0.8);}#mermaid-svg-dIYkfmZVkl9GLNpa .milestoneText{font-style:italic;}#mermaid-svg-dIYkfmZVkl9GLNpa .doneCritText0,#mermaid-svg-dIYkfmZVkl9GLNpa .doneCritText1,#mermaid-svg-dIYkfmZVkl9GLNpa .doneCritText2,#mermaid-svg-dIYkfmZVkl9GLNpa .doneCritText3{fill:black!important;}#mermaid-svg-dIYkfmZVkl9GLNpa .doneCritText0.taskTextOutsideLeft,#mermaid-svg-dIYkfmZVkl9GLNpa .doneCritText0.taskTextOutsideRight,#mermaid-svg-dIYkfmZVkl9GLNpa .doneCritText1.taskTextOutsideLeft,#mermaid-svg-dIYkfmZVkl9GLNpa .doneCritText1.taskTextOutsideRight,#mermaid-svg-dIYkfmZVkl9GLNpa .doneCritText2.taskTextOutsideLeft,#mermaid-svg-dIYkfmZVkl9GLNpa .doneCritText2.taskTextOutsideRight,#mermaid-svg-dIYkfmZVkl9GLNpa .doneCritText3.taskTextOutsideLeft,#mermaid-svg-dIYkfmZVkl9GLNpa .doneCritText3.taskTextOutsideRight{fill:black!important;}#mermaid-svg-dIYkfmZVkl9GLNpa .vert{stroke:navy;}#mermaid-svg-dIYkfmZVkl9GLNpa .vertText{font-size:15px;text-anchor:middle;fill:navy!important;}#mermaid-svg-dIYkfmZVkl9GLNpa .activeCritText0,#mermaid-svg-dIYkfmZVkl9GLNpa .activeCritText1,#mermaid-svg-dIYkfmZVkl9GLNpa .activeCritText2,#mermaid-svg-dIYkfmZVkl9GLNpa .activeCritText3{fill:black!important;}#mermaid-svg-dIYkfmZVkl9GLNpa .titleText{text-anchor:middle;font-size:18px;fill:#333;font-family:"trebuchet ms",verdana,arial,sans-serif;}#mermaid-svg-dIYkfmZVkl9GLNpa :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} 2026-09-21 2026-09-23 2026-09-25 2026-09-27 2026-09-29 2026-10-01 2026-10-03 2026-10-05 2026-10-07 2026-10-09 2026-10-11 2026-10-13 2026-10-15 隔离环境准备 只读分析与依赖图 规则抽取与业务签核 特征测试编写 小步重构/适配器开发 测试与对拍 影子运行与汇总 决策评审 第1周第2周第3周第4周 2-4周Claude Code遗留系统试点
7.2 示例试点效果对比
以下为演示口径，用于说明指标计算方式。实际请以贵司试点自测为准。
| 指标 | 试点前 | 试点后 | 说明 |
|---|---|---|---|
| 单模块规则梳理工时 | 5人日 | 2人日 | Claude先抽规则，人工做签核 |
| 特征测试覆盖率 | 0% | 82% | 仅覆盖试点子域关键路径 |
| 缺陷定位平均时长 | 4小时 | 1.5小时 | 依赖图和行号溯源辅助 |
| 接口文档完整度 | 20% | 90% | 适配器生成时同步产出 |
| 对拍差异率 | 无基准 | 0.02% | 新老实现同输入输出对比 |
使用说明：示例数据不承诺真实企业收益；若试点实际值低于预期，优先检查主数据、测试基线和业务参与度，而不是责怪模型。
八、踩坑实录与 FAQ
Q1：AI 补了一条不存在的规则，怎么办？
A：在提示词中强制要求"每条规则必须返回file:line；无法确认时写 UNVERIFIED"。所有规则表必须经过业务专家签核，才能进入实现阶段。
Q2：上下文超限，全库塞不进去怎么办？
A：按业务子域拆分，每域一个CLAUDE.md和一组代理任务。禁止"一个会话分析全库"的暴力方案。
Q3：老系统没有 CI/CD，能做对拍吗？
A：可以。写独立对拍脚本，从老库和测试库取真实订单/库存事件，分别调新旧实现，diff 输出。没有 CI 也能做，但至少要能自动化运行脚本。
Q4：老系统无法在本地启动，怎么办？
A：优先考虑沙箱还原数据库和相关服务；实在无法启动，就用离线日志、数据库快照和存储过程模拟，把可执行用例限制在纯SQL/纯函数上。
Q5：业务方不配合签核规则，怎么办？
A：不签核就不动。把"规则签核"设为进入实现阶段的硬门槛。可先选一个低危、影响小的模块作为"教育型试点"，让业务看到签核的收益。
Q6：财务/客户数据能用公网 Claude Code 吗？
A：不建议。使用企业版/私有化部署，或先脱敏再分析；所有 AI 改动作保留审计日志。
Q7：老系统改造预算大概多少？
A：没有标准答案。按"试点成本→单域成本→整体成本"逐步测算；可参考第6节成本模板设定止损线。
Q8：什么时候该放弃老系统，直接重买？
A：当业务已淘汰、数据全脏且无人能说清规则、合规要求新系统原生支持、维护成本长期超过替代品成本时，直接换商业SaaS可能更划算。AI辅助重构只适用于"业务还有价值、规则还可追溯"的系统。
九、结论与决策清单
Claude Code 是遗留系统的"安全测绘仪"，不是"全自动重写器"。它把看不懂的代码变成依赖图，把隐性规则变成可签核清单，把无人敢动的模块变成有测试保护的小步变更。但最终决定成败的是人：业务专家定规则，架构师定边界，测试保行为，组织能配合。
决策者清单：
- 选一个边界清晰、低危子域做2--4周试点；
- 产出依赖图、规则溯源表、特征测试、对拍报告、成本周报；
- 不满足"有人审、有测试、可回滚、可对账"不扩大；
- KPI 看"理解老系统工时、缺陷定位、测试覆盖、小模块交付周期"，不看"AI全自动改完多少行"。
文中示例数据与场景为演示口径，仅用于说明评估和计算方法，不构成对任何真实企业成效的承诺。生产改造请以本企业试点结果为准。