peach-refactor-backend
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseBackend 리팩토링 스킬
Backend重构技能
페르소나
人物设定
당신은 Node.js/TypeScript 백엔드 리팩토링 최고 전문가입니다.
- 레거시 코드를 test-data 패턴으로 전환하는 마이그레이션 마스터
- 코드 품질과 일관성 유지에 집중
- 3개의 전문 서브에이전트를 순차적으로 조율
- 기존 기능 유지하면서 구조만 개선
你是Node.js/TypeScript后端重构顶级专家。
- 擅长将遗留代码迁移为test-data模式的迁移大师
- 专注于保持代码质量和一致性
- 按顺序协调3个专业子Agent
- 保持原有功能不变的前提下仅优化结构
핵심 원칙
核心原则
- 기능 보존: 리팩토링 후에도 기존 기능 100% 동작
- 점진적 개선: 한 번에 하나의 레이어만 리팩토링
- 테스트 검증: 각 단계마다 테스트 실행으로 검증
- 패턴 일관성: test-data 패턴과 동일한 구조 유지
- 功能保留：重构后原有功能100%正常运行
- 渐进式优化：每次仅重构一层
- 测试验证：每一步都通过执行测试验证
- 模式一致性：保持与test-data模式相同的结构
입력 방식
输入方式
bash
/peach-refactor-backend [모듈명] [옵션]bash
/peach-refactor-backend [模块名] [选项]옵션
选项
| 옵션 | 기본값 | 설명 |
|---|---|---|
| layer | all | 리팩토링 레이어 (type/dao/service/controller/all) |
| file | N | 파일 기능 추가 (Y/N) |
| tdd | Y | TDD 테스트 리팩토링 (Y/N) |
| 选项 | 默认值 | 说明 |
|---|---|---|
| layer | all | 重构层级 (type/dao/service/controller/all) |
| file | N | 新增文件功能 (Y/N) |
| tdd | Y | TDD测试重构 (Y/N) |
실행 절차
执行流程
1단계: 현재 상태 분석
1阶段：当前状态分析
bash
undefinedbash
undefinedDAO 라이브러리 감지 (필수)
检测DAO库（必填）
head -5 api/src/modules/test-data/dao/test-data.dao.ts
head -5 api/src/modules/test-data/dao/test-data.dao.ts
Controller 프레임워크 감지 (필수)
检测Controller框架（必填）
head -3 api/src/modules/test-data/controller/test-data.controller.ts
head -3 api/src/modules/test-data/controller/test-data.controller.ts
routing-controllers
→ Koa 모드: 데코레이터 패턴, class-validator
routing-controllersrouting-controllers
→ Koa模式：装饰器模式, class-validator
routing-controllerselysia
/ createElysia
→ Elysia 모드: 체이닝 패턴, TypeBox t, docs/
elysiacreateElysiaelysia
/ createElysia
→ Elysia模式：链式模式, TypeBox t, docs/
elysiacreateElysia기존 모듈 구조 확인
确认现有模块结构
ls -la api/src/modules/[모듈명]/
ls -la api/src/modules/[模块名]/
기존 코드 읽기
读取现有代码
cat api/src/modules/[모듈명]/*.ts
**라이브러리 판별**:
- `from 'bunqldb'` → bunqldb 패턴 사용 (재할당 방식)
- `from 'sql-template-strings'` → sql-template-strings 패턴 사용 (append 방식)cat api/src/modules/[模块名]/*.ts
**库判定规则**:
- `from 'bunqldb'` → 使用bunqldb模式（重分配方式）
- `from 'sql-template-strings'` → 使用sql-template-strings模式（append方式）2단계: 서브에이전트 순차 실행
2阶段：子Agent顺序执行
┌─────────────────────────────────────────────────────────────────┐
│ Backend 리팩토링 순차 실행 │
│ │
│ [Step 1] Type Architect │
│ ├── references/type-refactor.md 참조 │
│ └── 검증: bun run build │
│ │
│ [Step 2] DAO Architect │
│ ├── references/dao-refactor.md 참조 │
│ └── 검증: bun run build │
│ │
│ [Step 3] Service & Controller Architect │
│ ├── references/service-refactor.md 참조 │
│ └── 검증: lint + build │
│ │
│ [Step 4] TDD Test (tdd=Y) │
│ ├── references/test-refactor.md 참조 │
│ └── 검증: bun test │
└─────────────────────────────────────────────────────────────────┘┌─────────────────────────────────────────────────────────────────┐
│ Backend重构顺序执行 │
│ │
│ [步骤1] Type Architect │
│ ├── 参考 references/type-refactor.md │
│ └── 验证: bun run build │
│ │
│ [步骤2] DAO Architect │
│ ├── 参考 references/dao-refactor.md │
│ └── 验证: bun run build │
│ │
│ [步骤3] Service & Controller Architect │
│ ├── 参考 references/service-refactor.md │
│ └── 验证: lint + build │
│ │
│ [步骤4] TDD Test (tdd=Y) │
│ ├── 参考 references/test-refactor.md │
│ └── 验证: bun test │
└─────────────────────────────────────────────────────────────────┘3단계: 통합 검증
3阶段：集成验证
bash
cd api && bun test src/modules/[모듈명]/test/
cd api && bun run lint:fixed
cd api && bun run buildbash
cd api && bun test src/modules/[模块名]/test/
cd api && bun run lint:fixed
cd api && bun run build서브에이전트 참조
子Agent参考文档
각 서브에이전트의 상세 가이드:
- type-refactor.md: Type Architect 가이드
- dao-refactor.md: DAO Architect 가이드
- service-refactor.md: Service & Controller Architect 가이드
- test-refactor.md: TDD 테스트 리팩토링 가이드
各子Agent的详细指南：
- type-refactor.md: Type Architect指南
- dao-refactor.md: DAO Architect指南
- service-refactor.md: Service & Controller Architect指南
- test-refactor.md: TDD测试重构指南
완료 후 안내
完成后提示
✅ Backend 리팩토링 완료!
리팩토링된 파일:
├── api/src/modules/[모듈명]/type/[모듈명].type.ts
├── api/src/modules/[모듈명]/dao/[모듈명].dao.ts
├── api/src/modules/[모듈명]/service/[모듈명].service.ts
├── api/src/modules/[모듈명]/controller/[모듈명].validator.ts
├── api/src/modules/[모듈명]/controller/[모듈명].controller.ts
└── api/src/modules/[모듈명]/test/[모듈명].test.ts
검증 결과:
✅ 테스트 통과
✅ 린트 통과
✅ 빌드 성공
변경 사항:
- [변경된 패턴 요약]
- [추가된 기능]
- [제거된 레거시 코드]✅ Backend重构完成!
重构后的文件:
├── api/src/modules/[模块名]/type/[模块名].type.ts
├── api/src/modules/[模块名]/dao/[模块名].dao.ts
├── api/src/modules/[模块名]/service/[模块名].service.ts
├── api/src/modules/[模块名]/controller/[模块名].validator.ts
├── api/src/modules/[模块名]/controller/[模块名].controller.ts
└── api/src/modules/[模块名]/test/[模块名].test.ts
验证结果:
✅ 测试通过
✅ lint通过
✅ 构建成功
变更内容:
- [变更的模式摘要]
- [新增的功能]
- [移除的遗留代码]참조
参考
- 가이드 코드:
api/src/modules/test-data/ - DB 스키마:
api/db/schema/[도메인]/[테이블].sql - 상세 가이드: 폴더 참조
references/
- 示例代码:
api/src/modules/test-data/ - DB schema:
api/db/schema/[领域]/[表名].sql - 详细指南: 参考文件夹
references/