name: dz-qa-scenario-builder description: Use when the user asks to create a QA/review scenario sheet from an Amaranth 10 screen design document and a target Google Sheets URL. This skill copies the standard template tab into the destination spreadsheet using Google Sheets MCP tools, renames it, fills header metadata, preserves formulas/formatting, and writes dense step-by-step test cases. version: 0.1.0

QA 검수시나리오 빌더 (qa-scenario-builder)

화면설계서를 기준으로 검수시나리오 구글시트를 만드는 스킬이다. Google Sheets MCP 도구를 사용해 템플릿 시트를 복제하고, 상단 메타정보를 채운 뒤, 실무 검수용 밀도의 테스트 케이스를 작성할 때 사용한다.

사용할 때

"화면설계서로 검수시나리오 작성해줘"
"검수 시트 만들어줘"
"검수 탭 추가해줘"
"QA 시나리오 작성해줘"
"검수시나리오 빌더로 [설계서명] 처리해줘"

전제 조건

Google Sheets MCP 연결 확인
- list_sheets, get_sheet_data, copy_sheet, rename_sheet, update_cells, batch_update_cells, find_cells 도구 가용 여부 확인
- MCP 미연결 시 → Markdown 형식 테스트 케이스로 대체 가능
sheets-config.json 로드 (있는 경우)
- 템플릿 스프레드시트 ID와 탭명 확인
- templates.qa-scenario 섹션에서 템플릿 정보 참조
화면설계서 → 메타정보 추출
- 메뉴명, LNB 코드, 기능명 확인
- 테스트 환경/URL/사전조건 파악

핵심 원칙

항상 템플릿 시트를 복제해서 시작한다. 새 시트를 빈 상태에서 직접 만들지 않는다.
상단 수식, 조건부 서식, 결과 영역 구조는 유지한다.
상단 통합테스트 ID는 TC-{LNB코드}-001 규칙을 쓰고, 본문 테스트 케이스 번호는 1, 2, 3... 순번으로 작성한다.
테스트 케이스는 기능명 또는 검수 묶음명으로 작성하고, 절차/예상결과를 여러 행으로 세분화한다.
1depth~3depth는 기능이 수행되는 화면 경로를 적는다.
복잡한 화면은 요약하지 말고, 실무자 작성 시트 수준으로 잘게 쪼갠다.
값 입력이나 항목 선택이 필요한 절차는 예시 값 또는 선택 항목을 절차와 예상결과에 함께 적는다.

작업 순서

화면설계서명, 대상 구글시트 URL, 요청자 이름을 확인한다.
화면설계서에서 메뉴명, 기능명, LNB 코드, 1depth~3depth 경로를 확인한다.
Google Sheets MCP 도구로 템플릿 시트를 대상 구글시트로 복제한다.
새 시트명을 [검수] {메뉴명 또는 기능명}으로 바꾼다.
상단 메타정보를 채운다.
검수율 수식과 조건부 서식은 템플릿 값을 유지한다.
화면설계서를 처음부터 끝까지 읽으면서 기능 묶음별 테스트 케이스를 만들고, 각 묶음 아래 절차를 순차적으로 작성한다.
예외 케이스가 있으면 다른 값, 다른 선택 항목, 비정상 입력 기준의 별도 테스트 케이스를 추가한다.
작성이 끝나면 설계서 누락/예외/Validation/추가 확인 절차 기준으로 자체 점검하고 필요한 케이스를 보강한다.
보강 후에는 추가된 테스트 케이스가 하단에만 쌓이지 않도록 실제 검수 흐름에 맞게 위치를 다시 정렬한다.
설계서 규칙이 모호하거나 누락된 항목은 예상결과에 화면설계 미기재/재확인 필요 메모를 추가해 표시한다.
같은 기능의 연관 설계서, 공통 정책, 히스토리 문서가 있으면 함께 대조해 누락된 검수 포인트를 보강한다.

템플릿 복제와 메타정보 채우기 상세는 references/workflow.md를 본다. 테스트 케이스를 어느 수준까지 쪼개야 하는지는 references/case-writing-rules.md를 본다.

