상품 페이지가 엉망이 되는 원인은 '표기 불일치'. AI에게 맡기기 전에 수정하는 절차

※예시는 모두 가상의 매장・상품입니다

지난 글에서는 '상품 마스터(1행=1상품)를 정본(기준이 되는 하나의 데이터)으로 삼고, 몰별 상품 페이지를 Claude Code에 분리 작성하게 한다'는 아이디어를 소개했습니다.

그중에서 '넘어지기 쉬운 포인트' 중 하나로 언급한 것이 상품 마스터의 표기 불일치입니다. 이번에는 이 부분을 깊이 파헤쳐 보겠습니다.

같은 머그컵인데, 표기가 제각각

가상의 '샘플 잡화점' 상품 마스터를 살펴보겠습니다.

상품 코드, 상품명, 용량, 사이즈, 컬러
mug-001, 북유럽풍 머그컵, 350ml, 직경8cm×높이9cm, 화이트
mug-002, 북유럽풍 머그컵 라지, ４５０ｍｌ, φ85×H100mm, 백
...

세 사람이 다른 날에 입력하면 대략 이렇게 됩니다. 사람의 눈으로 보면 같은 의미라는 것을 알 수 있습니다. 하지만 이대로 상품 페이지를 만들면 어떻게 될까요?

표기 불일치가 왜 문제인가요

• 검색에 걸리지 않음
  고객님이 '화이트'로 검색해도, '백', 'WHITE'라고 적은 상품은 나오지 않을 수 있습니다. -
• 글자 수가 달라짐
  전각의 '４５０ｍｌ'은 글자 수를 바이트로 세는 몰에서는 반각의 '450ml'보다 길게 계산될 수 있습니다. 몰의 글자 수 상한선에 아슬아슬하게 상품명을 만들 경우, 여기서 초과할 수 있습니다. -
• AI 출력도 들쭉날쭉함
  AI는 입력된 방식을 거의 그대로 사용합니다. 입력이 제각각하면 출력도 제각각입니다. 3개의 상품을 나열했을 때, 페이지의 모양이 일정하지 않습니다.

즉, 생성하기 전에 표기를 통일하지 않으면, 나중에 검토와 수정 작업이 전부 늘어납니다.

생각하는 방식: '생성 전에, 정리 단계를 하나 추가'하기

지난 과정에 단계를 하나 더합니다.

상품 마스터(1행=1상품)
↓
① 정리 (표기 불일치를 수정) ← 이번 내용
...

핵심은, ①을 ②와 섞지 않는 것입니다. '분리 작성하면서, 겸사겸사 표기도 고쳐줘'라고 부탁하면, 어디를 수정한 것인지 알 수 없게 됩니다. 정리 단계를 독립시켜서, 수정한 결과를 눈으로 확인할 수 있게 하는 것이 기본입니다.

흔한 표기 불일치 5가지

EC 상품 마스터에서 특히 자주 발생하는 5가지입니다. 자신의 가게의 '통일 방식'을 하나로 정해둡니다.

• 전각・반각 : '４５０', 'ＭＵＧ' → 숫자・영자는 반각으로 통일 -
• 단위 : 'ml', 'mL', '밀리리터' → 'ml'로 통일 -
• 사이즈 표기 : 'φ85×H100mm', '직경8cm×높이9cm' → '직경◯cm×높이◯cm'로 통일 (mm는 cm로 변환) -
• 색상 이름 : '백', '화이트', 'WHITE' → 가타카나의 'ホワイト'로 통일 -
• 기호 : '～'와 '〜', '・'과 '･' → '〜', '・'으로 통일

'무엇이 옳은가'보다, 매장 내에서 하나로 정해져 있는가가 중요합니다. 몰마다 다른 작성 방식이 필요한 경우에도, 먼저 하나로 통일한 다음 ②의 분리 작성 단계에서 변경하는 것이 관리하기 쉽습니다.

CLAUDE.md에 추가할 몇 줄

지난번 소개했던 규칙 파일(CLAUDE.md)에 예를 들어 다음과 같은 몇 줄을 추가합니다.

※products.csv는 상품 마스터 파일명입니다.

## 정리 (분리 작성 전에 반드시 수행)
- products.csv의 표기를 아래 '표기 규칙'에 따라 통일한다
- 결과는 products_clean.csv에 저장한다 (원본 파일은 덮어쓰지 않는다)
...

특히 중요한 것은 다음 두 가지입니다.

• 원본 파일을 덮어쓰지 않기: 잘못 수정해도 원상 복구할 수 있습니다. -
• 수정한 부분을 목록으로 내보내기: 모든 행을 다시 검토하지 않아도, 목록만 확인하면 됩니다.

주의: 임의로 고쳐서는 안 되는 것들

모든 것을 통일하면 되는 것은 아닙니다. 다음 항목들은 수정하지 않고 '확인 필요'로 목록에 내보내게 합니다.

• 모델 번호・JAN 코드: 1글자만 달라도 다른 상품이 됩니다 -
• 브랜드명・상품 고유 명사: '북유럽풍 머그 미니'를 '북유럽풍 머그컵 미니'로 수정하는 것은 매장이 결정할 문제입니다 -
• 의미가 바뀔 가능성이 있는 것: '약350ml'에서 '약'을 지우는 등

CLAUDE.md에는 이렇게 작성합니다.

- 모델 번호・JAN 코드・브랜드명・상품 고유 명사는 수정하지 않는다
- 수정하면 의미가 바뀔지 모르는 것은 수정하지 않고, '확인 필요'로 목록에 내보낸다

이전의 '모르겠으면 공란으로 두고, 확인 목록을 만들자'와 같은 생각입니다. AI에게는 '수정하기(直す)'보다 '찾아서 알려주기(見つけて知らせる)'를 더 많이 맡기는 것이 사고를 줄여줍니다.

요약

• 표기 불일치는 검색, 글자 수, AI 출력의 편차에 효과적입니다.
• 작성하기 전에 '정리하는(整える)' 공정을 독립시키고, 수정된 부분을 목록으로 만듭니다.
• 모델명이나 고유 명사는 수정하지 않고, '확인 필요' 항목으로 돌립니다.

이번에 소개한 표기 규칙은 5가지뿐입니다.

다음 항목들을 세트로 구성한 '상품 페이지 양산 키트'를 10월 31일에 공개할 예정입니다.

• 상품 마스터 템플릿
• 표기 규칙 일체
• 몰(Mall)별 규칙표
• 확인 필요 목록 출력

공개 알림은 X에서 진행합니다 → @ec_jidoka_kobo

(EC 자동화 공방)

토론