sync_func - 跨项目功能迁移工作流

总览

sync_func 用于将一个来源工程中的功能迁移到当前工程，保持业务逻辑一致，同时按当前工程的目录结构与编码规范重新落地实现。适用于：功能同步、功能迁移、跨项目复刻实现等场景。

使用方式

当用户提到以下场景时使用 sync_func：

• 功能同步
• 功能迁移
• 跨项目复刻实现
• 使用 /sync_func 命令

配置

读取 ~/.claude/skills/sync_func/.env：

• SYNC_FUNC_SOURCE_DIR - 来源工程目录

目标工程为当前工作目录，无需额外配置。

执行流程

1. 运行时确认

每次执行必须向用户确认来源目录：

• 若 .env 中已配置且目录存在，展示路径并询问确认
• 若未配置或目录不存在，要求用户提供来源工程路径

2. 功能分析

解析任务描述，明确：

• 同步范围
• 验收标准
• 是否允许简化

3. 来源工程定位

在来源工程中定位实现：

• 入口点
• 核心逻辑
• 依赖关系
• 数据结构
• 边界处理

4. 目标工程设计

在当前工程中定位承载位置，按目标工程规范设计：

• 分层结构
• 命名约定
• 框架约定

5. 实现转换

按当前工程结构实现同等逻辑，不直接照搬来源工程目录。

6. 适配补齐

补齐必要适配：

• 配置
• 依赖注入
• 接口层
• 异常处理
• 日志与测试

7. 验证执行

运行当前工程相关验证（至少覆盖本次同步路径）并修复问题。

8. 同步报告

输出内容包括：

• 改动文件
• 逻辑映射
• 差异点
• 验证结果
• 后续风险

强约束

约束	说明
逻辑一致性	保持功能逻辑与业务规则一致，不擅自改语义
当前工程优先	代码风格、目录结构、公共组件必须遵循当前工程
信息不足时确认	遇到信息不足时先补充确认，不在关键行为上猜测实现

执行检查清单

• [ ] 确认来源工程目录
• [ ] 解析同步范围和验收标准
• [ ] 定位来源工程实现
• [ ] 设计目标工程落点
• [ ] 按目标工程规范实现
• [ ] 补齐必要适配
• [ ] 运行验证并修复问题
• [ ] 输出同步报告