빠른 규칙

시트명: [검수] {기획서 기준 메뉴명/기능명}
상단 통합테스트 ID: TC-{LNB코드}-001
본문 테스트 케이스 번호: 1, 2, 3...
테스트 케이스: 화면명이 아니라 검증하려는 기능명
1depth~3depth: 기능이 위치한 메뉴/탭/팝업 경로
같은 기능 묶음의 연속 행은 테스트 케이스, 1depth~3depth 셀 병합을 우선 검토
입력/선택 절차는 예시 값 또는 선택 항목을 명시
예외 케이스는 별도 테스트 케이스로 분리
초안 보강 후 추가된 케이스는 하단에 두지 말고, 실제 검수 순서에 맞게 본문 위치를 다시 정렬
설계서 미흡 항목은 예상결과에 보강 메모를 추가하고, 가능한 경우 붉은색으로 강조
작성자: 기본값 SBUnit {요청자명}
테스트 사전조건: 기본값 유지, 특별한 전제조건이 있으면 교체
테스트환경: 기본값 크롬(Chrome)
URL: 별도 URL/계정 정보가 없으면 템플릿 값 유지
상세정보: 요청받은 화면설계서명

MCP 도구 활용

템플릿 시트 복제

MCP 도구: copy_sheet(
  spreadsheet_id="{템플릿ID}",
  source_sheet_name="{템플릿탭명}",
  destination_spreadsheet_id="{대상시트ID}"
)

시트탭명 변경

MCP 도구: rename_sheet(
  spreadsheet_id="{대상시트ID}",
  old_name="Copy of {템플릿탭명}",
  new_name="[검수] {메뉴명}"
)

헤더 메타정보 입력

MCP 도구: update_cells(
  spreadsheet_id="{대상시트ID}",
  range="'{시트명}'!F2:F8",
  values=[[통합테스트ID], [작성자], [메뉴], [사전조건], [테스트환경], [URL], [상세정보]]
)

테스트 케이스 본문 작성

MCP 도구: batch_update_cells(
  spreadsheet_id="{대상시트ID}",
  data=[
    { "range": "'{시트명}'!A10", "values": [["1"]] },
    { "range": "'{시트명}'!C10", "values": [["기능명"]] },
    ...
  ]
)

템플릿 정보

Google Sheets MCP가 연결된 경우, sheets-config.json의 templates.qa-scenario 섹션에서 템플릿 정보를 참조한다:

{
  "templates": {
    "qa-scenario": {
      "spreadsheet_id": "...",
      "sheet_name": "..."
    }
  }
}

MCP 미연결 시에는 Markdown 형식으로 테스트 케이스를 작성해 제공한다.

주의

템플릿 셀 위치를 외우고 바로 덮어쓰기보다, 현재 템플릿 라벨 구조를 먼저 읽고 작업한다.
복제 후 상단 수식/서식이 깨졌다면 수동 생성이 아니라 템플릿 복제 절차가 잘못된 것이다.
테스트 사이트 비밀번호는 사용자가 원하면 표시 마스킹 + 내부 원문 유지 방식으로 관리할 수 있다.
검수시나리오가 20~30건으로 끝나면 대개 너무 얕게 쓴 것이다. 복잡한 팝업/메뉴는 더 잘게 쪼갠다.

보조 자료

복제/채번/헤더 규칙: references/workflow.md
케이스 밀도와 작성 기준: references/case-writing-rules.md

마크다운 링크 규칙 (필수)

마크다운 파일 작성·업데이트 시 모든 경로·파일 참조는 클릭 가능한 상대 링크로 작성한다.

# 나쁜 예 (클릭 불가)
법무관리/tasks/_current.md에서 확인

# 좋은 예 (클릭 가능)
[법무관리/tasks/_current.md](../법무관리/tasks/_current.md)에서 확인

상대 경로는 현재 파일 위치 기준
코드블록 안의 폴더 구조 다이어그램은 예외 (링크 불필요)
상세 규칙은 douzone-forge CLAUDE.md의 "마크다운 링크 표기 규칙" 섹션 참조

QA Scenario Builder

Recommended for