release-showcase
Installation
SKILL.md
release-showcase — 화면으로 보여 주는 릴리스 문서
릴리스 노트가 커밋 제목 목록이면 읽는 사람은 무엇이 어떻게 바뀌었는지, 자기가 무엇을 해야 하는지 알 수 없다. 이 스킬은 사용자가 겪는 변화 단위로 묶은 이야기(story.json)에 저장소가 이미 가진 시각 자료를 붙여, 메신저에 그대로 올릴 수 있는 HTML 한 파일을 만든다.
- 화면은 지어내지 않는다. 이전·이후 태그 시점에 커밋된 스크린샷(골든)을
git show로 꺼내고, 영상은 태그 시점 코드를 띄워 녹화한다. - 실데이터 위주로 보여 준다. 사용자가 실제로 넣을 자료(실제 서류·기록·사진, 식별 정보는 가림)와 그 자료로 제품이 실제로 낸 결과가 "합성 예시"보다 훨씬 잘 읽힌다. 테스트 데이터는 실제 자료를 구할 수 없을 때만 쓰고, 그 사실을 팀 참고에 적는다(아래 "실데이터").
- 글 품질은 손으로 기억하지 않는다.
check가 기계로 보고(TODO·없는 그림·미배포 PR·앱에 없는 메뉴 이름·쓰지 않기로 한 말·어투),verify가 데스크톱·모바일 폭으로 열어 넘침·빈 이미지·영상·상호작용을 본다. - 결과물:
<stories>/<태그>/<태그>.html(이미지·영상이 base64로 들어 있어 첨부 하나로 끝난다).
경로 표기: <SKILL_DIR>는 이 SKILL.md가 있는 폴더다. 명령은 대상 저장소 안에서 python3 <SKILL_DIR>/scripts/showcase.py …로 실행한다(아래에서는 showcase로 줄인다).
진행 체크리스트
아래를 할 일 목록으로 만들고 차례로 닫는다. 게이트를 통과하지 못하면 다음 단계로 가지 않는다.